home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / nyword.zip / GUIDE5 < prev    next >
Text File  |  1986-11-25  |  24KB  |  498 lines

  1.  
  2.  
  3.  
  4.                                        27
  5.  
  6.  
  7.         5. PRINT COMMANDS
  8.         
  9.              In order to obtain a printout of a document, it is first
  10.         necessary to get the file into memory.  When the text is printed,
  11.         the details governing the appearance of the document are
  12.         controlled through these three mechanisms:
  13.         
  14.              1. Margin Settings.  The margins are set according to the
  15.                 parameters described in section 5.1.
  16.         
  17.              2. Printer Codes.  The special codes which make your printer
  18.                 function are contained in the file TW.DAT, described in
  19.                 section 6.2.
  20.         
  21.              3. Dot Commands.  Special printer commands can be inserted
  22.                 directly into your text.  These commands are recognized
  23.                 because they are at the start of a line and they begin
  24.                 with a period, a situation which would not normally
  25.                 arise.  These commands are described in section 5.5.
  26.         
  27.              When you are in the editing mode, you can determine your
  28.         location in the printout by hitting ^P (Ctrl-P).  This command
  29.         will internally simulate the printing process, including all dot
  30.         commands, equations, and figures; and stop when it gets to the
  31.         cursor's location in the file.  The corresponding page number and
  32.         distance in inches from the top line of that page are then
  33.         displayed.
  34.         
  35.         
  36.         5.1 Setting Margins
  37.           
  38.              RGB-TechWriter saves formatting information along with the
  39.         file so that whenever that file is retrieved; the margins, pitch,
  40.         spacing, and line length are set appropriately for that document.
  41.         It is best if this information is set properly when the file is
  42.         saved for the first time, but it is still a good idea to confirm
  43.         that the margins are set correctly before you attempt to print
  44.         the text.  To check or alter the margin information, use
  45.         
  46.         M - Margin Settings.  This command leads you through a list of
  47.         eight parameters which are stored along with the file.  For each
  48.         parameter, the current value is listed.  If that value is
  49.         satisfactory, you can simply hit the Enter key.  If you want to
  50.         change the parameter, then use the number keys to enter the new
  51.         value.  You can only use the numeric keypad if you hold down the
  52.         shift key or have hit the NumLock key.  Hit the Enter key when
  53.         you are done typing the new value.  After all eight parameters
  54.         have been reviewed, the text in memory is realigned from
  55.         beginning to end to insure that it fits into the specified line
  56.         width.  The eight parameters presented are:
  57.         
  58.  
  59.  
  60.  
  61.  
  62.  
  63.         PRINT COMMANDS
  64.  
  65.  
  66.                                        28
  67.  
  68.  
  69.              1. Pitch.  The number of characters per inch.
  70.              2. Line Width.  The number of characters per line.
  71.              3. Left Margin.  Inches of space on the left.
  72.              4. Top Margin.  Inches of space above the first line.
  73.              5. Paper Length.  Length of paper in inches (or 0).
  74.              6. Text Length.  Inches of text on each page.
  75.              7. Line Spacing.  Zero through Quad (Single=1.0).
  76.              8. Page Number Location.  Top, Bottom, or Top-Right.
  77.           
  78.         These values are interrelated so that the value entered for one
  79.         may affect the allowed range of values for subsequent values.
  80.         For example, the text length cannot be set any greater than the
  81.         paper length minus the top margin, minus 0.5 inch.  This insures
  82.         that there will be room on the paper for both the text and the
  83.         header and footer lines.  Alternatively, you can set the paper
  84.         length to 0, in which case RGB-TechWriter lets your printer keep
  85.         track of the paper length by sending a form feed command at the
  86.         start of each new page.  If you try to enter an invalid response
  87.         for any of the parameters, a valid response is substituted and
  88.         the query is repeated.  Further information about these
  89.         parameters is given in section 6.1.
  90.         
  91.         
  92.         5.2 Print to Printer
  93.           
  94.         Printing is initiated from the file screen menu by entering:
  95.         
  96.         P - Print Text.  You will be asked whether you wish to print to
  97.         the screen, the printer, or the disk.  Printing is normally done
  98.         to a hard-copy printer.  However, RGB-TechWriter also supports
  99.         printing to the screen or to a disk file.  These options are
  100.         described in the sections which follow.  Having made your choice,
  101.         you can then enter the first and last page you want printed.
  102.         These are page numbers, which will start with page 1 unless this
  103.         has been changed using the dot command NUMBER (see section 5.5).
  104.         If you want to start at the beginning, or continue to the end,
  105.         just hit the Enter key in response to these queries.  You can
  106.         then specify the number of copies to be printed.  Entering 0 at
  107.         this point is a good way to avoid printing if you have changed
  108.         your mind.  Beyond this point, the activity differs depending on
  109.         your selection of the screen, printer, or disk.  To stop the
  110.         printout to any of the three devices, just hit "P" again.
  111.         
  112.              It is strongly recommended that you make a habit of saving
  113.         your file before you print it, because errors during printing
  114.         (like running out of paper) can cause the computer to get lost in
  115.         certain situations.  In particular, hitting either Ctrl-Break or
  116.         Ctrl-C while printing to either the printer or the screen will
  117.         cause you to exit RGB-TechWriter and lose the text that was in
  118.         memory.
  119.         
  120.  
  121.  
  122.  
  123.  
  124.  
  125.         PRINT COMMANDS
  126.  
  127.  
  128.                                        29
  129.  
  130.  
  131.              If you selected the printer as the output device, and your
  132.         printer supports both data quality and correspondence quality
  133.         printing, you will be prompted to select between the two.  Enter
  134.         either C for correspondence or D for data quality.  If you just
  135.         hit the Enter key, the print routine is aborted and you return to
  136.         the file screen menu.
  137.         
  138.              First the print routine processes any dot commands which
  139.         appear at the beginning of your file.  This allows you to set up
  140.         the page number and header before printing of the first page
  141.         begins.  This initialization stage is terminated upon
  142.         encountering the first line of text or an EJECT, SKIP, or FIGURE
  143.         START dot command.  The printing process proceeds through the
  144.         entire text, but is internally suppressed for page numbers which
  145.         lie outside the range specified in response to the Print Text
  146.         command.  If this range does not start with the first page and
  147.         your printhead is not initially set to the top edge of the paper,
  148.         the paper is advanced to the top line of the next sheet, so that
  149.         the printer will be ready to begin printing when the first page
  150.         in the specified range is reached.  Once a page is encountered
  151.         that is within the specified page range, the header is printed if
  152.         one has been defined.  The header includes both the user-defined
  153.         header label and the page number, provided that the page number
  154.         location has been set to either the top or top-right position.
  155.         The location of the header line is always 1/2 inch above the
  156.         first line of text.
  157.         
  158.              Printing of the page proceeds using the specified line
  159.         spacing until the allowed length of text for that page has been
  160.         filled.  Dot commands are processed as they are encountered.
  161.         Factors which can cause an early skip to the top of the next page
  162.         are: insufficient room for an equation, the EJECT or SKIP dot
  163.         commands, and insufficient room for the minimum block size if
  164.         specified by a BLOCK dot command (see section 5.5).
  165.         
  166.              The footer is printed at the bottom of each page.  This
  167.         includes both the footer label and the page number, if the page
  168.         number location has been set to the bottom.  The footer line
  169.         appears 1/2 inch below the last printable line on the page.  This
  170.         corresponds to 1/2 inch plus the text length plus the top margin
  171.         below the top of the paper.  Thus in the typical situation where
  172.         the top margin is 1 inch, the text length is 9 inches, and the
  173.         paper is 11 inches, there will be 1/2 inch of margin above the
  174.         header and below the footer.
  175.         
  176.              After printing the header at the top of each page, any empty
  177.         lines in the text are skipped so that the next printable line
  178.         will start on the top line of the page.  An empty line is defined
  179.         as one which contains nothing except spaces and a carriage-return
  180.         marker.
  181.         
  182.  
  183.  
  184.  
  185.  
  186.  
  187.         PRINT COMMANDS
  188.  
  189.  
  190.                                        30
  191.  
  192.  
  193.              Any lines which would extend beyond the allowed width of the
  194.         printer are cut off at the right-hand edge of the paper.  When
  195.         the print routine either reaches the end of the text in memory,
  196.         the page number exceeds the last one requested, or a stop-print
  197.         command is issued, the paper is advanced for a final footer and
  198.         the printhead is returned to the same place it started with
  199.         respect to the top of the page.
  200.         
  201.         
  202.         5.3 Print to Screen
  203.           
  204.              The ability to print to the screen is a valuable tool for
  205.         reviewing your file before committing it to paper.  All of the
  206.         dot commands, page numbers, headers, and footers are active in
  207.         the print to screen just as they will appear on paper.  The only
  208.         differences in printing to the screen are:
  209.         
  210.              1. The left margin is ignored.  This allows longer lines to
  211.                 fit onto the screen's limited 80-column width.
  212.         
  213.              2. Fractional line spacing is rounded.  The screen can't put
  214.                 lines up at odd intervals, so each printed line is placed
  215.                 on the closest available screen line.  The same number of
  216.                 lines per page will be displayed as will appear on paper.
  217.         
  218.              3. All nonstandard characters are printed as blank spaces.
  219.                 This includes superscripts, subscripts, and alternate
  220.                 characters. Bold characters will appear as normal
  221.                 characters.
  222.         
  223.              4. Right justification will be accomplished by inserting
  224.                 spaces between words, even if your printer supports
  225.                 micro-justification.
  226.         
  227.              5. You can cause the printout to pause for inspection by
  228.                 hitting either Ctrl-NumLock or Ctrl-S.  The print is
  229.                 resumed by hitting any key. Warning! Do not hit either
  230.                 Ctrl-Break or Ctrl-C.
  231.         
  232.         
  233.         5.4 Print to Disk
  234.           
  235.              It is often desirable to create a disk file which looks as
  236.         much as possible like the printed document.  This file can be
  237.         uploaded to another computer or copied to a printer which RGB-
  238.         TechWriter doesn't directly support.  The file will look just
  239.         like the printed version with these exceptions:
  240.         
  241.              1. Fractional line spacing is rounded.  Files don't allow
  242.                 fractional line spacing, so each printed line is placed
  243.                 on the closest available file line.  The same number of
  244.                 lines per page will be generated as appear on paper.
  245.         
  246.  
  247.  
  248.  
  249.         PRINT COMMANDS
  250.  
  251.  
  252.                                        31
  253.  
  254.  
  255.              2. All nonstandard characters are printed as blank spaces.
  256.                 This includes superscripts, subscripts, and alternate
  257.                 characters. Bold characters will appear as normal
  258.                 characters.
  259.         
  260.              3. Right justification will be accomplished by inserting
  261.                 spaces between words, even if your printer supports
  262.                 micro-justification.
  263.         
  264.              4. The "Initial Top Margin" (see section 6.2) is set to
  265.                 zero.  If the disk file is later printed on paper, the
  266.                 printhead should start out located at the top edge of the
  267.                 paper.
  268.         
  269.         The disk file created in this way is given the same name as the
  270.         original file, but with the suffix .PRN, for "Printed Version."
  271.         This file's format is strictly standard ASCII.  None of the extra
  272.         information about special characters is present in this file.
  273.         You can review or even modify this file using RGB-TechWriter if
  274.         the need arises.
  275.         
  276.         
  277.         5.5 Dot Commands
  278.           
  279.              Whenever a line starts with a period, it is interpreted as a
  280.         dot command rather than as text to be printed.  These commands
  281.         perform a variety of functions related to the printing of the
  282.         file.  The dot commands which are recognized are listed below.
  283.         If an unrecognizable dot command is encountered, a warning
  284.         message is generated and the line is printed as normal text.  The
  285.         commands can be written in either small or capital letters.  A
  286.         synopsis of the available dot commands is contained in the
  287.         editing menu, accessible from the editor by pressing function key
  288.         F1.  Lines which start with a period are allowed to extend to
  289.         column 255, regardless of the current setting of the line width.
  290.         
  291.         ALT - This command allows you to define (or redefine) any of the
  292.         95 allowed alternate characters directly from within the text.
  293.         This is particularly useful if you need an unusual character, but
  294.         don't expect to use it frequently.  A single space should be left
  295.         after the ALT command, followed by the character to be
  296.         translated, another space, and the corresponding ASCII equivalent
  297.         string.  This format is identical to that used in the TW.DAT
  298.         printer configuration file, described in section 6.3.  The
  299.         alternate character is redefined when you print the text to
  300.         screen, printer, or disk; and the new definition remains in
  301.         effect until you exit to DOS (even if you start editing a new
  302.         file).  This means that you could create a file containing
  303.         nothing but a series of .ALT commands to define a set of
  304.         alternate characters.  To load that character set you could
  305.         simply get that file into memory and print it to screen.  When
  306.         you subsequently get another file into memory, it will be printed
  307.         using the new alternate character set.
  308.         
  309.  
  310.  
  311.         PRINT COMMANDS
  312.  
  313.  
  314.                                        32
  315.  
  316.  
  317.         BLOCK # - This complex command is designed to help avoid
  318.         stranding only one or two lines of a block of text at the bottom
  319.         of a page.  The value supplied by # can be any positive integer.
  320.         Initially this value is set to 1.  Setting # to a number greater
  321.         than 1 insures that if a block has more than # lines, no fewer
  322.         than # lines of the block will appear at the bottom of a page.
  323.         If the minimum number of lines will not fit, the rest of the page
  324.         is left blank and the block is started at the top of the next
  325.         page.  The definition of a block is any group of lines which is
  326.         both preceded and followed by either an empty line, an equation
  327.         line, or a dot command.  An empty line is one which contains
  328.         nothing but a carriage-return marker.  Thus, to make sure that a
  329.         section title doesn't get separated from the text which follows,
  330.         set # to 3 or more, and make sure that the blank line between the
  331.         title and the text contains at least one space so that the title
  332.         and text are forged into a single block.  If you want to create a
  333.         division between two blocks without inserting an empty line, use
  334.         the REM dot command.
  335.         
  336.         EJECT - Forces an immediate skip to the top of the next page,
  337.         leaving the rest of the current page blank except for the footer.
  338.         
  339.         FIGURE - After the current page is completed, the following page
  340.         is left blank except for the header and footer, including the
  341.         page number.  Place this command immediately after the paragraph
  342.         which first references a full-page figure.  Then wherever that
  343.         paragraph appears in the printout, the page after it is left
  344.         blank for pasting in the figure or table.
  345.         
  346.         FOOTER ##### - Sets the footer label to #####, effective with the
  347.         next page.  Special characters like boldface, superscripts, and
  348.         alternate characters will print as normal characters in the
  349.         footer.  To get a footer on the first page, this command must
  350.         appear near the start of the text, before any printable text. The
  351.         footer is printed starting 1/2 inch directly below the first
  352.         column of the last allowed line location on each page. To turn
  353.         the footer off, enter the command without any #####.
  354.         
  355.         HEADER ##### - Sets the header label to #####, effective with the
  356.         next page.  Special characters like boldface, superscripts, and
  357.         alternate characters will print as normal characters in the
  358.         header.  To get a header on the first page, this command must
  359.         appear near the start of the text, before any printable text.
  360.         The header is printed starting 1/2 inch directly above the first
  361.         column of the top line of each page.  To turn the header off,
  362.         enter the command without any #####.
  363.         
  364.         JUSTIFY ON - Initiates right-justification of the printed text.
  365.         Only those lines which do not end with a carriage-return marker
  366.         are justified.  The right justification is not shown when editing
  367.         the text, but it is shown if you print to the screen.  If your
  368.         printer supports horizontal motion indexing (HMI), then the
  369.         justification is "micro-justification," where the extra space
  370.         needed to fill out each line is divided equally between all
  371.  
  372.  
  373.         PRINT COMMANDS
  374.  
  375.  
  376.                                        33
  377.  
  378.  
  379.         characters and spaces on the line.  If your printer does not
  380.         support HMI, the extra space needed to fill out the line is
  381.         accomplished by allocating extra spaces between words.  The
  382.         print-to-screen and print-to-disk options use the method of extra
  383.         spaces between words.
  384.         
  385.         JUSTIFY OFF - Turns off right-justification.  This is the
  386.         default.
  387.         
  388.         NUMBER ## - Sets the page number, effective with the next page.
  389.         The ## can be any integer value (even negative).  The pages which
  390.         follow will have successive page numbers.  The first page of the
  391.         file is initially set to 1 unless you use this command to set it
  392.         otherwise, in which case this command must appear near the start
  393.         of the text, before any printable text.
  394.         
  395.         NUMBER ON - Turns on page numbering, effective with the next
  396.         page.  Page numbering is initially off, so to get numbering you
  397.         must include this statement in your text.  To get a page number
  398.         on the first page, this command must occur near the start of the
  399.         text, before any printable text.
  400.         
  401.         NUMBER OFF - Turns off page numbering, effective with the next
  402.         page.
  403.         
  404.         REM - Remark line.  The entire line which starts with this
  405.         command is ignored, to allow you to insert reminders to yourself.
  406.         
  407.         SKIP #.## - Allocates a contiguous block of empty space which is
  408.         #.## inches in length.  If there isn't enough room left on the
  409.         current page, the space is placed at the top of the next page,
  410.         leaving the rest of the current page blank except for the footer.
  411.         
  412.         SPACE #.## - Changes the line spacing to #.##, where #.## is
  413.         referenced so that 1.0 is single spacing, 2.0 is double spacing,
  414.         etc.  Values from 0.0 to 4.0 are permitted, including fractional
  415.         spacing like 1.5.  The new spacing takes effect immediately, and
  416.         continues until another SPACE command is encountered.  The
  417.         initial value for SPACE is set from the Margin Setting command
  418.         (M) in the file screen menu.  Printing to the screen or disk can
  419.         not faithfully reproduce fractional line spacing.  Spacing less
  420.         than 1 is useful for very complex expressions, but see section
  421.         4.3 for use of subscripts and superscripts in this case.
  422.         
  423.         TABLE START - This command can be used to indicate the beginning
  424.         of a table.  A "table" could just as easily be a figure, where
  425.         you leave room to paste in the figure and only type the caption
  426.         at the bottom.  When the text is printed, the table will be
  427.         inserted where it appears in the text if there is enough room for
  428.         it on the current page.  If there is not enough room, the table
  429.         is delayed until the top of the next page.  The current page is
  430.         then filled out with the text that follows the table.  If another
  431.         table closely follows the first, it is also delayed until the
  432.         next page, even if it would fit in the remaining space on the
  433.  
  434.  
  435.         PRINT COMMANDS
  436.  
  437.  
  438.                                        34
  439.  
  440.  
  441.         current page.  Thus the tables will always appear in the proper
  442.         sequential order.  The line spacing is automatically changed to
  443.         single spacing beginning with the first line following the TABLE
  444.         START command.  It is restored to its previous value following
  445.         the TABLE END command.  You can change the spacing within the
  446.         table using the SPACE dot command.  You may also use other
  447.         printer dot commands within the table like SKIP and EJECT.  If
  448.         you use EJECT (to create a full-page table or figure), it should
  449.         be the last line before the TABLE END command.  You can also use
  450.         equation lines within the table.  If the table as defined does
  451.         not fit on a single page, the table is printed where it appears
  452.         in the text.  This situation can result if you use a TABLE START
  453.         command but forget the matching TABLE END command.
  454.         
  455.         TABLE END - Identifies the end of a table.  This command causes
  456.         an error message if a preceding TABLE START command has not been
  457.         encountered.  You will want to leave one or two blank lines
  458.         between the end of the table and the TABLE END command to
  459.         separate the table from the text which follows.
  460.          
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.         PRINT COMMANDS 
  498.