home *** CD-ROM | disk | FTP | other *** search
/ The Glitch Apple Disk Collection / 2014.glitch.apple.collection.zip / indexed / ARCHIVE.DSK / EXECUTIONER.DOC.txt < prev    next >
Text File  |  2014-09-09  |  5KB  |  87 lines
  1.                        Documentation for EXECUTIONER
  2.                              by Glen E. Bredon
  3.  
  4.  The EXECUTIONER will take a ProDOS file of any type and convert it to an
  5.  EXEC file for uploading.  The file parameters (such as file type) will be
  6.  correctly put in the EXECed file.
  7.  
  8.  Directions:
  9.  
  10.  0.  An ESC at any (Y/N) prompt quits the program.  At other places it
  11.      usually sends you to the start of the program.  Hitting RETURN on
  12.      an empty filename also aborts the program as will Control-open apple-
  13.      RESET.
  14.  
  15.  1.  You are asked if you want packed mode.  A packed file is still a text
  16.      file but is compressed relative to standard dumps and an interpreter
  17.      routine is written into the file so that the file can still be EXECed.
  18.      Packed files are much shorter than unpacked ones and are recommended
  19.      for large files.  The packed mode includes a checksum and the EXEC
  20.      will produce an error message if the checksum is not ok.  (The file
  21.      will still be saved but its parameters will not have been fixed.)
  22.  
  23.  2.  If you chose packed mode then you are asked if you want 4 bit or 6 bit
  24.      packing.  The 4-bit mode just removes space between hex bytes.  The
  25.      6-bit mode is a denser packing in which lower case characters are
  26.      significant.  It is possible that some people will have trouble with
  27.      the EXEC of such files.  Time will tell.  For sizable files, the
  28.      4-bit compression is slightly more than twice the original file size,
  29.      while 6-bit mode produces a file about 45% larger than the original.
  30.  
  31.  3.  You are shown the current prefix and you can type over it to change it.
  32.      Just hit return to accept it as shown.  Hit ESC to go to the start of
  33.      the program.  You MUST set the prefix to the directory containing the
  34.      file you want converted.
  35.  
  36.  4.  The directory specified by the prefix is read and the last file in
  37.      that directory is displayed after a prompt for the file to be converted.
  38.      You can use the up/down arrow keys to see other files in that directory.
  39.      (The last one is displayed first because it is expected that that will
  40.      be the usual selection.)  You could also backspace to the beginning and
  41.      just type the name of the file you want to convert.
  42.  
  43.  5.  You will be shown some of the file characteristics of the file you have
  44.      selected and asked if it is correct.  If NO then you go back to the
  45.      start of the program.  If YES then the file is loaded for processing.
  46.  
  47.  6.  You are asked for the name of the destination EXEC text file.  This can
  48.      be a full pathname if you want it in another directory.  If you hit
  49.      return on the first character, the program is aborted, if you hit ESC
  50.      then you return to the start of the program.
  51.  
  52.  7.  If the text file exists, you will be asked if you want it deleted.
  53.      (A locked file is never deleted, that would defeat the purpose of locking
  54.      it in the first place.)  If not, or if you answer YES then the program
  55.      proceeds to create the EXEC file.
  56.  
  57.  8.  When the file is made, you are asked if you want to do another.  If YES
  58.      then you return to the start of the program.  If NO, it exits.  The
  59.      EXECUTIONER is a SYS (stand alone) program, so it exits through the
  60.      "quit" routine.
  61.  
  62.  9.  Note that the created EXEC file always has a "header" placed at $E00, then
  63.      the hex code of the converted file, placed at $1000, then a BSAVE command
  64.      then a E00G or E05G as the last line.  Do not modify this last line;
  65.      it is essential.  Also, do not modify the file name it is saved under,
  66.      which is always the original name of the file.  This name is also in
  67.      the "header" and if it is changed in the BSAVE line, the EXEC will not
  68.      work correctly.  In the packed modes there is an empty line before the
  69.      BSAVE line.  This is essential as it is the signal for the decompressor
  70.      that the data is finished.
  71.  
  72.  10. If the original file is a BAS file then, after step 6, you are asked
  73.      if you want a BASIC listing EXEC file.  This is just a listing with
  74.      spaces removed and "PRINT" changed to "?".  (There is no check on too
  75.      long lines.)  If you chose this option then previous answers to the
  76.      packing questions are ignored.  This is just a conveniece feature so
  77.      that separate means of making such files are unnecessary.
  78.  
  79.  11. You can use the "startup" position in the EXECUTIONER file, or the
  80.      startup in PROSEL or other program selectors to specify the destination
  81.      file directory (or the entire pathname if you want).  For example, if
  82.      the startup is "/HARD1/MODEM/" then in step 6 above, this text will
  83.      be placed after the prompt the cursor following it.  You can modify
  84.      it just as if you had typed it.
  85.  
  86.  
  87.