-- PrintDoc.tioga
-- last edited by vanLeunen, January 5, 1984 3:58 pm
-- last edited by MBrown, January 6, 1984 11:26 am
-- Last Edited by: Diebert, March 1, 1984 5:35:05 pm PST
-- Last Edited by: Plass, July 2, 1984 12:14:41 pm PDT
-- Pavel, February 18, 1986 3:22:54 pm PST
Print
Syntax
Print [-p | -l] [-n nCols] [-s sizeFont] [-f textFont] [-F headingFont]
[-h [hostName]] [-r [pfName]] [-c nCopies] [-t] file ...
Description
Print is useful for quick printing whenever speed is more important than formatting. For instance, Print produced a press file from [Indigo]<Cedar5.1>Documentation>Dependencies.txt!1, a 192478 byte file, in 29 seconds on a Dorado. Print may be especially useful for non-Dorado users.
The file extension defaults according to the SourceFileExtensions entry in the current user profile. If the file is already in press format, it is simply sent to a printer. (Print can also produce a press file without sending it to a printer; see the -h switch.)
Switches:
-p  print in portrait mode.
-l  print in landscape mode (this is the default).
-n nCols number of columns (default is 2 for landscape, 1 for portrait).
-s sizeFont
 size of font in points (default is 6 for landscape, 8 for portrait).
-f textFont
 font to use for the text of each page (default is Gacha).
 This font must be fixed-wdith.
-F headingFont
 font to use for the heading of each page (default is Gacha).
-h {hostName}
 By default, Print uses hostName = Hardcopy.PressPrinter
 entry of user profile. The -h switch with an empty hostName
 makes a .press file but does not send it to a printer. The -h switch
 with a nonempty hostName makes a .press file and sends it to the
 printer with that name.
-r {pfName}
 By default, Print makes a temporary Foo.press file from
 Foo.source. The -r switch with an empty pfName says retain
 the .press file; the -r switch with a pfName specified says give
 the file the specified name and retain it. A specified pfName
 of Baz does not default to Baz.press.
-c nCopies
 By default, Print prints one copy. The -c switch allows you to specify
 more copies.
-t  By default, Print indents to indicate nesting of Tioga nodes (exactly as in the
 WriteMesaPlain command, exported from TiogaExecCommands). The -t switch
 suppresses this (and makes Print run somewhat faster if nodes are present in
 the source file).
User Profile Options
Print has one User Profile option at the current time:
Print.DefaultOptions: TOKEN ← ""
Command-line options to be used each time by default. These can be overridden by actual command-line options.
Examples
Assume that Mumble is a source file, and Mumble.press is a press file, in the current working directory. Also assume that the current user profile contains the entry "Hardcopy.PressPrinter: Clover". Then
% Print Mumble
produces ///Temp/Mumble.press, ships it to Clover, and then deletes it,
% Print Mumble* Foo*.df Print.df
produces a press file called ///Temp/Mumble.press containing all of the printable files in the enumeration, ships it to Clover, and then deletes it,
% Print -h Menlo Mumble
produces ///Temp/Mumble.press, ships it to Menlo, and then deletes it,
% Print Mumble.press
ships Mumble.press to Clover,
% Print -h Mumble
produces a new version of Mumble.press on the current working directory, and
% Print -r Foo Mumble
produces a new version of Foo (not Foo.press) on the current working directory and ships it to Clover.
In these examples, if Mumble did not exist but Mumble.mesa did exist, then Mumble.mesa would be used as the source file, assuming that the current user profile contains no "SourceFileExtensions" entry (or an entry of the form "mesa ...").
Warnings
The "-r pfName" form of Print may destroy a press file that you were interested in keeping; if you want to be able to recover the previous version, be sure that its keep is at least 2 (see the SetKeep command).
Stop/Undo
The STOP! button will stop Print.
Implementation
Print.mesa in Print.df
Contact
<Diebert.PA>
Keyword Hints
print, hardcopy, fast, TSetter ...
Keywords
to be supplied by the Index Czar at the appropriate time in the future