home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !FALCON / !BONUS / UTILITY / STOOP103.ZIP / WHATSNEW.TXT < prev   
Text File  |  1994-11-27  |  6KB  |  154 lines
  1. Passing Parameters to Auto-Booting Programs
  2. ===========================================
  3.  
  4. Stoop can now pass parametrs to auto-booting programs, though this is not
  5. reliable as it should be because of bugs in TOS 4 or Lattice C which do not
  6. allow the path for a drive or partition to be set.  Environment strings
  7. can also be set at the same time.
  8.  
  9. To pass parameters to a program another program is needed, in this case
  10. Launcher.prg, which is run instead of the required program and then calls
  11. the program that you want to use. Launcher has to load in details, prepared
  12. by Stoop, which contain the program's name and the other data such as the
  13. filename(s) to be passed and the environment strings to be set.
  14.  
  15.  
  16. Setting Up Stoop for Passing Parameters
  17. ---------------------------------------
  18.  
  19. The parameters are attached to the  preset  buttons  so  that  when  you
  20. select a preset configuration to be set up the parameters will be set up
  21. as well.
  22.  
  23. To set up for passing parameters, set up a button for normal operation,
  24. see the section 'Deleting A Button', but after you have given the button
  25. a name select the LAUNCH button on the dialogue.  A  new  dialogue  will
  26. appear which has two windows, called tail and environment.
  27.  
  28. These windows can be have text entered into them in two  ways,  you  can
  29. type directly into them or you can  use  the  file  selector  to  either
  30. insert the text from a file or the full name of the file in the  window.
  31. Whatever you choose, the new text will appear at the cursor position.
  32.  
  33. The tail window should contain  the  parameters  to  be  passed  to  the
  34. program you want  to  use,  this  includes  filenames  or  command  line
  35. parameters.
  36.  
  37. To enter text into either window using the file selector.
  38.  
  39. First move the cursor to the line where you  want  the  text  to  appear
  40. (see below for keyboard commands), then call the file selector with the
  41. FSEL button, select the file you want and press OK. Another dialogue now
  42. appears, this gives you three choices; INSERT, PUT NAME or ABORT.
  43.  
  44. INSERT - Choosing this button will put the text contained in the file
  45. into your window.
  46. (WARNING - only try this with small files of about 10k length).
  47.  
  48. PUT NAME - This will put the file name, including it's full path, in the
  49. window.
  50.  
  51. ABORT - Allows you to abort making changes to the text in the window.
  52.  
  53. Example, if the program for which you are setting the button up is
  54. Gemview, you can put the names of picture  files  you  want  Gemview  to
  55. automatically load and display when you  auto-boot  it.  (Use  the  FSEL
  56. button and PUT NAME to enter the picture files, you can only do this one
  57. at a time.)
  58.  
  59.  
  60. Text Window Keyboard Commands
  61. -----------------------------
  62.  
  63. The four cursor keys move the cursor as normal (left, right, up or down
  64. one space).
  65.  
  66. Holding a SHIFT key down with either of the left and right cursor keys
  67. to move the cursor to the  start   or   end   of   the   current   line
  68. respectively.
  69.  
  70. Holding a SHIFT key down with either of the up and down cursor keys will
  71. page the text up or down respectively.
  72.  
  73. RETURN will add a new line below the current line the cursor is  on.  If
  74. the cursor is in the middle of the line, the text will be split  between
  75. the lines.
  76.  
  77. DELETE will delete the character the cursor is covering. If  the  cursor
  78. is at the end of the line, this line and the one below will  be  joined,
  79. (any characters over the maximum character line length will be left on
  80. the next line).
  81.  
  82. BACKSPACE will delete the character in front of the cursor. If the
  83. cursor is at the start of the line, this line and the one above will be
  84. joined, (any characters over the maximum character line length will be
  85. left on the line).
  86.  
  87. TAB will change the window the cursor is in (this may also be done  with
  88. a click of the mouse on the requred window).
  89.  
  90. CTRL - Y (hold the Control key down, press Y key before letting  go  of
  91. Control) will delete the current line.
  92. (BUG - the first line cannot be deleted in this way, to get around  this
  93. put the cursor on the first character and press return to move the  line
  94. to the next row and then delete, or just use the  Backspace  and  Delete
  95. keys to remove individual characters.)
  96.  
  97. CTRL - U (hold the Control key down, press U key before letting  go  of
  98. Control) will put the last line to  be  deleted  by  CTRL  -  Y  at  the
  99. current position of the cursor.
  100.  
  101. These commands are fairly basic, but they are not intended  to  be  used
  102. with large amounts of text.
  103.  
  104. NB. The maximum line length is 125 characters, if this is too small,
  105. please let me know. 
  106.  
  107.  
  108. Environment Options
  109. -------------------
  110.  
  111. Just below the Environment window are two recessed displays clicking  on
  112. the first of these will present options which can increase the usefulness
  113. of environment strings.
  114.  
  115. The options will appear on a pop-up window in the middle of the screen,
  116. they are :-
  117.  
  118. SEND TO PROGRAM ONLY - this is the  default  setting,  the  contents  of
  119. the environment window are sent to the launcher program which then  sets
  120. them up for the program it will launch.
  121.  
  122. SEND TO FILE ONLY - the environment window contents are sent to a  file,
  123. the name of the file can be chosen using the file selector  by  clicking
  124. on the second recessed display.
  125.  
  126. This will allow users of MultiTos to edit a MINT _or_ GEM configuration
  127. file before launching MultiTos. Other programs which have an editable
  128. configuration file may also benefit from this option.
  129.  
  130. If this is popular, I will add the ability to edit more than one file.
  131.  
  132. IGNORE ENVIRONMENT - the contents of the environment window are not used
  133. in any way.
  134.  
  135.  
  136. Problems With Passing Parameters
  137. --------------------------------
  138.  
  139. For some reason unknown to me, I cannot set the current path on a drive.
  140. This is a bug in either TOS 4.04 or in Lattice C  5.60.  Please  let  me
  141. know if this is a known bug - and if a fix is possible.
  142.  
  143. This only causes problems with a few programs which I believe  look  for
  144. their .RSC and .INF files in the current  directory  for  their  current
  145. drive. The only program that I found that does this is  Papyrus  and  to
  146. get around it put the .RSC and .INF files  it  looks  for  in  the  root
  147. directory of drive C (or A if you do not have a harddrive).
  148.  
  149. Hopefully, I can come up with a better solution to this problem for  the
  150. next release.
  151.  
  152.  
  153.  
  154.