---
name: "mmroff"
section: "1"
platform: "linux"
package: "groff"
version: "1.24.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mmroff"
---

# mmroff(1)

reference- and PostScript inclusion-handling front end for GNU roff mm macro package

## Name

mmroff - reference- and PostScript inclusion-handling front end for GNU *roff mm* macro package

## Synopsis

**mmroff** \[**-x**\] *groff-argument* ...

**mmroff** **--help**

**mmroff** **--version**

## Description

*mmroff* is a simple wrapper for *groff*, used to expand internal references in *mm* documents; see [*groff\_mm*(7)](/groff_mm/7.md). It runs *groff* with the **-mm** option twice, first with **-z** and **-rRef=1** to populate reference and index files with their corresponding entries, and then without to produce the document. It also handles the inclusion of PostScript images with the **PIC** macro. Documents that do not use these features of *groff mm* (the **INITI**, **IND**, **INDP**, **INITR**, **SETR**, **GETHN**, **GETPN**, **GETR**, **GETST**, and **PIC** macros) do not require *mmroff*.

## Options

**--help** displays a usage message, while **--version** shows version information; both exit afterward.

- **-x**

  Create or update the reference list file and exit.

## Environment

Normally, the path separator in environment variables ending with *PATH* is the colon; this may vary depending on the operating system. For example, Windows uses a semicolon instead.

- *GROFF\_BIN\_PATH*

  Locate *groff* commands in these directories, followed by those in *PATH*. If not set, the installation directory of GNU *roff* executables, */usr/bin*, is searched before *PATH*.

## Exit status

*mmroff* exits with status **0** if the **--help** or **--version** options were specified, or if **-x** was specified and the program successfully created or updated the reference list file. It exits with status **1** if it was unable to create necessary files. Otherwise, it exits with the status of *groff*.

## Authors

*mmroff* was written by Jrgen Hgg ⟨jh@\\:axis\\:.se⟩ of Lund, Sweden.

## See also

[*groff\_mm*(7)](/groff_mm/7.md), [*groff\_mmse*(7)](/groff_mmse/7.md), [*groff*(1)](/groff/1.md), [*troff*(1)](/troff/1.md), [*tbl*(1)](/tbl/1.md), [*pic*(1)](/pic/1.md), [*eqn*(1)](/eqn/1.md)