# .begin page command (Runoff)

The .begin page command executes a .break
command followed by an advance to a new page. The page number is incremented
and the page heading (if set) is printed.

**Synonyms:** .bp

## Syntax

```
.begin page
```

## Description

The .begin page command must begin in position one of the attribute. If it is in
the middle of an attribute, it is ignored and printed as text. The
text immediately following the .begin page command
is printed on the next page.

The .begin page command terminates the current page, prints the optional footing,
ejects a page, increments the page counter, and prints the optional
heading.

## Example(s)

```
.nf
This is page one.
.begin page
This is page two attribute 1.
This is page two attribute 2.
.bp
This is page three.
```

## See also

- [.fill command](https://d3codex.com/runoff/dot-fill-command/)

---
Source: https://d3codex.com/runoff/dot-begin-page-command-runoff/ - part of the D3Codex reference.