summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain/newsletr
diff options
context:
space:
mode:
authorManuel Pégourié-Gonnard <mpg@elzevir.fr>2008-07-04 14:16:50 +0000
committerManuel Pégourié-Gonnard <mpg@elzevir.fr>2008-07-04 14:16:50 +0000
commiteb0ca0896a18ae41f243b3f096f2bb4737a8c2e2 (patch)
treee888952a01584e0e1baf628429a437922e6619cc /Master/texmf-dist/doc/plain/newsletr
parent846eb2662596380d270e987384a1c636441999c5 (diff)
newsletr v01-016 22-Jan-2004
git-svn-id: svn://tug.org/texlive/trunk@9229 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/plain/newsletr')
-rwxr-xr-xMaster/texmf-dist/doc/plain/newsletr/italic.tex37
-rwxr-xr-xMaster/texmf-dist/doc/plain/newsletr/lodriver.tex56
-rw-r--r--Master/texmf-dist/doc/plain/newsletr/losample.tex1
-rw-r--r--Master/texmf-dist/doc/plain/newsletr/newsletr.txt1
-rw-r--r--Master/texmf-dist/doc/plain/newsletr/newssamp.pdfbin0 -> 55591 bytes
-rw-r--r--Master/texmf-dist/doc/plain/newsletr/newssamp.tex1
-rwxr-xr-xMaster/texmf-dist/doc/plain/newsletr/quote.tex118
-rwxr-xr-x[-rw-r--r--]Master/texmf-dist/doc/plain/newsletr/read.me (renamed from Master/texmf-dist/doc/plain/newsletr/READ.ME)67
-rw-r--r--Master/texmf-dist/doc/plain/newsletr/sample.dvibin12288 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/plain/newsletr/sample.pdfbin0 -> 95640 bytes
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
Binary files differ
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
Binary files differ
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
Binary files differ