### 9.12 Multiple Pages ¶

Msc-generator supports multi-page charts. These may be useful when you want to print a long chart. Also, when you only want to show some parts of a chart in a compound document, but want to keep the rest of the text, too. In the latter case just put the parts to show on a different page and show only that page in the compound document.

By default the whole chart is a single page. The chart can be manually broken into multiple pages by inserting ‘`newpage;`’ commands. The chart then can be viewed either as a whole or page by page. You can have as many pages in a document as you want. Adding the ‘`[auto_heading=yes]`’ option to the command will result in displaying an automatic entity heading at the top the page after the page break - but only when the chart is viewed page-by-page. If you want this for all such manually inserted, simply set the ‘`auto_heading`’ chart option to yes.

You can also make Msc-generator to paginate the chart for a given page size. On the command line this is available via the ‘`-p -a`’ options, on Windows, there is a checkbox on the ribbon. You can ask Msc-generator to insert headings to the top of the new pages by specifying ‘`-ah`’ or ticking the ‘`Auto Headings`’ checkbox.

The command-line version of Msc-generator creates as many output files as many pages there are. If there is more than one page, it appends the page number to the filename you specify. Specifying the ‘`-p`’ option for PDF output allows you to have a single, multi-page output file. In the Windows GUI if you export from Print Preview to PDF, a sinlge multi-page file is created using the page size, orientation, margins and alignment selected in Print Preview.