Package: maint-guide Version: 1.2.39 Severity: normal Tags: patch --
I have read the Maintainer's Guide, and while reading it also
proofread it. The patch file addresses typos and some grammar (such
as "which" versus "that"). I also made some typography-related
changes:
"..." became a horizontal ellipsis ("…" aka Unicode code point U+2026)
"-" became, according to context, an en-dash ("–" aka U+2013),
an em-dash ("—" aka U+2014), or remained a hyphen.
The HTML5 entities for the above symbols are not defined in the
maint-guide files; for reference, they are:
U+2026: …
U+2013: –
U+2014: —
See, for example, "https://www.w3schools.com/charsets/ref_utf_punctuation.asp";.
If not a huge effort, it would be good to add XML entities defining
those code points to match their HTML5 entity definitions, since
maint-guide uses them frequently.
On the various types of dashes, a good reference is _The TeXbook_ by
Donald Knuth. On p. 4 of my copy, he says:
"Book printing differs significantly from ordinary typing with respect
to dashes, hyphens, and minus signs. In good math books, these
symbols are all different; in fact there usually are at least four
different symbols:
a hyphen (-);
an en-dash (–);
an em-dash (—);
a minus sign (−).
"Hyphens are used for compound words like 'daughter-in-law' and
'X-rated'. En-dashes are used for number ranges like 'pages 13–34',
and also in contexts like 'exercise 1.26–52'. Em-dashses are used for
punctuation in sentences—they are what we often call simply dashes.
And minus signs are used in formulas."
If more convenient, I could send an attachment of the entire gzipped
"doc-new" directory. There are over 100 changes, and all the chapters
are modified. I have not changed anything substantive, but will file
a couple of non-typo-related bugs for other aspects of maint-guide.
Thanks,
Paul Hardy
doc-patches.txt.gz
Description: GNU Zip compressed data
