home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / util / print / addlprep.sit / AddLPrep docs next >
Encoding:
Text File  |  1989-12-08  |  8.0 KB  |  166 lines
  1. AddLPrep v1.2 Documentation  7/31/89
  2.  
  3. Apple's LaserWriter system allows a user to get a complete PostScript 
  4.  disk file (including the library code from the "Laser Prep" file) by 
  5.  hitting Command-K WHILE MOUSING DOWN on OK from the LaserWriter Print 
  6.  dialog, or a file without the library code by hitting Option-F.  
  7.  Option-K and Command-F may do one or the other (??). 
  8.  
  9. Unfortunately, the Laser Prep code includes a few features that make 
  10.  the Command-K file unusable on certain non-Apple laser printer systems, 
  11.  such as a DEC ScriptPrinter connected to a VAX.  
  12.  
  13. The AddLPrep program remedies this situation by adding a modified version 
  14.  of the PostScript code from the Laser Prep file to a PostScript file 
  15.  created by hitting Option-F.
  16. The output file produced by AddLPrep is thus suitable for
  17.  downloading to any PostScript printer or typesetter.
  18.  
  19. This version (1.2) differs from 1.1 in two ways:
  20. 1. It works with "Laserwriter 6.0" (AppleDict 70) as well as System 6.0 
  21.    (AppleDict 68) and System 5.0 (AppleDict 65).
  22. 2. A problem is fixed, wherein the DA version caused a system crash 
  23.    after an error message.
  24.  
  25. VERY IMPORTANT: AddLPrep is SHAREWARE and is copyright ⌐ 1988 by 
  26.  Software101, Los Gatos, CA.  Feel free to try it out and give 
  27.  copies to others, but if you find the program useful and continue 
  28.  to use it, send $20 to Software101, 15151 Old Ranch Road, Los Gatos, 
  29.  CA  95030.  As indicated below, this program may need considerable 
  30.  support; problems will be solved only for those who have paid 
  31.  for the program.  Someday, in some manner, new versions may be 
  32.  available only to those honest folks.
  33.  
  34. "Thank you for your support"
  35.                     -- Bartles & Jaymes, 1986
  36.  
  37. ALSO VERY IMPORTANT: The contents of the Laser Prep file are copyrighted 
  38.  by Apple Computer, and using the output of this program for any 
  39.  purpose other than 1) downloading to a PostScript printer, or 
  40.  2) study of PostScript programming techniques, is almost 
  41.  certainly a violation of that copyright.
  42.  
  43. GETTING READY:
  44. Since you're reading this, you've already mastered the first step:
  45. unpacking the distribution (.sit) file using the Stuffit program.
  46. There are two versions of AddLPrep in this package; one is an application
  47. that can be started from the Finder, the other is a Desk Accessory that
  48. can be selected from the Apple menu while using any program that supports
  49. Desk Accessories (most do).
  50.  
  51. If you want to use the Desk Accessory version, the next step is to
  52. use Apple's Font/DA Mover program to move the contents of the AddLPrepDA
  53. file to your System file.  If you don't have a hard disk, you'll need 
  54. to transfer it to the System files on all the floppies you want to use 
  55. it with.
  56.  
  57. In order to use either version, you must have a copy of the LaserWriter
  58. driver and the matching Laser Prep file in your System Folder (if you
  59. dont have a hard disk, in the System Folders on all the floppies you want 
  60. to use it with.
  61.  
  62. OPERATION: 
  63.  1) If necessary, use the Chooser DA to select the LaserWriter.
  64.     You don't have to actually have a LaserWriter connected to 
  65.     your Mac, but if you have an ImageWriter or something else
  66.     connected to your serial Printer port, be sure to turn its
  67.     power off before you use Chooser!
  68.  2) Start the application that produces the printout you want,
  69.     and open the document you want to print.  Or, just double-
  70.     click on the document from the Finder.  Or, most elegantly,
  71.     single-click on the document and choose Print from the Finder's
  72.     File menu.
  73.  3) Unless you did so from the Finder, choose Print from the 
  74.     application's File menu.
  75.  4) After selecting whatever options you want from from the LaserWriter 
  76.     Print dialog, press the mouse button down on the OK button AND HOLD 
  77.     IT DOWN!!  Now, while holding it down, hit Option-F on the keyboard. 
  78.     With some programs it may be necessary to hold Option and F down 
  79.     for a short while so as to "repeat" the key strike.  Then release 
  80.     the mouse button.
  81.  5) You should see a message box near the top of the screen saying 
  82.     something like "Creating PostScript file".  A disk file will be 
  83.     created named "PostScriptn", where n is most often 0.  Depending on 
  84.     the application, the file may end up in the System Folder, the folder 
  85.     the application is in, or (?) somewhere else.  You may have to use 
  86.     the Find File DA to find it.
  87. 6A) WITH THE APPLICATION VERSION OF AddLPrep:
  88.     * Quit the application.
  89.     * In the Finder, you may want to rename the file to something 
  90.       more meaningful.  
  91.     * Run the addLPrep application.
  92. 6B) WITH THE DESK ACCESSORY VERSION:
  93.     * Choose AddLPrep from the Apple menu.
  94.  7) With either version, a standard file selection box appears.  Choose 
  95.     the file created in steps 4-5, and double-click on it, or click on 
  96.     Open, or hit Return.
  97.  8) A new dialog box then appears, telling you that AddLPrep is converting
  98.     your file, and the cursor changes to a watch.  Depending on how long 
  99.     and complex your printout is and what kind of Mac you have, the 
  100.     process may take a few seconds to several minutes.  You can cancel
  101.     the process by clicking on the button in the dialog box, or holding 
  102.     down the Command (Apple) key and pressing the '.' key.
  103.  9) When it's done, the application version will quit to the Finder,
  104.     while the DA version will just go away.  Unless you cancelled, there 
  105.     is then another new file, with the same filename plus ".ps" at the end.
  106.     This is a complete PostScript file (program) suitable for direct 
  107.     downloading to any PostScript printer or typesetter.
  108.  
  109. TECHNICAL NOTE:
  110. AddLPrep substitutes the Laser Prep code for a line starting with:
  111. %%IncludeProcSet: "(AppleDict md)"
  112. If the input file does not contain a line like this, then AddLPrep
  113. produces an Alert box noting that it has just functioned as a text file
  114. duplicating program.  (This will not occur for files created by Option-F
  115. as described above.)
  116.  
  117. ABOUT RELIABILITY:
  118. As AddLPrep transfers the PostScript code from the Laser Prep
  119. file to the output file, it makes a few modifications to the code
  120. to make it suitable for use as a "transient" program that doesn't 
  121. "take over" the printer or modify its state.  AddLPrep has been 
  122. tested with a number of common Mac applications and with a DEC 
  123. ScriptPrinter.  However, it may prove unreliable in any of the 
  124. following cases:
  125.  
  126. a) when used with a version of Laser Prep other than the ones 
  127.    distributed with Apple's System Software 5.0 and 6.0 (a.k.a. System 
  128.    4.2/Finder 6.0 and 6.0/6.1 respectively).  Internally, the code in  
  129.    these Laser Prep files is called version 65 and 68 respectively.  The 
  130.    current version of AddLPrep (1.2) has also been tested with "Laserwriter 
  131.    6.0"; the accompanying Laser Prep is called version 70 internally.  
  132.    
  133.    If the Laser Prep file is sufficiently different, AddLPrep will detect 
  134.    the problem and show an Alert box.  Or,
  135.  
  136. b) when used with a different PostScript printer, or
  137.  
  138. c) when used with applications other than those the author has tested
  139.    it with, or
  140.  
  141. d) when used with documents that contain graphic shapes other than 
  142.    those the author happens to have tested (e.g., arcs have not been
  143.    tested).
  144.  
  145. The most likely source of problems is a), for future versions of Laser 
  146. Prep.
  147.  
  148. Problems can be reported to the author via EMail to CompuServe
  149. 72367,2599 or GEnie MACKENNA, but please be patient.  Assuming a ".ps" 
  150. file was produced and it's less than, say, 32Kbytes long, upload it on 
  151. EMail along with the description of the problem.  
  152.  
  153. If you have a problem with a huge PostScript file, try to reproduce it 
  154. in a small file.  For multi-page printouts, a problem is automatically
  155. isolated to the first page that doesn't print out, and other pages can 
  156. be deleted from the PostScript file.  The start of each page is marked 
  157. by a line like
  158. %%Page: n
  159. Always keep the part of the file before the start of page 1.
  160.  
  161. To isolate problems further, try inserting lines like 
  162.    (we got to here) print
  163. in the PostScript code.  The messages before the problem will come back
  164. from the PostScript printer, before the error message.  Warning: figuring
  165. out where to put those lines may turn you into a PostScript programmer!
  166.