Table of Contents

INTRODUCTORY STUFF

• What is mom?
• Definitions of terms used in this manual
• Using mom

TYPESETTING WITH MOM

• Introduction to the typesetting macros
• Page setup
• Basic typesetting parameters
• Justifying, quadding, etc.
• Refinements
• Modifying type
• Vertical movements
• Tabs
• Multiple columns
• Indents
• Goodies
• Inline escapes
• Coloured text
• Graphical objects

DOCUMENT PROCESSING WITH MOM

• Introduction to document processing
• Document defaults
• Preliminary document setup
• Behaviour of the typesetting macros during document processing
• The document element tags – heads, paragraphs, subheads, footnotes, etc.
• Inserting images into a document
• Page headers and footers
• Pagination
• Recto/verso printing and collating
• Cover pages
• Tables of contents
• Bibliographies and references
• Writing letters
  •  
• Quick reference guide
• Appendices
• Reserved words (macros, strings, registers)

1. WHAT IS MOM?

• 1.1 Who is mom meant for?
• 1.2 Typesetting with mom
• 1.3 Document processing with mom
• 1.4 Mom's philosophy
• 1.5 A note on mom's documentation
  • 1.5.1 How to read macro arguments
  • 1.5.2 "Toggle" macros
  • 1.5.3 Examples

2. DEFINITIONS OF TERMS USED IN THIS MANUAL

• 2.1 Typesetting terms
• 2.2 Groff terms
• 2.3 Mom's document processing terms

3. USING MOM

• 3.1 Introduction
• 3.2 How to input mom’s macros
• 3.3 How to preview documents
• 3.4 Saving documents
• 3.3 Printing — invoking groff with mom

4. TYPESETTING WITH MOM

• 4.1 Introduction to the typesetting macros
• 4.2 Paper and page Setup – paper size and page margins
  • 4.2.1 Macro list
• 4.3 Basic typesetting parameters – family, font, fallback font, point size, line space, line length, autolead
  • 4.3.1 Macro list
• 4.4 Justifying, quadding, filling and breaking lines
  • 4.4.1 Macro list
• 4.5 Refinements – word space, sentence space, letter spacing (track kerning), hyphenation, kerning, ligatures
  • 4.5.1 Macro list
• 4.6 Modifying Type – pseudo-italic, -bold, -condensed, and -extended
  • 4.6.1 Macro list
• 4.7 Vertical Movements – moving up and down on the page
  • 4.7.1 Macro list
• 4.8 Tabs
  • 4.8.1 Typesetting tabs
    • 4.8.1.1 Quickie tutorial
  • 4.8.2 String tabs (autotabs)
    • 4.8.2.1 Quickie tutorial
  • 4.8.3 Macro list
• 4.9 Multiple columns
  • 4.9.1 Macro list
• 4.10 Indents
  • 4.10.1 A brief explanation of how mom handles indents
  • 4.10.2 Macro list
• 4.11 Goodies – aliases, transparent (comment) lines, smartquotes, caps, underscoring/underlining, padding lines, leaders, drop caps, superscripts, user-definable strings, changing the escape character
  • 4.11.1 Macro list
• 4.12 Inline Escapes
  • 4.12.1 Introduction to inline escapes
  • 4.12.2 List of inline escapes
  • 4.12.3 Mom's personal inline escapes
  • 4.12.4 Commonly-used groff inline escapes
    • 4.12.4.1 Special characters and symbols
• 4.13 Coloured text
  • 4.13.1 Introduction to coloured text
  • 4.13.2 Macro list
• 4.14 Graphical objects – horizontal and vertical rules, boxes, ellipses (circles)
  • 4.14.1 Introduction to graphical objects
  • 4.13.2 Macro list

5. DOCUMENT PROCESSING WITH MOM

• 5.1 Introduction to document processing
• 5.2 Document defaults
  • 5.2.1 Important note on leading/spacing and bottom margins
    • 5.2.1.1 The SHIM macro – to get document leading back on track
