standards for long macro and class names -- first char l.c. for internal

[unix-history] / usr / src / usr.sbin / sendmail / doc / op / op.me

diff --git a/usr/src/usr.sbin/sendmail/doc/op/op.me b/usr/src/usr.sbin/sendmail/doc/op/op.me
index 771097d..bd0160e 100644 (file)
--- a/usr/src/usr.sbin/sendmail/doc/op/op.me
+++ b/usr/src/usr.sbin/sendmail/doc/op/op.me
@@ -1,10 +1,10 @@
-.\" Copyright (c) 1983 Eric P. Allman
+.\" Copyright (c) 1983, 1995 Eric P. Allman

 .\" Copyright (c) 1983, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" %sccs.include.redist.roff%
 .\"
 .\" Copyright (c) 1983, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" %sccs.include.redist.roff%
 .\"

-.\"    @(#)op.me       8.49 (Berkeley) %G%
+.\"    @(#)op.me       8.53 (Berkeley) %G%

 .\"
 .\" eqn op.me | pic | troff -me
 .eh 'SMM:08-%''Sendmail Installation and Operation Guide'
 .\"
 .\" eqn op.me | pic | troff -me
 .eh 'SMM:08-%''Sendmail Installation and Operation Guide'


@@ -43,7 +43,7 @@ University of California, Berkeley
 Mammoth Project
 eric@CS.Berkeley.EDU
 .sp
 Mammoth Project
 eric@CS.Berkeley.EDU
 .sp

-Version 8.49
+Version 8.53

 .sp
 For Sendmail Version 8.7
 .)l
 .sp
 For Sendmail Version 8.7
 .)l


@@ -2386,6 +2386,11 @@ turns on the AAONLY (accept authoritative answers only)
 and turns off the DNSRCH (search the domain path) options.
 Most resolver libraries default DNSRCH, DEFNAMES, and RECURSE
 flags on and all others off.
 and turns off the DNSRCH (search the domain path) options.
 Most resolver libraries default DNSRCH, DEFNAMES, and RECURSE
 flags on and all others off.

+You can also include
+.q HasWildcardMX
+to specify that there is a wildcard MX record matching your domain;
+this turns off MX matching when canonifying names,
+which can lead to inappropriate canonifications.

 .pp
 Version level 1 configurations
 turn DNSRCH and DEFNAMES off when doing delivery lookups,
 .pp
 Version level 1 configurations
 turn DNSRCH and DEFNAMES off when doing delivery lookups,


@@ -3067,6 +3072,9 @@ should be selected from the set of upper case letters only.
 Lower case letters
 and special symbols
 are used internally.
 Lower case letters
 and special symbols
 are used internally.

