home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 160.lha / gwPrint.doc < prev    next >
Text File  |  1988-04-27  |  6KB  |  172 lines
  1. gwPRINT.doc            document for            23-may-87
  2.  
  3.      `gwPRINT'  an AMIGA Program to Format the Printing of Text Files.
  4.  
  5.   gwPRINT was designed to make the printing of textfiles with margins,
  6.   headers, and a large range of other user preferences a simple task.
  7.   Output is to the Printer Device, which must be installed properly.
  8.  
  9.   A few minutes of playing with the gadgets will reveal their simplicity.
  10.   Note that some are toggled to a different values when you click them.
  11.   Some are standard Integer and String gadgets and some control the
  12.   printing process.
  13.  
  14. Header Gadgets:
  15. ==============
  16.  
  17.   `Style'    determines how the header is printed.
  18.  
  19.   `Title'    if ON, the string in the other `Title' gadget is used for
  20.         the left part of the header.
  21.  
  22.   `Date'    if ON, the system date is placed in the center of the header.
  23.  
  24.   `Page Nos'    if ON, places page numbers in the right portion of the header.
  25.  
  26.          The `Title' & `Date' & `Page Nos' must all be turned off to
  27.         completely eliminate a header.
  28.  
  29.          If the `Page Len' is zero, at most, only one header will be
  30.         printed at the beginning of the document.
  31.     
  32. Format Gadgets:
  33. ==============
  34.  
  35.   `Pitch'    determines the size of print characters for the text file.
  36.  
  37.   `Quality'    determines print quality of the text.
  38.  
  39.   `LPI'        Lines Per Inch.
  40.  
  41.   `Left Mar'    determines the print position of the leftmost character in
  42.         each line of the document.  Also used with the header.
  43.         Note, multiples of 8 for simplicity,
  44.  
  45.   `Page Len'    Page Length can be set to zero to disable paging.
  46.         Relative to Lines Per Inch.
  47.  
  48.   `Pg 1 Off'    Page 1 Offset allows the first page of a document to be
  49.         shorter than the others to compensate for printers which align
  50.         paper so you so you can't print get at the first few lines of
  51.         the first page.
  52.  
  53.   `Vert Mar'    Vertical Margins specify the number of blank lines for the
  54.         top and bottom margins and if there is a header, the space
  55.         between it and the first line of text on a page.
  56.  
  57.   `Right Mar'    Right Margin, the last column to be printed in.  Also used with
  58.         the header.
  59.  
  60. Other Gadgets:
  61. =============
  62.  
  63.   `File'    A valid file specification string for the file to be printed.
  64.  
  65.         When gwPrint first starts, it places the first CLI argument
  66.         to initalize this gadget.  If there are no CLI arguments,
  67.         the `File' gadget is automatically activated.
  68.  
  69.   `Title'    A string for the header.
  70.         Each time the File gadget detects a return it sets the `Title'
  71.         gadget to the filespec with the Dos path removed.  But, only
  72.         if the gadget is empty.  Use the Amiga x to clear it.
  73.  
  74. Control Gadgets:
  75. ===============
  76.  
  77.   `Begin'    Starts the printing according to the current settings.
  78.  
  79.   `Pause/Cont'    Toggles the Printing and Holding modes.
  80.  
  81.   `Abort'    Aborts the current file being printed.
  82.  
  83. Error Conditions:
  84. ================
  85.  
  86.   Error Opening File      - File Not Found.
  87.   Error Reading File    - 
  88.   Error Opening Printer - Printer Device Busy.
  89.   Error Writing Printer - Printer off line.
  90.   Empty File        -
  91.   Bad Text        - a null byte was found in text file.
  92.   Weird Settings    - one or more of the integer gadgets contains number(s)
  93.               which describe an impossible format.
  94.               Check for negative values, large vertical margins,
  95.               or a right margin smaller than the left.
  96.  
  97. Misc Notes:
  98. ==========
  99.  
  100.   To Print only one page header per document set the page length to zero
  101.   and turn on the desired header gadgets.
  102.  
  103.   Titles can be 79 characters long, but the `Date' and `Page Nos' gadgets
  104.   may need to be off to prevent conflicts.
  105.  
  106.   Once a printing is started you can change the gadgets settings for the next
  107.   printout without affecting the current printing.
  108.  
  109.   Often I edit a document using the full 80 columns of the display and no
  110.   margins. To print this file, I set the Left Margin gadget to 9 and the
  111.   Pitch gadget to elite.  This gives me a document with nice margins and
  112.   a full 80 characters on a line.  This also takes the margin information
  113.   out of the file to decrease its size and makes it easier to wordprocess.
  114.  
  115.   Be aware that printers with large buffers will accept data much quicker
  116.   than they can print it.  So, if you hit `Abort' or `Pause/Continue' the
  117.   program will stop sending data immediately, but the printer may take
  118.   awhile to finish printing what its already received.
  119.  
  120.   gwPrint will execute from a WorkBench Icon or the CLI and opens a window
  121.   in the WorkBench screen.
  122.     
  123.   Some printers may not support all of gwPrint's options.
  124.  
  125.   The printer device is only Open while actually sending data to the printer.
  126.  
  127.   When printing a counter tracks the number of text lines sent to the printer.
  128.  
  129.   A formfeed gadget, a reset printer gadget, and file requester were
  130.   not included for overhead reasons.
  131.  
  132. Development:
  133. ===========
  134.  
  135.   AmigaDos 1.2, Lattice 3.03, BLink65, AStartup, and `FixHunk'd for the big boys.
  136.   Every effort was made to ensure a safe, efficient, productive Amiga Program.
  137.   Lattice 3.10 generated an object file almost 50% larger.
  138.  
  139. Bugs/Quirks:
  140. ===========
  141.  
  142.   Currently, with the Okidata92 driver I get a single linefeed when the
  143.   Printer Device is opened for the first time.  This causes only the first
  144.   document printed after a boot to be shifted down one row on the page.
  145.   It must be in my driver ????
  146.  
  147.   Doesn't properly handle filenames with embedded spaces from the CLI.
  148.  
  149. ============================================================================
  150.  
  151.   `gwPrint'  an AMIGA Program to Format the Printing of Text Files.
  152.  
  153.   Copyright (c) 1987  by Gaylan D. Wallis ;  ALL RIGHTS RESERVED
  154. Permission is granted to use, copy, and distribute the program `gwPRINT'
  155. providing that no fee shall be charged for such copying and distribution,
  156. and that both `gwPRINT' and `gwPRINT.doc' are distributed together and in
  157. their unmodified state.
  158.  
  159.   gwPrint is offered `as is' under `ShareWare' terms.  Please try it and
  160. pass it on.  When and if you discover it worth having.  Please consider a
  161. small voluntary contribution that I may continue to produce more and better
  162. Amiga Software.
  163.  
  164.   Contributions, Suggestions, Comments and Request should be sent to:
  165.  
  166.     Gaylan Wallis
  167.     1324 Parkwoods Terr.
  168.     Midwest City, Ok  73110
  169.  
  170.     bix: gwallis        Ace BBS OKC  (405)-631-9040
  171.  
  172.