home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / ELM23-2 / ELM23-2.ZIP / doc / Config.guide (.txt) < prev    next >
Amigaguide Document  |  1990-04-28  |  12KB  |  272 lines
  1. .\" @(#)$Id: Config.guid,v 4.1 90/04/28 22:41:00 syd Exp $
  2. .\"  A guide to the ELM alias system and so on.
  3. .\"  format with:
  4. .\"      'troff tmac.n Config.guid > Config.fmtd'
  5. .\"  (C) Copyright 1986, 1987 Dave Taylor
  6. .\"  (C) Copyright 1988, 1989, 1990 Usenet Community Trust
  7. .\"  Elm is now in the public trust. Bug reports, comments, suggestions, flames
  8. .\"  etc. should go to:
  9. .\"    Syd Weinstein        elm@DSI.COM (dsinc!elm)
  10. .\"  $Log:    Config.guid,v $
  11. .\" Revision 4.1  90/04/28  22:41:00  syd
  12. .\" checkin of Elm 2.3 as of Release PL0
  13. .tm Have we been run through "tbl" first?? I hope so!
  14. .po 1i
  15. .ds h0
  16. .ds h1
  17. .ds h2
  18. .ds f0
  19. .ds f1
  20. .ds f2
  21. .nr Hy 1
  22. .nr Pt 1
  23. .nr Pi 0
  24. .lg 0
  25. .sp |3.0i
  26. .ce 99
  27. .ps 20
  28. \f3Elm Configuration Guide\f1
  29. .sp 4
  30. .ps 12
  31. .ss 14
  32. .vs 14
  33. \f2How to install and customize the Elm mail system\f1
  34. .sp 2
  35. Dave Taylor
  36. Hewlett-Packard Laboratories
  37. 1501 Page Mill Road
  38. Palo Alto CA
  39. 94304
  40. .sp 3
  41. email: taylor\s-1@\s+1hplabs.HP.COM  or  hplabs\s-1!\s+1taylor
  42. .sp 3
  43. >>> Elm is now in the public trust. Bug reports, comments, etc. to: <<<
  44. Syd Weinstein
  45. Datacomp Systems, Inc.
  46. 3837 Byron Road
  47. Huntingdon Valley, PA 19006-2320
  48. email: elm\s-1@\s+1DSI.COM  or  dsinc\s-1!\s+1elm
  49. .sp 3
  50. .ps 18
  51. \f3\(co\f1\s12 Copyright 1986,1987 by Dave Taylor
  52. .ps 18
  53. \f3\(co\f1\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
  54. .ps 10
  55. .ss 12
  56. .vs 12
  57. .bp 1
  58. .sv 5v
  59. .ps 14
  60. \f3Elm Configuration Guide\f1
  61. .ds h0 "Elm Configuration Guide
  62. .ds h1
  63. .ds h2 "Version 2.3
  64. .ds f0 "May 1, 1990
  65. .ds f1 "Page %
  66. .ps 10
  67. (Version 2.3)
  68. .sp 2
  69. Dave Taylor
  70. Hewlett-Packard Laboratories
  71. 1501 Page Mill Road
  72. Palo Alto CA
  73. 94304
  74. email: taylor\s-1@\s+1hplabs.HP.COM  or  hplabs\s-1!\s+1taylor
  75. .sp 2
  76. >>> Elm is now in the public trust. Bug reports, comments, etc. to: <<<
  77. Syd Weinstein
  78. Datacomp Systems, Inc.
  79. 3837 Byron Road
  80. Huntingdon Valley, PA 19006-2320
  81. email: elm\s-1@\s+1DSI.COM  or  dsinc\s-1!\s+1elm
  82. .sp 2
  83. May 1, 1990
  84. .ce 0
  85. .sp 3
  86. This document is intended as a supplement to the \f2Elm Users Guide\f1
  87. and \f2Elm Reference Guide\f1
  88. and should be of interest mainly to people at a site either installing
  89. or maintaining the source code to the \f3Elm\f1 mail system, or
  90. modifying the code.
  91. It is \f2required\f1 that installation be done by using the
  92. \f2Configure\f1 script supplied with the system.  Please see the
  93. file \f2Instruct\f1 for further information on running \f2Configure\f1.
  94. The remainder of this document will discuss the various questions
  95. asked by the \f2Configure\f1 script and the
  96. options available via direct editing of various files and
  97. parameters.  As indicated above, almost all of the sites that install
  98. \f3Elm\f1 should find the \f2Configure\f1 script more than
  99. sufficient.
  100. .hu Using Configure
  101. \f2Configure\fP is a shell script that will automatically determine the
  102. type of system it is running on and tune the parameters of Elm to fit
  103. that system and its environment.  Where the installer has a choice, it
  104. asks questions of the installer.  \f2Configure\fP provides its own
  105. instructions when run, so they are not repeated here.  However, when
  106. the installer is presented with a choice, this next section explains
  107. some of the options available.  Not all the questions or options to
  108. those questions are explained.
  109. .sp 2
  110. Enable calendar feature?
  111. Elm has a feature to take specially marked lines within mail messages
  112. and add them to a file for use by the system calendar program.  The
  113. command to do this extraction needs to be enabled to work.  There is
  114. also a follow on question regarding the name of the calendar file:
  115. Default calendar file?
  116. which is usually calendar on most systems.  This file will reside in the
  117. users home directory, not their .elm directory.
  118. Does your /etc/passwd file keep full names in Berkeley/V7 format (name
  119. first thing after ':' in GCOS field)?
  120. Elm uses the full name from the password file if it is available.
  121. There are two major ways this name is stored.  Berkeley/V7 systems
  122. place the name as the entire GCOS field string, that is it starts
  123. directly after the ':' that delimits the fields.  USG
  124. .ux " Systems" (
  125. Group, or AT&T) systems put the users name after a department number
  126. and separate it from that number by a '-'.  The end of the users full
  127. name in these systems is a '('.  Look at your /etc/password file and if
  128. either version applies, answer yes to that version.  If neither
  129. applies, answer no.  Elm can still get the users name from the
  130. ".fullname" file in their home directory.
  131. Every now and then someone has a (gethostname, uname) that lies about
  132. the hostname but can't be fixed for political or economic reasons.
  133. Would you like to pretend (gethostname, uname) isn't there and maybe
  134. compile in the hostname?
  135. Elm needs to know the correct name of the host on which it is executing
  136. to be able to create the proper headers for the outbound mail.  Some systems
  137. use one name for uucp and another name for the system and others just don't
  138. reply to the subroutines with the proper name.  In this case it will be
  139. necessary to compile in the name.  In all other cases this should not
  140. be needed.  It is provided just in case there is a problem with your
  141. system.
  142. Does your mailer understand INTERNET addresses?
  143. Elm will work with systems that can process the `@' character of INTERNET
  144. format addresses or with the `!' format of uucp addresses.  If your
  145. mail delivery agent understands the `@' format addresses, they should be
  146. used and this question is answered yes.  If when you send mail with the
  147. `@' format addresses (such as elm@dsi.com), they bounce, then answer this
  148. question no.
  149. Am I going to be running as a setgid program?
  150. On USG type systems and many other types,
  151. access to the mailboxes and the mailbox directory
  152. is via the group permissions.  The mail user agents, such as Elm, need
  153. write access into this directory to be able to move the mailbox around
  154. due to internal editing and to create lock files.  If the permissions
  155. on your mailbox directory are drwxrwxr-x, then Elm needs to be a setgid
  156. program.
  157. What is the default editor on your system?
  158. If no editor is specified in the users \f2.elm/elmrc file,\f1 this is which
  159. editor to use.  The editor is used to compose outbound mail messages.
  160. What pager do you prefer to use with Elm?
  161. This is the standard pager to use for reading messages.
  162. Besides the usual system pagers, two Elm specific internal options
  163. exist: builtin and builtin+.  The built-in pager is faster to execute
  164. but much less flexible than the system provided pagers.  The + version
  165. just clears the page before displaying the next page.  Otherwise the
  166. two versions are identical.
  167. .hu Other Configurable Parameters
  168. The following parameters rarely need to be changed, but are provided if
  169. you need them.  \f2Configure\fP does not prompt for their values.  To
  170. change them, edit the \f2hdrs/sysdefs.h\f1 file directly after running
  171. Configure.
  172. .lp FIND_DELTA 1.0i
  173. This is the delta that the binary search of the pathalias database
  174. will use to determine when it's slicing up a single line, rather than
  175. a multitude of lines.   Ideally, this should be set to 1 byte less
  176. than the shortest line in the file...the default is 10 bytes.
  177. .lp MAX_IN_WEEDLIST 1.0i
  178. The maximum number of headers that can be specified in the weedout
  179. list of the \f2.elm/elmrc\f1 file.  A suggested alternative approach if this
  180. number is too small is to specify initial substrings in the file
  181. rather than increasing the number.  For example, say you want to
  182. weedout the headers ``Latitude:'' and ``Latitudinal-Coords:'', you
  183. could simply specify ``Latitud''" and match them both!  Furthermore
  184. you could also specify headers like ``X-'' and remove all the user
  185. defined headers!
  186. .lp MAX_HOPS 1.0i
  187. When replying to a G)roup, this is the maximum number of hops that
  188. a message can have taken.  This is used to try to optimize the
  189. return address (remove cyclic loops and so on) and regular use
  190. should show that the default of 35 is plenty more than you'll
  191. ever need!
  192. .lp system_text_file 1.0i
  193. This is the source text file for the system level aliases.
  194. See either the \f2newalias(1L)\f1 man page, or \f2The Elm
  195. Alias System Users Guide\f1 for further details.
  196. .lp system_hash_file 1.0i
  197. This is the file that contains the hashed version of the system
  198. aliases.
  199. .lp system_data_file 1.0i
  200. This is the other file the \f2newalias\f1 command installs in the system
  201. alias area and contains the actual addresses for each of the aliases
  202. contained in the hashed data file.
  203. .lp ALIAS_TEXT 1.0i
  204. This is where the individual users alias text file lives.
  205. .lp ALIAS_HASH 1.0i
  206. Where the hashed aliases are stored,
  207. .lp ALIAS_DATA 1.0i
  208. and where the alias address data itself is kept.
  209. .lp DEBUGFILE 1.0i
  210. The name of the file to put in the users home directory if they choose to
  211. use the `-d' debug option.
  212. .lp OLDEBUG 1.0i
  213. The name of the file to save the previous debug output as.  (this feature
  214. was added to ensure that users wanting to mail bug reports wouldn't
  215. automatically overwrite the debug log of the session in question)
  216. .lp temp_lock_dir 1.0i
  217. Directory for lock files for XENIX.
  218. .lp temp_file 1.0i
  219. Temporary file for sending outbound messages.
  220. .lp temp_form_file 1.0i
  221. A place to store temporary forms (for Forms Mode) while answering them.
  222. .lp temp_mbox 1.0i
  223. Place to keep copy of incoming mailbox to avoid collisions with newer
  224. mail.
  225. .lp temp_print  1.0i
  226. File to use when creating a printout of a message.
  227. .lp temp_edit 1.0i
  228. File to use when editing the mailbox file on XENIX.
  229. .lp temp_uuname 1.0i
  230. Where to redirect output of the \f2uuname(1M)\f1 command.
  231. .lp mailtime_file 1.0i
  232. File to compare date to to determine if a given message is New
  233. since the last time the mail was read or not.
  234. .lp readmsg_file 1.0i
  235. File to use when communicating with the \f2readmsg\f1 program (see
  236. that program for more information)
  237. .lp smflags  1.0i
  238. Defines the flags to hand to \f2sendmail\f1 if and when the program
  239. chooses to use it.
  240. .lp smflagsv 1.0i
  241. Defines the flags to hand to \f2sendmail\f1 in verbose voyuer mode.
  242. .lp mailer 1.0i
  243. If you don't have \f2sendmail\f1, this is the mailer that'll be used.
  244. .lp helpfile 1.0i
  245. The help file name prefix.
  246. .lp ELMRC_INFO 1.0i
  247. The file containing textual messages associated with each
  248. \f3Elm\f1 variable setting in the users \f2``.elm/elmrc''\f1
  249. file.  This is used when the user chooses to auto-save the
  250. options from within the main program.
  251. .lp elmrcfile 1.0i
  252. The name of the automatic control file within the \f2.elm\f1
  253. directory. (currently \f2elmrc\f1)
  254. .lp old_elmrcfile 1.0i
  255. When a new elmrc file is saved, the old one is also saved, being
  256. renamed to whatever this identifier is set to.
  257. .lp mailheaders  1.0i
  258. The name of the optional file that users may have that will be
  259. included in the headers of each outbound message.
  260. .lp dead_letter 1.0i
  261. If the user decides not to send a message it will instead be saved
  262. to this filename in their home directory.
  263. .lp unedited_mail 1.0i
  264. In the strange case when the mailer suddenly finds all the directories
  265. it uses shut off (like \f2/usr/mail\f1 and \f2/tmp\f1)
  266. then it'll put the current
  267. mailbox into this file in the users home directory.
  268. .lp newalias 1.0i
  269. How to install new aliases..(note: you MUST have the '-q' flag!)
  270. .lp readmsg 1.0i
  271. What the \f2readmsg(1L)\f1 program is installed as.
  272.