[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: Use "e.g." correctly in documentation, comments.
|
From: |
G. Branden Robinson |
|
Subject: |
[groff] 01/01: Use "e.g." correctly in documentation, comments. |
|
Date: |
Sun, 22 Oct 2017 18:54:52 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 7ada398dfcef9645c113bc4356833dc65f876488
Author: G. Branden Robinson <address@hidden>
Date: Sun Oct 22 18:49:53 2017 -0400
Use "e.g." correctly in documentation, comments.
The Latin phrase "exempli gratia" is abbreviated "e.g." in English, and
means "for example", so it gets set off with commas just as the latter
would.
Stay within 80 columns in files that respect that limit.
Kill nearby useless trailing whitespace where it was obvious.
Signed-off-by: G. Branden Robinson <address@hidden>
---
contrib/mom/examples/mom-pdf.mom | 2 +-
contrib/mom/momdoc/appendices.html | 2 +-
contrib/mom/momdoc/cover.html | 2 +-
contrib/mom/momdoc/definitions.html | 14 ++++----
contrib/mom/momdoc/docelement.html | 52 +++++++++++++++---------------
contrib/mom/momdoc/docprocessing.html | 34 +++++++++----------
contrib/mom/momdoc/headfootpage.html | 16 ++++-----
contrib/mom/momdoc/images.html | 4 +--
contrib/mom/momdoc/inlines.html | 12 +++----
contrib/mom/momdoc/letters.html | 4 +--
contrib/mom/momdoc/rectoverso.html | 4 +--
contrib/mom/momdoc/refer.html | 22 ++++++-------
contrib/mom/momdoc/tables-of-contents.html | 6 ++--
contrib/mom/momdoc/typesetting.html | 16 ++++-----
contrib/mom/momdoc/using.html | 2 +-
contrib/mom/om.tmac-u | 12 +++----
font/devps/generate/Makefile | 2 +-
src/preproc/eqn/TODO | 2 +-
src/preproc/pic/pic.ypp | 2 +-
src/preproc/pic/troff.cpp | 2 +-
src/preproc/refer/TODO | 2 +-
src/roff/troff/TODO | 4 +--
src/roff/troff/div.cpp | 4 +--
src/roff/troff/env.cpp | 2 +-
src/roff/troff/input.cpp | 4 +--
tmac/TODO | 2 +-
tmac/an-old.tmac | 2 +-
27 files changed, 116 insertions(+), 116 deletions(-)
diff --git a/contrib/mom/examples/mom-pdf.mom b/contrib/mom/examples/mom-pdf.mom
index 328b1b4..b9388b1 100644
--- a/contrib/mom/examples/mom-pdf.mom
+++ b/contrib/mom/examples/mom-pdf.mom
@@ -605,7 +605,7 @@ is not compatible with
.PDF_WWW_LINK \
http://www.schaffter.ca/mom/momdoc/docprocessing.html#printstyle \
"PRINTSTYLE TYPEWRITE"
-underlining (eg of italics)
+underlining (e.g., of italics)
.ITEM
generally produces larger files; these can be reduced by piping
the output through \[ps2pdf]\*[B]
diff --git a/contrib/mom/momdoc/appendices.html
b/contrib/mom/momdoc/appendices.html
index dc8e566..37e05ff 100644
--- a/contrib/mom/momdoc/appendices.html
+++ b/contrib/mom/momdoc/appendices.html
@@ -637,7 +637,7 @@ of the form
<span class="pre-in-pp">
internalname <name>
</span>
-Usually, the internal name is helpfully descriptive, eg,
+Usually, the internal name is helpfully descriptive, e.g.,
<br/>
<span class="pre-in-pp">
internalname Optima-Bold
diff --git a/contrib/mom/momdoc/cover.html b/contrib/mom/momdoc/cover.html
index c58684c..9aea902 100644
--- a/contrib/mom/momdoc/cover.html
+++ b/contrib/mom/momdoc/cover.html
@@ -154,7 +154,7 @@ arguments you pass to
and/or
<a href="#cover">COVER</a>.
Provided you have already given mom the appropriate reference macros
-(eg
+(e.g.,
<a href="docprocessing.html#title">TITLE</a>
or
<a href="docprocessing.html#author">AUTHOR</a>),
diff --git a/contrib/mom/momdoc/definitions.html
b/contrib/mom/momdoc/definitions.html
index 806d69b..97bcf67 100644
--- a/contrib/mom/momdoc/definitions.html
+++ b/contrib/mom/momdoc/definitions.html
@@ -232,7 +232,7 @@ or concept you’re not familiar with.
<dd>
The collective name by which a collection of
<a href="#font">fonts</a>
- are known, eg Helvetica, Times Roman, Garamond.
+ are known, e.g., Helvetica, Times Roman, Garamond.
</dd>
<dt id="figurespace">Figure space/Digit space</dt>
@@ -270,7 +270,7 @@ or concept you’re not familiar with.
<a href="#shape">shape</a>
of type within a
<a href="#family">family</a>,
- eg light, medium, bold (which are weights), and roman, italic,
+ e.g., light, medium, bold (which are weights), and roman, italic,
condensed (which are shapes). By default, groff knows of four
fonts within its default set of families: R (medium roman), I
(medium italic), B (bold roman) and BI (bold italic).
@@ -796,7 +796,7 @@ or concept you’re not familiar with.
<p>
You can enter decimal values for any unit of measure. Different
- units may be combined by adding them together (eg 1.5i+2m,
+ units may be combined by adding them together (e.g., 1.5i+2m,
which gives a measure of 1-1/2 inches plus 2 ems).
</p>
@@ -855,7 +855,7 @@ or concept you’re not familiar with.
<dd>
Macros used in
<a href="docprocessing.html#docprocessing">document processing</a>
- to control/alter the appearance of document elements (eg
+ to control/alter the appearance of document elements (e.g.,
headings, quotes, footnotes,
<a href="#header">headers</a>,
etc.).
@@ -920,7 +920,7 @@ or concept you’re not familiar with.
<a href="#running">running text</a>,
frequently set off by typographic symbols such as asterisks or
daggers. Used to indicate a shift in the content of a document
- (eg a scene change in a short story). Also commonly called a
+ (e.g., a scene change in a short story). Also commonly called a
scene break or a section break.
</dd>
@@ -940,14 +940,14 @@ or concept you’re not familiar with.
<dt id="pdfoutline">PDF outline</dt>
<dd>
The hierarchically-arranged navigation outline provided by most PDF
- viewers (eg Okular, Evince), typically in a panel to the left of
+ viewers (e.g., Okular, Evince), typically in a panel to the left of
the document window, and usually labeled “Contents”.
</dd>
<dt id="quote">Quote</dt>
<dd>
A quote, to mom, is a line-for-line setting
- of quoted material (eg poetry, song lyrics, or a snippet of
+ of quoted material (e.g., poetry, song lyrics, or a snippet of
programming code). You don’t have to use
<a href="typesetting.html#br"><kbd>BR</kbd></a>
with quotes.
diff --git a/contrib/mom/momdoc/docelement.html
b/contrib/mom/momdoc/docelement.html
index cd1ffa2..642e3ab 100644
--- a/contrib/mom/momdoc/docelement.html
+++ b/contrib/mom/momdoc/docelement.html
@@ -665,7 +665,7 @@ Note that mom does not provide widow or orphan control for
paragraphs (ie even if only one line of a paragraph fits at the
bottom of a page, she will set it on that page). The reason for
this is that writers of fiction often have single-line paragraphs
-(eg in dialogue). Groff’s simplistic orphan control will
+(e.g., in dialogue). Groff’s simplistic orphan control will
break these one-liners—if they fall at the bottom of the
page—to a new page, which is not what you want.
</p>
@@ -750,7 +750,7 @@ If you wish to change the family for regular text
paragraphs only,
invoke <kbd>.FAMILY</kbd> immediately after <kbd>.PP</kbd> in every
paragraph whose family you wish to differ from the prevailing
document family. Alternatively, set the family and font for
-paragraphs with PP_FONT, giving it a complete family+font name, eg
+paragraphs with PP_FONT, giving it a complete family+font name, e.g.,
<br/>
<span class="pre-in-pp">
PP_FONT TI
@@ -1124,7 +1124,7 @@ bookmark for
<p>
Headings can also be numbered on a per-heading-level basis,
-hierarchically and concatenatively, eg
+hierarchically and concatenatively, e.g.,
<br/>
<span class="pre-in-pp">
1.
@@ -1383,7 +1383,7 @@ appended to it.
<p class="defaults" style="margin-bottom: 1em">
<kbd>NEEDS</kbd> lets you reserve the number of lines of text
-required beneath a heading, including fractions thereof (eg
+required beneath a heading, including fractions thereof (e.g.,
“1.5” for one line of text plus half a linespace).
If a heading falls near the bottom margin and there isn’t
sufficient room for both the heading and the reserved space, mom
@@ -1512,7 +1512,7 @@ numbered head element of each collated document).
<p>
PREFIX_CHAPTER_NUMBER can be disabled by passing it any argument
-other than a digit (eg <b>OFF, QUIT, END, X</b>, etc), although,
+other than a digit (e.g., <b>OFF, QUIT, END, X</b>, etc), although,
as noted above, mom will keep, and—in the case of collated
documents—increment the chapter number, allowing you to turn
prefixing of chapter numbers to numbered head elements off and on
@@ -1824,7 +1824,7 @@ Mom will alert you to this on stderr.
<p>
Linebreaks (“author linebreaks”, “section
breaks”) are gaps in the vertical flow of running text that
-indicate a shift in content (eg a scene change in story). They
+indicate a shift in content (e.g., a scene change in story). They
are frequently set off by typographic symbols, sometimes whimsical
in nature.
</p>
@@ -1884,7 +1884,7 @@ and a vertical adjustment factor.
</p>
<p>
-The first argument is any valid groff character (eg <kbd>*</kbd>
+The first argument is any valid groff character (e.g., <kbd>*</kbd>
[an asterisk], <kbd>\[dg]</kbd> [a dagger], <kbd>\f[ZD]\N'141\fP</kbd>
[an arbitrary character from Zapf Dingbats], <kbd>\l'4P'</kbd> [a
4-pica long rule]). Mom sets the character centred on the current
@@ -1988,7 +1988,7 @@ or underlined
indented from the left margin. Obviously, she’s thinking
“quotes from poetry or song lyrics”, but with the
<a href="#quote-control">QUOTE control macros</a>
-you can change her defaults so QUOTE serves other needs, eg
+you can change her defaults so QUOTE serves other needs, e.g.,
entering verbatim snippets of programming code, command-line
instructions, and so on. (See the
<a href="#code">CODE</a>
@@ -2101,7 +2101,7 @@ Macro: <b>QUOTE</b> <kbd class="macro-args">[ ADJUST
+|-<space> ] | <an
<p>
QUOTE is a toggle macro. To begin a section of quoted text, invoke
it with no argument, then type in your quote. When you’re
-finished, invoke <kbd>.QUOTE</kbd> with any argument (eg <kbd>OFF,
+finished, invoke <kbd>.QUOTE</kbd> with any argument (e.g., <kbd>OFF,
END, X, Q</kbd>...) to turn it off. Example:
<br/>
<span class="pre-in-pp">
@@ -2322,7 +2322,7 @@ Macro: <b>BLOCKQUOTE</b> <kbd class="macro-args">[
ADJUST +|-<space> ] |
BLOCKQUOTE is a toggle macro. To begin a cited passage, invoke
the tag with no argument, then type in your blockquote. When
you’re finished, invoke <kbd>.BLOCKQUOTE</kbd> with any
-argument (eg <kbd>OFF, END, X, Q</kbd>...) to turn it off.
+argument (e.g., <kbd>OFF, END, X, Q</kbd>...) to turn it off.
Example:
<br/>
<span class="pre-in-pp">
@@ -2553,7 +2553,7 @@ it as well, invoke <kbd>.CODE</kbd> with the argument,
you want a break afterwards, you must supply it manually with
<a href="typesetting.html#br">BR</a>
unless what follows immediately is a macro that automatically causes
-a break (eg
+a break (e.g.,
<a href="#pp">PP</a>).
</p>
@@ -2581,7 +2581,7 @@ introducing unwanted vertical whitespace.
<p>
Passing any argument other than <kbd>BR</kbd>, <kbd>BREAK</kbd> or
-<kbd>SPREAD</kbd> to CODE (eg <kbd>OFF, QUIT, END, X,</kbd> etc.)
+<kbd>SPREAD</kbd> to CODE (e.g., <kbd>OFF, QUIT, END, X,</kbd> etc.)
turns CODE off and returns the family, font, and smartquotes back to
their former state.
</p>
@@ -2820,7 +2820,7 @@ uppercase letters), <kbd>alpha</kbd> (for lowercase
letters),
<p>
The arguments, <kbd>ROMAN<n></kbd> and
<kbd>roman<n></kbd>, are special. You must append to them
-a digit (arabic, eg "1" or "9" or "17") saying how many items a
+a digit (arabic, e.g., "1" or "9" or "17") saying how many items a
particular roman-numeralled LIST is going to have. Mom requires this
information in order to align roman numerals sensibly, and will
abort—with a message — if you don’t provide it.
@@ -2988,7 +2988,7 @@ which would produce
Any single argument to <kbd>LIST</kbd> other than
<kbd>BULLET</kbd>, <kbd>DASH</kbd>, <kbd>DIGIT</kbd>,
<kbd>ALPHA</kbd>, <kbd>alpha</kbd>, <kbd>ROMAN<n></kbd>,
-<kbd>roman<n></kbd> or <kbd>USER</kbd> (eg
+<kbd>roman<n></kbd> or <kbd>USER</kbd> (e.g.,
<kbd>LIST OFF</kbd> or <kbd>LIST BACK</kbd>) takes you out
of the current list.
</p>
@@ -3373,7 +3373,7 @@ you must, at a minimum, tell it what line number you want
the
<a href="definitions.html#outputline">output line</a>
to have. The optional arguments <kbd>which lines to number</kbd>
and <kbd>gutter</kbd> allow you to state which lines should
-be numbered (eg every five or every ten lines), and the gutter to
+be numbered (e.g., every five or every ten lines), and the gutter to
place between line numbers and
<a href="definitions.html#running">running text</a>.
</p>
@@ -3838,7 +3838,7 @@ they’ll know the entry belongs to the previous
page).
</p>
<p>
-Very exceptionally, two footnotes may have to be deferred (eg one
+Very exceptionally, two footnotes may have to be deferred (e.g., one
occurs on the second to last line of a page, and another on the last
line). In such a circumstance, mom does not add
a blank after the second deferred footnote. If you’d like a blank
@@ -4317,12 +4317,12 @@ footnotes either by single line numbers, or line
ranges. If
what you want is a single line number, you need only invoke
<kbd>.FOOTNOTE</kbd>, <i>without the terminating</i> <kbd>\c</kbd>,
at the appropriate place in running text. Input lines after the
-footnote has been terminated (eg with <kbd>.FOOTNOTE OFF</kbd>)
+footnote has been terminated (e.g., with <kbd>.FOOTNOTE OFF</kbd>)
must begin at the left margin.
</p>
<p>
-If you want a range of line numbers (eg [5-11] ),
+If you want a range of line numbers (e.g., [5-11] ),
insert, directly into the first line of the range you want,
the <a href="definitions.html#inlines">inline escape</a>,
<kbd>\*[FN_MARK]</kbd>. For the terminating line number of the
@@ -4692,7 +4692,7 @@ is removed.
By default, mom starts the endnotes page with a bold, centred head,
“ENDNOTES”. Subsequently, for each section in a
<a href="rectoverso.html#collate-intro">collated</a>
-document (eg chapters in a book), she identifies the section in bold
+document (e.g., chapters in a book), she identifies the section in bold
type, flush left and underscored, followed by one-half linespace.
Endnotes pertaining to the section are output underneath, identified
by superscript numbers. The text of the endnotes themselves is
@@ -5068,7 +5068,7 @@ Macro: <b>ENDNOTE_SPACING</b> <kbd
class="macro-args"><space to insert betwee
<p>
If you'd like some whitespace between endnotes, just invoke
-ENDNOTE_SPACING with the amount of space you want, eg
+ENDNOTE_SPACING with the amount of space you want, e.g.,
<br/>
<span class="pre-in-pp">
.ENDNOTE_SPACING 6p
@@ -5522,7 +5522,7 @@ Invoked without an argument,
<kbd>.ENDNOTES_HEADER_UNDERSCORE</kbd>
will place a single rule underneath the endnotes page title. Invoked
with the argument, <kbd>DOUBLE</kbd>, ENDNOTES_HEADER_UNDERSCORE will
double-underscore the title. Invoked with any other non-numeric
-argument, (eg <kbd>OFF, NO, X</kbd>, etc.) the macro disables
+argument, (e.g., <kbd>OFF, NO, X</kbd>, etc.) the macro disables
underscoring of the title.
</p>
@@ -5683,7 +5683,7 @@ endnotes either by single line numbers or by line ranges.
If
what you want is a single line number, you need only invoke
<kbd>.ENDNOTE</kbd> at the appropriate place in running
text <i>without the terminating</i> <kbd>\c</kbd>. Input lines
-after the endnote has been terminated (eg with <kbd>.ENDNOTE
+after the endnote has been terminated (e.g., with <kbd>.ENDNOTE
OFF</kbd>) must begin at the left margin.
</p>
@@ -5697,7 +5697,7 @@ nothing to prevent you from doing so.)
</p>
<p id="en-mark">
-If you want a range of line numbers (eg [5-11] ),
+If you want a range of line numbers (e.g., [5-11] ),
insert, directly into the first line of the range you want, the
<a href="definitions.html#inlines">inline escape</a>,
<kbd>\*[EN-MARK]</kbd>. For the terminating line number of the
@@ -5774,7 +5774,7 @@ If you need less space (the total number of endnotes is
less than 10) or
more (the total number of endnotes is greater than 99), use the
macro,
<a href="docelement.html#endnote-numbers-align">ENDNOTE_NUMBERS_ALIGN</a>,
-to set the desired amount of reserved space, eg
+to set the desired amount of reserved space, e.g.,
<br/>
<span class="pre-in-pp">
.ENDNOTE_NUMBERS_ALIGN RIGHT 1
@@ -6153,7 +6153,7 @@ If you forget to do so, mom will issue a warning and
abort.
<p>
The arguments may be entered in any order, and since the list is
long, use of the backslash character ( <kbd>\</kbd> ) to put each on
-a separate line is recommended, eg.
+a separate line is recommended, e.g.,
<br/>
<span class="pre-in-pp">
.MN_INIT \
@@ -6463,7 +6463,7 @@ this:
<span class="pre-in-pp">
.FINIS_STRING_CAPS OFF
</span>
-<kbd>OFF</kbd>, above, could be anything, eg <kbd>NO</kbd> or
+<kbd>OFF</kbd>, above, could be anything, e.g., <kbd>NO</kbd> or
<kbd>X</kbd>.
</p>
diff --git a/contrib/mom/momdoc/docprocessing.html
b/contrib/mom/momdoc/docprocessing.html
index 6250ca1..54cf30d 100644
--- a/contrib/mom/momdoc/docprocessing.html
+++ b/contrib/mom/momdoc/docprocessing.html
@@ -169,7 +169,7 @@ macros that control how they look and behave.
Setting up a mom doc is a simple, four-part procedure. You
begin by entering metadata about the document itself (title,
subtitle, author, etc.). Next, you tell mom what kind of document
-you’re creating (eg chapter, letter, abstract, etc...) and
+you’re creating (e.g., chapter, letter, abstract, etc...) and
what kind of output you want (typeset, typewritten, draft-style,
etc) — essentially, templates. Thirdly, you make as many
or as few changes to the templates as you wish; in other words,
@@ -199,7 +199,7 @@ documentation, so just in case:
visually 1-inch
</li>
<li>pages are numbered; the number appears centred, at the
- bottom, surrounded by hyphens ( eg -6- )
+ bottom, surrounded by hyphens ( e.g., -6- )
</li>
<li>the first page of a document begins with a
<a href="definitions.html#docheader">document header</a>
@@ -235,7 +235,7 @@ Mom offers two modes of operation for ensuring flush bottom
margins:
shimming and flex-spacing. Shimming means that mom nudges the
next line after a significant break in running text back onto the
<a href="definitions.html#baseline-grid">baseline grid</a>
-(eg, after the insertion of a graphic). Flex-spacing means that any
+(e.g., after the insertion of a graphic). Flex-spacing means that any
vertical whitespace remaining between the end of running text and
the bottom margin is distributed equally at logical points on the
page.
@@ -407,7 +407,7 @@ suppresses the SHIM macro, and enables flex-spacing.
</p>
<p>
-NO_SHIM with any argument (eg <b>OFF, QUIT, END, X</b>, etc)
+NO_SHIM with any argument (e.g., <b>OFF, QUIT, END, X</b>, etc)
re-enables shimming if it has been disabled and disables
flex-spacing.
</p>
@@ -515,7 +515,7 @@ is a
<p>
It is typographically acceptable for there to be space between
-insertions in running text (eg an image) and the bottom margin when
+insertions in running text (e.g., an image) and the bottom margin when
the next page begins with a paragraph. If you’d like to
nudge the insertion a little closer to the bottom margin—not
all the way; that isn’t possible without pushing it to the
@@ -552,7 +552,7 @@ shimmed.
</p>
<p>
-NO_FLEX with any argument (eg <b>OFF, QUIT, END, X</b>, etc)
+NO_FLEX with any argument (e.g., <b>OFF, QUIT, END, X</b>, etc)
re-enables flex-spacing if it has been disabled.
</p>
@@ -972,7 +972,7 @@ the title of each article or entitled section), and appears
</p>
<ol style="list-style-type: lower-alpha">
- <li>as the window title in PDF viewers (eg Okular or Evince)</li>
+ <li>as the window title in PDF viewers (e.g., Okular or Evince)</li>
<li>in the initial rightmost position of page headers in the document</li>
</ol>
@@ -1090,7 +1090,7 @@ Macro: <b>AUTHOR</b> <kbd class="macro-args">[COVER |
DOC_COVER] "<autho
</p>
<p>
-Each author string can hold as many names as you like, eg
+Each author string can hold as many names as you like, e.g.,
<br/>
<span class="pre-in-pp" style="margin-bottom: -1em;">
.AUTHOR "Joe Blow"
@@ -1263,7 +1263,7 @@ page headers.
<p>
The style of the chapter title can be altered by
<a href="docelement.html#docelement-control">control macros</a>,
-eg CHAPTER_TITLE_FAMILY, CHAPTER_TITLE_FONT, etc. The default
+e.g., CHAPTER_TITLE_FAMILY, CHAPTER_TITLE_FONT, etc. The default
family, font and point size are Times Roman, Bold Italic, 4 points
larger than
<a href="definitions.html#running">running text</a>.
@@ -1512,7 +1512,7 @@ or
Style parameters for the copyright line may be
entered as individual macros or
<a href="docelement.html#grouping">grouped</a>,
-eg
+e.g.,
<br/>
<span class="pre-in-pp">
.COPYRIGHT_FAMILY H
@@ -1773,7 +1773,7 @@ the page header.
<p>
<kbd>NAMED</kbd> takes an additional argument: a name for this
-particular kind of document (eg outline, synopsis, abstract,
+particular kind of document (e.g., outline, synopsis, abstract,
memorandum), enclosed in double-quotes. <kbd>NAMED</kbd> is
identical to <kbd>DEFAULT</kbd> except that mom prints the argument
to <kbd>NAMED</kbd> beneath the
@@ -2314,7 +2314,7 @@ below have the following meanings:
FAMILY The family of all type in the document
PT_SIZE The point size of type in paragraphs; mom uses
this to calculate automatic point size changes
- (eg for heads, footnotes, quotes, headers, etc)
+ (e.g., for heads, footnotes, quotes, headers, etc)
LS/AUTOLEAD** The leading used in paragraphs; all leading and
spacing of running text is calculated from this
@@ -3465,14 +3465,14 @@ the tops of pages after the first.)
point size (ie the point size used in paragraphs);
subsequently disabled after START, except for calls
to DOC_PT_SIZE
-
+
•DOC_LEAD before DOC_PT_SIZE cancels the AUTOLEAD
set before START
•Invoked after START, remains in effect for all
subsequent point size changes made with PT_SIZE,
but does not affect the leading of the document
- element tags (eg HEADING, PP, QUOTE...), or calls
+ element tags (e.g., HEADING, PP, QUOTE...), or calls
to DOC_PT_SIZE
QUAD •Changes quad for the duration of the
@@ -3769,7 +3769,7 @@ Macro: <b>DOC_FAMILY</b> <kbd
class="macro-args"><family></kbd>
<li><a href="docelement.html#endnote-intro">endnotes pages</a></li>
<li><a href="docelement.html#toc-intro">table of contents</a></li>
</ul></li>
- <li>any page elements (eg headers page numbers, footnotes) whose
+ <li>any page elements (e.g., headers page numbers, footnotes) whose
families you wish to remain at their old values must be
reset with the appropriate
<a href="docelement.html#docelement-control">control macros</a>
@@ -3896,7 +3896,7 @@ You need do nothing special to terminate a document.
When groff
finishes processing the last
<a href="definitions.html#inputline">input line</a>
of a file, the page is ejected, subject to whatever routines are
-needed to complete it (eg printing footnotes or adding the page
+needed to complete it (e.g., printing footnotes or adding the page
number).
</p>
@@ -3910,7 +3910,7 @@ page at the end of the formatted document.
<p>
The situation is rare, generally occurring only when some additional
-macro is required after the input text, eg to exit a
+macro is required after the input text, e.g., to exit a
<a href="docelement.html#list-intro">list</a>
or terminate a
<a href="docelement.html#quote">quote</a>.
diff --git a/contrib/mom/momdoc/headfootpage.html
b/contrib/mom/momdoc/headfootpage.html
index 2ef2bf4..2763fb1 100644
--- a/contrib/mom/momdoc/headfootpage.html
+++ b/contrib/mom/momdoc/headfootpage.html
@@ -426,7 +426,7 @@ Macro: <b>HEADERS</b> <kbd class="macro-args">toggle</kbd>
<a href="definitions.html#header">Page headers</a>
are on by default. If you don’t want them, turn them off by
invoking <kbd>.HEADERS</kbd> with any argument (<b>OFF, QUIT,
-END, X...</b>), eg
+END, X...</b>), e.g.,
<br/>
<span class="pre-in-pp">
.HEADERS OFF
@@ -472,7 +472,7 @@ Macro: <b>FOOTERS</b> <kbd class="macro-args">toggle</kbd>
are off by default. If you want them instead of
<a href="definitions.html#header">headers</a>
(you can’t have both), turn them on by invoking
-<kbd>.FOOTERS</kbd> without an argument, eg
+<kbd>.FOOTERS</kbd> without an argument, e.g.,
<br/>
<span class="pre-in-pp">
.FOOTERS
@@ -539,7 +539,7 @@ to headers/footers) can be designed to your own
specifications.
</ul></li>
<li><a href="#hdrftr-right">HEADER_RIGHT</a></li>
<li><a href="#reserved-strings">Using mom’s reserved strings in
header/footer definitions</a>
- (eg <kbd>\E*[$TITLE]</kbd> when you want
+ (e.g., <kbd>\E*[$TITLE]</kbd> when you want
the title, <kbd>\E*[$AUTHOR]</kbd> when you want the author, etc.)
</li>
<li><a href="#page-number-symbol">Replacing header-left, centre or right
with the page number</a></li>
@@ -1043,7 +1043,7 @@ or as defined by you with the
simply invoke this macro (using the appropriate position) with no
argument. If you wish to turn capitalization off (say, for the
header-right string that mom capitalizes by default), invoke the
-macro with any argument (eg <kbd>OFF, QUIT, END, X</kbd>...).
+macro with any argument (e.g., <kbd>OFF, QUIT, END, X</kbd>...).
</p>
<p>
@@ -1061,7 +1061,7 @@ HEADER_<POSITION>_SMALLCAPS is a
If you want any part of headers to be set in smallcaps, simply
invoke this macro (using the appropriate position) with no argument.
If you wish to turn the smallcaps off, invoke the macro with any
-argument (eg <kbd>OFF, QUIT, END, X</kbd>...).
+argument (e.g., <kbd>OFF, QUIT, END, X</kbd>...).
</p>
<p>
@@ -1415,7 +1415,7 @@ Macro: <b>HEADER_RULE</b> <kbd
class="macro-args">toggle</kbd>
By default, mom prints a header separator rule underneath headers
(or above footers). If you don’t want the rule, turn it off by
invoking <kbd>.HEADER_RULE</kbd> with any argument (<kbd>OFF, QUIT,
-END, X...</kbd>), eg
+END, X...</kbd>), e.g.,
<br/>
<span class="pre-in-pp">
.HEADER_RULE OFF
@@ -1898,7 +1898,7 @@ to the style shown above to keep things manageable.
<p>
If you want to disable having both headers and footers on the same
page, invoke <kbd>.HEADERS_AND_FOOTERS</kbd> with any argument
-you want (eg <kbd>OFF, QUIT, END, X...</kbd>). Mom will restore
+you want (e.g., <kbd>OFF, QUIT, END, X...</kbd>). Mom will restore
her default behaviour of setting automatically generated page
headers, with the page number, centered, at the bottom of the
page. If you would prefer footers instead of headers after turning
@@ -2018,7 +2018,7 @@ Macro: <b>PAGINATE</b> <kbd
class="macro-args">toggle</kbd>
By default, mom paginates documents (in the bottom margin). If
you’d prefer she not paginate, turn pagination off by invoking
<kbd>.PAGINATE</kbd> with any argument (<kbd>OFF, NO, QUIT, END,
-X...</kbd>), eg
+X...</kbd>), e.g.,
<br/>
<span class="pre-in-pp">
.PAGINATE NO
diff --git a/contrib/mom/momdoc/images.html b/contrib/mom/momdoc/images.html
index 54c7ee3..7a2fe9e 100644
--- a/contrib/mom/momdoc/images.html
+++ b/contrib/mom/momdoc/images.html
@@ -786,7 +786,7 @@ Floats use
<a href="definitions.html#filled">no-fill mode</a>,
with each input line beginning at the left margin. If this is not
what you want, you must specify the preferred horizontal alignment
-<i>within the float</i> (eg
+<i>within the float</i> (e.g.,
<a href="typesetting.html#lrc">CENTER</a>
or
<a href="typesetting.html#lrc">RIGHT</a>).
@@ -972,7 +972,7 @@ before <kbd>.START</kbd>.
<p>
If
<a href="#autolabel">autolabelling</a>
-is enabled, eg <kbd>.AUTOLABEL_IMAGES</kbd> (List
+is enabled, e.g., <kbd>.AUTOLABEL_IMAGES</kbd> (List
of Figures) or <kbd>.AUTOLABEL_PIC</kbd> (also List of Figures),
the prefix is stripped from the label when it appears in
the List. Thus, if you have invoked <kbd>.AUTOLABEL_PIC</kbd>,
diff --git a/contrib/mom/momdoc/inlines.html b/contrib/mom/momdoc/inlines.html
index f8d93b1..bf2dcca 100644
--- a/contrib/mom/momdoc/inlines.html
+++ b/contrib/mom/momdoc/inlines.html
@@ -211,7 +211,7 @@ and/or
HEADERS or FOOTERS, or in the strings passed to
<a href="headfootpage.html#headers-and-footers">HEADERS_AND_FOOTERS</a>,
you must enter the inlines beginning with <kbd>\E*</kbd>
-rather than just <kbd>\*</kbd>, eg <kbd>\E*[BD]</kbd>.
+rather than just <kbd>\*</kbd>, e.g., <kbd>\E*[BD]</kbd>.
</p>
</div>
@@ -418,7 +418,7 @@ HEADERS or FOOTERS, or in the strings passed to
you <i>must</i> use the forms <kbd>\E*[BU<n>]</kbd>
and <kbd>\E*[FU<n>]</kbd> (ie with no space), and enter the
inline beginning with <kbd>\E*</kbd> rather than just <kbd>\*</kbd>,
-eg <kbd>\E*[BU4]</kbd>.
+e.g., <kbd>\E*[BU4]</kbd>.
</p>
<p class="tip-bottom">
@@ -501,7 +501,7 @@ HEADERS or FOOTERS, or in the strings passed to
you <i>must</i> use the forms <kbd>\E*[BP<n>]</kbd>
and <kbd>\E*[FP<n>]</kbd> (ie with no space), and enter the
inline beginning with <kbd>\E*</kbd> rather than just <kbd>\*</kbd>,
-eg <kbd>\E*[BP.75]</kbd>.
+e.g., <kbd>\E*[BP.75]</kbd>.
</p>
</div>
@@ -569,7 +569,7 @@ HEADERS or FOOTERS, or in the strings passed to
you <i>must</i> use the forms <kbd>\E*[ALD<n>]</kbd>
and <kbd>\E*[RLD<n>]</kbd> (ie with no space), and enter the
inline beginning with <kbd>\E*</kbd> rather than just <kbd>\*</kbd>,
-eg <kbd>\E*[ALD.5]</kbd>.
+e.g., <kbd>\E*[ALD.5]</kbd>.
</p>
</div>
@@ -600,7 +600,7 @@ document entry for EL, you'd use <kbd>\*[B]</kbd> like this:
<h3 id="tb-plus-mom" class="docs">Call the next sequential tab without
advancing on the page</h3>
<p>
-Sometimes, you want mom to move to the next tab in sequence (eg
+Sometimes, you want mom to move to the next tab in sequence (e.g.,
from TAB 1 to TAB 2, or TAB 8 to TAB 9) without mom advancing on the
page. (See the NOTE
<a href="typesetting.html#note-tn">here</a>
@@ -914,7 +914,7 @@ used <kbd>\v</kbd> with the minus sign) or too low (if you
used
<p>
In the context of mom, the string width inline
<kbd>\w'<string>'</kbd> primarily serves to let you establish the
-horizontal measure of something (eg indents) based on the length
+horizontal measure of something (e.g., indents) based on the length
of a bit of text. For example, if you want a left indent the length
of the word “Examples:” plus a space, you can set it with
the <kbd>\w</kbd> inline escape:
diff --git a/contrib/mom/momdoc/letters.html b/contrib/mom/momdoc/letters.html
index 0531534..a837c06 100644
--- a/contrib/mom/momdoc/letters.html
+++ b/contrib/mom/momdoc/letters.html
@@ -109,7 +109,7 @@ After the START macro, you enter headers pertinent to your
letter:
the date, the addressee (in business correspondence, typically both
name and address), the addresser (that’s you; in business
correspondence, typically both name and address), and a greeting
-(in full, eg “Dear Mr. Smith,” or “Dear
+(in full, e.g., “Dear Mr. Smith,” or “Dear
Mr. Smith:”).
</p>
@@ -486,7 +486,7 @@ Macro: <b>CLOSING</b>
<p>
Invoke <kbd>.CLOSING</kbd> on a line by itself after the body of
-the letter, with the closing you’d like (eg “Yours
+the letter, with the closing you’d like (e.g., “Yours
truly,”) underneath, like this:
<br/>
<span class="pre-in-pp">
diff --git a/contrib/mom/momdoc/rectoverso.html
b/contrib/mom/momdoc/rectoverso.html
index 9a8ffba..112e6ef 100644
--- a/contrib/mom/momdoc/rectoverso.html
+++ b/contrib/mom/momdoc/rectoverso.html
@@ -219,7 +219,7 @@ together. You need only concatenate chapters into a single
file
(most likely with the <kbd>cat</kbd> command), put <kbd>.COLLATE</kbd> at the
end of each
concatenated chapter, follow it with the
<a href="docprocessing.html#reference-macros">reference macros</a>
-(metadata) needed for the new chapter, eg
+(metadata) needed for the new chapter, e.g.,
<a href="docprocessing.html#chapter">CHAPTER</a>
or
<a href="docprocessing.html#chapter-string">CHAPTER_STRING</a>,
@@ -301,7 +301,7 @@ that require their own titles, looks like this:
<span class="tip">Tip:</span>
If the last line of text before <kbd>.COLLATE</kbd>
falls too close to the bottom margin, or if the line is followed
-by a macro likely to cause a linebreak (eg <kbd>.LIST OFF</kbd> or
+by a macro likely to cause a linebreak (e.g., <kbd>.LIST OFF</kbd> or
<kbd>.IQ</kbd>), mom may output a superfluous blank page before
the start of the following document.
</p>
diff --git a/contrib/mom/momdoc/refer.html b/contrib/mom/momdoc/refer.html
index ef90caf..aa509e0 100644
--- a/contrib/mom/momdoc/refer.html
+++ b/contrib/mom/momdoc/refer.html
@@ -172,7 +172,7 @@ are separated from each other by a single, blank line. The
records
themselves are composed of single lines (“fields”) with
no blank lines between them. Each field begins with a percent
sign and a single letter (the "field identifier")
-eg <kbd>%A</kbd> or <kbd>%T</kbd>. The letter identifies
+e.g., <kbd>%A</kbd> or <kbd>%T</kbd>. The letter identifies
what part of a bibliographic entry the field refers to: Author,
Title, Publisher, Date, etc. After the field identifier comes
a single space, followed by the information appropriate to
@@ -253,7 +253,7 @@ database <full path to database>
</div>
<p style="margin-top: .5em; font-size: 95%; line-height: 120%;">
<kbd><full path to the database></kbd>
-means the full path including the filename, eg
+means the full path including the filename, e.g.,
<kbd>/home/user/refer/my-database-file</kbd>.
</p>
@@ -282,7 +282,7 @@ database <full path to database>
</div>
<p style="margin-top: .5em; font-size: 95%; line-height: 120%;">
<kbd><full path to the database></kbd>
-means the full path including the filename, eg
+means the full path including the filename, e.g.,
<kbd>/home/user/refer/my-database-file</kbd>.
</p>
@@ -313,7 +313,7 @@ database <full path to database>
<p style="margin-top: .5em; font-size: 95%; line-height: 120%;">
<kbd><full path to the database></kbd>
-means the full path including the filename, eg
+means the full path including the filename, e.g.,
<kbd>/home/user/refer/my-database</kbd>.
</p>
@@ -752,7 +752,7 @@ are very few rules, and those there are make sense. In a
nutshell:
escapes <kbd>\*[IT]</kbd> and <kbd>\*[PREV]</kbd>; if the italicized
portion concludes the field, omit <kbd>\*[PREV]</kbd></li>
<li>if you require characters with accents, ligatures or special
- symbols, use groff’s “named” glyphs (eg.
+ symbols, use groff’s “named” glyphs (e.g.,
<kbd>\['e]</kbd> for <kbd>é</kbd>); a full list can be found in
<kbd>man groff_char</kbd></li>
</ul>
@@ -763,11 +763,11 @@ are very few rules, and those there are make sense. In a
nutshell:
<span class="pre">
<a class="quick" href="#A">%A</a> author – records may contain
multiple authors,
one per line
-<a class="quick" href="#Q">%Q</a> non-human author – corporate author,
eg. National Geographic;
+<a class="quick" href="#Q">%Q</a> non-human author – corporate author,
e.g., National Geographic;
may also be used for exceptional reference types
<a class="quick" href="#m">%m</a> multiple authors – whenever "et al."
is desirable
<a class="quick" href="#i">%i</a> idem – multiple works by
the same author
-<a class="quick" href="#p">%p</a> post-author – post-author
information (eg appendix,
+<a class="quick" href="#p">%p</a> post-author – post-author
information (e.g., appendix,
foreword, letter)
%T title – primary title (of a book) or the
title of an article (within a scholarly
@@ -788,7 +788,7 @@ are very few rules, and those there are make sense. In a
nutshell:
newspaper
%J journal – when %T contains the title of an article
%e edition – number or name of an edition
- (eg Second, 2nd, Collector's, etc.)
+ (e.g., Second, 2nd, Collector's, etc.)
%S series – series name of books or journals
%V volume – volume number (of books)
%N journal number – journal or magazine number
@@ -805,7 +805,7 @@ are very few rules, and those there are make sense. In a
nutshell:
<a class="quick" href="#n">%n</a> annotation – annotation to the
reference
%s site name – for internet references, the website name
%c content – for internet references, the source of
- the material (eg. Web or Email); for websites,
+ the material (e.g., Web or Email); for websites,
the content, if unclear
%o organization – for internet sites, the organization, group
or sponsor of the site
@@ -930,7 +930,7 @@ like this:
<p>
Use this only if the author and the editor are not one in the same,
-eg
+e.g.,
<br/>
<span class="pre-in-pp">
%A Geoffrey Chaucer
@@ -2030,7 +2030,7 @@ Invoked without an argument,
underneath the bibliography’s first-page title. Invoked with the
argument, <kbd>DOUBLE</kbd>, BIBLIOGRAPHY_STRING_UNDERSCORE will
double-underscore the title. Invoked with any other non-numeric
-argument, (eg <kbd>OFF, NO, X</kbd>, etc.) the macro disables
+argument, (e.g., <kbd>OFF, NO, X</kbd>, etc.) the macro disables
underlining of the title.
</p>
diff --git a/contrib/mom/momdoc/tables-of-contents.html
b/contrib/mom/momdoc/tables-of-contents.html
index 0f872e1..2f907e1 100644
--- a/contrib/mom/momdoc/tables-of-contents.html
+++ b/contrib/mom/momdoc/tables-of-contents.html
@@ -298,7 +298,7 @@ invoke <kbd>.TOC</kbd> with <kbd>INCLUDE_TITLE</kbd>.
<span class="note">Note:</span>
If the last line of text in a document, before <kbd>.TOC</kbd>,
falls too close to the bottom margin, or if the line is followed
-by a macro likely to cause a linebreak (eg <kbd>.LIST OFF</kbd> or
+by a macro likely to cause a linebreak (e.g., <kbd>.LIST OFF</kbd> or
<kbd>.IQ</kbd>), mom may output a superfluous blank page before the
Table of Contents.
</p>
@@ -351,7 +351,7 @@ themselves (overall family, headers/footers, pagination,
etc).
<li><a href="#paginate-toc">PAGINATE_TOC</a> – turn table of
contents pagination on or off</li>
<li><a href="#toc-pagenum-style">TOC_PAGENUM_STYLE</a> – table of
contents page numbering style</li>
</ul></li>
- <li><a href="#toc-header">Header string (eg “Contents”) and
style</a>
+ <li><a href="#toc-header">Header string (e.g., “Contents”) and
style</a>
<ul style="margin-left: -.5em;">
<li><a href="#toc-header-string">Changing the header string</a></li>
<li><a href="#toc-header-v-pos">Header string vertical placement</a></li>
@@ -654,7 +654,7 @@ documents) and headings as they appear in the table of
contents:
Head level 3
...
</span>
-The style for title entries (eg chapter numbers or titles) and
+The style for title entries (e.g., chapter numbers or titles) and
heading levels is controlled by
<a href="#toc-title-style">TOC_TITLE_STYLE </a>
and
diff --git a/contrib/mom/momdoc/typesetting.html
b/contrib/mom/momdoc/typesetting.html
index 7f5c9d4..315def4 100644
--- a/contrib/mom/momdoc/typesetting.html
+++ b/contrib/mom/momdoc/typesetting.html
@@ -236,7 +236,7 @@ or
or
<a href="#page">PAGE</a>),
you must include <kbd>-P-p<papersize></kbd> on whichever
-command line you use, eg
+command line you use, e.g.,
<br/>
<span class="pre-in-pp">
pdfmom -Tps -mom -P-plegal
@@ -504,7 +504,7 @@ and right margin, like this:
That way, you don’t have to worry about calculating the line
length. On the other hand, if you know the line length for a patch
of type should be 17 picas and 3 points, entering the line length
-with LL is much easier than calculating the right margin, eg
+with LL is much easier than calculating the right margin, e.g.,
<br/>
<span class="pre-in-pp">
.LL 17P+3p
@@ -1106,7 +1106,7 @@ is measured in points. Therefore, to change the type
size to, say,
<span class="pre-in-pp">
.PT_SIZE 11
</span>
-Point sizes may be fractional (eg 10.25 or 12.5).
+Point sizes may be fractional (e.g., 10.25 or 12.5).
</p>
<p>
@@ -1170,7 +1170,7 @@ Macro: <b>LS</b> <kbd class="macro-args"><distance
between lines></kbd>
<p>
LS (Line Space) takes one argument: the distance you want, typically
in points, from baseline to baseline of type. The argument may be
-fractional (eg 12.25 or 14.5). Like PT_SIZE, LS does not require
+fractional (e.g., 12.25 or 14.5). Like PT_SIZE, LS does not require
a unit of measure, since
<a href="definitions.html#leading">leading</a>
is most often given in points. Therefore, to set the linespace to
@@ -1241,7 +1241,7 @@ requests automatically update the linespacing by the
autolead amount.
Used in this way, AUTOLEAD does not require a unit of measure;
points is assumed. However, you may use an alternate unit of
measure by appending it to the argument. The argument may be a
-decimal fraction (eg .5 or 2.75).
+decimal fraction (e.g., .5 or 2.75).
</p>
<p>
@@ -2170,7 +2170,7 @@ explicit hyphens (ie the actual hyphen character) do not.
<p>
HY MARGIN sets the amount of room allowed at the end of a line
-before hyphenation is tripped (eg if there’s only 6 points
+before hyphenation is tripped (e.g., if there’s only 6 points
left at the end of a line, groff won’t try to hyphenate the
next word). HY MARGIN only applies if you’re using
<a href="#quad">QUAD</a>,
@@ -2494,7 +2494,7 @@ Macro: <b>KERN</b> <kbd class="macro-args">toggle</kbd>
<p>
By itself (ie with no argument), KERN turns automatic pairwise
<a href="definitions.html#kern">kerning</a>
-on. With any argument (eg OFF, Q, X), pairwise kerning is turned
+on. With any argument (e.g., OFF, Q, X), pairwise kerning is turned
off.
</p>
@@ -3791,7 +3791,7 @@ string tab markers.
</span>
String tab 1 begins at the start of the line and ends after the word
“time”. String tab 2 starts at “good” and
-ends after “men”. Inline escapes (eg font or point
+ends after “men”. Inline escapes (e.g., font or point
size changes, or horizontal movements, including
<a href="goodies.html#pad">padding</a>)
are taken into account when mom determines the position and length
diff --git a/contrib/mom/momdoc/using.html b/contrib/mom/momdoc/using.html
index 67a34e9..ea179bd 100644
--- a/contrib/mom/momdoc/using.html
+++ b/contrib/mom/momdoc/using.html
@@ -154,7 +154,7 @@ flyer for your lost dog, the following apply.
<li>
<a href="definitions.html#stringargument">String arguments</a>,
in the sense of this manual, must be surrounded by double-quotes
- (eg <kbd>"text"</kbd>). Multiple
+ (e.g., <kbd>"text"</kbd>). Multiple
string arguments are separated from each other by spaces (with
each argument surrounded by double-quotes).
<br/>
diff --git a/contrib/mom/om.tmac-u b/contrib/mom/om.tmac-u
index b92ff75..055ddfe 100644
--- a/contrib/mom/om.tmac-u
+++ b/contrib/mom/om.tmac-u
@@ -5001,7 +5001,7 @@ y\R'#DESCENDER \\n[.cdp]'
\# TYPE-STYLE CONTROL MACROS
\# -------------------------
\# The control macros for family, font, size, color and quad are
-\# here grouped together. Each (eg _FAMILY) uses the calling alias
+\# here grouped together. Each (e.g., _FAMILY) uses the calling alias
\# to determine the document element to which the style parameter
\# applies. Defaults for all these guys are set in DEFAULTS, and
\# listed in the "Control Macros" section of the documentation
@@ -5181,7 +5181,7 @@ y\R'#DESCENDER \\n[.cdp]'
. substring c1-c5 0 4 \" Grab first five letters of the alias
. \}
.\" If none of the following, convert the substring of the
-.\" calling alias, ie \*[ELEMENT], into the parameter string, eg
+.\" calling alias, ie \*[ELEMENT], into the parameter string, e.g.,
.\" $TITLE_FAM, assign arg, and set register.
. if !'\\*[c1-c5]'BIBLI' \
. if !'\\*[c1-c5]'BLOCK' \
@@ -14364,7 +14364,7 @@ E\\R'#CAP_HEIGHT \\n[.cht]'
\!. if \\\\n[.vpt]=0 .vpt
\!. ne 3
. vs \\n[#EN_LEAD]u
-.\" Print identifying doc title (eg Chapter n)
+.\" Print identifying doc title (e.g., Chapter n)
. if \\n[#EN_NUMBER]=1 \{\
. if \\n[#PRINT_STYLE]=1 .TYPEWRITER
. if \\n[#PRINT_STYLE]=2 \{\
@@ -21179,7 +21179,7 @@ does not fit on page \\n[pgnum]\\*[col-num].
.if '\\*[eval*[A]'.' \
. if !'\\*[$REF_STYLE]'NOTE' .chop [A
.\" Per MLA, NOTE should not use idem, therefore if %i contains other than
-.\" idem (eg. ed., trans.), transpose it to after author's name
+.\" idem (e.g., ed., trans.), transpose it to after author's name
.ie '\\*[$REF_STYLE]'NOTE' \{\
. ie !'\\*[idem]'' .ref*field A "" "" ", \\*[idem]"
. el .ref*field A
@@ -21224,7 +21224,7 @@ does not fit on page \\n[pgnum]\\*[col-num].
.\}
.ref*field m ,
..
-\# %p Post-author string (eg. Preface, Foreword, etc)
+\# %p Post-author string (e.g., Preface, Foreword, etc)
.de ref*add-p
.\" Convert first letter to uppercase, per MLA, if BIBLIO
.if '\\*[$REF_STYLE]'BIBLIO' \{\
@@ -21557,7 +21557,7 @@ does not fit on page \\n[pgnum]\\*[col-num].
.ie '\\*[$REF_STYLE]'NOTE' ref*field G ,
.el .ref*field G . " "
..
-\# %O Other (info that goes after %T [or %B] but is hard to categorize; eg a
dissertation)
+\# %O Other (info that goes after %T [or %B] but is hard to categorize; e.g.,
a dissertation)
.de ref*add-O
.ds eval*[O \\*([O
.substring eval*[O -1
diff --git a/font/devps/generate/Makefile b/font/devps/generate/Makefile
index 2cf67d2..2b75cce 100644
--- a/font/devps/generate/Makefile
+++ b/font/devps/generate/Makefile
@@ -27,7 +27,7 @@
SHELL = /bin/sh
# Directory containing AFM files. Must not be current directory.
-# Either long names (eg Times-Roman.afm) or short names (eg timesr.afm)
+# Either long names (e.g., Times-Roman.afm) or short names (e.g., timesr.afm)
# may be used. See the afmname script.
afmdir=/usr/local/lib/afm
diff --git a/src/preproc/eqn/TODO b/src/preproc/eqn/TODO
index 210d0ab..2a22183 100644
--- a/src/preproc/eqn/TODO
+++ b/src/preproc/eqn/TODO
@@ -17,7 +17,7 @@ Consider whether there should be extra space at the side of
piles.
Provide scriptstyle displaystyle etc.
-Provide a nicer matrix syntax, eg
+Provide a nicer matrix syntax, e.g.,
matrix ccc {
a then b then c above
e then f then g above
diff --git a/src/preproc/pic/pic.ypp b/src/preproc/pic/pic.ypp
index 8decce3..7343aa7 100644
--- a/src/preproc/pic/pic.ypp
+++ b/src/preproc/pic/pic.ypp
@@ -219,7 +219,7 @@ box "foo" above ljust == box ("foo" above ljust)
%left LEFT RIGHT
/* Give attributes that take an optional expression a higher
-precedence than left and right, so that eg `line chop left'
+precedence than left and right, so that, e.g., `line chop left'
parses properly. */
%left CHOP SOLID DASHED DOTTED UP DOWN FILL COLORED OUTLINED
%left XSLANTED YSLANTED
diff --git a/src/preproc/pic/troff.cpp b/src/preproc/pic/troff.cpp
index e7bf413..32ca015 100644
--- a/src/preproc/pic/troff.cpp
+++ b/src/preproc/pic/troff.cpp
@@ -421,7 +421,7 @@ static const char *choose_delimiter(const char *text)
void troff_output::text(const position ¢er, text_piece *v, int n,
double ang)
{
- line_thickness(BAD_THICKNESS); // the text might use lines (eg in equations)
+ line_thickness(BAD_THICKNESS); // text might use lines (e.g., in equations)
int rotate_flag = 0;
if (driver_extension_flag && ang != 0.0) {
rotate_flag = 1;
diff --git a/src/preproc/refer/TODO b/src/preproc/refer/TODO
index 5bbd9bf..e0fe4bf 100644
--- a/src/preproc/refer/TODO
+++ b/src/preproc/refer/TODO
@@ -17,7 +17,7 @@ back to filenames.
Rename join-authors to join-fields. Have a separate label-join-fields
command used by @ and #.
-Have some sort of quantifier: eg $.n#A means execute `$.n' for each
+Have some sort of quantifier: e.g., $.n#A means execute `$.n' for each
instance of an A field, setting $ to that field, and then join the
results using the join-authors command.
diff --git a/src/roff/troff/TODO b/src/roff/troff/TODO
index bc4c829..2c36ab1 100644
--- a/src/roff/troff/TODO
+++ b/src/roff/troff/TODO
@@ -73,11 +73,11 @@ Request to set character slant.
Provide some way to upcase or downcase strings.
Support non-uniformly scalable fonts. Perhaps associate a suffix with
-a particular range of sizes. eg
+a particular range of sizes. E.g.,
sizesuffix .display 14-512
Then is you ask for R at pointsize 16, groff will first look for
R.display and then R. Probably necessary to be able to specify a
-separate unitwidth for each sizesuffix (eg. for X).
+separate unitwidth for each sizesuffix (e.g., uuu for X).
Make it possible to suppress hyphenation on a word-by-word basis.
(Perhaps store hyphenation flags in tfont.)
diff --git a/src/roff/troff/div.cpp b/src/roff/troff/div.cpp
index bf62d62..50cede7 100644
--- a/src/roff/troff/div.cpp
+++ b/src/roff/troff/div.cpp
@@ -178,12 +178,12 @@ macro_diversion::macro_diversion(symbol s, int append)
{
#if 0
if (append) {
- /* We don't allow recursive appends eg:
+ /* We don't allow recursive appends, e.g.:
.da a
.a
.di
-
+
This causes an infinite loop in troff anyway.
This is because the user could do
diff --git a/src/roff/troff/env.cpp b/src/roff/troff/env.cpp
index f242d4e..86d340c 100644
--- a/src/roff/troff/env.cpp
+++ b/src/roff/troff/env.cpp
@@ -777,7 +777,7 @@ environment::environment(const environment *e)
suppress_next_eol(e->suppress_next_eol),
seen_break(e->seen_break),
tabs(e->tabs),
- name(e->name), // so that eg `.if "\n[.ev]"0"' works
+ name(e->name), // so that, e.g., `.if "\n[.ev]"0"' works
control_char(e->control_char),
no_break_control_char(e->no_break_control_char),
hyphen_indicator_char(e->hyphen_indicator_char)
diff --git a/src/roff/troff/input.cpp b/src/roff/troff/input.cpp
index 7cc2d91..5e546d9 100644
--- a/src/roff/troff/input.cpp
+++ b/src/roff/troff/input.cpp
@@ -3733,7 +3733,7 @@ void macro_iterator::shift(int n)
}
}
-// This gets used by eg .if '\?xxx\?''.
+// This gets used by, e.g., .if '\?xxx\?''.
int operator==(const macro &m1, const macro &m2)
{
@@ -5595,7 +5595,7 @@ static void skip_alternative()
;
}
/*
- Note that the level can properly be < 0, eg
+ Note that the level can properly be < 0, e.g.
.if 1 \{\
.if 0 \{\
diff --git a/tmac/TODO b/tmac/TODO
index f9fd490..89da313 100644
--- a/tmac/TODO
+++ b/tmac/TODO
@@ -15,7 +15,7 @@ footnote height.)
Possibly have a place above which the footnote trap must not be
placed.
-Improved indexing, not using tm, controlled by string variable (eg
+Improved indexing, not using tm, controlled by string variable (e.g.,
-dIDX=file.idx).
When changing from multi-column to narrower columns, we could avoid
diff --git a/tmac/an-old.tmac b/tmac/an-old.tmac
index 1091e3d..22a5e18 100644
--- a/tmac/an-old.tmac
+++ b/tmac/an-old.tmac
@@ -507,7 +507,7 @@
. ns
..
.
-.ds an-empty \" this is referenced to avoid looping on eg .RB ( \\ )
+.ds an-empty \" this is referenced to avoid looping on, e.g., .RB ( \\ )
.
.de1 RI
. if \\n[.$] \{\
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: Use "e.g." correctly in documentation, comments.,
G. Branden Robinson <=