~ubuntu-branches/debian/stretch/alpine/stretch

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Asheesh Laroia
  • Date: 2007-02-17 13:17:42 UTC
  • Revision ID: james.westby@ubuntu.com-20070217131742-99x5c6cpg1pbkdhw
Tags: upstream-0.82+dfsg
ImportĀ upstreamĀ versionĀ 0.82+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
alpine.tar.z README
 
2
Last changed: 25 January 2007
 
3
 
 
4
-----------------------------------------------------------------------
 
5
                Alpine/Pico/Pilot/Web Alpine/Imapd Distribution
 
6
-----------------------------------------------------------------------
 
7
 
 
8
/* ========================================================================
 
9
 * Copyright 2007 University of Washington
 
10
 *
 
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
 
14
 *
 
15
 *     http://www.apache.org/licenses/LICENSE-2.0
 
16
 *
 
17
 * ========================================================================
 
18
*/
 
19
 
 
20
For the latest info about Alpine, see http://www.washington.edu/alpine
 
21
 
 
22
-----------------------------------------------------------------------
 
23
DISTRIBUTION CONTENTS
 
24
-----------------------------------------------------------------------
 
25
 
 
26
This Alpine distribution includes:
 
27
 
 
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
 
39
 
 
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.
 
45
 
 
46
 
 
47
-----------------------------------------------------------------------
 
48
PRELIMINARIES
 
49
-----------------------------------------------------------------------
 
50
 
 
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:
 
54
 
 
55
        tar zxf alpine.tar.z
 
56
 
 
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
 
59
above.
 
60
 
 
61
 
 
62
-----------------------------------------------------------------------
 
63
BUILD PROCESS
 
64
-----------------------------------------------------------------------
 
65
 
 
66
Alpine build process uses GNU autoconf.  It should be sufficient to build
 
67
alpine by typing the commands:
 
68
 
 
69
        ./configure
 
70
        make
 
71
 
 
72
For a list of configuration options and default settings type:
 
73
 
 
74
       ./configure --help   
 
75
 
 
76
 
 
77
-----------------------------------------------------------------------
 
78
RESULTING EXECUTABLES
 
79
-----------------------------------------------------------------------
 
80
 
 
81
The executables produced are:
 
82
 
 
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.
 
88
 
 
89
 pico   The standalone editor similar to the Alpine message composer.
 
90
        This is a very simple straight forward text editor.
 
91
 
 
92
 pilot  The standalone file system navigator.
 
93
 
 
94
 alpined
 
95
        The Web Alpine serveret which manages the 
 
96
 
 
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.
 
101
 
 
102
 mtest  The test IMAP client, an absolutely minimal mail client, useful
 
103
        for debugging.
 
104
 
 
105
 rpload Utility for uploading a local pinerc or address book to an IMAP
 
106
        server.
 
107
 
 
108
 rpdump Utility for downloading a pinerc or address book to the
 
109
        local machine.
 
110
 
 
111
 mailutil 
 
112
        Utility for performing various operations on mailboxes,
 
113
        be they local or remote.
 
114
 
 
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
 
119
done by hand.
 
120
 
 
121
  
 
122
-----------------------------------------------------------------------
 
123
END OF alpine.tar.z README
 
124
-----------------------------------------------------------------------