IOTiogaDoc.tioga
Bier, February 27, 1991 2:50 pm PST
IOTioga
PCEDAR 2.0 %
IOTioga
Complete Tioga Formatting for IO.STREAMs
Eric A. Bier
Ó Copyright 1989, 1990, 1991 Xerox Corporation. All rights reserved.
Abstract: Some IO streams produce Tioga documents as output. IOTioga is a set of routines that allow client control of the character set, character looks, character properties, node properties, and node nesting levels of the Tioga document produced by such a stream. IOTioga currently works on both streams producing files and Typescripts. Use IOTioga.CreateTiogaAccessStream to create a formatted Tioga file.
Created by: Doug Wyatt, Eric Bier
Maintained by: Wyatt, Bier
Keywords: IO, Tioga, formatting, looks, character properties, node properties, nesting levels
XEROX Xerox Corporation
Palo Alto Research Center
3333 Coyote Hill Road
Palo Alto, California 94304
1. How to Use IOTioga
IOTioga is a library of routines (see IOTioga.mesa). Most of these routines operate on an IO.STREAM. Any application that runs in Viewers and is loaded after Tioga is loaded, can use these routines to add looks, character properties, node properties, node breaks and other Tioga-specific information to the document that the IO.STREAM is producing.
To create a new Tioga file and write to it using a combination of IO.mesa and IOTioga.mesa operations, use the routine IOTioga.CreateTiogaAccessStream (and see the instructions in its comments).
To write to a Typescript, simply apply IO.mesa and IOTioga.mesa to the Commander's ouput stream (cmd.out).
On other streams, such as those produced by IO.ROS, IOTioga operations will be ignored. These streams do not produce a tree-structured Tioga data structure and hence cannot directly represent node structure, font changes, character set changes and so forth.
2. IOTioga Limitations
Because IOTioga depends on the Tioga interfaces, lower level Cedar packages cannot use it to add formatting to their user messages. We are thinking of producing an additional package (perhaps called IOFormat?) that will provide a similar interface that is independent of Tioga and can be placed lower in the Cedar house of cards.