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.