-- IPrintDoc.tioga
-- last edited by vanLeunen, January 5, 1984 3:58 pm
-- last edited by MBrown, January 6, 1984 11:26 am
-- last edited by Plass, March 6, 1984 4:26:44 pm PST
name  IPrint
syntax
IPrint {-p} {-h {hostName}} {-r {pfName}} {-c nCopies} {-t} file
description
IPrint is useful for quick printing whenever speed is more important than formatting.  For instance, IPrint produced an Interpress 
file from /Indigo/Cedar/Documentation/Dependencies.txt, a 163497 byte file, in 13 seconds on a Dorado.  IPrint 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 
Interpress format, it is simply sent to a printer.  (IPrint can also produce an Interpress file without sending it to a printer; 
see the -h switch.)
    Switches:
    -p     By default, IPrint prints landscape (Gacha 6 two columns);
             the -p switch says print portrait instead (Gacha 8 one column).
    -h {hostName}     By default, IPrint uses hostName = Hardcopy.interpressPrinter
                               entry of user profile.  The -h switch with an empty hostName
                               makes a .interpress file but does not send it to a printer.  The -h switch
                               with a nonempty hostName makes a .interpress file and sends it to the
                               printer with that name.
    -r {pfName}     By default, IPrint makes a temporary Foo.interpress file from
                            Foo.source.  The -r switch with an empty pfName says retain
                            the .interpress 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.interpress.
    -c nCopies     By default, IPrint prints one copy.  The -c switch allows you to specify
                         more copies.
    -t         By default, IPrint indents to indicate nesting of Tioga nodes (exactly as in the
               WriteMesaPlain command, exported from TiogaExecCommands).  The -t switch
               suppresses this (and makes IPrint run somewhat faster if nodes are present in
               the source file).
    examples
    Assume that Mumble is a source file, and Mumble.interpress is an Interpress file, in the current working directory.  Also assume 
    that the current user profile contains the entry "Hardcopy.interpressPrinter: DontYouWishWeHadOne".  Then
        % IPrint Mumble
            produces ///Temp/Mumble.interpress, ships it to DontYouWishWeHadOne, and then deletes it,
        % IPrint -h YouHaveOne Mumble
            produces ///Temp/Mumble.interpress, ships it to YouHaveOne, and then deletes it,
        % IPrint Mumble.interpress
            ships Mumble.interpress to DontYouWishWeHadOne,
        % IPrint -h Mumble
            produces a new version of Mumble.interpress on the current working directory, and
        % IPrint -r Foo Mumble
            produces a new version of Foo (not Foo.interpress) on the current working directory and ships it to DontYouWishWeHadOne.
    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 IPrint may destroy an Interpress 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).
    Since we don't have any Interpress servers yet, the Interpress files are not sent anywhere.
    stop/undo 
    The STOP! button will stop IPrint.
    implementation 
    IPrint.mesa in IPrint.df
    contact
    MBrown
    keyword hints
    print, hardcopy, fast, TSetter, Interpress...
    keywords
    to be supplied by the Index Czar at the appropriate time in the future