home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsm / makeboot / !MakeBoot / Resources / UK / Help next >
Encoding:
Text File  |  1993-07-12  |  11.3 KB  |  258 lines

  1.  
  2.  
  3.                           !MakeBoot User Manual
  4.                           ---------------------
  5.            
  6. About !MakeBoot
  7. ---------------
  8.  
  9. !MakeBoot is a program that lets you create and edit the "Boot" (startup)
  10. sequence of your RiscOS computer. Its features are:
  11.  
  12. * Easy to use:
  13.     - Multitasking, runs in the desktop
  14.     - Items are shown as icons plus leafnames
  15.     - Drag items from Filer windows to a MakeBoot window
  16.     - Drag items within MakeBoot windows to change the order in which they
  17.       are executed
  18.  
  19. * Changes made quickly; MakeBoot reads the existing boot sequences when it
  20. is started.
  21.  
  22. * Several "actions" on items:
  23.     - Applications can be run or booted (i.e. the same as when they have
  24.       been "seen" by the filer)
  25.     - Directories can be opened (Filer_OpenDir)
  26.     - Sprite files can be merged into the Wimp area (IconSprites), or used
  27.       for window borders (ToolSprites)
  28.     - Modules can be loaded (RMLoad)
  29.     - All files and applications can be run with optional command-line
  30.       arguments.
  31.  
  32. !MakeBoot supports !Help, Acorn's interactive help application.
  33.  
  34. !MakeBoot is FreeWare. For conditions of use, read the copyright notice at
  35. the end of this manual.
  36.  
  37.  
  38. Structure
  39. ---------
  40.  
  41. !MakeBoot uses two files that together form the system boot sequence. The
  42. first is an Obey file called !Run, located in the application directory
  43. $.!Boot. It contains a number of commands, and at the end calls the other
  44. boot sequence, the desktop boot sequence.
  45.  
  46. Schematically:
  47.  
  48.  --------------------------------
  49. | $.!Boot.!Run                   |
  50. |--------------------------------|
  51. |   ...                          |
  52. |   ...                          |
  53. |  (commands)                    |
  54. |   ...                          |
  55. |   ...                          |
  56. | Desktop -File $.!Boot.DeskBoot | -->  --------------------------
  57.  --------------------------------      | $.!Boot.DeskBoot         |
  58.                                        |--------------------------|
  59.                                        |   ...                    |
  60.                                        |   ...                    |
  61.                                        |   ...                    |
  62.                                         --------------------------
  63.  
  64. The normal boot sequence can be used to run anything that you want loaded
  65. before the desktop is started, such as:
  66.  
  67.   * modules that define extra VDU modes
  68.   * obey files that define aliases, paths, set the library, etc.
  69.   * a BBC font file, replacing the system font
  70.   * sprite files to load replacements for Wimp sprites
  71.   * toolsprite files, for customized window borders
  72.   * some utilities that must be loaded before the desktop starts, e.g.
  73.     ToEdit, Larger
  74.   * obey files that set the Wimp$Path variable, to make the Wimp load
  75.     non-standard templates
  76.  
  77. The desktop sequence usually contains:
  78.  
  79.   * applications that you want "seen" by the filer, e.g. !System,
  80.     !Fonts, !Paint or !ArcFS. That way the Wimp knows where to find modules
  81.     or fonts, and what to do when you double-click a Sprite or Archive file.
  82.   * applications that you want running after startup, because you use 
  83.     them a lot: a backdrop program (!Menon, !PlaceIt, etc.) or your
  84.     favourite text editor.
  85.   * directories that you want to have opened, because they contain
  86.     files or applications that you are working on.
  87.  
  88. In the scheme above, the desktop boot sequence was called DeskBoot. In fact,
  89. this file can have any name you choose, but it must be located in the same
  90. directory.
  91.  
  92.  
  93. Using the program
  94. -----------------
  95.  
  96. The program is started by double-clicking on its icon in a filer window.
  97. First it tries to read the existing boot sequences, from the disk it is
  98. stored on. After that, the application installs itself on the icon bar.
  99. Clicking with the Select button on the icon opens two windows, containing
  100. the boot sequences. Clicking with Adjust closes them again. 
  101.  
  102. Pressing the Menu button over the icon bar icon brings up the main menu.
  103. Apart from the usual "Info" and "Quit", the main menu has three items:
  104.  
  105.   Re-read files   To read the boot sequences again, e.g. after you have
  106.                   changed the file names, or messed up the sequences a bit.
  107.   File names      Leads to a submenu-window in which you can view and edit
  108.                   the file names of the sequences. The first name is that
  109.                   of the boot directory itself, the second is the leafname
  110.                   of the desktop sequence (the leafname of the first
  111.                   sequence must be "!Run").
  112.   Save all        Saves both sequences.
  113.  
  114.  
  115. Loading the boot sequences
  116. --------------------------
  117.  
  118. Two ways to load the contents of the boot sequences have already been
  119. mentioned (at program startup, and with "Re-read files" from the menu).
  120. A third way is to drop the icon of the directory $.!Boot on the icon bar
  121. icon. This can be useful if MakeBoot is not run from the same disc as the
  122. boot disc.
  123.  
  124.  
  125. Editing the boot sequences
  126. --------------------------
  127.  
  128. The sequence windows show the boot sequences. Each sequence consists of a
  129. list of items (files, applications or directories). The window shows each
  130. item as an icon with a leafname. To the right of this, you can see the
  131. action, shown in red. This action is the command that is executed on the
  132. item when the sequence is run.
  133.  
  134. Inside a sequence window, you have the following possibilities to edit:
  135.   
  136. * To add a new item to a sequence: drag a file or application from a Filer
  137. window to the !MakeBoot sequence window. The new item is inserted into the
  138. sequence; a default action is attached to the item (it depends on the type
  139. of the item which action that is)
  140.  
  141. * To change the order of the items in the sequence: drag the item to the new
  142. position. It is moved to just before the item that the mouse pointer was on
  143. when you dropped it.
  144.  
  145. * To move an item to the other sequence: drag it to the other window
  146.  
  147. * To change the action that is attached to an item: click on the action with
  148. Select or Adjust.
  149.  
  150. * You can "deactivate" an item. A deactivated item is shown in grey. Deactivated items are saved with the rest of the sequence, but they are not run: they are commented out (with a "|") in the file. This can be handy when you are experimenting with the contents of a sequence. Items are deactivated by clicking on their name with Adjust, or from the menu.
  151.  
  152. Clicking the Menu button above a sequence window brings up a menu with a
  153. couple of choices:
  154.   
  155. Item ⇨ Inactive        Toggles the "deactivated" setting for the item (see
  156.                        above)
  157. Item ⇨ Arguments ⇨     A writable submenu where you can enter the
  158.                        command-line arguments that are attached to the item.
  159. Item ⇨ Open parent     Opens a Filer window on the parent directory, in
  160.                        which the item is located.
  161. Item ⇨ Change to root  Changes the name of a directory to "$". This option
  162.                        is needed if you want a Filer_OpenDir on the root
  163.                        directory: there is no icon of the root directory that
  164.                        can be be dragged to the window! In that case, drag
  165.                        another directory in the sequence, and choose this
  166.                        option.
  167. Item ⇨ Delete          Removes the item from the sequence.
  168. Sequence info ⇨        Gives some info about this sequence.
  169. Save sequence          Saves this sequence to disc.
  170.  
  171.  
  172. To !Boot
  173. --------
  174.  
  175. Archimedes users with some experience probably know how to make their
  176. machine run a boot sequence, but for those who don't, here is how to get it
  177. done.
  178.  
  179.  1) Create a directory called !Boot in the root directory of your harddisc.
  180.  
  181.  2) Press F12, to go to the command line and enter the following commands:
  182.       *Configure Boot
  183.        (this tells your computer to boot from disc; the default is
  184.         NoBoot)
  185.       *Opt 4 2
  186.        (selects the boot action: the !Boot application will be run)
  187.     Before entering the last command, you should make sure that the
  188.     current directory is somewhere on the harddisc.
  189.  
  190.  3) Depending on what kind of hardisc you have, you may need to set
  191.     some more configurations, e.g.:
  192.  
  193.       *Configure FileSystem SCSIFS  (or IDEFS)
  194.        (to set the file system that is booted from; the default is ADFS)
  195.       *Configure Drive 4            (or 5)
  196.        (to select the ADFS drive to boot from; the default is 0)
  197.  
  198.  
  199. Setting the language with ResFind
  200. ---------------------------------
  201.  
  202. !MakeBoot adapts automatically to the configured language if the corresponding messages etc. are available. For this purpose a Resources directory is contained in the application in which a subdirectory for each language supported resides. If the language you need isn't in there, please feel free to duplicate any of these language directories and translate the contents.
  203.  
  204. When you run the program a utility called ResFind is called which reads the language your computer is configured to and then looks for the corresponding language directory. If this fails the program will run in English (UK). By setting several system variables (best done in your system's !Boot file) you can change the language looked for. With this you can make sure a program runs in a certain language, e.g. to avoid a weird translation. Furthermore it is possible to name several languages you prefer to English.
  205. This is controlled by three system variables:
  206. MakeBoot$Language, ResFind$LanguagesPref und ResFind$Languages$Suff.
  207. When running the application ResFind looks for the first language supported along the following list of languages:
  208. 1. Contents of the variable MakeBoot$Language
  209. 2. Contens of the variable ResFind$LanguagesPref
  210. 3. The configured language
  211. 4. Contens of the variable ResFind$LanguagesSuff
  212. 5. UK
  213.  
  214. Take a Norwegian user for example (lots of great programs come from there) whose computer is configured to 'Norway'. Since this language isn't too common in Europe most programs won't support it - except for Norwegian ones. But our user is pretty good in German and French but not too fond of English. Therefore he prefers these languages to UK and would thus put the following line in his system's !Boot file:
  215. *Set ResFind$LanguagesSuff Germany,France
  216. Running an applications (such as this one) using ResFind the list of languages looked for is 'Norway,Germany,France,UK'.
  217. In case this user hat an application calles !Pete supporting the languate 'Humorous' the line
  218. *Set Pete$Language Humor
  219. in the !Boot file makes sure !Pete will run humorous.
  220.  
  221.  
  222. Known bugs and possible future additions
  223. ----------------------------------------
  224.  
  225. No known bugs.
  226.  
  227.  
  228.  
  229. Copyright notice
  230. ________________
  231.  
  232. This program is FreeWare. If you like it, you may copy it and distribute it,
  233. provided that you do not charge anything for it. Use of the program is
  234. entirely at your own risk. You may change the program to suit your own
  235. needs, but you may not give a modified copy to someone else. If you think
  236. your changes are an improvement, then please send them to the address below,
  237. so that I can incorporate them in a new version. Also, if you have any
  238. questions, bug reports or suggestions for improvements, you can contact me
  239. at the following address:
  240.  
  241. Dick Alstein
  242. Lijnslagerstraat 204
  243. 5625 BP  Eindhoven
  244. The Netherlands
  245.  
  246. e-mail: wsinda@info.win.tue.nl
  247.  
  248.  
  249. ResFind is copyrighted ©1992
  250. Olaf Krumnow & Herbert zur Nedden
  251. German Archimedes Group (GAG)
  252.  
  253. Olaf Krumnow                     Herbert zur Nedden
  254. August-Bebel-Strasse 102c        Alte Landstraße 21
  255. D-21029 Hamburg 80               D-22962 Siek
  256. Germany                          Germany
  257. (+49 40) 7 21 92 87              (+49 41 07) 99 00
  258.