home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / PSTSCRPT / ASCII_PS.ZIP / ASCII-PS.DOC < prev    next >
Encoding:
Text File  |  1990-05-09  |  4.1 KB  |  82 lines
  1. === Documentation for ASCII-PS
  2. === A program to dump ASCII files to a postscript printer
  3. === Author: David Jeffrey <djeffrey@uwo.ca>
  4. === Date: 6 May 1990 (my birthday)
  5.  
  6. Purpose:
  7.    This program will take a file containing ASCII text and generate
  8.    the postscript commands needed to print that file. The commands can
  9.    be sent directly to an attached printer or written to a file.
  10.  
  11. History:
  12.    My department got a laser printer and I wanted to print program
  13.    listings on it. I was particularly keen on compressing them
  14.    into the smallest number of pages possible. Similarly for
  15.    spreadsheets, posting labels etc. This is the main purpose of
  16.    the program. Other functions were later added which may be
  17.    specific to the QMS brand of printer which we bought.
  18.  
  19. Other Options:
  20.    If you have any of the following problems, you may
  21.    like to look at the other options offered by my program.
  22.          (1) Large postscript files will not produce output.
  23.          (2) When several different packages are used one after the
  24.              other, the printer appears to sulk and do nothing.
  25.  
  26. Getting started:
  27.    If you have found ASCII-PS.EXE, just run it and answer the questions
  28.    truthfully. If you have the source ASCII-PS.BAS, then load it into
  29.    QuickBasic 4.5 or similar and compile it. If your computer is
  30.    connected to the printer through a serial port with a
  31.    complete serial cable (not one of your dinky 2-wire jobbies), then
  32.    you can select any option, otherwise only the file conversion
  33.    option will be useful.
  34.  
  35. Managing QMS or similar printers:
  36.    A QMS printer runs by accepting "jobs". A job is a set of postscript
  37.    commands terminated by a control-D. If there is an error in the set
  38.    of commands, either because your application program made an error or
  39.    because there was a transmission error, there will be no output unless
  40.    you have loaded special postscript error handlers. There is, however,
  41.    an error message returned over the serial line, if you can read it.
  42.    Further, it is likely that the printer will become confused waiting for
  43.    a control-D to terminate the current job and then appear to be catatonic.
  44.    The advantages of sending a file directly to the printer using the
  45.    program are (1) the serial connection is properly managed by BASIC
  46.    rather than DOS's inadequate MODE and COPY commands. (2) Error messages
  47.    from the printer are displayed. (3) The printer can often be reset
  48.    when it appears to have halted.
  49.  
  50. Trouble-shooting:
  51.    The QuickBasic compiler is not perfect. I have found that _within_ the
  52.    Quickbasic development environment, the program always works perfectly,
  53.    but when it is compiled to a stand-alone EXE file, it sometimes
  54.    crashes, reporting an error at line 0. My QuickBasic QB.EXE file is
  55.    dated 09-28-88.
  56.  
  57.    The program cannot wake the dead. The designers of Postscript deliberately
  58.    made it possible for applications to make changes to the printer that
  59.    can only be undone by turning the printer off (like IBM computers, our
  60.    QMS has no re-set switch).
  61.  
  62.    Most printers wake up expecting XON-XOFF protocol. If your printer
  63.    requires different commands from a QMS to turn on hardware handshaking
  64.    then you will have to edit the source. "What is wrong with XON-XOFF?"
  65.    I hear you cry. Well the first version of this program was written using
  66.    QuickBasic 4.0 and the XON-XOFF protocol in that compiler did not work.
  67.    I never tested QB 4.5
  68.  
  69. This has been used for several months now on an XT-clone connected
  70.  to a QMS PS-800.
  71.  
  72. The future:
  73.    There are obviously many places where features could be added. If
  74.    someone else actually uses this program and tells me and makes a
  75.    suggestion, then I shall do something (who knows what).
  76.  
  77. Comments, improvements etc can be sent to David Jeffrey
  78.                                           Dept Applied Mathematics
  79.                                           The University of Western Ontario
  80.                                           London, Ontario, Canada N6A 5B9
  81.                                           DJEFFREY@UWO.CA
  82.