home *** CD-ROM | disk | FTP | other *** search
/ ftp.uni-stuttgart.de/pub/systems/acorn/ / Acorn.tar / Acorn / acornet / dev / basic / makeapp.spk / !MakeApp2 / !Help next >
Text File  |  1995-03-21  |  4KB  |  98 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 modifying, 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, or a Basic compiler.)
  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 comes with a utility that does the same, but can be called from the command line.
  24.  
  25. !MakeApp2 is FreeWare. For conditions of use, read the copyright notice at the end of this manual.
  26.  
  27.  
  28. How to use it
  29. ÿÿÿÿÿÿÿÿÿÿÿÿÿ
  30. 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 drag the file from that window to a directory viewer.
  31.  
  32. The Options window opens when you click with Select on the iconbar icon, or choose 'Options...' from the menu. There are two options:
  33.  
  34.   'Preserve command parameters' - When off, !MakeApp2 omits the code that
  35.       retains the command-line parameters. This gives output that is about 200
  36.       bytes smaller than with the option on.
  37.  
  38.   'Default output leafname' - Controls the filename in the 'Save as:' window,
  39.       when it is opened. Either it contains the same name as the input file, or
  40.       it contains the name that is entered in the writeable field.
  41.  
  42.  
  43. The command-line version
  44. ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  45. Included with !MakeApp2 is bas2app, a utility which does the same, but is run from the command line. That way, it can be used by other programs, or it can be started from an Obey file. You can find bas2app inside the application directory, in subdirectory CLIapp. The command syntax is
  46.  
  47.   bas2app infile [outfile]
  48.  
  49. If no 'outfile' is given, then the output file has the same name, i.e. the input file is overwritten (!).
  50.  
  51. The command parameters are always preserved. If you don't need that, then use
  52. bas2app0.
  53.  
  54.  
  55. How it works
  56. ÿÿÿÿÿÿÿÿÿÿÿÿ
  57. !MakeApp2 adds a small ARMcode header to the Basic program. This header:
  58.  
  59.  Å Moves the Basic program to a suitable location in memory
  60.  Å Reads the command line, converts it from
  61.        <program name> <parameters>
  62.    to
  63.        Basic -quit "<program name>" <parameters>
  64.    and stores this in the system variable MakeApp2$CLI
  65.  Å Passes control to Basic by issuing the command
  66.      'Basic -quit @<start address>,<end address>'
  67.  
  68. The Basic program has an extra line (at the start) added, which
  69.  
  70.  Å Reads the content of the variable MakeApp2$CLI
  71.  Å Changes the command line by a call to OS_SetEnv
  72.  Å Deletes the variable
  73.  
  74.  
  75. Version history
  76. ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  77. 1.00  First released version
  78. 1.01  Added the command-line version of the program
  79.  
  80.  
  81. Credits and copyright notice
  82. ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  83. 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):
  84.  
  85.          Alex Petrov
  86.          Bld. 1, Flat 107
  87.          Kavkazsky boulevard, 29
  88.          Moscow 115541
  89.          RUSSIA
  90.          e-mail: APetrov@misis.msk.su
  91.  
  92. 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.
  93.  
  94. Dick Alstein
  95. Lijnslagerstraat 204
  96. 5625 BP  Eindhoven
  97. The Netherlands
  98.