Table of Contents

GNU GENERAL PUBLIC LICENSE

Preamble
How to Apply These Terms to Your New Programs

1. Introduction

1.1 What Is groff?
1.2 History
1.3 groff Capabilities
1.4 Macro Packages
1.5 Preprocessors
1.6 Output Devices
1.7 Credits

2. Invoking groff

2.1 Options
2.2 Environment
2.3 Invocation Examples

2.3.1 grog

3. Tutorial for Macro Users

3.1 Basics
3.2 Common Features

3.2.1 Paragraphs
3.2.2 Sections and Chapters
3.2.3 Headers and Footers
3.2.4 Page Layout
3.2.5 Displays
3.2.6 Footnotes and Annotations
3.2.7 Table of Contents
3.2.8 Indices
3.2.9 Paper Formats
3.2.10 Multiple Columns
3.2.11 Font and Size Changes
3.2.12 Predefined Strings
3.2.13 Preprocessor Support
3.2.14 Configuration and Customization

4. Macro Packages

4.1 `man'

4.1.1 Options
4.1.2 Usage
4.1.3 Macros to set fonts
4.1.4 Miscellaneous

4.2 `mdoc'
4.3 `ms'
4.4 `me'
4.5 `mm'

5. Programming Tutorial

5.1 Text

5.1.1 Filling and Adjusting
5.1.2 Hyphenation
5.1.3 Sentences
5.1.4 Tab Stops
5.1.5 Implicit Line Breaks

5.2 Input Conventions
5.3 Measurements

5.3.1 Default Units

5.4 Expressions
5.5 Identifiers
5.6 Embedded Commands

5.6.1 Requests

5.6.1.1 Request Arguments

5.6.2 Macros
5.6.3 Escapes

5.6.3.1 Comments

5.7 Registers

5.7.1 Setting Registers
5.7.2 Interpolating Registers
5.7.3 Auto-increment
5.7.4 Assigning Formats
5.7.5 Built-in Registers

5.8 Manipulating Filling and Adjusting
5.9 Manipulating Hyphenation
5.10 Manipulating Spacing
5.11 Tabs and Fields

5.11.1 Leaders
5.11.2 Fields

5.12 Character Translations
5.13 Troff and Nroff Mode
5.14 Line Layout
5.15 Page Layout
5.16 Page Control
5.17 Fonts

5.17.1 Changing Fonts
5.17.2 Font Families
5.17.3 Font Positions
5.17.4 Using Symbols
5.17.5 Artificial Fonts
5.17.6 Ligatures and Kerning

5.18 Sizes

5.18.1 Changing Type Sizes
5.18.2 Fractional Type Sizes

5.19 Strings
5.20 Conditionals and Loops

5.20.1 if-else
5.20.2 while

5.21 Writing Macros

5.21.1 Copy-in Mode
5.21.2 Parameters

5.22 Page Motions
5.23 Drawing Requests
5.24 Traps

5.24.1 Page Location Traps
5.24.2 Diversion Traps
5.24.3 Input Line Traps
5.24.4 End-of-input Traps

5.25 Diversions
5.26 Environments
5.27 I/O
5.28 Postprocessor Access
5.29 Miscellaneous
5.30 Debugging

5.30.1 Warnings

5.31 Implementation Differences
5.32 Summary

6. Preprocessors

6.1 geqn

6.1.1 Invoking geqn

6.2 gtbl

6.2.1 Invoking gtbl

6.3 gpic

6.3.1 Invoking gpic

6.4 ggrn

6.4.1 Invoking ggrn

6.5 grap
6.6 grefer

6.6.1 Invoking grefer

6.7 gsoelim

6.7.1 Invoking gsoelim

7. Output Devices

7.1 Special Characters
7.2 grotty

7.2.1 Invoking grotty

7.3 grops

7.3.1 Invoking grops
7.3.2 Embedding POSTSCRIPT

7.4 grodvi

7.4.1 Invoking grodvi

7.5 grolj4

7.5.1 Invoking grolj4

7.6 grolbp

7.6.1 Invoking grolbp

7.7 grohtml

7.7.1 Invoking grohtml

7.8 gxditview

7.8.1 Invoking gxditview

8. File formats

8.1 gtroff Output

8.1.1 Output Format
8.1.2 Device Control
8.1.3 Drawing Functions
8.1.4 Line Continuation

8.2 Font Files

8.2.1 `DESC' file format
8.2.2 Font file format

9. Installation
10. Request and Escape Index
11. Operator Index
12. Register Index
13. Macro and String Index
14. Glyph Name Index
15. Font File Keyword Index
16. Program and File Index
17. Concept Index