home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsd / drwimp / Utils / !MakeApp2 / !Help next >
Text File  |  1994-09-06  |  4KB  |  71 lines

  1.  
  2.  
  3.                       !MakeApp2 User Manual
  4.                       —————————————————————
  5.            
  6. About !MakeApp2
  7. ———————————————
  8. This utility converts a Basic program to a file of type Absolute (&ff8), which can be run just like the original program. The converted program has a couple of advantages:
  9.  
  10.  • It is a bit safer against unwanted copying and modification, because it
  11.    isn't easily recognizable as a Basic program.
  12.  
  13. But, more importantly,
  14.  
  15.  • It can be treated by compression programs such as Acorn's 'squeeze', or
  16.    !Crunch (by BASS). These make it much smaller, up to 50%. You save disc
  17.    space and loading time, and the compression makes it fully incomprehensible.
  18.    (Note, however, that it makes no difference for the execution speed. To make
  19.    your program run faster, use a Basic cruncher.)
  20.  
  21. The application is called !MakeApp2, after the original !MakeApp by Stuart Hickinbottom and John 'Lofty' Wallace. The improvement that !MakeApp2 gives is that it retains the command-line parameters. The old !MakeApp can not be used if your program has to read some parameters from the command line: the parameters are lost in the process.
  22.  
  23. !MakeApp2 is FreeWare. For conditions of use, read the copyright notice at the end of this manual.
  24.  
  25.  
  26. How to use it
  27. —————————————
  28. The program installs itself on the icon bar. To convert a Basic file, drop it on the icon. A 'Save as:' window opens, from where you can change the leafname. The conversion starts when you drop the file in a directory viewer.
  29.  
  30. The Options window opens when you click with Select on the iconbar icon, or choose 'Options...' from the menu. There are two options:
  31.  
  32.   'Preserve command parameters' - When off, !MakeApp2 omits the part that
  33.       retains the command-line parameters. This gives output that is about 200
  34.       bytes smaller than with the option on.
  35.  
  36.   'Default output leafname' - Controls the filename in the 'Save as:' window,
  37.       when it is opened. Either it contains the same name as the input file, or
  38.       it contains the name that is entered in the writeable field.
  39.  
  40.  
  41. How it works
  42. ————————————
  43. !MakeApp2 adds a small ARMcode header to the Basic program. This header:
  44.  
  45.  • Moves the Basic program to a suitable location in memory
  46.  • Reads the command line, converts it and stores this in the system
  47.    variable MakeApp2$CLI
  48.  • Passes control to Basic by issuing the command
  49.      'Basic -quit @<start address>,<end address>'
  50.  
  51. The Basic program has an extra line (at the start) added, in which the content of the variable is read and the command line is changed by a call to OS_SetEnv. The variable is then deleted.
  52.  
  53.  
  54. Credits and copyright notice
  55. ————————————————————————————
  56. The idea for this program (and the original !MakeApp) is by Stuart Hickinbottom and John Wallace. The MenuUtils module is FreeWare, and was written by (and is © of):
  57.  
  58.          Alex Petrov
  59.          Bld. 1, Flat 107
  60.          Kavkazsky boulevard, 29
  61.          Moscow 115541
  62.          RUSSIA
  63.          e-mail: APetrov@misis.msk.su
  64.  
  65. This program is FreeWare. This means that I retain the copyright. You may freely copy and distribute it, provided that it is complete with all original files, and that you do not sell it. PD libraries may charge a nominal fee for the cost of duplication, postage etc. When you use the program, you do so entirely at your own risk. You may change the program to suit your own needs. If it's a bug fix, or if you think it's an improvement, then please send the changes to me.
  66.  
  67. Dick Alstein
  68. Lijnslagerstraat 204
  69. 5625 BP  Eindhoven
  70. The Netherlands
  71.