home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 19 Printer / 19-Printer.zip / pm2col1d.zip / pmtwocol.inf (.txt) < prev   
OS/2 Help File  |  1994-06-06  |  12KB  |  282 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.  If you like and use PMTwoCol, please see BUYING THIS PROGRAM for how to pay 
  5. for it.  This is a beta version so please report bugs/suggestions to Reporting 
  6. Bugs. 
  7.  
  8.  PMTwoCol is a multithreaded PM utility for concatenating text files (inputs) 
  9. into a multicolumn text file (output) and optionally creating conforming 
  10. PostScript output. 
  11.  PMTwoCol is useful for making compact listings of programming code. For 
  12. instance, on my PostScript printer, I get four times the normal 66 line by 80 
  13. character positions of text by using 131 lines and 164 character positions 
  14. arranged in 2 (portrait) columns. 
  15.  There is flexibility in the layout of the output files.  See Options Dialog. 
  16.  PostScript output is monospaced Courier font with auto-scaling. 
  17.  
  18. Please use the SETUP dialog the first time you run the program.  See Setup for 
  19. details. 
  20.  
  21. The program displays the status of the conversions in progress in a Status 
  22. area. 
  23.  
  24.  
  25. ΓòÉΓòÉΓòÉ 2. USAGE HINTS ΓòÉΓòÉΓòÉ
  26.  
  27. This program is easier to use with a PostScript printer rather than a 
  28. non-PostScript printer, but then what is'nt. 
  29. The next 2 sections indicate how to use the program with these printers.  (For 
  30. actually sending output to the printer, see Printing does not work.) 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 2.1. PostScript Printers ΓòÉΓòÉΓòÉ
  34.  
  35. Note that you should create text output first, then create PostScript output. 
  36. When the PostScript output is ready, send the PostScript file to the PostScript 
  37. printer.  The font will be auto-scaled to fit the paper size and 
  38. margin-adjusted in the printer. 
  39. i.e. with a PostScript printer, you do not have to match the number of 
  40. lines/character positions option to the paper size. 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 2.2. Non-PostScript Printers ΓòÉΓòÉΓòÉ
  44.  
  45. First make sure that the selected font in the printer is a monospaced font. 
  46. Next, you will need to make sure that the printer settings match certain 
  47. PMTwoCol option values.  These are: 
  48.  (1) Number of lines. 
  49.  (2) Number of character positions per line. 
  50.  
  51. You may save these settings, after figuring out appropriate values for your 
  52. printer.  However, getting the right numbers will probably take a few 
  53. trial-and-error iterations. 
  54. NOTE:  The output file created will not print correctly on other printers. 
  55. (That's the advantage in having a PostScript printer.) 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 3. Dialogs ΓòÉΓòÉΓòÉ
  59.  
  60. There are 4 dialogs through which you use the program. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 3.1. Main Dialog ΓòÉΓòÉΓòÉ
  64.  
  65. This dialog comes up when you first start the program.  The Setup Dialog, Add 
  66. Dialog and Options Dialog are accessed via pushbuttons in this dialog. 
  67. Besides these, the main dialog contains : 
  68. (1) a 2 line output file specification area where you type in the names of the 
  69. output text file and the output PostScript file. 
  70. (2) a 3 line status area, where you can monitor conversion status, 
  71. initialization status etc. 
  72. (3) an input area which displays the number of inputs, and has push buttons to 
  73. delete one or all inputs and one to start the Add Dialog. 
  74. (4) a save area with push buttons to save the output filenames and the input 
  75. filenames. 
  76. (5) a print area with push buttons to print the text and PostScript output 
  77. files.  These do not work in this version (see Printing does not work). 
  78. (6) a view area with push buttons to view the output files that have been 
  79. created. 
  80. (7) a create area with push buttons to create the TEXT and PostScript outputs. 
  81. These push buttons convert into CANCEL buttons when conversion is started. 
  82. (8) Push buttons to start the Options Dialog and the Setup Dialog, to view help 
  83. and to exit the program. 
  84.  
  85.  
  86. ΓòÉΓòÉΓòÉ 3.1.1. Deleting from the Input File List ΓòÉΓòÉΓòÉ
  87.  
  88. You may delete a file from the input file list in the main window by 
  89. highlighting it with the mouse and then clicking the DEL ONE button or pressing 
  90. the DELETE key. 
  91.  
  92. Or you may delete all the files in the input file list via the DEL ALL button. 
  93.  
  94.  
  95. ΓòÉΓòÉΓòÉ 3.2. Setup Dialog ΓòÉΓòÉΓòÉ
  96.  
  97. PMTwoCol needs several pathnames which are to be specified in the setup dialog. 
  98. When you first run the program, please push the SETUP button on the main dialog 
  99. and fill in appropriate values for the following (if the default values are not 
  100. appropriate for your setup): 
  101.  (1) The program to use for viewing text output.  It is called with the file to 
  102. be viewed as its sole argument. 
  103.  (2) The program to use to view PostScript.  If unspecified, the text viewer is 
  104. used. 
  105.  (3) The program to use to view help, which resides in this file 
  106. (PMTWOCOL.INF). 
  107. If any of these names does not begin with a drive letter, colon and backslash, 
  108. then the PATH environment variable is searched for that name. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 3.3. Add Dialog ΓòÉΓòÉΓòÉ
  112.  
  113. This dialog is used to add input files.  This dialog is accessed by pushing the 
  114. ADD choice on the main dialog.  Files in the chosen directory may be added in 
  115. any of the following ways: 
  116. (1) clicking on the filename in the file list. 
  117. (2) selecting the file extension in the extension dropdown list adds all the 
  118. files with that extension. 
  119. (3) use the ADD ALL push button to add all the files in the current directory. 
  120.  
  121. NOTE:  Files are added to the main dialog's input file list immediately. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 3.4. Options Dialog ΓòÉΓòÉΓòÉ
  125.  
  126. There are options for the format of the text and PostScript files. You may save 
  127. these options and also the input and output file lists. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 3.4.1. Field Feed at EOF ΓòÉΓòÉΓòÉ
  131.  
  132. To save space you may want to start a new file immediately after the end of the 
  133. previous one.  Or you may want to let the files stand out by leaving the rest 
  134. of the column blank when you reach the end of a file.  This also allows each 
  135. filename to appear in the column heading. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 3.4.2. Padding the archive ΓòÉΓòÉΓòÉ
  139.  
  140. The last page of a text archive may not eject from the printer if data only 
  141. fills part of the page.  The option to pad the archive handles this by writing 
  142. blanks till the end of the last page. 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 3.4.3. Page Header ΓòÉΓòÉΓòÉ
  146.  
  147. The default is to print the string ARCHIVED on the top left hand side of the 
  148. first page.  You may replace this header.  Remember to save options if you want 
  149. it to appear each time. 
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ 3.4.4. Page Footer ΓòÉΓòÉΓòÉ
  153.  
  154. The default is to skip this item.  If you add a footer, it will be placed on 
  155. the bottom dashed line of each page of the output. 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 3.4.5. Table Of Contents ΓòÉΓòÉΓòÉ
  159.  
  160. You may choose not to create the TABLE OF CONTENTS which lists the input files. 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 3.4.6. No Border (Plain) ΓòÉΓòÉΓòÉ
  164.  
  165. If this is checked, borders, table of contents and line numbers are not used. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 3.4.7. Line Numbering ΓòÉΓòÉΓòÉ
  169.  
  170. Check this option to cause line numbers to appear in the output.  Only every 
  171. tenth line is numbered explicitly - for other lines only the last digit is 
  172. shown. 
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 3.4.8. Long Lines ΓòÉΓòÉΓòÉ
  176.  
  177. You may choose to truncate lines that reach the right margin of the field.  The 
  178. default is to wrap these lines to the next line and to change the usual right 
  179. margin delimiter to a backslash.  The result looks like a wrapped line in 
  180. EMACS. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 3.4.9. Unprintable Characters In Input Files ΓòÉΓòÉΓòÉ
  184.  
  185. The options are either to delete these from the output, to substitute a '*' for 
  186. them or to display them as they would appear in EMACS (for instance using a 
  187. caret for CONTROL) . 
  188.  
  189.  
  190. ΓòÉΓòÉΓòÉ 3.4.10. PostScript Orientation ΓòÉΓòÉΓòÉ
  191.  
  192. The orientation of PostScript output may be set to Portrait or Landscape.  Note 
  193. that the margins are applied to the oriented output. 
  194.  
  195.  
  196. ΓòÉΓòÉΓòÉ 3.4.11. PostScript Output Margins ΓòÉΓòÉΓòÉ
  197.  
  198. You may set all four margins for the PostScript output as percentages of the 
  199. imageable area. 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 3.4.12. Not Yet Implemented ΓòÉΓòÉΓòÉ
  203.  
  204. The following features are not yet implemented: 
  205.  Printing from within the program 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 4. Error Messages and Problems ΓòÉΓòÉΓòÉ
  209.  
  210. Error Messages 
  211.  PMTWOCOL will complain if you try to modify information that is currently in 
  212. use.  For instance, the input file list may not be modified while another 
  213. thread is using the list to create the output file.  If you find any bugs, have 
  214. suggestions or code snippets to handle the problems listed in the next 
  215. sections, please see Reporting Bugs. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 4.1. Spawning A Process To Run A Batch File ΓòÉΓòÉΓòÉ
  219.  
  220. Please send me a code snippet to spawn a process to run a batch file. At 
  221. present the program may only run executable files. (see Reporting Bugs) 
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 4.2. Printing does not work ΓòÉΓòÉΓòÉ
  225.  
  226. Printing of the files created by PMTwoCol must be done manually.  I do not know 
  227. how to send the output files to a printer.  I usually do the following: 
  228.  
  229. COPY PMTWOCOL.OUT PRN 
  230.  
  231. If you have suggestions on this point, please let me know. (see Reporting Bugs) 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 4.3. Running Help via the HELP buttons. ΓòÉΓòÉΓòÉ
  235.  
  236. This program uses only dialog windows.  I do not know how to associate a help 
  237. instance with such a program.  Thus contextual help is not available.  (Instead 
  238. the present solution is to spawn view.exe on pmtwocol.inf.)  Does anyone have a 
  239. code sample that solves this?  (see Reporting Bugs) 
  240.  
  241.  
  242. ΓòÉΓòÉΓòÉ 5. SETUP ΓòÉΓòÉΓòÉ
  243.  
  244. When you first use the program or remove its initialization file, please use 
  245. the Setup Dialog to set up the program. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 6. HELP IMPROVE THIS PROGRAM ΓòÉΓòÉΓòÉ
  249.  
  250. I would really appreciate receiving code snippets to solve the problems listed 
  251. in Problems  See Bug Reports on how to send them to me. 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 7. BUYING THIS PROGRAM ΓòÉΓòÉΓòÉ
  255.  
  256. You may pay for this program by making a tax-exempt donation of $10 or more to: 
  257. ASHA 
  258. 1915 Napa Avenue 
  259. Berkeley CA 94707 
  260.  
  261. 100 percent of your donation will be used to support primary healthcare and 
  262. education of underprivileged children in India. All overhead incurred is paid 
  263. for by ASHA's part-time volunteers.  For more information, please contact 
  264. asha@ocf.berkeley.edu 
  265.  
  266. Do not send bug reports to ASHA.  For that see Reporting Bugs 
  267. The program author has no connection to ASHA. 
  268. This is the full-function version of the program. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 8. Bug Reports ΓòÉΓòÉΓòÉ
  272.  
  273. This is a beta version of PMTwoCol.  Please report bugs as follows: 
  274.  
  275. On INTERNET send email to: 
  276.  fernand@cs.nyu.edu 
  277.  
  278. Or by regular mail to: 
  279.  Shuyi Chen 
  280.  206 W99 St #6A 
  281.  NYC NY 10025 
  282.