From eb0ca0896a18ae41f243b3f096f2bb4737a8c2e2 Mon Sep 17 00:00:00 2001 From: Manuel Pégourié-Gonnard Date: Fri, 4 Jul 2008 14:16:50 +0000 Subject: newsletr v01-016 22-Jan-2004 git-svn-id: svn://tug.org/texlive/trunk@9229 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/plain/newsletr/READ.ME | 76 -------------- Master/texmf-dist/doc/plain/newsletr/italic.tex | 37 +++++++ Master/texmf-dist/doc/plain/newsletr/lodriver.tex | 56 ++++++++++ Master/texmf-dist/doc/plain/newsletr/losample.tex | 1 - Master/texmf-dist/doc/plain/newsletr/newsletr.txt | 1 - Master/texmf-dist/doc/plain/newsletr/newssamp.pdf | Bin 0 -> 55591 bytes Master/texmf-dist/doc/plain/newsletr/newssamp.tex | 1 - Master/texmf-dist/doc/plain/newsletr/quote.tex | 118 ++++++++++++++++++++++ Master/texmf-dist/doc/plain/newsletr/read.me | 85 ++++++++++++++++ Master/texmf-dist/doc/plain/newsletr/sample.dvi | Bin 12288 -> 0 bytes Master/texmf-dist/doc/plain/newsletr/sample.pdf | Bin 0 -> 95640 bytes 11 files changed, 296 insertions(+), 79 deletions(-) delete mode 100644 Master/texmf-dist/doc/plain/newsletr/READ.ME create mode 100755 Master/texmf-dist/doc/plain/newsletr/italic.tex create mode 100755 Master/texmf-dist/doc/plain/newsletr/lodriver.tex create mode 100644 Master/texmf-dist/doc/plain/newsletr/newssamp.pdf create mode 100755 Master/texmf-dist/doc/plain/newsletr/quote.tex create mode 100755 Master/texmf-dist/doc/plain/newsletr/read.me delete mode 100644 Master/texmf-dist/doc/plain/newsletr/sample.dvi create mode 100644 Master/texmf-dist/doc/plain/newsletr/sample.pdf (limited to 'Master/texmf-dist/doc/plain/newsletr') diff --git a/Master/texmf-dist/doc/plain/newsletr/READ.ME b/Master/texmf-dist/doc/plain/newsletr/READ.ME deleted file mode 100644 index 53d258b0d55..00000000000 --- a/Master/texmf-dist/doc/plain/newsletr/READ.ME +++ /dev/null @@ -1,76 +0,0 @@ -% Save file as: AAAREAD.ME Source: FILESERV@SHSU.BITNET - - NEWSLETR - A newsletter format for Plain TeX - Hunter Goatley - August 21, 1991 - -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): - - 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. - -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 -enough for the stuff I wanted to do---namely multiple columns (1--6 columns), -switching columns on the same page, and including figures. - -When you see it, some of the stuff will look kludged---but it sounds like -what some of you are using now was kludged, so it shouldn't be much worse! - -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 - -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 -a newsletter, you can execute \newspage to use pages that are a little taller -and wider (7" x 9") and to change some of TeX's penalties, etc. - -Finally, I would like to point out a couple of features that I think would be -useful for anybody who uses TeX for any reason. I've extracted these two -pieces into separate files so that you can easily include them in other -documents. - -As you all know, TeX requires that you use `` and '' instead of " to get -proper double-quotes. I have written a macro that will let the double-quote -character (") work like `` and ''. It assumes that they come in pairs, except -that a " as the first character of a paragraph is treated as ``. To enable -the double-quote recognition, simply add \begindoublequotes to your file. -(You can disable it using \enddoublequotes.) Proper spacing after '' is -maintained. (QUOTE.TEX) - -I've also included macros \ital and \slant for typesetting text in the -italic (\it) and slanted (\sl) fonts, respectively. A lot of people don't -seem to know about---or forget to use---the italic correction (\/) when -switching among fonts. The \ital and \slant macros look at the next character -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. - -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 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 Binary files /dev/null and b/Master/texmf-dist/doc/plain/newsletr/newssamp.pdf 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 new file mode 100755 index 00000000000..b500c4741d9 --- /dev/null +++ b/Master/texmf-dist/doc/plain/newsletr/read.me @@ -0,0 +1,85 @@ + NEWSLETR - A newsletter format for Plain TeX + Hunter Goatley + 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 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): + + 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 +enough for the stuff I wanted to do---namely multiple columns (1--6 columns), +switching columns on the same page, and including figures. + +When you see it, some of the stuff will look kludged---but it sounds like +what some of you are using now was kludged, so it shouldn't be much worse! + +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 + +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 +a newsletter, you can execute \newspage to use pages that are a little taller +and wider (7" x 9") and to change some of TeX's penalties, etc. + +Finally, I would like to point out a couple of features that I think would be +useful for anybody who uses TeX for any reason. I've extracted these two +pieces into separate files so that you can easily include them in other +documents. + +As you all know, TeX requires that you use `` and '' instead of " to get +proper double-quotes. I have written a macro that will let the double-quote +character (") work like `` and ''. It assumes that they come in pairs, except +that a " as the first character of a paragraph is treated as ``. To enable +the double-quote recognition, simply add \begindoublequotes to your file. +(You can disable it using \enddoublequotes.) Proper spacing after '' is +maintained. (QUOTE.TEX) + +I've also included macros \ital and \slant for typesetting text in the +italic (\it) and slanted (\sl) fonts, respectively. A lot of people don't +seem to know about---or forget to use---the italic correction (\/) when +switching among fonts. The \ital and \slant macros look at the next character +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. 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 +------ +Hunter Goatley, Process Software, http://www.process.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 Binary files a/Master/texmf-dist/doc/plain/newsletr/sample.dvi and /dev/null 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 Binary files /dev/null and b/Master/texmf-dist/doc/plain/newsletr/sample.pdf differ -- cgit v1.2.3