Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog

# 6.34. output Macro

## Interface

The general syntax is:

      !output outfile

The arguments are:

Name | Type | Default | Rule
outfile | string |  |

See Understanding Macro Interfaces, if necessary.

## Description

The output macro dynamically changes the output file being used. It can be used in the following ways:

1. output "filename"
2. output ">filename"
3. output "-"

The first form changes the output file to be filename. The second form appends the output onto the filename given. The third form closes the (current) output file, if any.

## Examples

To be completed...

## Limitations & Future Directions

html is the only target which currently supports this macro.