newsletr v01-016 22-Jan-2004

git-svn-id: svn://tug.org/texlive/trunk@9229 c570f23f-e606-0410-a88d-b1316a301751

10 files changed, 249 insertions, 32 deletions

diff --git a/Master/texmf-dist/doc/plain/newsletr/italic.tex b/Master/texmf-dist/doc/plain/newsletr/italic.tex
new file mode 100755
index 00000000000..de8459decab
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/newsletr/italic.tex
@@ -0,0 +1,37 @@
+%
+%  File:	ITALIC.TEX
+%
+%  Author:	Hunter Goatley
+%		goathunter@goatley.com
+%
+%  Date:	August 21, 1991
+%
+%  Abstract:
+%
+%	The macros \ital and \slant are defined to typeset tex in italic
+%	(\it) and slanted (\sl) fonts, automatically inserting the italic
+%	correction (\/) if necessary.  The correction is not inserted if
+%	the token following the parameter is a period or a comma, as
+%	suggested on page 14 of _The TeXbook_.
+%
+%	Based on the \predict macro presented in _TeX for the Impatient_,
+%	p. 233.
+%
+%	These macros use \toks0 as a temporary.
+%
+%	The \futurelet\it@next in \ital and \slant defines \it@next to be
+%	whatever the character following the parameter is.  \d@slant checks
+%	to see if \it@next is a comma or period; if it is neither, the
+%	italic correction (\/) is included.
+%
+\catcode`\@=11				% Temporarily make @ a letter
+\def\ital#1{\toks0={#1}\let\slf@nt=\it\futurelet\it@next\d@slant}
+\def\slant#1{\toks0={#1}\let\slf@nt=\sl\futurelet\it@next\d@slant}
+\def\d@slant{{\slf@nt\the\toks0}%
+	\ifx\it@next,%			% If \it@next is not a comma
+	\else\ifx\it@next.%		% ... and is not a period
+	\else\/%			% ... insert the correction (\/)
+	\fi\fi%				% ...
+	\let\it@next=\relax%		% "Undefine" \it@next
+	}
+\catcode`\@=12				% Reset @ as other
diff --git a/Master/texmf-dist/doc/plain/newsletr/lodriver.tex b/Master/texmf-dist/doc/plain/newsletr/lodriver.tex
new file mode 100755
index 00000000000..9c63879c390
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/newsletr/lodriver.tex
@@ -0,0 +1,56 @@
+%
+%  File:	LODRIVER.TEX
+%
+%  Functional description:
+%
+%	This file is the TeX control file for the Robert R. McCammon newsletter
+%	published by Hunter Goatley.
+%
+%	It depends on the file NEWSLETTER_FORMAT.TEX.
+%
+%  Author:	Hunter Goatley
+%
+%  Date:	May 26, 1990
+%
+%  Modified by:
+%
+%	01-000		Hunter Goatley		 3-JUN-1989 14:56
+%		Original version.
+%
+\ifx\undefined\eoa\input newsletr \fi	% Include macro definitions if needed
+
+\def\LO{\book{Lights Out!\/}}
+\def\POBox{P.\thinspace O.~Box 1234\relax}
+\def\CityState{Nowhere, NA\relax}
+\def\ZipCode{12345-6789\relax}
+\def\LOAddress{\POBox, \CityState \ZipCode\relax}
+\def\RRM{Robert~R. McCammon\relax}
+\def\RM{Rick McCammon\relax}
+\def\McC{McCammon\relax}
+\newspage
+\begindoublequotes		%Handle double-quotes
+
+\say{Producing Robert R. McCammon Newsletter: Vol. 2  No. 1, Issue 5}
+
+\pageheaderlinetrue	\pagefooterlinetrue		% Do head/foot lines
+\evenpageheader{}{Lights Out!}{}			% Header for even pages
+\oddpageheader{}{The Robert R. McCammon Newsletter}{}	% Header for odd pages
+\evenpagefooter{Page\ \folio}{}{January 1991}		% Footer for even pages
+\oddpagefooter{Vol.\ 2\ \ No.\ 1}{}{Page\ \folio}	% Footer for odd pages
+
+%\say{}
+%\say{*************  PROOF MODE IS SET  ************}
+%\say{}
+
+\ignoreunderfill
+%
+%  Normally, I have separate files that I include.
+%
+%\include{TITLE.TEX}
+%\include{EDITORIAL.TEX}
+%\include{KAZUE.TEX}
+%\include{NEXTTIME.TEX}
+
+\include{LOSAMPLE.TEX}
+
+\bye
diff --git a/Master/texmf-dist/doc/plain/newsletr/losample.tex b/Master/texmf-dist/doc/plain/newsletr/losample.tex
index 660019319ee..a92a7c3af74 100644
--- a/Master/texmf-dist/doc/plain/newsletr/losample.tex
+++ b/Master/texmf-dist/doc/plain/newsletr/losample.tex
@@ -1,4 +1,3 @@
-% Save file as: LOSAMPLE.TEX           Source: FILESERV@SHSU.BITNET  
 %% TITLE.TEX %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begingroup
 \font\HUGE=cmss17 %scaled\magstep2
