Mom, version 1.3-a -- Table of Contents

# Table of Contents for mom, version 1.3-a

The table of contents has grown quite large. If you've been using mom for a while, you might prefer the Quick Reference Guide.

If you're new to mom, click on any link in the Quick Table of Contents to go to the appropriate section of the Full Table of Contents.

Or click here to go directly to the Full Table of Contents.

## Quick Table of Contents

INTRODUCTORY STUFF

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

TYPESETTING WITH MOM

- Intro to typesetting macros
- Page setup
- Basic typesetting parameters
- Justifying, quadding, etc.
- Refinements
- Modifying type
- Vertical movements
- Tabs
- Multiple columns
- Indents
- Goodies
- Inline escapes
- Coloured text

DOCUMENT PROCESSING WITH MOM

- Introduction to document processing
- Preliminary document setup
- The document element tags -- heads, subheads, footnotes, etc.
- Headers and footers
- Pagination
- Recto/verso printing and collating
- Cover pages
- Bibliographies and references
- Writing letters
- Using typesetting macros during document processing
- Quick reference guide to mom
- Appendices

## Full Table of Contents

- 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
- 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 Printing -- invoking groff with mom
  - 3.4 How to preview documents
- 4. THE TYPESETTING MACROS
  - 4.1 Introduction to the typesetting macros
  - 4.2 Page Setup -- paper size and page margins
    - 4.2.1 Macro list
  - 4.3 Basic 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 Multi-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 lines, smartquotes, caps, underscoring/underlining, padding lines, leaders, drop caps, superscripts, (nested) lists, user-definable strings
    - 4.11.1 Macro list
  - 4.12 Inline Escapes
    - 4.12.1 Introduction to inline escapes
    - 4.12.2 Mom's personal inlines
    - 4.12.3 Groff inlines
    - 4.12.3.1 Inlines for special characters and symbols
  - 4.13 Coloured text
    - 4.13.1 Introduction to coloured text
    - 4.13.2 Macro list
- 5. DOCUMENT PROCESSING WITH MOM
  - 5.1 Introduction to document processing
  - 5.2 Some document defaults
    - IMPORTANT NOTE on leading/spacing and bottom margins
    - 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
      - 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 COVER_TITLE
      - 5.3.2.12 DOC_COVER_TITLE
    - 5.3.3 The Docstyle Macros
      - 5.3.3.1 DOCTYPE -- kind of document
      - 5.3.3.2 PRINTSTYLE -- typeset or typewrite
      - 5.3.3.3 COPYSTYLE -- draft or final
    - 5.3.4 Changing Type and Style Parameters before START
      - 5.3.4.1 Typesetting macros before START -- usage
        - Colour
      - 5.3.4.2 DOC_LEAD_ADJUST -- adjusting the document leading (line spacing) to fill pages
      - 5.3.4.3 DOCHEADER -- managing the document header
      - 5.3.4.4 COLUMNS -- setting documents in columns
    - 5.3.5 ***START*** -- the macro to initiate document processing
    - 5.3.6 Changing Document-wide Style Parameters after START
      - 5.3.6.1 Macro list
    - 5.3.7 Using typesetting macros during document processing
  - 5.4 THE DOCUMENT ELEMENT TAGS
    - 5.4.1 Introduction to the document element tags
      - Control macros -- changing style defaults for document element tags
      - 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. code snippets)
    - 5.4.9 Blockquotes -- cited material
    - 5.4.10 Lists -- (nested) lists
    - 5.4.11 Line numbering
    - 5.4.12 Footnotes
    - 5.4.13 Endnotes
    - 5.4.14 Margin notes
    - 5.4.15 Blank pages
    - 5.4.16 Table of contents
    - 5.4.17 Document termination -- FINIS
  - 5.5 DOCUMENT HEADERS AND FOOTERS
    - 5.5.1 Introduction
    - 5.5.2 General description of headers/footers
    - 5.5.3 Default specs for headers/footers
    - 5.5.4 Vertical placement and spacing of headers/footers
    - 5.5.5 Managing headers/footers
      - 5.5.5.1 User-defined, single string recto/verso headers/footers
    - 5.5.6 Control macros for headers/footers
  - 5.6 PAGINATION
    - Introduction
    - Pagination macros list
  - 5.7 RECTO/VERSO PRINTING AND COLLATING
    - 5.7.1 Introduction to recto/verso
      - 5.7.1.1 Macro list
    - 5.7.2 Introduction to collating
      - 5.7.2.1 The COLLATE macro
  - 5.8 CREATING COVER PAGES
  - 5.9 BIBLIOGRAPHIES AND REFERENCES
  - 5.10 WRITING LETTERS
    - 5.10.1 Introduction to writing letters
    - 5.10.2 Tutorial on writing letters
    - 5.10.3 Default style for letters
    - 5.10.4 The letter macros
- 6. QUICK REFERENCE GUIDE TO MOM

- 7. APPENDICES
  - 7.1 Further notes on this documentation
  - 7.2 Adding PostScript fonts to groff
    - 7.2.1 How to create a PostScript font for use with groff
  - 7.2 Some reflections on mom
  - 7.3 List of reserved words
  - 7.4 Contact the author