summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain/impatient/errata.future
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/plain/impatient/errata.future')
-rw-r--r--Master/texmf-dist/doc/plain/impatient/errata.future112
1 files changed, 27 insertions, 85 deletions
diff --git a/Master/texmf-dist/doc/plain/impatient/errata.future b/Master/texmf-dist/doc/plain/impatient/errata.future
index 78ed14aba37..12e944fc552 100644
--- a/Master/texmf-dist/doc/plain/impatient/errata.future
+++ b/Master/texmf-dist/doc/plain/impatient/errata.future
@@ -1,39 +1,31 @@
-$Id: errata.future,v 1.2 2011/01/27 22:16:24 karl Exp $
+$Id: errata.future,v 1.7 2020/01/02 23:45:45 karl Exp $
-Ideas for future changes. Did not make these in the free edition since
-I didn't want to change the page breaks because I didn't want to install
-Icon so I could regenerate the index -- aside from lack of time and
-inclination. :) See the README.
+Ideas for future changes. (This file is public domain.)
+Did not make these in the free edition since I didn't want to change the
+page breaks because I didn't want to install Icon (or more likely
+rewrite to use makeindex or texindex) so I could regenerate the index.
+See the README.
- incorporate the images in the artwork/ subdirectory.
- discuss CTAN, other Internet resources, plain or generic macro
packages, and so on.
-- extend with descriptions of e-TeX, pdftex, omega.
+- extend with descriptions of e-TeX, pdftex, xetex, luatex.
-- html output, perhaps using tex2page.
- http://www.ccs.neu.edu/home/dorai/tex2page/tex2page-doc.html
- (tex4ht did nothing useful with it, but maybe with work ...)
+- html output, perhaps using tex2page,
+ http://www.ccs.neu.edu/home/dorai/tex2page/tex2page-doc.html
+ though more likely using tex4ht, with work:
+ https://tug.org/tex4ht
+- use pdftex's hz line breaking for better-looking paragraphs (and to
+ reduce rewriting for overfull boxes).
-from Will Adams:
- - p. 105 (and throughout) the encoding for Zapf Dingbats doesn't
-agree w/ what was used and instead of a right pointing hand dingbat, a
-Star of David appears on the .pdf
-
- - p. 113 - text overlaps / crashes here, I think 'cause some stuff
-escaped out of Verbatim mode.
-
- - colophon - this appears on a verso, not a recto, which I find a bit odd.
-
-One last bit of consideration is how you want to handle the cover /
-frontmatter.
-
-
-from Karl and Kathy:
+
+From Karl and Kathy (now in 2020 ... some of these changes seem unnecessary
+to Karl, but leaving them listed for any future maintainer to consider):
* The default values should probably be in roman everywhere. I don't
think `6pt plus 1pt minus 2pt' looks bad in roman any more, which was
@@ -73,28 +65,15 @@ file extension. `{\sc DVI}' would be more appropriate.
too high and too far to the left. This is probably a consequence of
\chapter changing and \shortchapter not.
-
+
(The rest of the changes are by page number.)
-1 Section 13 is also designed to be accessed randomly. Also, wouldn't it
-be better to use section names as well as numbers?
+1 It would be nice to use section names as well as numbers.
7 (first para) local information tells you => local information will
tell you, since they couldn't have found it yet.
-9 (first para) by typing something => by first typing something, since
-they have to do more to input screed.
-(bottom) unclosed left parenthesis => unmatched left parenthesis.
-
-10 The third in the subsection (with ``typeset me'') looks like it has
-extra space in it.
-
-12 (bottom) supposed to produce => supposed to do, because the macro
-might not be supposed to produce anything at all.
-
-16 Say that TeX does its own spacing in formulas. This is probably the
-most crucial fact about doing math in TeX. Index `spacing, in formulas'
-and `formulas, spacing in'.
+16 Index `spacing, in formulas' and `formulas, spacing in'.
(math formulas) can appear in text ... or set off => can appear in
text ... or can appear set off, for structure.
enclose a text formula in => enclose a text formula within
@@ -109,8 +88,8 @@ commands in the first example go into it.
(bottom) is defined in plain TeX => is either a primitive or defined
in plain TeX.
-22 You use the en-dash in the place where an em-dash should be in the
-last sentence.
+22 There's an en-dash in the place (before the first "like so") where an
+em-dash should be in the last sentence. Needs rewording.
23 (three instances near the top) The comments should have periods at
the end and be capitalized properly. We are remarkably inconsistent on
@@ -123,13 +102,6 @@ and not capitalized.
hard time => If we hadn't ..., you would have had ..., to remove the
time warp.
-25 % The left brace start => % The { starts, to shorten the line.
-(middle) % Skips like this => % Skips like that, because one of the
-skips was just given.
-
-26 fonts won't give you => fonts don't give you
-page 100 and page 97 => pages 97 and 100
-
32 (bottom) try to use these commands => try to use those commands,
since the commands are above the comment.
Also, they can get lists with more levels than one by using the Eplain
@@ -138,12 +110,6 @@ list stuff, instead of programming it themselves, alas.
34 The title might be better as `Using non-Computer Modern fonts' or
something, since we haven't said what the first source is.
-37 (towards the top) => Use \vtop for short multiline entries => Use
-\vtop to get whole paragraphs, since ``multiline entries'' is a pretty
-stupid term (that I wrote).
-(towards the bottom) % without the kern, the `f' and `l' would be too
-close => % Without the kern, the `f' and `l' would be a ligature.
-
44 (after example input) Put the page reference (p.176) after the
`\settabs 2 \columns'.
@@ -168,19 +134,6 @@ could be moved down.)
(the list) the box (or rule) => the box or rule, because the rule
case isn't subordinate or anything. This is in both items.
-53 In `cgrok', the `c' is too close to the `grok'. I realize it
-shouldn't be a full space, but right now they're practically touching.
-Italic correction? Explicit space?
-
-54 (first line) It would be nice to say the names of categories 11--13.
-(third para from top) Chars in categories 11 and 12 don't mean
-``produce a box containing this character typeset in the current font''.
-They don't produce a box, for one thing. And they don't typeset ``this
-character'', either. They typeset whatever is in the font at their
-character code. I don't know how you want to explain this, but I think
-this is seriously wrong.
-(example) control sequence `foo$' => control sequence `\foo$'
-
55 (second para) Same problem with characters vs. character code. The
input letter `h' is not transformed into the letter `h' typeset in the
current font. It's transformed into the character at position 104.
@@ -192,15 +145,6 @@ think).
(two more paras) An example showing the 64 less/greater stuff would be
nice.
-56 (under class) is in class 3 => has class 3, because the class is
-really an attribute of a character, not an external set of characters.
-(before class example) Wouldn't ``arbitrarily changed'' be better
-than ``randomly changed''? (Unless you really used a random number
-generator.)
-(first para of command concept): same problem with characters. TeX
-doesn't construct a box containing that character typeset in the current
-font.
-
57 (under control sequence) with an escape character, usually a
backslash (\) => with an escape character, which is usually the
backslash character, since \ isn't always an escape character.
@@ -234,7 +178,7 @@ other way to make one.
66 (example) the shrinks are 1 and 3, whereas the shrinks on the next
page are 2 and 6. Might as well make them all the same.
-69 {\TeX} => \TeX{} (if we must keep this horrible example).
+69 {\TeX} => \TeX{} (if we must keep this example).
71 The item concept is pretty useless as it is; it would be nice to say
what the possible items were, and clearly distinguish items from tokens,
@@ -243,8 +187,8 @@ etc.
72 (towards the bottom) insured that the dots => made the dots, because
we've done something active than ``insure''.
-73 (ligature) the '' and , in office'', aren't kerned. You put
-``office'' in an \hbox for some reason.
+73 (ligature) the '' and , in office'', aren't kerned. The word
+``office'' is in an \hbox, not sure why.
80 (math mode) Should say that display math gives you space above and
below the formula.
@@ -257,12 +201,10 @@ text and the headers or footers.
217 \mathsurround should make an index entry for `formulas, spacing
around' or something like that.
-224 I think `Converting information to tokens' is really a misnomer.
-How about just calling it `Conversions' and making `Environmental
-information' its own section.
+224 I think `Converting information to tokens' is really a misnomer.
+Maybe just call it `Conversions' and making `Environmental information'
+its own section.
263 `Ending the job' should be next to `Initializing TeX'.
294 Have an index entry for `logos'.
-
-298 \unnumberedlist has become \unorderedlist.