home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume13 / ease.pch / doc.diffs next >
Encoding:
Text File  |  1988-01-31  |  13.4 KB  |  513 lines
  1. diff -cr doc/Makefile /usr/src/local/local.bin/ease/doc/Makefile
  2. *** doc/Makefile    Thu Aug 13 12:07:05 1987
  3. --- /usr/src/local/local.bin/ease/doc/Makefile    Wed Dec 23 11:30:35 1987
  4. ***************
  5. *** 1,10 ****
  6.   #
  7.   #    Makefile for Ease document.
  8.   #
  9.   #    James S. Schoner
  10.   #    Purdue University Computing Center
  11.   #
  12. ! all:    cover mainbody apen1 apen2 apen3
  13.       
  14.   cover: FRC
  15.       troff -ms cover
  16. --- 1,21 ----
  17.   #
  18. + # $Header: Makefile,v 1.2 87/12/23 11:30:27 root Locked $
  19. + #
  20. + # $Log:    Makefile,v $
  21. + # Revision 1.2  87/12/23  11:30:27  root
  22. + # Added new appendix. ADR.
  23. + # 
  24. + # Revision 1.1  87/12/23  10:40:45  root
  25. + # Initial revision
  26. + # 
  27. + #
  28. + #
  29.   #    Makefile for Ease document.
  30.   #
  31.   #    James S. Schoner
  32.   #    Purdue University Computing Center
  33.   #
  34. ! all:    cover mainbody apen1 apen2 apen3 apen4
  35.       
  36.   cover: FRC
  37.       troff -ms cover
  38. ***************
  39. *** 20,25 ****
  40. --- 31,39 ----
  41.   
  42.   apen3:
  43.       tbl ap3 | troff -ms
  44. + 
  45. + apen4:
  46. +     tbl ap4 | troff -ms
  47.   
  48.   FRC:
  49.   
  50. diff -cr doc/ap1 /usr/src/local/local.bin/ease/doc/ap1
  51. *** doc/ap1    Thu Aug 13 12:07:06 1987
  52. --- /usr/src/local/local.bin/ease/doc/ap1    Thu Jan 21 15:33:47 1988
  53. ***************
  54. *** 37,42 ****
  55.   \fIm_rhdir\fR    z    The home directory of the recipient
  56.   .TE
  57.   .FS
  58. ! *  Taken from pages 15 and 16 of the Installation and Operation Guide
  59. ! for Sendmail (UNIX Programmer's Manual, Volume 2c), by Eric Allman.
  60.   .FE
  61. --- 37,42 ----
  62.   \fIm_rhdir\fR    z    The home directory of the recipient
  63.   .TE
  64.   .FS
  65. ! *  Taken from pages 19 and 20 of the Sendmail Installation and Operation Guide
  66. ! (SMM:7 in the 4.3 BSD UNIX System Manager's Manual), by Eric Allman.
  67.   .FE
  68. diff -cr doc/ap2 /usr/src/local/local.bin/ease/doc/ap2
  69. *** doc/ap2    Thu Aug 13 12:07:08 1987
  70. --- /usr/src/local/local.bin/ease/doc/ap2    Thu Jan 21 17:10:56 1988
  71. ***************
  72. *** 1,3 ****
  73. --- 1,20 ----
  74. + ...
  75. + ... $Header: ap2,v 1.4 88/01/21 17:10:33 root Locked $
  76. + ... 
  77. + ... $Log:    ap2,v $
  78. + ... Revision 1.4  88/01/21  17:10:33  root
  79. + ... Added new option; change location of Sendmail doc to 4.3 SMM. ADR.
  80. + ... 
  81. + ... Revision 1.3  87/09/04  14:55:36  root
  82. + ... Fixed typo in new options. ADR.
  83. + ... 
  84. + ... Revision 1.2  87/03/03  17:05:41  root
  85. + ... Changes for 4.3 version of sendmail. ADR.
  86. + ... 
  87. + ... Revision 1.1  87/03/03  17:01:24  root
  88. + ... Initial revision
  89. + ... 
  90. + ...
  91.   .DS C
  92.   \s+5\fBAppendix B\fR
  93.   
  94. ***************
  95. *** 7,14 ****
  96.   .sp 2
  97.   .PP
  98.   For a complete description of Sendmail's options and their values, refer to 
  99. ! Appendix B of the Installation and Operation Guide for Sendmail (UNIX
  100. ! Programmer's Manual, Volume 2c), by Eric Allman.
  101.   .sp 2
  102.   .TS 
  103.   center box;
  104. --- 24,31 ----
  105.   .sp 2
  106.   .PP
  107.   For a complete description of Sendmail's options and their values, refer to 
  108. ! Appendix B of the Sendmail Installation and Operation Guide (SMM:7 in the
  109. ! 4.3 BSD UNIX System Managers's Manual), by Eric Allman.
  110.   .sp 2
  111.   .TS 
  112.   center box;
  113. ***************
  114. *** 41,46 ****
  115. --- 58,64 ----
  116.   \fIo_dnet\fR    N    
  117.   \fIo_hformat\fR    o    
  118.   \fIo_qdir\fR    Q    
  119. + \fIo_qfactor\fR    q
  120.   \fIo_tread\fR    r    
  121.   \fIo_flog\fR    S    
  122.   \fIo_safe\fR    s    
  123. ***************
  124. *** 51,54 ****
  125. --- 69,76 ----
  126.   \fIo_wizpass\fR    W    
  127.   \fIo_loadq\fR    x    
  128.   \fIo_loadnc\fR    X    
  129. + \fIo_recipfactor\fR    y
  130. + \fIo_newproc\fR    Y
  131. + \fIo_prifactor\fR    z
  132. + \fIo_waitfactor\fR    Z
  133.   .TE
  134. diff -cr doc/ap3 /usr/src/local/local.bin/ease/doc/ap3
  135. *** doc/ap3    Thu Aug 13 12:07:10 1987
  136. --- /usr/src/local/local.bin/ease/doc/ap3    Thu Jan 21 17:11:11 1988
  137. ***************
  138. *** 1,3 ****
  139. --- 1,17 ----
  140. + ...
  141. + ... $Header: ap3,v 1.3 88/01/21 17:10:57 root Locked $
  142. + ... 
  143. + ... $Log:    ap3,v $
  144. + ... Revision 1.3  88/01/21  17:10:57  root
  145. + ... Changed location of Sendmail doc to 4.3 SMM. ADR.
  146. + ... 
  147. + ... Revision 1.2  87/03/03  17:05:53  root
  148. + ... Changes for 4.3 version of sendmail. ADR.
  149. + ... 
  150. + ... Revision 1.1  87/03/03  17:04:52  root
  151. + ... Initial revision
  152. + ... 
  153. + ...
  154.   .DS C
  155.   \s+5\fBAppendix C\fR
  156.   
  157. ***************
  158. *** 7,14 ****
  159.   .sp 5
  160.   .PP
  161.   For a complete description of mailer flags, refer to 
  162. ! Appendix C of the Installation and Operation Guide for Sendmail (UNIX
  163. ! Programmer's Manual, Volume 2c), by Eric Allman.
  164.   .sp 5
  165.   .TS 
  166.   center box;
  167. --- 21,28 ----
  168.   .sp 5
  169.   .PP
  170.   For a complete description of mailer flags, refer to 
  171. ! Appendix C of the Sendmail Installation and Operation Guide (SMM:7 in the
  172. ! 4.3 BSD UNIX System Manager's Manual), by Eric Allman.
  173.   .sp 5
  174.   .TS 
  175.   center box;
  176. ***************
  177. *** 38,41 ****
  178. --- 52,56 ----
  179.   \fIf_retsmtp\fR    p    
  180.   \fIf_smtp\fR    I    
  181.   \fIf_addrw\fR    C    
  182. + \fIf_escape\fR    E
  183.   .TE
  184. diff -cr doc/cover /usr/src/local/local.bin/ease/doc/cover
  185. *** doc/cover    Thu Aug 13 12:07:11 1987
  186. --- /usr/src/local/local.bin/ease/doc/cover    Wed Dec 23 11:30:46 1987
  187. ***************
  188. *** 1,3 ****
  189. --- 1,14 ----
  190. + ...
  191. + ... $Header: cover,v 1.2 87/12/23 11:30:36 root Locked $
  192. + ...
  193. + ... $Log:    cover,v $
  194. + ... Revision 1.2  87/12/23  11:30:36  root
  195. + ... Updated list of authors. ADR.
  196. + ... 
  197. + ... Revision 1.1  87/12/23  10:16:35  root
  198. + ... Initial revision
  199. + ... 
  200. + ...
  201.   .DA
  202.   .sp 15
  203.   .nr PS 14
  204. ***************
  205. *** 19,25 ****
  206.     
  207.   for Sendmail
  208.   .DE
  209. ! .sp 13
  210.   .nr PS 14
  211.   .ps 14
  212.   .DS C
  213. --- 30,36 ----
  214.     
  215.   for Sendmail
  216.   .DE
  217. ! .sp 8
  218.   .nr PS 14
  219.   .ps 14
  220.   .DS C
  221. ***************
  222. *** 27,30 ****
  223. --- 38,49 ----
  224.   
  225.   \fIJames S. Schoner\fR
  226.   \fIPurdue University Computing Center\fR
  227. + 
  228. + Amended by
  229. + 
  230. + \fIJeff P. Stearns\fR
  231. + \fIJohn Fluke Manufacturing Company\fR
  232. + 
  233. + \fIArnold D. Robbins\fR
  234. + \fIEmory University Computing Center\fR
  235.   .DE
  236. diff -cr doc/ease.paper /usr/src/local/local.bin/ease/doc/ease.paper
  237. *** doc/ease.paper    Thu Aug 13 12:08:37 1987
  238. --- /usr/src/local/local.bin/ease/doc/ease.paper    Thu Jan 21 17:19:52 1988
  239. ***************
  240. *** 1,3 ****
  241. --- 1,24 ----
  242. + ...
  243. + ... $Header: ease.paper,v 1.5 88/01/21 17:19:35 root Locked $
  244. + ... 
  245. + ... $Log:    ease.paper,v $
  246. + ... Revision 1.5  88/01/21  17:19:35  root
  247. + ... Several editorial changes. ADR.
  248. + ... 
  249. + ... Revision 1.4  87/12/23  11:30:47  root
  250. + ... Updated list of authors. Documented extended canon() capability.
  251. + ... Integrated fluke changes in a little better. ADR.
  252. + ... 
  253. + ... Revision 1.3  87/11/04  11:33:45  root
  254. + ... Documented new keyword "while" which is equivalent to "if". ADR.
  255. + ... 
  256. + ... Revision 1.2  87/08/13  17:08:05  root
  257. + ... Changes from Jeff Stearns, fluke!jeff, for Sun. ADR.
  258. + ... 
  259. + ... Revision 1.1  87/08/13  17:05:00  root
  260. + ... Initial revision
  261. + ... 
  262. + ...
  263.   .LP
  264.   .TL
  265.   Ease: A Configuration Language
  266. ***************
  267. *** 7,12 ****
  268. --- 28,43 ----
  269.   .AI
  270.   Purdue University Computing Center
  271.   West Lafayette, Indiana  47907
  272. + .AU
  273. + Jeff P. Stearns
  274. + .AI
  275. + John Fluke Manufacturing Company
  276. + Everett, Washington  98206
  277. + .AU
  278. + Arnold D. Robbins
  279. + .AI
  280. + Emory University Computing Center
  281. + Atlanta, Georgia  30322
  282.   .sp 2
  283.   .I
  284.   .ce
  285. ***************
  286. *** 47,53 ****
  287.   the most needed improvement.  Nevertheless, every element of a configuration 
  288.   file is structurally enhanced through the use of \fBEase\fR. 
  289.   .FS
  290. ! *  UNIX is a trademark of AT&T Bell Laboratories.
  291.   .FE
  292.   .sp 2
  293.   .NH
  294. --- 78,84 ----
  295.   the most needed improvement.  Nevertheless, every element of a configuration 
  296.   file is structurally enhanced through the use of \fBEase\fR. 
  297.   .FS
  298. ! *  UNIX is a registered trademark of AT&T.
  299.   .FE
  300.   .sp 2
  301.   .NH
  302. ***************
  303. *** 107,114 ****
  304.   the special uses of
  305.   pre-defined macros, and the method of building configuration files.  To
  306.   obtain this information, the reader is advised to refer to
  307. ! the Installation and Operation Guide for Sendmail (UNIX
  308. ! Programmer's Manual, Volume 2c), by Eric Allman.\fR
  309.   .FE
  310.   .PP
  311.   At its highest level, \fBEase\fR can be viewed as a collection of 
  312. --- 138,146 ----
  313.   the special uses of
  314.   pre-defined macros, and the method of building configuration files.  To
  315.   obtain this information, the reader is advised to refer to
  316. ! the Sendmail Installation and Operation Guide (SMM:7 in the 4.3 BSD
  317. ! UNIX System Manager's Manual),
  318. ! by Eric Allman.\fR
  319.   .FE
  320.   .PP
  321.   At its highest level, \fBEase\fR can be viewed as a collection of 
  322. ***************
  323. *** 218,224 ****
  324.   .PP
  325.   last_name = "Schoner";
  326.   .PP
  327. ! whole_name = "${first_name} ${second_name}";
  328.   .sp 1
  329.   defines the macros first_name, last_name, and whole_name, where whole_name
  330.   is the string, "James Schoner".
  331. --- 250,256 ----
  332.   .PP
  333.   last_name = "Schoner";
  334.   .PP
  335. ! whole_name = "${first_name} ${last_name}";
  336.   .sp 1
  337.   defines the macros first_name, last_name, and whole_name, where whole_name
  338.   is the string, "James Schoner".
  339. ***************
  340. *** 291,297 ****
  341.   .PP
  342.   \fIo_tmode\fR = "0600" ;
  343.   .PP
  344. ! \fIo_delivery\fR = d_background ;
  345.   .sp 1
  346.   sets the options \fIo_alias\fR, \fIo_tmode\fR, and \fIo_delivery\fR.
  347.   .NH 2
  348. --- 323,329 ----
  349.   .PP
  350.   \fIo_tmode\fR = "0600" ;
  351.   .PP
  352. ! \fIo_delivery\fR = \fId_background\fR ;
  353.   .sp 1
  354.   sets the options \fIo_alias\fR, \fIo_tmode\fR, and \fIo_delivery\fR.
  355.   .NH 2
  356. ***************
  357. *** 382,390 ****
  358.   define a header,
  359.   regardless of mailer flags.  Refer to Appendix C for a list of \fBEase\fR 
  360.   identifiers representing mailer flags.  The header title is a simple
  361. ! string of characters (no macro references), whereas the \fBheader-value\fR can
  362. ! be either a string of characters (possibly containing macro references) or 
  363. ! a \fBconditional-expression\fR (discussed later).
  364.   .sp 1
  365.   The following example,
  366.   .DS
  367. --- 414,423 ----
  368.   define a header,
  369.   regardless of mailer flags.  Refer to Appendix C for a list of \fBEase\fR 
  370.   identifiers representing mailer flags.  The header title is a simple
  371. ! string of characters (no macro references), whereas the \fBheader-value\fR
  372. ! is a series of one or more strings and
  373. ! \fBconditional-expressions\fP (discussed later).
  374. ! Concatenation is implicit (as in \fIawk\fP).
  375.   .sp 1
  376.   The following example,
  377.   .DS
  378. ***************
  379. *** 495,502 ****
  380.       \fImatch\fR ( 0* )
  381.       \fImatch\fR ( 1* )
  382.       \fImatch\fR ( 1 )
  383. !     \fImatch\fR ( 1 ) in <class-X>
  384. !     \fImatch\fR ( 0 ) in <class-X>
  385.   .DE
  386.   The star in the first two forms means: "or more".  Thus, the first
  387.   form would read: "match zero or more tokens".  The fourth form describes
  388. --- 528,535 ----
  389.       \fImatch\fR ( 0* )
  390.       \fImatch\fR ( 1* )
  391.       \fImatch\fR ( 1 )
  392. !     \fImatch\fR ( 1 ) \fIin\fR <class-X>
  393. !     \fImatch\fR ( 0 ) \fIin\fR <class-X>
  394.   .DE
  395.   The star in the first two forms means: "or more".  Thus, the first
  396.   form would read: "match zero or more tokens".  The fourth form describes
  397. ***************
  398. *** 504,509 ****
  399. --- 537,552 ----
  400.   the fifth form describes a field where one token is matched if it is not of the
  401.   given class (class-X).
  402.   .sp 1
  403. + In addition, the Sun release 3.0 version of sendmail supports several
  404. + new pattern matching operations represented by the following forms:
  405. + .DS
  406. +     \fImatch\fR ( 0 ) \fImap\fR <macro-identifier-X>
  407. +     \fImatch\fR ( 1 ) \fImap\fR <macro-identifier-X>
  408. +     \fImatch host\fR
  409. + .DE
  410. + The macro \*Qmacro-identifier-X\*U should be assigned the name of the
  411. + relevant YP map.
  412. + .sp 1
  413.   The following example,
  414.   .sp 1
  415.   .DS
  416. ***************
  417. *** 510,517 ****
  418.   \fIfield\fR
  419.       anypath        : \fImatch\fR ( 0* );
  420.       recipient_host    : \fImatch\fR ( 1 );
  421. !     local_site        : \fImatch\fR ( 1 ) in \fIm_sitename\fR;
  422. !     remote_site        : \fImatch\fR ( 0 ) in \fIm_sitename\fR;
  423.   .DE
  424.   defines the fields anypath, recipient_host, local_site, and remote_site.
  425.   .NH 2
  426. --- 553,560 ----
  427.   \fIfield\fR
  428.       anypath        : \fImatch\fR ( 0* );
  429.       recipient_host    : \fImatch\fR ( 1 );
  430. !     local_site        : \fImatch\fR ( 1 ) \fIin m_sitename\fR;
  431. !     remote_site        : \fImatch\fR ( 0 ) \fIin m_sitename\fR;
  432.   .DE
  433.   defines the fields anypath, recipient_host, local_site, and remote_site.
  434.   .NH 2
  435. ***************
  436. *** 536,541 ****
  437. --- 579,591 ----
  438.           <match-action> ( <rewriting-pattern> ) ;
  439.   .DE
  440.   where match-pattern, rewriting-pattern, and match-action are described below.
  441. + An alternative form is available:
  442. + .DS
  443. +     \fIwhile\fR ( <match-pattern> )
  444. +         <match-action> ( <rewriting-pattern> ) ;
  445. + .DE
  446. + which is somewhat more useful when the \*Qmatch-action\*U is \fIretry\fP
  447. + (see below).
  448.   .NH 3
  449.   Match-patterns
  450.   .PP
  451. ***************
  452. *** 601,609 ****
  453.   T}
  454.   
  455.   T{
  456. ! 7. Canonicalized host names of the form \fIcanon\fR (<id-token>),
  457. ! where id-token is a regular identifier, a quoted identifier (with
  458. ! double quotes), a macro reference yielding an identifier, or a 
  459.   positional reference in the matched address.  The canonicalization of 
  460.   a host name is simply a mapping to its canonical (or official) form.
  461.   T}
  462. --- 651,662 ----
  463.   T}
  464.   
  465.   T{
  466. ! 7. Canonicalized host names of the form \fIcanon\fR (<id-token-list>),
  467. ! where \*Qid-token-list\*U is a list of one or more \*Qid-tokens.\*U
  468. ! An \*Qid-token\*U is a regular identifier, a quoted identifier (with
  469. ! double quotes), a macro reference yielding an identifier,
  470. ! a numeric internet specification (see below),
  471. ! a literal character (such as a \*Q.\*U or a \*Q[\*U), or a 
  472.   positional reference in the matched address.  The canonicalization of 
  473.   a host name is simply a mapping to its canonical (or official) form.
  474.   T}
  475. ***************
  476. *** 682,688 ****
  477.       anypath    : \fImatch\fR (0*);
  478.       usr, path    : \fImatch\fR (1*);
  479.       hostname    : \fImatch\fR (1);
  480. !     phone_host    : \fImatch\fR (1) in phonehosts;
  481.   .DE
  482.   .DS
  483.   \fIruleset\fR
  484. --- 735,741 ----
  485.       anypath    : \fImatch\fR (0*);
  486.       usr, path    : \fImatch\fR (1*);
  487.       hostname    : \fImatch\fR (1);
  488. !     phone_host    : \fImatch\fR (1) \fIin\fR phonehosts;
  489.   .DE
  490.   .DS
  491.   \fIruleset\fR
  492. diff -c /dev/null ap4
  493. *** /dev/null    Mon Jan 25 15:47:24 1988
  494. --- ap4    Thu Jan 21 15:13:19 1988
  495. ***************
  496. *** 0 ****
  497. --- 1,15 ----
  498. + .DS C
  499. + \s+5\fBAppendix D\fR
  500. + 
  501. + 
  502. + \fBPre-Defined Classes\fR\s-5
  503. + .DE
  504. + .sp 5
  505. + .TS 
  506. + center box;
  507. + c|c|c
  508. + l|l|l.
  509. + \fBEase\fR Class    Raw Equivalent    Meaning
  510. + =
  511. + \fIc_myname\fR    w    The list of names by which this host is known
  512. + .TE
  513.