-- 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
name
Print
syntax
Print {-p} {-n nCols} {-s sizeFont} {-h {hostName}} {-r {pfName}} {-c nCopies} {-t} filePattern {filePattern} ...
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 By default, Print prints landscape; the -p switch says print portrait instead.
-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).
-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).
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
keyword hints
print, hardcopy, fast, TSetter ...
keywords
to be supplied by the Index Czar at the appropriate time in the future