Making and Preventing Breaks

Usually, a Texinfo file is processed both by TeX and by one of the Info formatting commands. Line, paragraph, or page breaks sometimes occur in the `wrong' place in one or other form of output. You must ensure that text looks right both in the printed manual and in the Info file.

For example, in a printed manual, page breaks may occur awkwardly in the middle of an example; to prevent this, you can hold text together using a grouping command that keeps the text from being split across two pages. Conversely, you may want to force a page break where none would occur normally. Fortunately, problems like these do not often arise. When they do, use the break, break prevention, or pagination commands.

The break commands create or allow line and paragraph breaks:

@*

Force a line break.

@sp n

Skip n blank lines.

@-

Insert a discretionary hyphen.

@hyphenation{hy-phen-a-ted words}

Define hyphen points in hy-phen-a-ted words.

The line-break-prevention command holds text together all on one line:

@w{text}

Prevent text from being split and hyphenated across two lines.

The pagination commands apply only to printed output, since Info files do not have pages.

@page

Start a new page in the printed manual.

@group

Hold text together that must appear on one printed page.

@need mils

Start a new printed page if not enough space on this one.

Go to the first, previous, next, last section, table of contents.