# .preface command

The .preface command sets the automatic
preface formatting. If a .preface command
has already been issued, the page numbers resume where the last .preface command ended.

**Synonyms:** .pf

Preface sections display in the table of contents with
Roman numeral page numbers. To set the page numbers to Roman numerals
in the preface header/footer, specify the r option
in the .footing command.

The preface mode
continues until an .xpreface command is encountered.

```
.preface text
```

## Parameter(s)

| text | Preface heading. The heading text is centered at the top of the next page and begins a separate page numbering scheme. |
| --- | --- |

## See also

- [.footing command (Output processor)](https://d3codex.com/output-processor/dot-footing-command-output-processor/)
- [.xpreface command](https://d3codex.com/output-processor/dot-xpreface-command/)
- [Output processor commands](https://d3codex.com/output-processor/output-processor-commands/)
- [Output processor overview](https://d3codex.com/output-processor/output-processor-overview/)

---
Source: https://d3codex.com/output-processor/dot-preface-command/ - part of the D3Codex reference.