packages icon
The pine2mutt Handbook

Jan Schaumann jschauma@netmeister.org 
Version 0.1 , Th November 09 18:19:15 EST 2000
This information is also available at http://www.netmeister.org/apps/pine2mutt/


This Handbook describes pine2mutt Version 0.1


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. Currently, pine2mutt only converts pines addressbook
into a mutt-compatible alias-file, but it might facilitate other necessary
conversion in the future. 

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

2. Installation

2.1 How to obtain pine2mutt 

pine2mutt 0.1 can be obtained from: 

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

View CHANGES for (d'uh) changes.

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.1.tar.gz
    % cd pine2mutt-0.1
    % 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 
to convert your ~/.addressbook into ~/.aliases. pine2mutt will also add the
line
source ~/.aliases
to your ~/.muttrc (if neccessary). 

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

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 Copyright 2000 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. 


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