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

[jhefferon at domain.hid]

Author: jhefferon
Date: Thu Sep 24 15:03:46 2015
New Revision: 444

URL: http://svn.gna.org/viewcvs/latexrefman?rev=444&view=rev
Log:
more stuff on Letters

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=444&r1=443&r2=444&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Thu Sep 24 15:03:46 2015
@@ -1,3 +1,8 @@
+2015-09-23  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (Letters \address, \closing, \location): Add examples.
+	The intent of \location is hard to understand; for Willy the Mailboy?
+
 2015-09-23  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (Letters): Add synopsis, examples.

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=444&r1=443&r2=444&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Thu Sep 24 15:03:46 2015
@@ -9016,6 +9016,9 @@
  \end at domain.hid@}
 @end example
 
+The start of the @code{letter} environment resets the page number to 1,
+and the footnote number to 1 also.
+
 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}
@@ -9028,7 +9031,7 @@
 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 domain.hid make no sense in a letter are turned off.  Each
+ 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
 @code{\closing at domain.hid,@}}.
 
@@ -9062,19 +9065,36 @@
 
 
 @node \address
- at domain.hid @code{\address at domain.hid@}}}
+ at section @code{\address}
 
 @findex \address
 
-The @code{\address} specifies the return address of a letter, as it
-should appear on the letter and the envelope.  Separate lines of the
-address should be separated by @code{\\} commands.
-
-If you do not make an @code{\address} declaration, then the letter
-will be formatted for copying onto your organization's standard
-letterhead.  (@xref{Overview}, for details on your local
-implementation).  If you give an @code{\address} declaration, then the
-letter will be formatted as a personal letter.
+Synopsis: 
+
+ at example
+\address at domain.hid address}@}
+ at end example
+
+Specifies the return address as it appears on the letter and on the
+envelope.  Separate multiple lines in @var{senders address} with a
+double backslash at domain.hid{\\}.
+
+Because it can apply to multiple letters this declaration is often put
+in the preamble.  However, it can go anywhere, including inside an
+individual @code{letter} environment.
+
+This command is optional: without the @code{\address} declaration the
+letter is formatted with some blank space on top, for copying onto
+pre-printed letterhead paper.  (@xref{Overview}, for details on your
+local implementation.)  With the @code{\address} declaration, it is
+formatted as a personal letter.
+
+Here is an example.
+
+ at example
+\address at domain.hid Maturin \\
+         The Grapes of the Savoy@}
+ at end example
 
 
 @node \cc
@@ -9086,11 +9106,19 @@
 Synopsis:
 
 @example
-\cc at domain.hid}@}
- at domain.hid example
-
-Produce a list of @var{name}s the letter was copied to.  Each name is
-printed on a separate line.
+\cc at domain.hid name} \\ 
+    .. @}
+ at end example
+
+Produce a list of names to which copies of the letter were sent.  This
+command is optional.  If it appears then typically it comes after
+ at code{\closing}.  Separate multiple lines with a double
+backslash at domain.hid{\\}.
+
+ at example
+\cc at domain.hid \\
+    Vice President@}
+ at end example
 
 
 @node \closing
@@ -9106,10 +9134,11 @@
 \closing at domain.hid@}
 @end example
 
-A letter closes with a @code{\closing} command, for example,
-
- at domain.hid
-\closing at domain.hid Regards,@}
+Usually at the end of a letter, above the handwritten signature, there
+is a @code{\closing} (although this command is optional).  For example,
+
+ at example
+\closing at domain.hid,@}
 @end example
 
 
@@ -9122,10 +9151,18 @@
 Synopsis:
 
 @example
-\encl at domain.hid}@}
- at domain.hid example
-
-Declare a list of one more enclosures.
+\encl at domain.hid enclosed object} \\ 
+      .. @}
+ at end example
+
+Produce a list of things included with the letter. This command is
+optional; when it is used, it typically is put after @code{\closing}.
+Separate multiple lines with a double backslash at domain.hid{\\}.
+
+ at example
+\encl at domain.hid \\
+       Passport @}
+ at end example
 
 
 @node \location
@@ -9133,10 +9170,29 @@
 
 @findex \location
 
- at domain.hid@}}
-
-This modifies your organization's standard address.  This only appears
-if the @code{firstpage} pagestyle is selected.
+ at code{\location at domain.hid}@}}
+
+The @var{text} appears centered at the bottom of the each page.  It only
+appears if the page style is @code{firstpage}.
+
+This puts @samp{Mailbox 13} at the center bottom of the page.  Were
+there to be more than one page, it would not be at the bottom of
+subsequent pages.
+
+ at example
+\documentclass at domain.hid@}
+\address at domain.hid name \\ Senders address@}
+\signature at domain.hid \\ Sender title@}
+\location at domain.hid 13@} 
+\begin at domain.hid@}
+\begin at domain.hid \\ Recipient's house@}
+\opening at domain.hid:@}
+\thispagestyle at domain.hid@}
+I will not interested in entering a buisness arrangement with you.
+\closing at domain.hid,@}
+\end at domain.hid@}
+\end at domain.hid@}
+ at end example
 
 
 @node \makelabels
@@ -9174,9 +9230,9 @@
 \opening at domain.hid}@}
 @end example
 
-A letter begins with the @code{\opening} command.  The mandatory
-argument, @var{text}, is whatever text you wish to start your letter.
-For instance:
+This command is required to start a letter. The mandatory argument,
+ at var{text}, is whatever text you wish to start your letter.  For
+instance:
 
 @example
 \opening at domain.hid Joe,@}