4.3 Free Text

4.3 Free Text

Free text

 is any text that is not part of a macro definition or a directive. A scrap of

free text consists of a sequence of items drawn from the following list: non special

Tutorial

printable characters, insert eol special sequences, insert special character special

sequences, insert arbitrary character special sequence.

Developer

free_text      = ordinary_text

Reference

ordinary_text  = { ordinary_char | eol | text_special }+

1 Introduction

text_special   = "@+" | "@@" | "@^" char_spec

2 Interface

ordinary_char  = " ".."~"   special

3 Scanner

An example of some rather messy free text is as follows:

4 Parser

5 Analyser

This@@ is a very@+ messy

6 Tangle

@^D(009)chunk of text indeed.

7 Weave

But FunnelWeb still views it as

8 Shell

a single chunk of text.

9 Commands

FunnelWeb never sees two text chunks next to each other in the input; they are

10 Glossary

always merged into a single text token.

11 References

The free text in an input file does not affect the product files. However, by default,

it appears in the printed documentation exactly as it is given in the input file, except

SEARCH

that it is filled and justified into paragraphs.

Any printable character or particular sequence of characters may appear in the free

text of a document. FunnelWeb ensures that they will appear exactly as given in the

input file, even if they happen to be escape characters or commands in the target

typesetter. However, FunnelWeb also provides a special mode that allows this

censoring to be overridden.

Webmaster

Copyright   Ross N. Williams 1992,1999. All rights reserved.

http://www.ross.net/funnelweb/reference/parser_freetext.html [3/3/2000 10:46:29 PM]