+Long names beginning with a lower case letter or a punctuation character
+are reserved for use by sendmail,
+so user-defined long macro names should begin with an upper case letter.

 .pp
 The syntax for macro definitions is:
 .(b F
 .pp
 The syntax for macro definitions is:
 .(b F


@@ -3498,10 +3506,12 @@ so that attempts to send to oneself
 can be eliminated.
 These can either be defined directly in the configuration file
 or read in from another file.
 can be eliminated.
 These can either be defined directly in the configuration file
 or read in from another file.

-Classes may be given names
-from the set of upper case letters.
-Lower case letters and special characters
-are reserved for system use.
+Classes are named as a single letter or a word in {braces}.
+Class names beginning with lower case letters
+and special characters are reserved for system use.
+Classes defined in config files may be given names
+from the set of upper case letters for short names
+or beginning with an upper case letter for long names.

 .pp
 The syntax is:
 .(b F
 .pp
 The syntax is:
 .(b F


@@ -3896,6 +3906,8 @@ If the
 .b 7
 option is set, this is essentially always set,
 since the eighth bit was stripped on input.
 .b 7
 option is set, this is essentially always set,
 since the eighth bit was stripped on input.

+Note that this option will only impact messages
+that didn't have 8\(->7 bit MIME conversions performed.

 .ip 8
 If set,
 it is acceptable to send eight bit data to this mailer;
 .ip 8
 If set,
 it is acceptable to send eight bit data to this mailer;


@@ -4240,6 +4252,23 @@ lines in the configuration file)
 and subtracted from the priority.
 Thus, messages with a higher Priority: will be favored.
 Defaults to 1800.
 and subtracted from the priority.
 Thus, messages with a higher Priority: will be favored.
 Defaults to 1800.

+.ip ColonOkInAddr
+[no short name]
+If set, colons are acceptable in e-mail addresses
+(e.g.,
+.q host:user ).
+If not set, colons indicate the beginning of a RFC 822 group construct
+(\c
+.q "groupname: member1, member2, ... memberN;" ).
+Doubled colons are always acceptable
+(\c
+.q nodename::user )
+and proper route-addr nesting is understood
+(\c
+.q <@relay:user@host> ).
+Furthermore, this option defaults on if the configuration version level
+is less than 6 (for back compatibility).
+However, it must be off for full compatibility with RFC 822.

 .ip ConnectionCacheSize=\fIN\fP
 [k]
 The maximum number of open connections that will be cached at a time.
 .ip ConnectionCacheSize=\fIN\fP
 [k]
 The maximum number of open connections that will be cached at a time.


@@ -4410,24 +4439,26 @@ The possible
 .i action s
 are:
 .(b
 .i action s
 are:
 .(b

-  r    Reject undeclared 8-bit data;
-       don't convert 8BITMIME\(->7BIT (``reject'')
-  s    Reject undeclared 8-bit data;
-       do convert 8BITMIME\(->7BIT (``strict'')
-  c    Convert undeclared 8-bit data to MIME;
-       don't convert 8BITMIME\(->7BIT (``convert'')
-  m    Convert undeclared 8-bit data to MIME;
-       do convert 8BITMIME\(->7BIT (``mime'')
-  j    Pass undeclared 8-bit data;
-       don't convert 8BITMIME\(->7BIT (``just send 8'')
-  p    Pass undeclared 8-bit data;
-       do convert 8BITMIME\(->7BIT (``pass'')
-  a    Adaptive algorithm: see below
+.\"  r Reject undeclared 8-bit data;
+.\"    don't convert 8BITMIME\(->7BIT (``reject'')
+  s    Reject undeclared 8-bit data (``strict'')
+.\"    do convert 8BITMIME\(->7BIT (``strict'')
+.\"  c Convert undeclared 8-bit data to MIME;
+.\"    don't convert 8BITMIME\(->7BIT (``convert'')
+  m    Convert undeclared 8-bit data to MIME (``mime'')
+.\"    do convert 8BITMIME\(->7BIT (``mime'')
+.\"  j Pass undeclared 8-bit data;
+.\"    don't convert 8BITMIME\(->7BIT (``just send 8'')
+  p    Pass undeclared 8-bit data (``pass'')
+.\"    do convert 8BITMIME\(->7BIT (``pass'')
+.\"  a Adaptive algorithm: see below

 .)b
 .)b

-The adaptive algorithm is to accept 8-bit data,
-converting it to 8BITMIME only if the receiver understands that,
-otherwise just passing it as undeclared 8-bit data;
-8BITMIME\(->7BIT conversions are done.
+.\"The adaptive algorithm is to accept 8-bit data,
+.\"converting it to 8BITMIME only if the receiver understands that,
+.\"otherwise just passing it as undeclared 8-bit data;
+.\"8BITMIME\(->7BIT conversions are done.
+In all cases properly declared 8BITMIME data will be converted to 7BIT
+as needed.

 .ip ErrorHeader=\fIfile-or-message\fP
 [E]
 Prepend error messages with the indicated message.
 .ip ErrorHeader=\fIfile-or-message\fP
 [E]
 Prepend error messages with the indicated message.


@@ -4595,6 +4626,14 @@ can be
 .q stayopen ,
 or
 .q dnsrch .
 .q stayopen ,
 or
 .q dnsrch .

+The string
+.q HasWildcardMX
+(without a
+.b +
+or
+.b \- )
+can be specified to turn off matching against MX records
+when doing name canonifications.

 .b N.B.
 Prior to 8.7,
 this option indicated that the name server be responding
 .b N.B.
 Prior to 8.7,
 this option indicated that the name server be responding


@@ -5118,6 +5157,14 @@ change many of the local processing options
 to be mailer flags;
 this allows fine-grained control over the special local processing.
 Level six configuration files may also use long option names.
 to be mailer flags;
 this allows fine-grained control over the special local processing.
 Level six configuration files may also use long option names.

+The
+.b ColonOkInAddr
+option (to allow colons in the local-part of addresses)
+defaults
+.b on
+for lower numbered configuration files;
+the configuration file requires some additional intelligence
+to properly handle the RFC 822 group construct.

 .pp
 The
 .b V
 .pp
 The
 .b V


@@ -7358,7 +7405,7 @@ A transcript of the current session.
 .\"Eric Allman
 .\"Britton-Lee, Inc.
 .\".sp
 .\"Eric Allman
 .\"Britton-Lee, Inc.
 .\".sp

-.\"Version 8.49
+.\"Version 8.53

 .\".ce 0
 .bp 2
 .rs
 .\".ce 0
 .bp 2
 .rs