[latexrefman-commits] r443 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Wed Sep 23 13:13:08 2015
New Revision: 443

URL: http://svn.gna.org/viewcvs/latexrefman?rev=443&view=rev
Log:
Letters

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=443&r1=442&r2=443&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Wed Sep 23 13:13:08 2015
@@ -1,3 +1,7 @@
+2015-09-23  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (Letters): Add synopsis, examples.
+
 2015-09-22  Vincent Belaïche  <vincent.belaiche at domain.hid>
 
 	* latex2e-fr.texi (filecontents): Add Jim's 2015-09-18 (r439) edits.

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=443&r1=442&r2=443&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Wed Sep 23 13:13:08 2015
@@ -558,6 +558,10 @@
 matter, such as a preface, and back matter, such as an appendix
 (@pxref{Front/back matter}).
 
+ at item letter
+Mail, optionally including mailing labels 
+(@pxref{Letters}).
+
 @item report
 For documents of length between an @code{article} and a @code{book},
 such as technical reports or theses, which may contain several chapters.
@@ -8982,41 +8986,61 @@
 @cindex letters, writing
 @cindex writing letters
 
-You can use @LaTeX{} to typeset letters, both personal and business.  The
- at domain.hid} document class is designed to make a number of letters at
-once, although you can make just one if you so desire.
-
-Your @file{.tex} source file has the same minimum commands as the other
-document classes, i.e., you must have the following commands as a
-minimum:
-
- at domain.hid
- \documentclass at domain.hid@}
- \begin at domain.hid@}
-  ... letters ...
- \end at domain.hid@}
- at domain.hid example
-
-Each letter is a @code{letter} environment, whose argument is the name
-and address of the recipient.  For example, you might have:
-
- at domain.hid
- \begin at domain.hid. Joe Smith\\ 2345 Princess St.
-      \\ Edinburgh, EH1 1AA@}
+Synopsis: 
+
+ at example
+\documentclass at domain.hid@}
+\address at domain.hid address}@}
+\signature at domain.hid name}@}
+\begin at domain.hid@}
+\begin at domain.hid address}@}
+\opening at domain.hid}@}
+  @var{letter body}
+\closing at domain.hid text}@}
+\end at domain.hid@}
+  ...  more letters ...
+\end at domain.hid@}
+ at end example
+
+Produce one or more letters.  
+
+Each letter is in a separate @code{letter} environment, whose argument
+ at var{recipient address} often contains multiple lines separated with a
+double backslash at domain.hid{\\}).  For example, you might have:
+
+ at example
+ \begin at domain.hid. Joe Smith \\ 
+      2345 Princess St. \\ 
+      Edinburgh, EH1 1AA@}
    ...
  \end at domain.hid@}
 @end example
 
-The letter itself begins with the @code{\opening} command.  The text of
-the letter follows.  It is typed as ordinary @LaTeX{} input.  Commands that
-make no sense in a letter, like @code{\chapter}, do not work.  The letter
-closes with a @code{\closing} command.
+The @var{sender address} and @var{sender name} are common to all of the
+letters, whether there is one or more, so these are best put in the
+preamble.  As with the recipient address, often @var{sender address}
+contains multiple lines separated by a double
+backslash at domain.hid{\\}).  @LaTeX{} will put the @var{sender name}
+under the closing, after a vertical space for the traditional
+hand-written signature; it also can contain multiple lines.
+
+Each letter environment begins with an optional @code{\opening} command
+such as @code{\opening at domain.hid Madam or Sir:@}}.  The @var{letter body}
+text is ordinary @LaTeX{} so it can contain everything from from
+enumerated lists to displayed math, except that commands such as
+ at code{\chapter}that make no sense in a letter are turned off.  Each
+letter environment typically ends with a @code{\closing} command such as
+ at code{\closing at domain.hid,@}}.
 
 @findex \\ @r{for letters}
-After the @code{closing}, you can have additional material.  The
- at domain.hid} command produces the usual ``cc: @dots{}''.  There's also a
-similar @code{\encl} command for a list of enclosures. With both these
-commands, use @code{\\} to separate the items.
+Additional material may come after the @code{\closing}.  You can say who
+is receiving a copy of the letter with a command like @code{\cc at domain.hid
+Boss \\ the Boss's Boss@}}.  There's a similar @code{\encl} command for
+a list of enclosures.  And, you can add a postscript with @code{\ps}.
+
+To set a fixed date do something like
+ at code{\renewcommand at domain.hid@}}.  This can go in the
+preamble.
 
 These commands are used with the @code{letter} class.
 
@@ -9122,9 +9146,9 @@
 
 @code{\makelabels at domain.hid@}}
 
-If you issue this command in the preamble, @LaTeX{} will create a sheet of
-address labels. This sheet will be output before the letters.
-
+If you issue this command in the preamble, @LaTeX{} will create a sheet
+of address labels from the recipient addresses. This sheet will be
+output before the letters.
 
 
 @node \name