The pine2mutt Handbook

Jan Schaumann jschauma@netmeister.org 
Version 0.3 , Sat November 10 13:08:08 EST 2001
This information is also available at http://www.netmeister.org/apps/pine2mutt/


This Handbook describes pine2mutt Version 0.3


1. Introduction

2. Installation

    2.1 How to obtain pine2mutt 
    2.2 Requirements 
    2.3 Compilation and installation 

3. Usage 

4. Copyright

5. Misc

-------------------------------------------------------

1. Introduction

pine2mutt is a simple perl-script interesting to people who switch from using
pine to mutt. It converts pine's .addressbook into mutt-readable aliases,
enables pine-like sent-mail-folder handling and provides pine-like
keybindings.

-------------------------------------------------------

2. Installation

2.1 How to obtain pine2mutt 

pine2mutt 0.3 can be obtained from: 

    http://www.netmeister.org/apps/pine2mutt-0.3.tar.gz 
    http://guinness.cs.stevens-tech.edu/~jschauma/pine2mutt-0.3.tar.gz 
    http://www.netmeister.org/apps/pine2mutt-0.3-1mdk.i386.rpm 
    http://www.netmeister.org/apps/pine2mutt-0.3-1mdk.src.rpm 

View CHANGES for (d'uh) changes.
Older versions can be obtained from http://www.netmeister.org/apps/

2.2 Requirements 

In order to successfully use pine2mutt, you need the following programs and
libraries which are available on most platforms as distribution
packages and thereby can be installed easily. 

Required: 

    Perl 5.x, available at http://www.perl.com 

2.3 Compilation and installation 

In order to install pine2mutt on your system, type the following in the the
directory to which you downloaded the pine2mutt distribution: 

    % tar zxvf pine2mutt-0.3.tar.gz
    % cd pine2mutt-0.3
    % su
    % make install

This will install pine2mutt in /usr/local/bin/ and copy the man-page for
pine2mutt into /usr/local/man/man1/. 

If perl does not live in /usr/bin/perl, please edit the file "pine2mutt" in the
base-directory of the distribution and change the first line
appropriately. 

Should you run into problems please report them to the the author at
jschauma@netmeister.org


-------------------------------------------------------

3. Usage 

pine2mutt is fairly uncomplicated: simply run
% pine2mutt -i ~/.addressbook
to convert your ~/.addressbook and enable all default features.

Alternatively, you can specify the input and outputfiles on the command-line.
See 
% pine2mutt -h 
or
% man pine2mutt 
for details. 

pine2mutt adds the line "source ~/.pine2mutt" (or the filename you specified)
to your .muttrc. By sourcing this file some existing keybindings might seem to
stop working even though they are still in your ~/.muttrc. The reason for
this is, that pine2mutt's output contains keybindings. If you wish to keep
your old bindings, you can edit the file "~/.pine2mutt" and simply comment out
the appropriate lines.

If you run into any problems, if you encounter bugs, or if you have any other
comments on this program,please don't hesitate to email me. 

-------------------------------------------------------

4. Copyright

pine2mutt (c) 2000, 2001 Jan Schaumann, jschauma@netmeister.org 

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your option)
any later version. 

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details. 

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA. 

-------------------------------------------------------

5. Misc

Please take the time to visit these websites: 

    http://www.aclu.org 
    http://www.amnesty.org 
    http://www.worldwildlife.org 
    http://www.ncadp.org 

Take the time to think about it. 


-------------------------------------------------------
