home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 8 / AU_CD8.iso / Utilities / !PSUtils / UtilsHelp < prev   
Text File  |  1998-11-24  |  6KB  |  139 lines
  1. Welcome to !PSUtils
  2. -------------------
  3.  
  4. This program being a frontend (or backside?) to the psutils package written
  5. by Angus Duggan. The version here is release 1 Patchlevel 16 which I believe
  6. to be the latest, unless anyone cares to prove otherwise.
  7.  
  8. Copyright and all that ...
  9. --------------------------
  10.  
  11. Anything in the bin, pl and man directories are covered by the LICENSE file in
  12. the !PSUtils application directory. `bin` contains the psutils programs as
  13. compiled by myself. The source code needed no changes and everything I've tried
  14. seems to work. `man` contains a text version of the manual pages for the psutils
  15. package, with in that directory is another called `man1` which contains the
  16. original source for the manuals. The 'pl' directory containcs several Perl
  17. scripts for knocking Postscript from various platforms into shape for use with
  18. PSUtils. I haven't found any Acorn produced Postscript to need any alteration.
  19.  
  20. I have created Obey files to perform the actions of the GetAFM and ShowChar
  21. shell scripts, stored in the bin directory within !PSUtils.
  22.  
  23. Everything else was done by me and is all my fault. Basically I've written a
  24. Wimp based front end to the main programs to save you having to use nasty
  25. horrible command line options. The frontend is written in Basic, using BLibII
  26. by Ian Palmer (and libraries by Tom Hughes). The utils themselves use
  27. UnixLib 3.7b.
  28.  
  29. Everything here is StrongARM/Risc OS 3.7 compatible.
  30.  
  31. Sorry if the frontend doesn't look too stunning on RiscOS 3.1, I haven't had
  32. much chance to test it. The program runs and the utils work so there should be
  33. no great problems.
  34.  
  35. Use
  36. ---
  37.  
  38. The icon bar menu has the usual Info and Quit options. In between them are the
  39. 6 psutils programs. There is a tick beside the currenty selected one. Change
  40. this by clicking on the appropriate menu entry. Every one of the programs has a
  41. submenu which allows the configuration window for that program to be opened.
  42. The name of the currently selected util is displayed below the icon.
  43.  
  44. Clicking select on the iconbar icon will open the confiuration window for the
  45. currenty selected program. Clicking adjust on the iconbar icon will cycle
  46. through the the utils. 
  47.  
  48. That's about it except to say that once you've setup the options drag a
  49. postscript file to the icon on the iconbar and a savebox will popup. Drag the
  50. Icon to a filer window as normal and the Postscript will be processed by the
  51. currently selected program. (Default is psnup).
  52.  
  53. I've tried to give reasonably sensible defaults for the options, or at the very
  54. least the 'no effect' option.
  55.  
  56. What are all the options?
  57. -------------------------
  58.  
  59. Hopefully they're at least slightly self explanatory, they certainly should be
  60. if you've used psutils before. If not then take a quick look at the manual
  61. pages, everything is described fully there.
  62.  
  63. For all but the pstops program I've merely given all the command line options a
  64. button, writable thing or whatever to allow the option to be adjusted.
  65.  
  66. The options are only updated when you click the OK button.
  67. (Actually this is currently a little inconsistent - the settings viewed in the
  68. window will remain as they were last set, whether OK is clicked or not, the
  69. action taken by the appropriate util will not change until OK is selected. I do
  70. intend to change this at some point in time but it's another massive update and
  71. I don't feel like it at the moment.)
  72.  
  73. For pstops I've gone a bit further. A pagespec must be given to tell pstops
  74. what to do with your pages. I've decoded this and given a graphical
  75. representation in the window. Double click on the window and you get a larger
  76. view. Close the large view with Adjust to get back to the pstops configuration
  77. window. Pages with the same outline colour will be on the same real sheet of
  78. paper. That means that pages with a different colour will definitely be on
  79. different sheets (unless you have more than 8 pages in a group, then the wimp
  80. colours wrap round again!).
  81.  
  82. Read the manual for a description of the syntax of the page definition, or
  83. fiddle with the definition there and see what happens. Dimensions can be
  84. supplied as 'in', 'mm', 'cm', or 'pt' (points = 1/72 inch). No units implies
  85. points.
  86.  
  87. Eventually it should be possible to drag the page outlines in the overview
  88. window to alter the page definition toy your liking.
  89.  
  90. Anything else ...
  91. -----------------
  92.  
  93. If anyone wants the source to the psutils programs then just ask.
  94.  
  95. The Frontend program (!RunImage and all the associated files) remain copyright
  96. Graham Jones, 1997. Please distribute all over the place, just don't charge
  97. anyone for any of this stuff.
  98.  
  99. If anyone actually finds this stuff useful, has any suggestions, finds any bugs
  100. (see below) etc etc please let me know.
  101.  
  102. As far as I am aware the Acorn Printer drivers produce Postscript which the
  103. psutils programs can handle.
  104.  
  105. Bugs
  106. ----
  107.  
  108. In the event of finding a bug roll up a newspaper and apply a hard downward
  109. swiping action. If it's Bluebottle just give him a quarter of Pontefract cakes!
  110.  
  111. Alternatively, if it's a problem with the frontend then tell me what you were
  112. doing, what options were set and I'll see if I can repeat it and possibly fix
  113. the problem.
  114.  
  115. If you have a problem with the Postscript produced I'm willing to investigate.
  116. If the same behaviour occurs with the UNIX versions of the programs then it
  117. would be best to take it up with Angus Duggan, last known contact
  118. address  --------- -. 
  119. If there is a problem only with the Acorn version then certainly I'll look into
  120. it.
  121.  
  122.  
  123. Graham Jones
  124.  
  125.  
  126. Contacting me
  127. -------------
  128.  
  129. Currently and for the forseeable future
  130.  
  131. E-mail: Graham.Jones@sharp.co.uk
  132.  
  133. or ...
  134.  
  135. Snail:- 26 Tuckers Road,
  136.         Faringdon,
  137.         Oxfordshire,
  138.         SN7 7YG
  139.