home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsm / makeboot / !MakeBoot / Resources / UK / Help next >
Text File  |  1993-07-12  |  12KB  |  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.