Diverting and undiverting output
********************************

   Diversions are a way of temporarily saving output.  The output of
`m4' can at any time be diverted to a temporary file, and be reinserted
into the output stream, "undiverted", again at a later time.

   Up to ten numbered diversions (numbered from 0 to 9) are supported in
`m4', of which diversion number 0 is the normal output stream.  The
number of available diversions can be increased with the `-N' option.

* Menu:

* Divert                       Diverting output
* Undivert                     Undiverting output
* Divnum                       Diversion numbers
* Cleardiv                     Discarding diverted text