• 5.3 PRELIMINARY DOCUMENT SETUP
  • 5.3.1 Tutorial – setting up a mom document
  • 5.3.2 The reference macros – meta-information mom needs to do her job
    • 5.3.2.1 TITLE
    • 5.3.2.2 DOCTITLE
    • 5.3.2.3 SUBTITLE
    • 5.3.2.4 AUTHOR
    • 5.3.2.5 CHAPTER
    • 5.3.2.6 CHAPTER_TITLE
    • 5.3.2.7 DRAFT
    • 5.3.2.8 REVISION
    • 5.3.2.9 COPYRIGHT
    • 5.3.2.10 MISC
    • 5.3.2.11 COVERTITLE
    • 5.3.2.12 DOC_COVERTITLE
  • 5.3.3 The docstyle macros – general appearance; what kind of document you're creating, and how you want it to look overall
    • 5.3.3.1 DOCTYPE – the kind of document
    • 5.3.3.2 PRINTSTYLE – typeset or “typewritten, double-spaced”
    • 5.3.3.3 COPYSTYLE – draft or final
  • 5.3.4 Initiate document processing
    • 5.3.4.1 START – the required macro to initiate document processing
  • 5.3.5 Establishing type and formatting parameters before START
    • 5.3.5.1 Use of the typesetting macros before START
      • – 5.3.5.1.1 Including (sourcing) style sheets and files
      • – 5.3.5.1.2 Initializing colours
    • 5.3.5.2 DOC_LEAD_ADJUST – adjust document leading to fill pages
      • – 5.3.5.2.1 SHIM – macro to get document leading back on track
    • 5.3.5.3 Managing the document header
    • 5.3.5.4 COLUMNS – setting documents in columns
  • 5.3.6 Changing basic type and formatting parameters after START
    • 5.3.6.1 Behaviour of the typesetting macros during document processing
    • 5.3.6.2 Post-START global style change macros
      • – Macro list
• 5.4 THE DOCUMENT ELEMENT TAGS
  • 5.4.1 Introduction to the document element tags
    • 5.4.1.1 Control macros – changing style defaults for document element tags
    • 5.4.1.2 Arguments to the control macros
  • 5.4.2 Epigraphs
  • 5.4.3 Paragraphs
  • 5.4.4 Main heads
  • 5.4.5 Subheads
  • 5.4.6 Paragraph heads
  • 5.4.7 Linebreaks – author linebreaks (section breaks)
  • 5.4.8 Quotes – line for line poetic quotes or unformatted, verbatim text (e.g. blocks of code)
  • 5.4.9 Blockquotes – cited material
  • 5.4.10 Code – inserting code snippets
  • 5.4.11 Lists – nested lists
  • 5.4.12 Line numbering
  • 5.4.13 Footnotes
  • 5.4.14 Endnotes
  • 5.4.15 Margin notes
  • 5.4.16 Document termination string – FINIS
• 5.5 INSERTING IMAGES
• 5.6 PAGE HEADERS AND FOOTERS
  • 5.6.1 Introduction
  • 5.6.2 General description of headers/footers
  • 5.6.3 Default specs for headers/footers
  • 5.6.4 Vertical placement and spacing of headers/footers
  • 5.6.5 Managing page headers and footers
  • 5.6.6 Control macros for headers/footers
  • 5.6.7 User-defined, single string recto/verso headers/footers
    • 5.6.7.1 User-defined, single string headers/footers (no recto/verso)
  • 5.6.8 Headers and footers on the same page
• 5.7 PAGINATION
  • 5.7.1 Introduction
  • 5.7.2 Pagination macros list
  • 5.7.3 Blank pages
• 5.8 RECTO/VERSO PRINTING, COLLATING
  • 5.8.1 Introduction to recto/verso printing
    • 5.8.1.1 Macro list
  • 5.8.2 Introduction to collating
    • 5.8.2.1 The COLLATE macro
• 5.9 COVER PAGES
• 5.10 TABLES OF CONTENTS
  • 5.10.1 Table of contents behaviour
  • 5.10.2 Using psselect to put tables of contents where you want them
  • 5.10.3 Table of contents control macros
• 5.11 BIBLIOGRAPHIES AND REFERENCES
• 5.12 WRITING LETTERS
  • 5.11.1 Introduction to writing letters
  • 5.11.2 Tutorial on writing letters
  • 5.11.3 Default style for letters
  • 5.11.4 The letter macros

6. QUICK REFERENCE GUIDE

7. APPENDICES

• 7.1 Notes on the documentation
• 7.2 Adding PostScript fonts to groff
  • 7.2.1 How to create a PostScript font for use with groff
• 7.3 Some reflections on mom
• 7.5 List of reserved words – complete list of macros, registers, strings, aliases and diversions
• 7.5 Contact the author