diff --git a/Master/texmf-dist/doc/plain/newsletr/newsletr.txt b/Master/texmf-dist/doc/plain/newsletr/newsletr.txt
index df802b00264..6badec3a089 100644
--- a/Master/texmf-dist/doc/plain/newsletr/newsletr.txt
+++ b/Master/texmf-dist/doc/plain/newsletr/newsletr.txt
@@ -1,4 +1,3 @@
-% Save file as: NEWSLETR.TXT           Source: FILESERV@SHSU.BITNET  
                         Help for NEWSLETTER_FORMAT.TEX
                                 Hunter Goatley
                                 August 21, 1991
diff --git a/Master/texmf-dist/doc/plain/newsletr/newssamp.pdf b/Master/texmf-dist/doc/plain/newsletr/newssamp.pdf
new file mode 100644
index 00000000000..f7ab43a34b4
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/newsletr/newssamp.pdf
diff --git a/Master/texmf-dist/doc/plain/newsletr/newssamp.tex b/Master/texmf-dist/doc/plain/newsletr/newssamp.tex
index 006946ed2d9..e0af4e82505 100644
--- a/Master/texmf-dist/doc/plain/newsletr/newssamp.tex
+++ b/Master/texmf-dist/doc/plain/newsletr/newssamp.tex
@@ -1,4 +1,3 @@
-% Save file as: NEWSSAMP.TEX           Source: FILESERV@SHSU.BITNET  
 %
 %  File:        NEWSLETTER_SAMPLE.TEX
 %
