]>
Commit | Line | Data |
---|---|---|
67522789 PG |
1 | --- ./doc/tech-notes.txt.org 2008-03-25 21:28:28.958953593 +0100 |
2 | +++ ./doc/tech-notes.txt 2008-03-25 21:36:04.727408589 +0100 | |
3 | @@ -271,14 +271,14 @@ SMTP and Sendmail | |
4 | The selection of which MTA to use depends on the settings of smtp-server, | |
5 | sendmail-path, and compile-time options. The first MTA specified in the | |
6 | following list is used: | |
7 | - 1. _sendmail-path_ in /usr/local/lib/pine.conf.fixed | |
8 | - 2. _smtp-server_ in /usr/local/pine.conf.fixed | |
9 | + 1. _sendmail-path_ in /etc/alpine/alpine.conf.fixed | |
10 | + 2. _smtp-server_ in /etc/alpine/alpine.conf.fixed | |
11 | 3. _sendmail-path_ specified on the command line. | |
12 | 4. _smtp-server_ specified on the command line. | |
13 | 5. _sendmail-path_ in the user's .pinerc file. | |
14 | 6. _smtp-server_ in the user's .pinerc file. | |
15 | - 7. _sendmail-path_ in /usr/local/lib/pine.conf | |
16 | - 8. _smtp-server_ in /usr/local/pine.conf | |
17 | + 7. _sendmail-path_ in /etc/alpine/alpine.conf | |
18 | + 8. _smtp-server_ in /etc/alpine/alpine.conf | |
f9dda27f JR |
19 | 9. DF_SENDMAIL_PATH defined at compile time. |
20 | 10. SENDMAIL and SENDMAILFLAGS defined at compile time. | |
21 | ||
67522789 | 22 | @@ -595,24 +595,24 @@ Installing Alpine and Pico on UNIX Platf |
f9dda27f | 23 | |
67522789 PG |
24 | Installing _Alpine_ and _Pico_ is simple. You take the program files which |
25 | you have just transferred or built and you move them to the correct | |
f9dda27f | 26 | - directory on your system. Most often the binaries go in /usr/local/bin |
67522789 | 27 | - though sometimes they are placed in /usr/bin. All the help text is compiled |
f9dda27f | 28 | + directory on your system. Most often the binaries go in /usr/bin |
67522789 PG |
29 | + though sometimes they are placed in /usr/local/bin. All the help text is compiled |
30 | into _Alpine_ so there are no _required_ auxiliary files. Instead of copying | |
31 | the binaries manually, you may use make install to install them. | |
f9dda27f | 32 | |
67522789 | 33 | - There are three optional auxiliary files: /usr/local/lib/pine.info, |
f9dda27f | 34 | - /usr/local/lib/pine.conf, and /usr/local/lib/pine.conf.fixed. The file |
67522789 | 35 | + There are three optional auxiliary files: /usr/lib/pine.info, |
cd68a07f | 36 | + /etc/alpine/alpine.conf, and /etc/alpine/alpine.conf.fixed. The file |
67522789 PG |
37 | pine.info contains text on how to get further help on the local system. It |
38 | is part of the help text for the main menu and should probably refer to the | |
39 | local help desk or the system administrator. If this file doesn't exist a | |
40 | generic version which suggests ``talking to the computer support staff at | |
41 | - your site'' is shown. The file pine.conf is used to set system-wide default | |
42 | - configurations for _Alpine_. The file pine.conf.fixed is also used to set | |
43 | + your site'' is shown. The file alpine.conf is used to set system-wide default | |
44 | + configurations for _Alpine_. The file alpine.conf.fixed is also used to set | |
45 | system-wide default configurations for _Alpine_. The difference between | |
46 | - these two files is that configuration variables set in the pine.conf.fixed | |
47 | + these two files is that configuration variables set in the alpine.conf.fixed | |
48 | file may not normally be over-ridden by a user. See the section on Alpine | |
49 | - Configuration later in this document for details about the pine.conf and | |
50 | - pine.conf.fixed files. | |
51 | + Configuration later in this document for details about the alpine.conf and | |
52 | + alpine.conf.fixed files. | |
53 | _________________________________________________________________ | |
cd68a07f PG |
54 | |
55 | Installing PC-Alpine | |
67522789 PG |
56 | @@ -674,11 +674,11 @@ Support Files and Environment Variables: |
57 | This section lists the various files which _Alpine_ uses which are not email | |
58 | folders. All of these are the default names of files, they may vary based on | |
59 | _Alpine_'s configuration. | |
f9dda27f | 60 | - /usr/local/lib/pine.conf |
cd68a07f | 61 | + /etc/alpine/alpine.conf |
f9dda27f JR |
62 | Pine's global configuration file. |
63 | - /usr/local/lib/pine.conf.fixed | |
cd68a07f | 64 | + /etc/alpine/alpine.conf.fixed |
f9dda27f JR |
65 | Non-overridable global configuration file. |
66 | - /usr/local/lib/pine.info | |
67 | + /usr/lib/pine.info | |
68 | Local pointer to system administrator. | |
69 | ~/.pinerc | |
70 | Personal configuration file for each user. | |
67522789 | 71 | @@ -872,10 +872,10 @@ Alpine |
f9dda27f | 72 | Configuration: Prints a sample system configuration file to the |
67522789 | 73 | screen or standard output. To generate an initial system |
f9dda27f JR |
74 | configuration file, execute |
75 | - alpine -conf > /usr/local/lib/pine.conf | |
cd68a07f | 76 | + alpine -conf > /etc/alpine/alpine.conf |
67522789 PG |
77 | To generate a system configuration file using settings from an old |
78 | system configuration file, execute | |
f9dda27f | 79 | - alpine -P old-pine.conf -conf > /usr/local/lib/pine.conf |
cd68a07f | 80 | + alpine -P old-pine.conf -conf > /etc/alpine/alpine.conf |
f9dda27f | 81 | A system configuration file is not required. |
67522789 PG |
82 | -convert_sigs _-p pinerc_ |
83 | Convert signatures contained in signature files into literal | |
84 | @@ -973,7 +973,7 @@ Alpine | |
85 | Pinerc may be either a local file or a remote configuration folder. | |
86 | -P _pinerc_ | |
87 | Uses the named file as the system wide configuration file instead of | |
88 | - _/usr/local/lib/pine.conf_ on UNIX, or nothing on _PC-Alpine_. Pinerc | |
89 | + _/etc/alpine/alpine.conf_ on UNIX, or nothing on _PC-Alpine_. Pinerc | |
90 | may be either a local file or a remote configuration folder. | |
91 | -passfile _passfile_ | |
92 | This tells _Alpine_ what file should be used as the password file. | |
93 | @@ -1180,10 +1180,10 @@ Alpine Configuration | |
94 | configuration. In most cases, the compiled-in preferences will suit users | |
95 | and administrators just fine. When running _Alpine_ on a UNIX system, the | |
96 | default built-in configuration can be changed by setting variables in the | |
97 | - system configuration files, /usr/local/lib/pine.conf or | |
98 | - /usr/local/lib/pine.conf.fixed. (Actually, these files can be changed using | |
99 | + system configuration files, /etc/alpine/alpine.conf or | |
100 | + /etc/alpine/alpine.conf.fixed. (Actually, these files can be changed using | |
101 | the configure arguments --with-system-pinerc=VALUE or | |
102 | - --with-system-fixed-pinerc=VALUE.) The location of the pine.conf file can be | |
103 | + --with-system-fixed-pinerc=VALUE.) The location of the alpine.conf file can be | |
104 | changed with the -P command line argument. Both _Alpine_ and _PC-Alpine_ | |
105 | also use personal (user-based) configuration files. On UNIX machines, the | |
106 | personal configuration file is the file ~/.pinerc. For _PC-Alpine_ systems, | |
107 | @@ -1192,7 +1192,7 @@ Alpine Configuration | |
108 | configuration file can be specified with the -p command line argument. | |
109 | ||
110 | All of these configuration files, other than the fixed system config | |
cd68a07f PG |
111 | - pine.conf.fixed on UNIX systems, may optionally be remote configuration |
112 | + alpine.conf.fixed on UNIX systems, may optionally be remote configuration | |
67522789 PG |
113 | files instead of local files. This is discussed further in the following |
114 | section and in Remote Configuration. | |
115 | ||
116 | @@ -3538,7 +3538,7 @@ index-format=STATUS MSGNO SMARTDATETIME2 | |
117 | For Unix _Alpine_ the program _ispell_ works well as an alternate | |
118 | spell checker. If your Unix system has _ispell_ it is probably | |
119 | reasonable to make it the default speller by configuring it as the | |
120 | - default in the system configuration file, /usr/local/lib/pine.conf. | |
121 | + default in the system configuration file, /etc/alpine/alpine.conf. | |
122 | If this option is not set, then the system's _spell_ command is used. | |
123 | The spell command does not work the same as the alternate speller. It | |
124 | produces a list of misspelled words on its standard output, instead, | |
125 | @@ -3932,15 +3932,15 @@ index-format=STATUS MSGNO SMARTDATETIME2 | |
126 | must exist as a full path or a path relative to your home directory). | |
f9dda27f JR |
127 | Now for an example: |
128 | ||
67522789 | 129 | - url-viewers=_TEST("test -n '${DISPLAY}'")_ /usr/local/bin/netscape, |
f9dda27f | 130 | - /usr/local/bin/lynx, C:\BIN\NETSCAPE.BAT |
67522789 | 131 | + url-viewers=_TEST("test -n '${DISPLAY}'")_ /usr/bin/netscape, |
f9dda27f | 132 | + /usr/bin/lynx, C:\BIN\NETSCAPE.BAT |
67522789 PG |
133 | This example shows that for the first browser in the list to be used |
134 | the environment variable DISPLAY must be defined. If it is, then the | |
135 | - file /usr/local/bin/netscape must exist. If either condition is not | |
136 | - met, then the file /usr/local/bin/lynx must exist. If it doesn't, | |
137 | - then the final path and file must exist. Note that the last entry is | |
138 | - a DOS/Windows path. This is one way to support _Alpine_ running on | |
139 | - more than one architecture with the same configuration file. | |
140 | + file /usr/bin/netscape must exist. If either condition is not met, | |
141 | + then the file /usr/bin/lynx must exist. If it doesn't, then the final | |
142 | + path and file must exist. Note that the last entry is a DOS/Windows | |
143 | + path. This is one way to support _Alpine_ running on more than one | |
144 | + architecture with the same configuration file. | |
145 | _use-only-domain-name_ | |
146 | Can be set to _yes_ or _no._ Anything but _yes_ means _no._ If set to | |
147 | _yes_ the first label in the host name will be lopped off to get the | |
148 | @@ -10273,9 +10273,9 @@ Configuration Inheritance | |
149 | 4. a command line argument | |
150 | 5. the system-wide _fixed_ configuration file (Unix _Alpine_ only) | |
151 | ||
152 | - The fixed configuration file is normally /usr/local/lib/pine.conf.fixed. | |
153 | + The fixed configuration file is normally /etc/alpine/alpine.conf.fixed. | |
154 | ||
155 | - The system-wide configuration file is normally /usr/local/lib/pine.conf for | |
156 | + The system-wide configuration file is normally /etc/alpine/alpine.conf for | |
157 | Unix _Alpine_ and is normally not set for _PC-Alpine_. For _PC-Alpine_, if | |
158 | the environment variable _$PINECONF_ is set, that is used for the | |
159 | system-wide configuration. This location can be set or changed on the | |
160 | @@ -10524,7 +10524,7 @@ SMTP Servers | |
f9dda27f JR |
161 | * A program that implements the SMTP or ESMTP protocol via stdio. |
162 | * An entry in /etc/services for the alternate service. | |
163 | * An entry in /etc/inetd.conf for the alternate service. | |
67522789 PG |
164 | - * An entry in /usr/local/lib/pine.conf, /usr/local/lib/pine.conf.fixed or |
165 | + * An entry in /etc/alpine/alpine.conf, /etc/alpine/alpine.conf.fixed or | |
166 | ~/.pinerc. | |
167 | _________________________________________________________________ | |
168 | ||
169 | @@ -10533,7 +10533,7 @@ MIME.Types file | |
170 | _Alpine_'s MIME-TYPE support is based on code contributed by Hans Drexler | |
171 | <drexler@mpi.nl>. _Alpine_ assigns MIME Content-Types according to | |
172 | file name extensions found in the system-wide files | |
173 | - /usr/local/lib/mime.types and /etc/mime.types, and a user specific | |
174 | + /usr/lib/mime.types and /etc/mime.types, and a user specific | |
f9dda27f JR |
175 | ~/.mime.types file. |
176 | ||
67522789 PG |
177 | In Windows, _Alpine_ looks in the same directory as the PINERC file and the |
178 | @@ -11366,7 +11366,7 @@ Printers and Printing | |
f9dda27f JR |
179 | |
180 | The second selection is the standard UNIX print command. The default is | |
67522789 | 181 | _lpr_, but it can be changed on a system basis to anything so desired in |
f9dda27f | 182 | - /usr/local/lib/pine.conf. |
cd68a07f | 183 | + /etc/alpine/alpine.conf. |
f9dda27f | 184 | |
67522789 PG |
185 | The third selection is the user's personal choice for a UNIX print command. |
186 | The text to be printed is piped into the command. _Enscript_ or _lpr_ with | |
187 | --- ./doc/alpine.1.org 2008-03-15 00:53:39.000000000 +0100 | |
188 | +++ ./doc/alpine.1 2008-03-25 21:39:17.983313992 +0100 | |
189 | @@ -113,7 +113,7 @@ argument is applied to the first defined | |
190 | .IP \fB-conf\fR 20 | |
191 | Produce a sample/fresh copy of the | |
192 | system-wide configuration file, | |
193 | -.I pine.conf, | |
194 | +.I alpine.conf, | |
195 | on the standard output. This is distinct from the per-user | |
196 | .I .pinerc | |
197 | file. | |
198 | @@ -176,7 +176,7 @@ Use | |
199 | .I config-file | |
200 | as the configuration file instead of default | |
201 | system-wide configuration file | |
202 | -.IR pine.conf . | |
203 | +.IR alpine.conf . | |
204 | .IP \fB-pinerc\ \fIfile\fR 20 | |
205 | Output fresh pinerc configuration to | |
206 | .I file, preserving the settings of variables that the user has made. | |
207 | @@ -255,7 +255,7 @@ increasing precedence: | |
cd68a07f PG |
208 | o built-in defaults. |
209 | .br | |
210 | o system-wide | |
211 | -.I pine.conf | |
212 | +.I alpine.conf | |
213 | file. | |
214 | .br | |
215 | o personal | |
67522789 | 216 | @@ -265,7 +265,7 @@ file (may be set via built-in Setup/Conf |
cd68a07f PG |
217 | o command-line options. |
218 | .br | |
219 | o system-wide | |
220 | -.I pine.conf.fixed | |
67522789 | 221 | +.I alpine.conf.fixed |
cd68a07f PG |
222 | file. |
223 | ||
224 | There is one exception to the rule that configuration values are replaced | |
67522789 | 225 | @@ -285,7 +285,7 @@ uses the following environment variables |
cd68a07f PG |
226 | .if n .ta 2.8i |
227 | .if t .ta 2.1i | |
228 | ||
229 | -/usr/spool/mail/xxxx Default folder for incoming mail. | |
230 | +/var/mail/xxxx Default folder for incoming mail. | |
231 | .br | |
232 | ~/mail Default directory for mail folders. | |
233 | .br | |
67522789 | 234 | @@ -305,13 +305,13 @@ uses the following environment variables |
cd68a07f PG |
235 | .br |
236 | /etc/mime.types System-wide file ext. to MIME type mapping | |
237 | .br | |
238 | -/usr/local/lib/pine.info Local pointer to system administrator. | |
239 | +/usr/lib/pine.info Local pointer to system administrator. | |
240 | .br | |
241 | -/usr/local/lib/pine.conf System-wide configuration file. | |
67522789 | 242 | +/usr/lib/alpine.conf System-wide configuration file. |
cd68a07f PG |
243 | .br |
244 | -/usr/local/lib/pine.conf.fixed Non-overridable configuration file. | |
67522789 | 245 | +/usr/lib/alpine.conf.fixed Non-overridable configuration file. |
cd68a07f PG |
246 | .br |
247 | -/tmp/.\\usr\\spool\\mail\\xxxx Per-folder mailbox lock files. | |
248 | +/tmp/.\\var\\mail\\xxxx Per-folder mailbox lock files. | |
249 | .br | |
250 | ~/.pine-interrupted-mail Message which was interrupted. | |
251 | .br |