TIPToolsDoc.tioga
Last tweaked by Mike Spreitzer on March 25, 1992 7:16 am PST
TIPTools
CEDAR 7.0 — FOR INTERNAL XEROX USE ONLY
TIPTools
Mike Spreitzer
© Copyright 1989 Xerox Corporation. All rights reserved.
Abstract: This package provides a few helpful things for debugging TIP tables. One is TPP, the TIP PreProcessor: it expands TIP macros. Another is a procedure that simply reads TIP tables, to expose errors in a less deadly environment. The final one is a kind of test viewer for an arbitrary TIP table.
Created by: Mike Spreitzer
Maintained by: Mike Spreitzer <Mike Spreitzer:PARC:Xerox>
Keywords: TIP Table, GPM, Macro Expand
XEROX   Xerox Corporation
    Palo Alto Research Center
    3333 Coyote Hill Road
    Palo Alto, California 94304

For Internal Xerox Use Only
1. Commands
name TPP
syntax
TPP
description
Applies TIP's macro expander (GPM) as a filter; input is read from stdin, and output written to stdout.
examples
TPP < [Cedar7.0]<Tioga>EditTypeScript.tip
See what EditTypeScript.tip looks like after it's been expanded.
TPP < Macrous.tip > Expanded.tip
Expand Macrous.tip into Expanded.tip.
stop/undo
Well, it's a command, so you can click STOP!
name TIPRead
syntax
TIPRead tipFileName*
description
Reads TIP files.
examples

% TIPRead TiogaDisplay.tip
[]<>Users>Spreitzer.pa>TT>TiogaDisplay.tip!3 errors on TIP.ERRORS
stop/undo
Well, it's a command, so you can click STOP!
name TIPTest
syntax
TIPTest tipFileName*
description
Creates a test viewer whose TIP table is the given ones, layered in the given order.
examples

% tiptest ///7.0/Commands/KeyboardScan.TIP ///7.0/Commands/KeyboardTioga.TIP ///Users/Spreitzer.pa/Tioga-SpreitzerExtras.TIP [Cedar7.0]<Tioga>Tioga.tip
stop/undo
Well, it's a command, so you can click STOP! ... but the command doesn't take long to execute. Once it's created the test viewer, you can destroy the viewer.
name TransparentTIPTest
syntax
TransparentTIPTest
description
Creates a test viewer whose TIP table is the transparent one. For keystrokes, the two numbers printed are a KeyCode and a KeySym; the next command offers information about these numbers.
examples

% TransparentTIPTest
stop/undo
Well, it's a command, so you can click STOP! ... but the command doesn't take long to execute. Once it's created the test viewer, you can destroy the viewer.
name IdentityTIPTest, IdentityPlusTimeTIPTest
syntax
IdentityTIPTest [+time|-time]
IdentityPlusTimeTIPTest
description
Like TransparentTIPTest, but even more so. The IdentityPlusTimeTIPTest command, or the IdentityTIPTest command with the +time argument, pass time events; the other cases filter out time events.
examples

% IdentityTIPTest
% IdentityTIPTest +time
% IdentityPlusTimeTIPTest
stop/undo
Well, it's a command, so you can click STOP! ... but the command doesn't take long to execute. Once it's created the test viewer, you can destroy the viewer.
name ListMapping
syntax
ListMapping
description
Lists (on standard output) the mapping from UserInput.KeyCode to UserInput.KeySym (about which the KeyGlyphs interface also has things to say) and names usable in TIP tables.
examples

% ListMapping
stop/undo
Well, it's a command, so you can click STOP! ... but it might not listen.
name UserInputSpy
syntax
UserInputSpy [+time|-time]
description
Lists (on standard output) all future input (and maybe also a little from the recent past). -time is default.
examples

% UserInputSpy
stop/undo
click STOP!
name TIPPrintDown
syntax
TIPPrintDown
description
Lists all the KeySyms that are currently "down", and for each one the set of KeyCodes (and their glyphIndices, whatever those are) that may be responsible.
examples

% TIPPrintDown
stop/undo
Well, it's a command, so you can click STOP! ... but it might not listen.