summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain/newsletr/READ.ME
blob: 53d258b0d5532d10732d7410ad2bd1885a0d49d1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
% 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