unroff-website/www/doc/m.html

78 lines
2.7 KiB
HTML

<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/21/96 19:29:41. -->
<!-- Do not edit! -->
<link rev="made" href="mailto:net@informatik.uni-bremen.de">
<title>unroff Programmer's Manual</title>
</head><body>
<!-- $Revision: 1.12 $ -->
<h1>
unroff 1.0 Programmer's Manual
</h1>
<p>
<i>Oliver Laumann
<br>
</i><hr>
<p>
<i>unroff
</i>is a programmable, extensible troff translator that is useful for
converting documents with embedded troff markup into another
format.<tt> </tt>
Although
<i>unroff
</i>has been designed with higher-level, structure-oriented target
languages (such as SGML) in mind, it fully supports all constructs
and idiosyncrasies of ordinary troff, so that even low-level
formatting requests can be handled correctly if desired.<tt> </tt>
<p>
&#160;<tt> </tt>&#160;<tt> </tt>&#160;<tt> </tt>Translation rules for a specific output format and knowledge about
existing troff macro packages are not hard-wired in
<i>unroff</i>,
instead, the translation is controlled by a user-supplied set
of procedures written in the
<a href="http://www-swiss.ai.mit.edu/scheme-home.html"><i>Scheme</i> programming language</a>.<tt> </tt>
Interpretation of the procedures is facilitated by a full Scheme
interpreted embedded in
<i>unroff</i>.<tt> </tt>
This manual describes the Scheme primitives provided by
<i>unroff
</i>that can be used to customize the translation rules implemented
by existing back-ends and to write new ones for new output formats.<tt> </tt>
<hr>
<h2>Table of Contents</h2>
<ul><li><a href="m-1.html#section1">1. </a>
Additional Documentation
<li><a href="m-2.html#section2">2. </a>
Where to Place Scheme Code?
<li><a href="m-3.html#section3">3. </a>
<a name=".events">Events and Event Handling</a>
<li><a href="m-4.html#section4">4. </a>
Defining Event Handlers
<li><a href="m-5.html#section5">5. </a>
Querying Event Handlers
<li><a href="m-6.html#section6">6. </a>
Event Procedures with Side-Effects
<li><a href="m-7.html#section7">7. </a>
How Troff Input is Processed
<li><a href="m-8.html#section8">8. </a>
Calling the Parser
<li><a href="m-9.html#section9">9. </a>
Streams
<li><a href="m-10.html#section10">10. </a>
Input and Output Primitives
<li><a href="m-11.html#section11">11. </a>
String Functions
<li><a href="m-12.html#section12">12. </a>
Tables
<li><a href="m-13.html#section13">13. </a>
Miscellaneous Primitives
<li><a href="m-14.html#section14">14. </a>
File Insertions
<li><a href="m-15.html#section15">15. </a>
Utilities for Back-Ends
<li><a href="m-notes.html#section0">Footnotes</a>
</ul>
<p><hr>
Markup created by <em>unroff</em> 1.0,&#160;<tt> </tt>&#160;<tt> </tt>March 21, 1996,&#160;<tt> </tt>&#160;<tt> </tt>net@informatik.uni-bremen.de</body>
</html>