diff --git a/Master/texmf-dist/doc/plain/newsletr/quote.tex b/Master/texmf-dist/doc/plain/newsletr/quote.tex
new file mode 100755
index 00000000000..79aa2a54300
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/newsletr/quote.tex
@@ -0,0 +1,118 @@
+%
+%  File:	QUOTE.TEX
+%
+%  Author:	Hunter Goatley
+%		goathunter@goatley.com
+%
+%  Date:	August 14, 1991
+%
+%  Abstract:
+%
+%	This file defines the macros \begindoublequotes and \enddoublequotes,
+%	which let TeX replace the double-quote character (") with TeX's
+%	left double-quote and right double-quote.  For example:
+%
+%		"This is a test."     --->    ``This is a test.''
+%
+%	The double-quote character is still available via \dq.  (\" is still
+%	treated as the umlaut accent.)
+%
+%	This macro makes a couple of assumptions about the double-quotes:
+%
+%	1.  Double-quotes are assumed to come in pairs.  When replacing
+%	    double-quotes, the macro alternates between `` and ''.  The only
+%	    exception to this is noted in (2) below.
+%	2.  A double-quote at the beginning of a paragraph is always treated
+%	    as ``.  This correctly handles the case where a quotation is
+%	    continued into a second paragraph:
+%
+%		"This is the first paragraph.\par
+%		"This is the second paragraph of the same quote."
+%
+%	Normal TeX spacing after `` and '' is maintained by saving and
+%	restoring the \spacefactor.
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%  HOW IT WORKS:
+%
+%	The double-quote character (") is made active by \begindoublequotes.
+%	The " macro keeps track of left-quote/right-quote pairs and inserts
+%	the appropriate `` and '' in its place.
+%
+%	Each character has a \spacefactor associated with it, which specifies
+%	the amount of stretch or shrink that a space following the character
+%	can have.  Most characters have a factor of 1000, but some punctuation
+%	marks have higher spacefactors, most notably the period, which has a
+%	\spacefactor of 3000.  This means the space following a period can
+%	stretch up to 3 times more than the space after a regular character,
+%	accounting for the increased space at the end of sentences.
+%
+%	The `` and '' ligatures are assigned \spacefactor's of 0, so that the
+%	\spacefactor that is applied to the next character is the same as that
+%	of the character preceding the quotes.  Because " has been redefined as
+%	a macro, any spaces following " are swallowed by TeX.  It was necessary
+%	to have this macro re-insert any needed space so that the following
+%	cases worked correctly:
+%
+%		"This is a test," she said. --> ``This is a test,'' she said.
+%		"This is in a list"; etc.   --> ``This is in a list''; etc.
+%
+%	Without the added space, the first example becomes:
+%
+%		``This is a test,''she said.
+%
+%	The solution was to save the current \spacefactor before inserting a
+%	right double-quote, then resetting the \spacefactor after the
+%	insertion.  The net effect was that the " macro has a \spacefactor
+%	of 0, which matches the way TeX treats `` and ''.
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+{%					% Begin a group for which " is active
+\catcode`\"=\active			% Make " an active character
+\catcode`\@=11				% Make @ an active character
+%
+%  \begindoublequotes
+%
+%	This macro makes " an active character, resets the control sequence
+%	\dblqu@te to L (left), and defines \dq as a replacement for ".
+%
+\gdef\begindoublequotes{%		% \begindoublequotes enables "
+    \global\catcode`\"=\active		% Make " an active character
+    \global\chardef\dq=`\"		% Double-quote char. via \dq
+    \global\let\dblqu@te=L		% Always start with a left double-quote
+    }					% End of macro
+%
+%  Define the macro that will be executed whenever " is encountered.
+%
+\gdef"{%
+	%  If the double-quote is the first character in a new paragraph,
+	%  make sure it becomes a left double-quote.  This case can be
+	%  detected by checking to see if TeX is currently in vertical mode.
+	%  If so, the double-quote is at the beginning of the paragraph
+	%  (since " hasn't actually generated any horizontal mode tokens
+	%  yet, TeX is still in vertical mode).  If the mode is vertical,
+	%  set \dblqu@te equal to L.
+	%
+	\ifinner\else\ifvmode\let\dblqu@te=L\fi\fi
+	%
+	%  Now insert the appropriate left or right double-quote.
+	%
+	%  If \dblqu@te is L, insert a `` and set \dblqu@te to R.
+	%
+	\if L\dblqu@te``\global\let\dblqu@te=R%
+	%
+	%  Otherwise, save the current \spacefactor, insert '', set \dblqu@te
+	%  to L, and reset the original \spacefactor.
+	%
+	\else
+	   \let\xxx=\spacefactor		% Save the \spacefactor
+	   ''\global\let\dblqu@te=L%		% Insert '' and reset \dblqu@te
+	   \spacefactor\xxx			% Reset the \spacefactor
+	\fi					% End of \if L\dblqu@te...
+	}					% End of " macro
+}						% End of group
+
+\gdef\enddoublequotes{%
+	\catcode`\"=12				%Set " back to other
+	}
diff --git a/Master/texmf-dist/doc/plain/newsletr/READ.ME b/Master/texmf-dist/doc/plain/newsletr/read.me
index 53d258b0d55..b500c4741d9 100644..100755
--- a/Master/texmf-dist/doc/plain/newsletr/READ.ME
+++ b/Master/texmf-dist/doc/plain/newsletr/read.me
@@ -1,22 +1,36 @@
-% Save file as: AAAREAD.ME             Source: FILESERV@SHSU.BITNET  
-
                  NEWSLETR - A newsletter format for Plain TeX
                                 Hunter Goatley
-                                August 21, 1991
+                               January 22, 2004
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Copyright 1989--2004 by Hunter Goatley.
+%
+% Permission is granted to anyone to use this software for any purpose
+% on any computer system, and to redistribute it freely, subject to the
+% following restrictions:
+%
+% 1. This software is distributed in the hope that it will be useful,
+%    but WITHOUT ANY WARRANTY; without even the implied warranty of
+%    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+%
+% 2. Altered versions must be plainly marked as such, and must not be
+%    misrepresented as being the original software.
+%
+% End
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-NEWSLETR is a file of plain TeX macros that has been used for the last few
-years to publish a newsletter about a horror author (Robert R. McCammon).
-Most of the macros are original, but some came from _The TeXbook_ and other
-sources; most of these have been either rewritten or modified.  The following
-files should be found here (and the names are short for people using MS-DOS):
+NEWSLETR is a file of plain TeX macros that I wrote to publish a printed
+newsletter about author Robert McCammon. Most of the macros are original,
+but some came from _The TeXbook_ and other sources; most of these have been
+either rewritten or modified.  The following files should be found here (and
+the names are short for people using MS-DOS):
 
-	AAAREAD.1ST	This file
-	NEWSLETR.TEX	The newsletter format
-	NEWSLETR.TXT	List of commands in newsletter format
-	NEWSSAMP.TEX	Sample newsletter file
-	NEWSSAMP.UUE	Uuencoded sample .DVI file
-	LODRIVER.TEX	Sample newsletter driver (part of a real newsletter)
-	LOSAMPLE.TEX	Sample newsletter title page, articles, etc.
+        READ.ME         This file
+        NEWSLETR.TEX    The newsletter format
+        NEWSLETR.TXT    List of commands in newsletter format
+        NEWSSAMP.TEX    Sample newsletter file
+        LODRIVER.TEX    Sample newsletter driver (part of a real newsletter)
+        LOSAMPLE.TEX    Sample newsletter title page, articles, etc.
 
 The format is for plain TeX, not LaTeX---real TeXies don't use LaTeX! 8-)
 Seriously, I developed my newsletter format because LaTeX wasn't flexible
@@ -30,8 +44,8 @@ Because the format file (NEWSLETR.TEX) is pretty big, I'd suggest that you
 create a new TeX format file that contains it.  Under VMS using DECUS TeX,
 the command would be:
 
-	$ TEX/INIT/NOFORMAT "&plain \input newsletr \dump"
-	$ TEX/FORMAT=newsletr
+        $ TEX/INIT/NOFORMAT "&plain \input newsletr \dump"
+        $ TEX/FORMAT=newsletr
 
 NEWSLETR is set up so that it can be used as an extended plain TeX (you have
 access to the macros, with all of TeX's default settings).  When building
@@ -59,18 +73,13 @@ following the parameter and add the italic correction unless the next character
 is a period or a comma, as recommended on page 14 of _The TeXbook_.  Using
 these macros, you should never need to type \/ again.  (ITALIC.TEX)
 
-I would appreciate being kept informed of bug fixes or improvements you make
-to the file.  To that end, I've created a mailing list that can be used to
-discuss the NEWSLETR format.  Feel free to post questions, problems, or
-solutions to the list; as usually with freeware, I can't promise support,
-but I use these macros too, and I'm willing to help whenever/wherever I can.
-To subscribe to the list, send e-mail with the body SUBSCRIBE NEWSLETR to
-LISTSERV@WKUVX1.BITNET.  Note that this isn't a real LISTSERV, so commands
-other than UNSUBSCRIBE and REVIEW won't work.
+I would appreciate being kept informed of bug fixes or improvements you make to
+the file.  I can't promise support, but I use these macros too, and I'm willing
+to help whenever/wherever I can.
 
 Questions, comments, or suggestions are welcome.
 
-Hunter Goatley, VAX Systems Programmer	    E-mail: goathunter@WKUVX1.BITNET
-Academic Computing, STH 226		    Voice:  (502) 745-5251
-Western Kentucky University
-Bowling Green, KY 42101
+Hunter
+------
+Hunter Goatley, Process Software, http://www.process.com/
+<goathunter@GOATLEY.COM>     http://www.goatley.com/hunter/
diff --git a/Master/texmf-dist/doc/plain/newsletr/sample.dvi b/Master/texmf-dist/doc/plain/newsletr/sample.dvi
deleted file mode 100644
index 6172555f9aa..00000000000
--- a/Master/texmf-dist/doc/plain/newsletr/sample.dvi
+++ /dev/null
diff --git a/Master/texmf-dist/doc/plain/newsletr/sample.pdf b/Master/texmf-dist/doc/plain/newsletr/sample.pdf
new file mode 100644
index 00000000000..455a95ba275
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/newsletr/sample.pdf