home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 354.lha / PPMore_v1.3 / PPMore.doc < prev    next >
Text File  |  1990-03-06  |  10KB  |  238 lines
  1.  
  2.  
  3.                            PPMore 1.3 User Manual
  4.  
  5.                                 Dec 17, 1989
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15.      If you have suggestions or remarks about this program, or if you find
  16. any bugs, please let me know.
  17.  
  18.      Write to the following address:
  19.  
  20.                                 Nico François
  21.                                 Corbielaan 13
  22.                              3060 Bertem BELGIUM
  23.  
  24.  
  25. Contents
  26. ========
  27.  
  28. 1. An introduction
  29.  
  30. 2. Usage
  31.  
  32. 3. Control
  33.  
  34. 4. Using PPMore from other programs
  35.  
  36.  
  37. 1. An introduction
  38. ==================
  39.  
  40.      This program was written to complement one of my other utilities,
  41. PowerPacker (a command and data cruncher).  It is used to read normal ascii
  42. text files or text files crunched with PowerPacker.  The program itself is
  43. about 10K long and when you know you save about 60% when you crunch a text
  44. file, you can see that this could save a lot of space on your disks.
  45.      PPMore was written as a more replacement (as you could have guessed :-),
  46. so I tried to keep the keyboard commands the same as well as adding some new.
  47. There are two main differences between PPMore and More, PPMore uses gadgets
  48. and it always loads the complete file in memory (More only loads part of the
  49. file and will load the rest when needed).  If you can live with these
  50. differences, you can replace More with PPMore anywhere you want.
  51.      If you haven't got PowerPacker you are of course missing the main
  52. feature of this program.  You can try to find it in your favourite public
  53. domain library or you can get it by writing to my address and adding $15 US
  54. (if you live in Europe), $20 US (if you live elsewhere).  Send money in
  55. cash (bit risky though), by international money order or by EuroCheck (only
  56. in Belgian Francs (BF) !!!!) (Please don't send other checks).  PowerPacker
  57. was published in the November 89 issue of JumpDisk and can be found on one of
  58. the Antares RD or Fish disks.
  59.  
  60.  
  61. 2. Usage
  62. ========
  63.  
  64.      PPMore can be used in three different ways.
  65.  
  66. - First of all via the CLI:
  67.  
  68.      If you enter PPMore without arguments you will get a usage template.
  69. You use PPMore like this:
  70.  
  71.      PPMore [<options>] <filename>
  72.  
  73.      The program will then load the ascii file and display it.  If the file
  74. was crunched using PowerPacker 2.0 or higher PPMore will first decrunch it
  75. for you.  If the file was encrypted you will be prompted for the password.
  76.      The options are explained in section 4.
  77.      PPMore can be made resident so it doesn't have to be loaded every time
  78. you use it, use the ARP ARes command or the WB1.3 Resident command for this.
  79. You can't make PPMore resident when it is crunched !!  The file is supplied
  80. as an uncrunched command file with the pure bit set.
  81.  
  82. - Via the WorkBench:
  83.  
  84.      There are three different ways of using PPMore via the workbench: you
  85. can set the default tool of the (crunched) text file to 'PPMore', you can
  86. single click the PPMore icon and then double click the text file icon or you
  87. can double-click the PPMore icon and enter the filename in the string gadget
  88. you will be presented with.
  89.      You set the default tool by single clicking the icon of the text file
  90. and selecting 'Info' from the workbench menu.  You will get a window with
  91. several gadgets in it, click in the string gadget where it says 'Default
  92. tool' and enter ':ppmore'.  PPMore should be in the root directory of your
  93. disk for this to work, if e.g. it's in the system directory you should enter
  94. ':system/ppmore'.  Last of all select the 'Save' gadget.
  95.  
  96. NOTE: - PPMore will add '.pp' to the filename when the file wasn't found.
  97.         This is very useful in the WorkBench enviroment: you can make an
  98.         icon for 'text.doc' but name the file 'text.doc.pp'.  Now the
  99.         WorkBench will show an icon with 'text.doc' as name, but if you
  100.         doubleclick it 'text.doc.pp' will be displayed.  (As long as there
  101.         is no 'text.doc' file in the directory !)
  102.  
  103. 3. Control
  104. ==========
  105.  
  106.      PPMore can be controlled by keyboard or by intuition gadgets.  To get a
  107. summary of the keyboard commands press <HELP>, the function of the gadgets
  108. shouldn't be hard to understand.
  109.      A few notes on printing:
  110.  
  111. - The printer.device has to be in the devs: directory for PPMore to be able
  112.   to print, you should also have a correct system-configuration for your
  113.   printer.
  114.  
  115. - You can continue to read the text when PPMore is printing (this IS a
  116.   multitasking computer ! :-), you can't quit when printing is still in
  117.   progress !
  118.  
  119. 4. Using PPMore from other programs
  120. ===================================
  121.  
  122.      If you are not a programmer you can skip this section.
  123.  
  124.      PPMore 1.3 has two new power options to make it possible to use PPMore
  125. from other programs.  This way you don't have to include a text displayer in
  126. your programs, you just execute PPMore with one (or all) of the following
  127. options:
  128.  
  129.      -@mem,len,flags[,name]
  130.  
  131.        If you specify this option PPMore will not load a file but instead it
  132.      will display a chunk of memory.  You specify the memory addres and
  133.      length in the command line as well as some flags.  The current version
  134.      only has one flag: PPMORE_FREEMEM = bit 0 of the flag-word = 0x1.
  135.        When this flag is set PPMore will free the memory after it has
  136.      finished, if it isn't set PPMore will just exit and leave the memory
  137.      alone.  This way your program can start PPMore with the PPMORE_FREEMEM
  138.      flag set and exit before PPMore has ended.  PPMore will then free the
  139.      memory instead of your program.
  140.           The address, length and flags must be presented as HEX longwords
  141.      seperated by a comma.  These options can be followed by another comma
  142.      and a string to give the memory chunk a name, if this string is omited
  143.      PPMore will use the name 'memory'.  This string ends with the end of the
  144.      command line so it can contain spaces.
  145.  
  146.      -Sscreen or -S*
  147.  
  148.        With this option you can use PPMore on another screen.  You must
  149.      provide a screen address in HEX.  PPMore will the open the main window
  150.      on this screen.  If you specify a '*' instead of a screen address the
  151.      frontmost screen will be used.
  152.  
  153.      Examples:
  154.  
  155.        o  PPMore -@1A000,1D4E,0,my chunk
  156.  
  157.             PPMore will open a window 'Listing of my chunk', start
  158.           displaying at address 0x1A000 and stop at address 0x1BD4E.  The
  159.           memory will not be freed after PPMore exits.
  160.  
  161.        o  PPMore -Sc2d8a0 -@1A000,1D4E,1,my chunk
  162.  
  163.             Same as previous but now PPMore will free the memory chunk and
  164.           open the main window on the custom screen with the screen structure
  165.           on address 0xc2d8a0.
  166.  
  167.        o  PPMore -S* myfile
  168.  
  169.             Load and display the file 'myfile' and open window on the front
  170.           screen.
  171.  
  172. NOTE: - The options are case sensitive.
  173.       - The @ option must always be the last option on the command line.
  174.       - If you open PPMore on another screen PPMore will not check if the
  175.         screen closes !!  PPMore should always finish before this screen is
  176.         closed !
  177.       - I advise you to use the ARP 1.3 SyncRun and/or ASyncRun instead of
  178.         the AmigaDOS Execute function to execute PPMore from your programs
  179.         because the ARP functions also work when your program has been
  180.         started from WorkBench.
  181.       - Watch out when using this options, it is very easy to crash the Amiga
  182.         when you don't know what you are doing !!!
  183.  
  184.                       As always, I hope you find this program useful !
  185.  
  186.  
  187.                               PROGRAM HISTORY:
  188.  
  189. *****************************************************************************
  190. VERSION 1.0
  191.  
  192.      First release.
  193.  
  194. *****************************************************************************
  195. VERSION 1.1
  196.  
  197.      '.pp' suffix added to filename when file not found, very useful in
  198.        WorkBench enviroment.
  199.      PPMore now also loads encrypted files. (PowerPacker 2.3a or higher)
  200.  
  201. *****************************************************************************
  202. VERSION 1.2
  203.  
  204.      Rewritten some routines in assembler, results in a slightly faster
  205.        and smaller PPMore.
  206.      Keyboard input improved. Autorepeat of keys is ignored so you can keep
  207.        on pressing <page down> without typing it 20 times ahead !
  208.      Gadget input also improved, now handles repeat.
  209.      PPMore now prompts for a filename when double-clicked from WorkBench.
  210.  
  211. *****************************************************************************
  212. VERSION 1.3
  213.  
  214.      PPMore can now be made resident and is reentrant. (provided PPMore is
  215.        not crunched)
  216.      Improved error reporting, the main window only opens when PPMore is
  217.        going to display the file.
  218.      File is checked to see if it is an ASCII (text) file.
  219.      Two new power-options for use of PPMore from other programs:
  220.        -@ to display memory, -S to open window on a custom screen.
  221.      Fast assembler search function added.
  222.      Display position is displayed in titlebar (percentage).
  223.      Goto n% function added, replaced 'Refresh' gadget with this function.
  224.      Decrunching is 15% faster.
  225.      'Exit PPMore' only selected when button is released on top of gadget.
  226.      NO bugs removed because none where found. :-)
  227.      Only about 700 bytes larger than version 1.2 !
  228.  
  229. *****************************************************************************
  230.  
  231. PPMore 1.3 written by Nico François (Yes, Nico is my first name :-)
  232.  
  233. (c) 1989 Nico François / PowerPeak
  234.  
  235.                                    //
  236.                        Thanks to \X/ Amiga for being the best computer ever !
  237.  
  238.