home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 19 Printer / 19-Printer.zip / prt2up.zip / read.me < prev   
Text File  |  1993-09-20  |  12KB  |  335 lines
  1. Prt2Up *** BETA TEST ***
  2. ========================
  3.  
  4. To report any bugs or ask any questions, please post a message on the
  5. CompuServe OS2AVEN forum, section 1, Other Vendors.  Address the message
  6. to:
  7.  
  8.     Guy Scharf 76702,557
  9.  
  10. If you do not have access to CompuServe, you can send an electronic
  11. mail message to me at this Internet address:
  12.  
  13.     Internet: 76702.557@compuserve.com
  14.  
  15. You may also report bugs by FAX at (415) 948-1620.
  16.  
  17. New versions of Prt2Up will be uploaded to the OS2AVEN forum, library 1,
  18. Other Vendors.
  19.  
  20.  
  21.  
  22. DISCLAIMER
  23. ==========
  24.  
  25. THIS PROGRAM IS SUPPLIED "AS IS" WITHOUT ANY WARRANTY OF ANY KIND,
  26. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  27. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  28.  
  29. IN NO EVEN SHALL SOFTWARE ARCHITECTS, INC. BE LIABLE FOR ANY DAMAGES,
  30. EITHER DIRECT OR CONSEQUENTIAL, CAUSE DBY THE USE, OR INABILITY TO USE,
  31. THIS PROGRAM, EVEN IF SOFTWARE ARCHITECTS, INC. HAS BEED ADVISED OF
  32. THE POSSIBILITY OF SUCH DAMAGES.
  33.  
  34. DO NOT USE THIS PROGRAM UNLESS YOU AGREE TO THESE CONDITIONS AND AGREE 
  35. TO ASSUME ALL RISKS.
  36.  
  37.  
  38. Prt2Up Version 0.88
  39. ===================
  40.  
  41. Prt2Up is a OS/2 2.0 print utility for printing multiple page images on a 
  42. single sheet of paper.  This program is intended to print typical 
  43. documentation and read.me files -- text files normally prepared for
  44. monospaced printing.  Both scalable and device monospaced fonts are 
  45. supported.  HPFS long names are supported.
  46.  
  47. Prt2Up is a true, 32-bit, PM application.  It should support printing, in 
  48. any supported layout, to any printer with a PM driver.  OS/2 2.0 or later
  49. is required.  As a full PM application, network printer support is
  50. enabled.  If a copy or shadow of a network printer is on the desktop,
  51. that printer can be used by Prt2Up.  
  52.  
  53. Usage:
  54.  
  55.     Prt2Up     [file names]
  56.  
  57. Without any file names, Prt2Up brings up a settings notebook.  You should
  58. first run Prt2Up without any parameters and review the parameters.
  59.  
  60. To get duplex printing, select the Printer tab and press the Setup
  61. pushbutton.  Set duplex printing in the printer properties dialog.
  62. Duplex printing is supported only if your printer and OS/2 printer driver
  63. support it.
  64.  
  65. To print files from the command line, type Prt2Up on the command line,
  66. followed by one or more file names.
  67.  
  68. To print files from the workplace shell, create a program reference
  69. object for Prt2Up, and drag files to that program reference object.
  70.  
  71.  
  72. Installation
  73. ------------
  74.  
  75. To install Prt2Up, unzip the ZIP file into a directory, use CD to make
  76. that the current directory, and type INSTALL.
  77.  
  78. To install Prt2Up manually, copy PRT2UP.EXE, PRT2UP.HLP, and PRT2.CMD
  79. to any directory included in your PATH statement.  Create a program
  80. object for PRT2UP.EXE.
  81.  
  82.  
  83. Future Enhancements
  84. -------------------
  85.  
  86. I would appreciate any suggestions on how to make this utility more useful.
  87. Here are some on the list, in no particular order.
  88.  
  89. o  Support pseudo-duplex printing (print back sides of paper in a second
  90.    pass).
  91.  
  92. o  Number lines in each file, or on each page.
  93.  
  94. o  Support mainframe ANSI carriage control characters (column 1 with
  95.    1, 0, -, +).  Carriage control would probably be mutually exclusive
  96.    with wrapping of long lines.  This would benefit people trying to
  97.    print output generated on mainframes but have little use for
  98.    people using output generated by PC programs.
  99.  
  100. o  If .LONGNAME EA exists for a file, print that name, or as much of that
  101.    name as will fit on a line.
  102.  
  103. o  Support font style and emphasis options.
  104.  
  105. o  Add Default button to each notebook page. (dcb)
  106.  
  107. o  Add Undo button to each notebook page.
  108.  
  109. o  Margin spinbuttons should not spin around end of range.
  110.  
  111. o  Support multiple INI files, using either a command line parameter or
  112.    a current directory approach.
  113.  
  114.  
  115. Far Future Ehancements
  116. ----------------------
  117.  
  118. The following features have been suggested for a future version.  They
  119. will not be implemented in the first release.
  120.  
  121. o  Support 'book' mode, allowing the user to cut a stack of paper in half
  122.    and have the first and last halves of a book.
  123.  
  124. o  Support printing of 'index tabs.'  There are some design layout 
  125.    problems associated with HPFS long names.
  126.  
  127. o  Support proportional fonts in some way.  It's not really clear how
  128.    to do this, as it involves intelligent reformatting of the text in
  129.    the file being printed.
  130.  
  131.  
  132. Known Problems and Restrictions
  133. -------------------------------
  134.  
  135. Known problems with Prt2Up are as follows.  My intention is to fix
  136. these problems, though some minor ones may become restrictions or
  137. future enhancements.  
  138.  
  139. o  With some size combinations, the frame can be cut off and not
  140.    painted.
  141.  
  142. o  Footer collides with text if Full Frame is not selected and 
  143.    using a full-height page image.
  144.  
  145. o  Program icon is not attractive on 8514 display.
  146.  
  147. o  Help is incomplete.  Not all help has been written.  Help is not
  148.    available for font dialog.
  149.  
  150. o  If you press Enter or Esc on Font notebook page, font dialog
  151.    is dismissed.  These keys will be blocked.
  152.  
  153. o  Margins on the printed page do not match the settings on LJ III-D
  154.    in landscape mode.  Portrait mode margins are fine.  The error is
  155.    in the range of 1/10".  
  156.  
  157. o  If you change selected printers, and then go to the Margins page,
  158.    the minimum margins have not been adjusted to reflect the new
  159.    printer.
  160.  
  161. o  If you change printer, printer settings, or font, and the last
  162.    selected layout is no longer valid, it is not automatically reset
  163.    to a valid value.
  164.  
  165. o  An extra blank page is sometimes generated at the end of the printout.
  166.  
  167.  
  168. Problems In Analysis
  169. --------------------
  170.  
  171. (none)
  172.  
  173.  
  174. Permanent Restrictions
  175. ----------------------
  176.  
  177. o  When run from a command line, the command window disappears
  178.    because Prt2Up is a PM application.  This will be fixed so that
  179.    if Settings notebook is not required, no focus change occurs.  Fixing
  180.    this will apparently require a separate shell program.  For now,
  181.    we'll supply a batch file to start prt2up in the background.
  182.  
  183. o  The amount of space left at the bottom of a frame may be greater
  184.    than the amount at the top of the frame.  This is a consequence
  185.    of design trade-offs.  I decided that the frame should always have
  186.    exactly the same positioning and size, independent of font size
  187.    chosen.  The frame size is related to the page size and the number
  188.    of page images requested.  The font height may not divide an
  189.    integral number of times into the frame dimension, thus leaving
  190.    a variable amount of space at the bottom of the frame.
  191.  
  192.    I decided this was better than other alternatives, such as adjusting
  193.    the font height to match the frame size (the "Procrustrean solution").
  194.  
  195.  
  196. Problems Fixed and Features Added in 0.88
  197. -----------------------------------------
  198.  
  199. o  Beta defined as running through December 31
  200.  
  201. o  Expiration date code disabled.
  202.  
  203. o  More help added.
  204.  
  205.  
  206. Problems Fixed and Features Added in 0.87
  207. -----------------------------------------
  208.  
  209. o  Beta notification screen added
  210.  
  211. o  Beta expiration added
  212.  
  213. o  Header and footer options are now in a drop-down list box (dcb)
  214.  
  215.  
  216. Problems Fixed and Features Added in 0.86
  217. -----------------------------------------
  218.  
  219. o  PRT2.CMD REXX file added to package.  PRT2.CMD allows easier printing
  220.    from OS/2 command window or full screen.
  221.  
  222. o  Page number is now restarted with 1 for each file.
  223.  
  224. o  Second file does now starts properly at top of page.
  225.  
  226. o  Cancel button on PM error box now terminates Prt2Up as it should.
  227.  
  228. o  Printing with a device font could cause a failure in GpiQueryTextBox
  229.    in prnmain.c line about 1275.  Appears to be an error in OS/2 2.1
  230.    beta when using device fonts.  Implemented a workaround.  (dcb)
  231.  
  232. o  System menu is now set to the program icon.
  233.  
  234. o  Installation utility, INSTALL.CMD, added to package.
  235.  
  236. o  Initial page margins are now set to 0.5" all around.  (dcm, re:
  237.    Okidata truncation problem)
  238.  
  239. o  A few more remnants of the old PRT2UPS name have been removed. (gts)
  240.  
  241.  
  242. Problems Fixed and Features Added in 0.85
  243. -----------------------------------------
  244.  
  245. Initials of the first person reporting each problem follow the report.
  246.  
  247. o  A few remnants of the old PRT2UPS name have been removed. (dcb)
  248.  
  249. o  The message displayed when the INI file is not found has been made
  250.    more gentle for first-time users. (dcb)
  251.  
  252. o  Minor improvements have been made to Help.  (I have converted the
  253.    help file to use IBM's HyperWrite editor.  There are a few glitches
  254.    in appearance as I do not yet fully understand how to use 
  255.    HyperWrite.)
  256.  
  257.  
  258. Problems Fixed and Features Added in 0.84
  259. -----------------------------------------
  260.  
  261. o  Automatic selection of portrait or landscape on the Layout screen
  262.    is allowed for ATM fonts, but not allowed for device fonts.  If
  263.    you have selected a device font, you can use only a paper orientation
  264.    that matches what is currently installed in the printer.  Other
  265.    options will be disabled.
  266.    
  267.    This is explained in the help text briefly for now.  A more extensive
  268.    explanation will be added later.
  269.  
  270. o  Changes to dialog sizes on Layout screen made to accomodate some
  271.    displays which truncated strings.
  272.  
  273. o  Notebook is not resized as the main window is resized.
  274.  
  275. o  Headers now work properly.  Note: using both headers and footers
  276.    without the full frame option is not recommended.  The headers
  277.    and footers are likely to blend in visually with the text being 
  278.    printed.
  279.  
  280. o  Product name changed from PRT2UPS to PRT2UP.
  281.  
  282.  
  283. Problems Fixed and Features Added in 0.82
  284. -----------------------------------------
  285.  
  286. o  Error messages (file not found, etc.) are now displayed in a message
  287.    box.
  288.  
  289. o  If you change the printer selection, the correct set of fonts
  290.    is displayed.
  291.  
  292. o  With print confirmation selected, Settings button brings up
  293.    settings notebook, but notebook was not modal.
  294.  
  295. o  File date is now formatted mm/dd rather than dd/mm.
  296.  
  297. o  Vertical line frame option is implemented.
  298.  
  299. o  Dialog title of 'ok to print' dialog improved.
  300.  
  301. o  Now recognizes Ctrl-L (dec 12) as page eject.
  302.  
  303. o  Notebook/Margins.  Margins are rounded to 0.1".  The minimum 
  304.    margin value is set to match the minimum margin reported by
  305.    the OS/2 printer driver.
  306.  
  307. o  Printer setup should now be remembered between successive
  308.    sessions.
  309.  
  310. o  Landscape settings on Layout dialog are implemented.  It is no
  311.    longer necessary to set landscape paper in printer settings to
  312.    obtain landscape output.
  313.  
  314. o  When printing X x Y pages on a single sheet using a device font
  315.    on an HP LJ III-D, there was some "slippage" and with rightmost or 
  316.    bottommost truncation of text.  This has been fixed.
  317.  
  318. o  Printing no longer hogs the message queue.
  319.  
  320. o  Correct help panels are now displayed for most functions.  Please
  321.    advise of any incorrect panel displayed.
  322.  
  323.  
  324. Debugging Information
  325. ---------------------
  326.  
  327. If strange things happen on your system, debugging information may help
  328. me determine what the problem is.  The beta version of Prt2Up uses IBM's
  329. PMPRINTF program.  If you have IBM's 32-bit version of PMPRINTF, run it
  330. while reproducing your Prt2Up problem.  Set PMPRINTF to log messages to
  331. a file.  Send me the file along with your bug report.  PMPRINTF is
  332. available on OS2USER library 17, as PMPRTF.ZIP.
  333.  
  334. --- end ---
  335.