alpine-doc.patch

   1 --- ./doc/tech-notes.txt.org    2007-12-21 10:47:34.000000000 +0100
   2 +++ ./doc/tech-notes.txt        2007-12-21 10:59:49.000000000 +0100
   3 @@ -275,14 +275,14 @@
   4     The selection of which MTA to use depends on the settings of
   5     smtp-server, sendmail-path, and compile-time options. The first MTA
   6     specified in the 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
  19      9. DF_SENDMAIL_PATH defined at compile time.
  20     10. SENDMAIL and SENDMAILFLAGS defined at compile time.
  21
  22 @@ -605,26 +605,26 @@
  23
  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
  26 -   directory on your system. Most often the binaries go in /usr/local/bin
  27 -   though sometimes they are placed in /usr/bin. All the help text is
  28 +   directory on your system. Most often the binaries go in /usr/bin
  29 +   though sometimes they are placed in /usr/local/bin. All the help text is
  30     compiled into Alpine so there are no required auxiliary files. Instead
  31     of copying the binaries manually, you may use make install to install
  32     them.
  33
  34 -   There are three optional auxiliary files: /usr/local/lib/pine.info,
  35 -   /usr/local/lib/pine.conf, and /usr/local/lib/pine.conf.fixed. The file
  36 +   There are three optional auxiliary files: /usr/lib/pine.info,
  37 +   /etc/alpine/alpine.conf, and /etc/alpine/alpine.conf.fixed. The file
  38     pine.info contains text on how to get further help on the local system.
  39     It is part of the help text for the main menu and should probably refer
  40     to the local help desk or the system administrator. If this file
  41     doesn't exist a generic version which suggests ``talking to the
  42 -   computer support staff at your site'' is shown. The file pine.conf is
  43 +   computer support staff at your site'' is shown. The file alpine.conf is
  44     used to set system-wide default configurations for Alpine. The file
  45 -   pine.conf.fixed is also used to set system-wide default configurations
  46 +   alpine.conf.fixed is also used to set system-wide default configurations
  47     for Alpine. The difference between these two files is that
  48 -   configuration variables set in the pine.conf.fixed file may not
  49 +   configuration variables set in the alpine.conf.fixed file may not
  50     normally be over-ridden by a user. See the section on Alpine
  51 -   Configuration later in this document for details about the pine.conf
  52 -   and pine.conf.fixed files.
  53 +   Configuration later in this document for details about the alpine.conf
  54 +   and alpine.conf.fixed files.
  55       __________________________________________________________________
  56
  57  Installing PC-Alpine
  58 @@ -688,11 +688,11 @@
  59     This section lists the various files which Alpine uses which are not
  60     email folders. All of these are the default names of files, they may
  61     vary based on Alpine's configuration.
  62 -   /usr/local/lib/pine.conf
  63 +   /etc/alpine/alpine.conf
  64            Pine's global configuration file.
  65 -   /usr/local/lib/pine.conf.fixed
  66 +   /etc/alpine/alpine.conf.fixed
  67            Non-overridable global configuration file.
  68 -   /usr/local/lib/pine.info
  69 +   /usr/lib/pine.info
  70            Local pointer to system administrator.
  71     ~/.pinerc
  72            Personal configuration file for each user.
  73 @@ -889,11 +889,11 @@
  74            Configuration: Prints a sample system configuration file to the
  75            screen or standard output. To generate an initial system
  76            configuration file, execute
  77 -                alpine -conf > /usr/local/lib/pine.conf
  78 +                alpine -conf > /etc/alpine/alpine.conf
  79
  80            To generate a system configuration file using settings from an
  81            old system configuration file, execute
  82 -                alpine -P old-pine.conf -conf > /usr/local/lib/pine.conf
  83 +                alpine -P old-pine.conf -conf > /etc/alpine/alpine.conf
  84
  85            A system configuration file is not required.
  86     -convert_sigs -p pinerc
  87 @@ -998,7 +998,7 @@
  88            configuration folder.
  89     -P pinerc
  90            Uses the named file as the system wide configuration file
  91 -          instead of /usr/local/lib/pine.conf on UNIX, or nothing on
  92 +          instead of /etc/alpine/alpine.conf on UNIX, or nothing on
  93            PC-Alpine. Pinerc may be either a local file or a remote
  94            configuration folder.
  95     -passfile passfile
  96 @@ -1207,10 +1207,10 @@
  97     configuration. In most cases, the compiled-in preferences will suit
  98     users and administrators just fine. When running Alpine on a UNIX
  99     system, the default built-in configuration can be changed by setting
 100 -   variables in the system configuration files, /usr/local/lib/pine.conf
 101 -   or /usr/local/lib/pine.conf.fixed. (Actually, these files can be
 102 +   variables in the system configuration files, /etc/alpine/alpine.conf
 103 +   or /etc/alpine/alpine.conf.fixed. (Actually, these files can be
 104     changed using the configure arguments --with-system-pinerc=VALUE or
 105 -   --with-system-fixed-pinerc=VALUE.) The location of the pine.conf file
 106 +   --with-system-fixed-pinerc=VALUE.) The location of the alpine.conf file
 107     can be changed with the -P command line argument. Both Alpine and
 108     PC-Alpine also use personal (user-based) configuration files. On UNIX
 109     machines, the personal configuration file is the file ~/.pinerc. For
 110 @@ -1220,7 +1220,7 @@
 111     the -p command line argument.
 112
 113     All of these configuration files, other than the fixed system config
 114 -   pine.conf.fixed on UNIX systems, may optionally be remote configuration
 115 +   alpine.conf.fixed on UNIX systems, may optionally be remote configuration
 116     files instead of local files. This is discussed further in the
 117     following section and in Remote Configuration.
 118
 119 @@ -3679,7 +3679,7 @@
 120            spell checker. If your Unix system has ispell it is probably
 121            reasonable to make it the default speller by configuring it as
 122            the default in the system configuration file,
 123 -          /usr/local/lib/pine.conf.
 124 +          /etc/alpine/alpine.conf.
 125            If this option is not set, then the system's spell command is
 126            used. The spell command does not work the same as the alternate
 127            speller. It produces a list of misspelled words on its standard
 128 @@ -4076,11 +4076,11 @@
 129            Now for an example:
 130
 131       url-viewers=_TEST("test -n '${DISPLAY}'")_ /usr/local/bin/netscape,
 132 -     /usr/local/bin/lynx, C:\BIN\NETSCAPE.BAT
 133 +     /usr/bin/lynx, C:\BIN\NETSCAPE.BAT
 134            This example shows that for the first browser in the list to be
 135            used the environment variable DISPLAY must be defined. If it is,
 136            then the file /usr/local/bin/netscape must exist. If either
 137 -          condition is not met, then the file /usr/local/bin/lynx must
 138 +          condition is not met, then the file /usr/bin/lynx must
 139            exist. If it doesn't, then the final path and file must exist.
 140            Note that the last entry is a DOS/Windows path. This is one way
 141            to support Alpine running on more than one architecture with the
 142 @@ -10707,9 +10707,9 @@
 143      5. the system-wide fixed configuration file (Unix Alpine only)
 144
 145     The fixed configuration file is normally
 146 -   /usr/local/lib/pine.conf.fixed.
 147 +   /etc/alpine/alpine.conf.fixed.
 148
 149 -   The system-wide configuration file is normally /usr/local/lib/pine.conf
 150 +   The system-wide configuration file is normally /etc/alpine/alpine.conf
 151     for Unix Alpine and is normally not set for PC-Alpine. For PC-Alpine,
 152     if the environment variable $PINECONF is set, that is used for the
 153     system-wide configuration. This location can be set or changed on the
 154 @@ -10969,8 +10969,8 @@
 155       * A program that implements the SMTP or ESMTP protocol via stdio.
 156       * An entry in /etc/services for the alternate service.
 157       * An entry in /etc/inetd.conf for the alternate service.
 158 -     * An entry in /usr/local/lib/pine.conf,
 159 -       /usr/local/lib/pine.conf.fixed or ~/.pinerc.
 160 +     * An entry in /etc/alpine/alpine.conf,
 161 +       /etc/alpine/alpine.conf.fixed or ~/.pinerc.
 162       __________________________________________________________________
 163
 164  MIME.Types file
 165 @@ -10978,7 +10978,7 @@
 166     Alpine's MIME-TYPE support is based on code contributed by Hans Drexler
 167     &LT;drexler@mpi.nl&GT;. Alpine assigns MIME Content-Types according to
 168     file name extensions found in the system-wide files
 169 -   /usr/local/lib/mime.types and /etc/mime.types, and a user specific
 170 +   /etc/mime.types and /usr/lib/mime.types, and a user specific
 171     ~/.mime.types file.
 172
 173     In Windows, Alpine looks in the same directory as the PINERC file and
 174 @@ -11834,7 +11834,7 @@
 175
 176     The second selection is the standard UNIX print command. The default is
 177     lpr, but it can be changed on a system basis to anything so desired in
 178 -   /usr/local/lib/pine.conf.
 179 +   /etc/alpine/alpine.conf.
 180
 181     The third selection is the user's personal choice for a UNIX print
 182     command. The text to be printed is piped into the command. Enscript or
 183 --- ./doc/alpine.1.org  2007-12-21 10:43:27.000000000 +0100
 184 +++ ./doc/alpine.1      2007-12-21 10:47:01.000000000 +0100
 185 @@ -255,7 +255,7 @@
 186   o built-in defaults.
 187  .br
 188   o system-wide
 189 -.I pine.conf
 190 +.I alpine.conf
 191  file.
 192  .br
 193   o personal
 194 @@ -265,7 +265,7 @@
 195   o command-line options.
 196  .br
 197   o system-wide
 198 -.I pine.conf.fixed
 199 +.I aline.conf.fixed
 200  file.
 201
 202  There is one exception to the rule that configuration values are replaced
 203 @@ -285,7 +285,7 @@
 204  .if n .ta 2.8i
 205  .if t .ta 2.1i
 206
 207 -/usr/spool/mail/xxxx   Default folder for incoming mail.
 208 +/var/mail/xxxx Default folder for incoming mail.
 209  .br
 210  ~/mail Default directory for mail folders.
 211  .br
 212 @@ -305,13 +305,13 @@
 213  .br
 214  /etc/mime.types        System-wide file ext. to MIME type mapping
 215  .br
 216 -/usr/local/lib/pine.info       Local pointer to system administrator.
 217 +/usr/lib/pine.info     Local pointer to system administrator.
 218  .br
 219 -/usr/local/lib/pine.conf       System-wide configuration file.
 220 +/etc/alpine/alpine.conf        System-wide configuration file.
 221  .br
 222 -/usr/local/lib/pine.conf.fixed  Non-overridable configuration file.
 223 +/etc/alpine/alpine.conf.fixed   Non-overridable configuration file.
 224  .br
 225 -/tmp/.\\usr\\spool\\mail\\xxxx Per-folder mailbox lock files.
 226 +/tmp/.\\var\\mail\\xxxx        Per-folder mailbox lock files.
 227  .br
 228  ~/.pine-interrupted-mail       Message which was interrupted.
 229  .br