home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / print / prtf / prtf.doc < prev    next >
Text File  |  1993-09-01  |  5KB  |  115 lines
  1.  
  2.                     Function:
  3.  
  4. This program prints a text file using PM's Postscipt fonts, rather than
  5. printer's own fonts (as would COPY file LPTn). It works from full-screen
  6. sessions and from batch files. I was amazed that such an obvious utility is not
  7. included with OS/2, so I wrote one and am putting it out for beta-testing.
  8. Please let me know at the address below if you come across any bugs or if you
  9. have suggestions for additional features. I don't promise to answer every
  10. letter but I will try to read everything and take it into consideration for
  11. future versions.
  12.  
  13.                     Usage:
  14.  prtf file [options]
  15.  
  16. Options can be specified in any order.
  17.  
  18. Option              default
  19. -f "Face Name"      Courier
  20.     Important! Put multi-word face names in quotes, e.g.,
  21.      -f "Times New Roman Bold"
  22.      -f "Helvetica Bold Italic"
  23. -q      queue       default queue
  24. -p n    pointsize   12
  25. -c n    # copies    1
  26. -a      spooler parameters
  27. Switches:
  28. -i      Italic       (This is in addition to -f "<Face> Italic")
  29. -u      Underscore
  30. -b      Bold
  31. -s      Strikeout
  32. -o      Outline
  33.  
  34. Examples:
  35.  
  36. prtf notice -o -i -b -p 168 -q laser
  37.  prints a large notice on the "laser" queue, which may have been previously
  38.  set to landscape.
  39.  
  40. prtf testf -c 50 -a "FORM=A4" -f "Helv Italic"
  41.  prints 50 copies of testf using 12-pont Helvetica Italic and A4 form on the
  42.  default queue.
  43.  
  44. You can also use the PostScipt fonts in your printer, but you must spell
  45. out their names, e.g.  -f "ITC Zapf Dingbats".
  46.  
  47.                    Known bugs:
  48.  
  49. 1. EPSON device driver hangs when it receives DevEscape(...ENDDOC...).
  50. I think it's a bug in that driver, not in this program.  DON'T USE THIS
  51. BETA VERSION WITH EPSON.DRV. It seems to work fine with all the other
  52. printer drivers I've tried.
  53.  
  54. 2. OS/2's SplQueryQueue API sometimes returns garbage (2 smiley faces) instead
  55. of the printer driver. The remedy is to open the settings notebook for the
  56. printer queue, go to the "printer driver" page, and click on the default
  57. printer driver. This is definitely a bug in OS/2 2.1 and not this program.
  58.  
  59. 3. Certain PostScript printers complain about forms mismatch, print anyway.
  60.  
  61.                     Limitations and other notes:
  62.  
  63. Because the program must work in full-screen mode, it cannot bring up
  64. job dialog and font selection boxes. If you want to set job parameters,
  65. such as landscape printing, do it before using the printer object.
  66.  
  67. In particular, if your spooler queue is set to print to file and the
  68. dialog box must be displayed, prtf won't print (there will be an
  69. error about the print job aborted when opening device context).
  70.  
  71. Some text files use backspaces and carriage returns without line feeds
  72. to generate overstricken characters and underlining.  This should work with
  73. fixed-width fonts.
  74.  
  75. Network printing: Because the picture is computed locally, PM does not allow
  76. UNC names for remote queues. To print to a remote queue, install it locally
  77. using Templates->Network printer->Install.
  78.  
  79.                     Source code:
  80.  
  81. The source code compiles under IBM C Set++. It demonstrate the usefulness of
  82. the goto statement. The commented code under "never" demonstrates an
  83. alternative way of sending data (raw only!) to a printer queue using spl calls.
  84. I've noticed that such programs as emTeX and the various ports of Ghostscript
  85. all try to handle various printers by providing their own device drivers. This
  86. program shows how one can compose a page and let Presentation Manager print it
  87. using its own device-specific driver. I'll be happy to see this trick
  88. incorporated into programs, which brings us to the subject of
  89.  
  90.                     Copyright:
  91.  
  92. This program is copyrighted (C) 1993 by Dimitri Vulis. However the public
  93. is granted an unlimited licence to do as it pleases with this program and
  94. its source code. Obviously, there is
  95.  
  96.                     No warranty:
  97.  
  98. This program is provided "as is" without warranty of any kind. This is a
  99. beta-test program which may be reasonably expected to contain "bugs". You
  100. assume all risks of running such a beta test program in a production
  101. environment.
  102.  
  103.                     Donations:
  104.  
  105. If you find this program useful, please send me $20. If you can't afford $20,
  106. I'd appreciate $5.  But you don't really have to. :)
  107.  
  108.                     Author:
  109.  
  110.           Dimitri Vulis
  111.           67-67 Burns St., Apt. 4K
  112.           Forest Hills, NY 11375
  113.           Tel: 718-261-6839
  114.           Internet: DLV@DM.COM
  115.