2
Last changed: 25 January 2007
4
-----------------------------------------------------------------------
5
Alpine/Pico/Pilot/Web Alpine/Imapd Distribution
6
-----------------------------------------------------------------------
8
/* ========================================================================
9
* Copyright 2007 University of Washington
11
* Licensed under the Apache License, Version 2.0 (the "License");
12
* you may not use this file except in compliance with the License.
13
* You may obtain a copy of the License at
15
* http://www.apache.org/licenses/LICENSE-2.0
17
* ========================================================================
20
For the latest info about Alpine, see http://www.washington.edu/alpine
22
-----------------------------------------------------------------------
24
-----------------------------------------------------------------------
26
This Alpine distribution includes:
28
alpine - The Alpine source directory
29
configure - Script to set system-specific configuration, defaults
30
contrib - Contributed ports and additions
31
doc - Documentation directory. The main documentation is tech-notes.txt
32
imap - Source tree containing C-Client IMAP implementation
33
m4 - macros used in the configure process
34
packages - Scripts for building packages for various Linux distributions
35
pico - The Pico and Pilot source directory
36
pith - Core functions common to Alpine/Web Alpine
37
po - localization data
38
web - Source and scripts for web-based version of Alpine
40
Most of the documentation is in doc/tech-notes.txt. It is not user
41
level documentation, but there are things in it some users might find
42
useful. The directory doc/tech-notes contains source for
43
doc/tech-notes.txt in HTML format which can be viewed via a Web
44
browser by opening doc/tech-notes/index.html.
47
-----------------------------------------------------------------------
49
-----------------------------------------------------------------------
51
If you are reading this, you have presumably succeeded in extracting
52
the distribution from the compressed tar archive file, via the following
53
command, or equivalent:
57
Some of the instructions that follow assume that your current workding
58
directory is the alpine-X.XX directory created by the un-tar process
62
-----------------------------------------------------------------------
64
-----------------------------------------------------------------------
66
Alpine build process uses GNU autoconf. It should be sufficient to build
67
alpine by typing the commands:
72
For a list of configuration options and default settings type:
77
-----------------------------------------------------------------------
79
-----------------------------------------------------------------------
81
The executables produced are:
83
alpine The Alpine mailer. Once compiled this should work just fine on
84
your system with no other files than this binary, and no
85
modifications to your system. Optionally you may create two
86
configuration files, /usr/local/lib/pine.conf and
87
/usr/local/lib/pine.info. See the documentation for details.
89
pico The standalone editor similar to the Alpine message composer.
90
This is a very simple straight forward text editor.
92
pilot The standalone file system navigator.
95
The Web Alpine serveret which manages the
97
imapd The IMAP daemon. If you want to run alpine in client/server mode,
98
this is the daemon to run on the server. Installing this
99
requires system privileges and modifications to /etc/services.
100
See doc/tech-notes for more details.
102
mtest The test IMAP client, an absolutely minimal mail client, useful
105
rpload Utility for uploading a local pinerc or address book to an IMAP
108
rpdump Utility for downloading a pinerc or address book to the
112
Utility for performing various operations on mailboxes,
113
be they local or remote.
115
In general "make install" should place alpine, pico and pilot, and
116
their corresponding man pages, in the proper directory for your
117
system. As the remaining binaries are intended for specific uses or
118
are a component of a larger package, their installation is typically
122
-----------------------------------------------------------------------
123
END OF alpine.tar.z README
124
-----------------------------------------------------------------------