summaryrefslogtreecommitdiff
path: root/contrib/mom/momdoc/intro.html
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/mom/momdoc/intro.html')
-rw-r--r--contrib/mom/momdoc/intro.html45
1 files changed, 24 insertions, 21 deletions
diff --git a/contrib/mom/momdoc/intro.html b/contrib/mom/momdoc/intro.html
index ec62285f..e21fa3c0 100644
--- a/contrib/mom/momdoc/intro.html
+++ b/contrib/mom/momdoc/intro.html
@@ -59,16 +59,16 @@ on a document's content and logical structure without worrying about
typesetting or page layout at all.
<p>
Because <strong>mom</strong> provides both typesetting and document
-processing macros, it's safe to say she blurs the distinction
-between document processing and document design. While her basic
-document design comes with pretty spiffy defaults (okay -- change
-&quot;spiffy&quot; to &quot;typographically professional&quot;),
-you can easily redesign nearly every element of a document:
-title information, page headers and footers, page numbering, heads,
-subheads, footnotes... The list goes on. And should you need precise
+processing macros, it's safe to say she blurs the distinction between
+document processing and document design. While her basic document style
+comes with pretty spiffy defaults (okay -- change &quot;spiffy&quot;
+to &quot;typographically professional&quot;), you can easily control
+how all the various document elements look: titles, page headers and
+footers, page numbering, heads, subheads, footnotes and so on can be
+made to come out exactly the way you want. And should you need precise
typographic control over elements in a document that fall outside the
-range of <strong>mom</strong>'s document markup tags, you don't have
-to read up on groff
+range of <strong>mom</strong>'s document element tags, you don't have to
+read up on groff
<a href="definitions.html#TERMS_PRIMITIVES">primitives</a>
in order to accomplish what you want; the typesetting macros take
care of that.
@@ -77,13 +77,16 @@ care of that.
<h2><u>Typesetting with mom</u></h2>
</a>
-<strong>Mom</strong>'s typesetting macros control the basic elements of
-type: margins, line length, type family, font, point size, linespacing,
-and so on. In addition, they allow you to move around on the page
-horizontally and vertically, and to set up tabs, indents, and columns.
-Finally, they let you adjust such typographic details as justification
-style, letter spacing, word spacing, hyphenation, and kerning.
-<p> In terms of typographic control, these macros resemble the
+<strong>Mom</strong>'s typesetting macros control the basic parameters
+of type: margins, line length, type family, font, point size,
+linespacing, and so on. In addition, they allow you to move around
+on the page horizontally and vertically, and to set up tabs, indents,
+and columns. Finally, they let you adjust such typographic details as
+justification style, letter spacing, word spacing, hyphenation, and
+kerning.
+
+<p>
+In terms of typographic control, these macros resemble the
commands used on dedicated typesetting computers like Compugraphics and
Linotronics. Most of them simply give access to groff's typesetting
primitives in a way that's consistent and easy to use. A few of
@@ -259,11 +262,11 @@ And when explanations aren't enough, I offer examples.
The canonical reference materials for groff are <strong>cstr54</strong>
(a downloadable PostScript copy of which is available
<a href="http://www.kohala.com/start/troff/">here</a>)
-and the troff manpages. I've tried to avoid reiterating them, however,
-in a few places, this has proved impossible. Be forewarned: I have
-no qualms about sidestepping excrutiating completeness about groff
-usage; I'm more concerned with getting <strong>mom</strong> users up
-and running. <em>Mea culpa.</em>
+and the <strong>troff</strong> and <strong>groff_diff</strong> manpages.
+I've tried to avoid reiterating them, however, in a few places, this has
+proved impossible. Be forewarned: I have no qualms about sidestepping
+excrutiating completeness about groff usage; I'm more concerned with
+getting <strong>mom</strong> users up and running. <em>Mea culpa.</em>
<p>
<strong>Note:</strong> <strong>Mom</strong>'s macro file
(om.tmac) is heavily commented. Each macro is preceded by a