home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / m / menubar / Manual / !Help
Encoding:
Text File  |  1997-01-07  |  34.1 KB  |  931 lines

  1.  
  2.  
  3.                MenuBar - Version 2.09 - 7 January 1997
  4.              
  5.                            by Graham Crow   
  6.  
  7.              Copyright (c) Crow Associates 1995,1996,1997
  8.  
  9.                   *** THIS PROGRAM IS SHAREWARE ***
  10.         *** IT HAS BEEN TESTED ON RISC OS 3.7 AND STRONGARM ***
  11.  
  12.  
  13.                               CONTENTS                         PAGE
  14.                            
  15.  
  16.   1. Introduction . . . . . . . . . . . . . . . . . . . . . . .  1
  17.   2. What is MenuBar? . . . . . . . . . . . . . . . . . . . . .  2
  18.   3. Getting started. . . . . . . . . . . . . . . . . . . . . .  3  
  19.   4. Building a Menu Bar. . . . . . . . . . . . . . . . . . . .  3  
  20.   5. MenuBar menus. . . . . . . . . . . . . . . . . . . . . . .  4
  21.   6. Objects. . . . . . . . . . . . . . . . . . . . . . . . . .  4
  22.   7. Menus. . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  23.   8. Sprites. . . . . . . . . . . . . . . . . . . . . . . . . .  8
  24.   9. System Variables . . . . . . . . . . . . . . . . . . . . .  9
  25.  10. Choices. . . . . . . . . . . . . . . . . . . . . . . . . .  9
  26.  11. Library. . . . . . . . . . . . . . . . . . . . . . . . . . 10
  27.  12. Passwords. . . . . . . . . . . . . . . . . . . . . . . . . 10
  28.  13. Data Conversion. . . . . . . . . . . . . . . . . . . . . . 11
  29.  14. Miscellaneous. . . . . . . . . . . . . . . . . . . . . . . 11
  30.  15. Changes since version 1.00 . . . . . . . . . . . . . . . . 12
  31.                     
  32.      Registration form  . . . . . . . . . . . . . . . . . . . . 14
  33.  
  34.  
  35.                           1.  Introduction
  36.                           ----------------
  37.  
  38. The first version of MenuBar was published by Beebug Limited in
  39. October 1995. 
  40.  
  41.  What they said about Version 1.00
  42.  ---------------------------------
  43.  
  44. Archimedes World, January 1996
  45.  "a winner...a thoroughly professional and genuinely useful utility
  46. that no user should be without".  Peter Bellamy
  47.  
  48. Acorn User, April 1996
  49.  "great for organising...worth every penny."  Karen Peach
  50.  
  51. Archive, May 1996
  52.   "..a first class program and I shall keep it and use it on my
  53. desktop."  John Laski
  54.  
  55. Users of Version 1 can easily import their existing MenuData file
  56. into Version 2.
  57.  
  58. The current version is issued as Shareware, which allows you to 'try
  59. before you buy'.  Anyone who continues to use the program after a
  60. brief trial period must register with the author.  To register, send
  61. a cheque for 15.00 pounds payable to Graham Crow to the address
  62. given at the end of this document.  If you are already a user of
  63. MenuBar 1 you may upgrade for 7.50 pounds by sending your original
  64. program disc with your cheque.  Registration entitles you a full
  65. copy of the program plus support and upgrades.
  66.  
  67.  
  68.  
  69.                                                                Page 2
  70.  
  71. No warranty, express or implied, is made about the suitability of
  72. MenuBar for any purpose.  The author cannot be held responsible for
  73. any damage to or loss of data which may occur whilst using this
  74. program.
  75.  
  76. My thanks to Paul Ashmore (Beebug), Mike Williams, and John Laski
  77. for constructive criticisms and helpful suggestions, and in 
  78. particular to Keith Vernon for his support and practical assistance.
  79.  
  80. Note:  To avoid confusion, this User Guide has a capital 'M' for
  81. Menus on the MenuBar, while the application's conventional menu is
  82. in lower-case.
  83.  
  84.  
  85.                         2.  What is MenuBar?
  86.                         --------------------
  87.  
  88. MenuBar is a multi-tasking desktop utility for the Acorn Archimedes
  89. and RISC PC range of computers running under RISC OS.  It requires
  90. RISC OS 3.1 or later, at least 1mb of RAM, and a hard disc.  It is
  91. StrongARM compatible.
  92.  
  93. MenuBar provides a convenient way of accessing often-used
  94. directories, applications and files.  In operation it is similar to
  95. the Filer and the Pinboard, but is presented as a slim bar of
  96. pull-down menus at the top of the screen, complementing the icon bar
  97. at the bottom.  Menus may be dragged or clicked open and shut.  A
  98. Bar may contain up to ten menus, each with up to 30 objects (ie
  99. directories, applications or files).  It is very simple to add,
  100. reposition and remove objects or Menus.
  101.  
  102. Up to 30 separate Bars may be created and saved in a Library for
  103. loading as required.
  104.  
  105. MenuBar allows you to organise files to suit the way you work -
  106. regardless of the way they are stored on disc.  Each Menu may be
  107. given a name so that, for example, you could arrange for 'DTP' to
  108. hold !Printers, !Style, !MultiChrs and a data directory.  Or you
  109. might have 'Tools' containing !Measure, !CloseFile, !WimpAid,
  110. !Pointer, !Flags, !Magnifier, etc.  A third might contain 'WIP' -
  111. work in progress.  It's up to you!  The important point is that all
  112. these objects can be run from within MenuBar by double-clicking or
  113. dragging.   
  114.  
  115. Moreover, the Menus are instantly available: no frustrating delays
  116. while you dig deep into the filer hierarchy waiting for all the
  117. icons to be read.  By including MenuBar in your Boot sequence your
  118. most important files are available from the MenuBar on start-up, and
  119. no need for any more cluttered backdrops with windows obscuring the
  120. icons you want!  
  121.  
  122. MenuBar is economical on space because all it stores is basic
  123. information about the objects you drag onto it - just enough to
  124. display them and to allow them to be retrieved from their source
  125. (normally your hard disc) when required.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                                                                
  135.                                                                Page 3
  136.                                                                
  137.                         3.  Getting started
  138.                         -------------------
  139.  
  140. Copy the !MenuBar application from the supplied floppy disc to any
  141. directory on your hard disc, and run the program by double-clicking
  142. on the !MenuBar icon.
  143.  
  144. Demonstration version 
  145.  
  146. The demonstration version is restricted to five Bars, and each Bar
  147. is limited to five Menus containing up to three Objects.  It is
  148. complete in all other respects.  Each time you run the program a
  149. window appears informing you of the restrictions which apply to the
  150. demonstration version, and how you can order the full version. 
  151.  
  152. Full version
  153.  
  154. When you place an order, you are supplied with the latest version,
  155. pre-registered to you.  The 'Library' directory contains a special
  156. 'Register' file, encrypted with your name.  The Library directory is
  157. your personal property, and when in future you obtain upgrades
  158. from the PD Library, you simply copy your Library directory to the
  159. new version.
  160.  
  161. You are encouraged to pass on unregistered copies of the program,
  162. and to do this, you simply copy the MenuBar to a floppy disc
  163. and then delete the entire Library directory.  This ensures that
  164. your personal property is safeguarded, and that the version you pass
  165. on behaved as an unregistered demo version.
  166.  
  167. Users of MenuBar 1 can transfer their existing data to MenuBar 2 by
  168. simply dropping their existing application '!MenuBar' onto the
  169. button.  If you wish to retain data you have created using the demo
  170. version, you will need to run each data file through !Convert first
  171. (see Section 1).
  172.  
  173. Both versions
  174.  
  175. When you run MenuBar the initial Bar appears at the top of the
  176. screen with a button and five (empty) Menus.  The button is instead
  177. of the usual icon bar icon.
  178.  
  179. It is recommended that you include in your Boot sequence an
  180. instruction to Run !MenuBar so that the program is launched
  181. automatically each time you switch on the computer.  If you are
  182. unsure how to do this please refer to the RISC OS 3 User Guide. 
  183.  
  184.  
  185.                       4.  Building a Menu Bar
  186.                       -----------------------
  187.  
  188. Suppose you want to use the first Menu to hold some favourite
  189. applications.  To give the Menu a more meaningful name click the
  190. middle mouse button while the pointer is over the title bar of 'Menu
  191. 1'.  Now slide off 'Menu 1 - Rename' and replace the current name
  192. with 'Applications'.  The new name remains in white to indicate that
  193. the Menu is still empty.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                               Page 4
  202.  
  203. To add some applications to the Menu simply drag them from a Filer
  204. window, singly or as a selection.  (If you try to add more than the
  205. maximum permitted, a buzz sounds.)  The Menu name changes to black
  206. and the Menu may be opened by simply dragging the 'handle' or
  207. double-clicking on it with Select.  As with the Filer, the items may
  208. be double-clicked to execute them or dragged to any relevant place
  209. on the desktop.
  210.  
  211. Continue to build the other Menus in the same way and when you are
  212. satisfied save the data by the following short-cut.  If the button
  213. to the left of the Menus is not already coloured cream then click
  214. Select on it to give MenuBar the 'input focus'.  Then press F3 to
  215. save the data.  Next time you run MenuBar the data will
  216. automatically be loaded. 
  217.  
  218. The objects in a Menu (ie. directories, applications or files) may
  219. be treated in a variety of ways and these are detailed in Section 6. 
  220. Similarly, the actions which may be performed on the Menus are
  221. accounted for in Section 7. Additional Bars may be created and added
  222. to the Library as described in Section 11. First, however, MenuBar's
  223. own menus are described. 
  224.  
  225.  
  226.                          5.  MenuBar menus
  227.                          -----------------
  228.  
  229. MenuBar has two menus - the main menu and the button menu.
  230.  
  231. The main menu
  232.  
  233. Click the menu button anywhere on a Menu to display the main menu. 
  234. There are three menu items, one for the current Bar, one for the
  235. current Menu, and one for the current Object.  The text of the
  236. second two depends on the pointer position when you click the menu
  237. button.  If the pointer is not over an Object the third item is
  238. greyed out.
  239.  
  240. The button menu
  241.  
  242. Click menu on the button icon to display the button menu.  Below the
  243. dotted line are the usual Info and Quit, and above are five items -
  244. 'Library', 'Sprites', 'SysVars', 'Choices' and 'Help'.
  245.  
  246. The submenu functions are described in the sections that follow.  If
  247. changes have been made an asterisk appears in the title of both
  248. menus, and if you attempt to quit with unsaved data a warning is
  249. issued.
  250.  
  251.  
  252.            6. Objects (directories, applications or files)
  253.            ----------------------------------------------- 
  254.  
  255.    6.1  Add objects
  256.  
  257. To add objects (directories, applications or files) to a Menu, drag
  258. them from a Filer window, either individually or as a selection.  If
  259. you attempt to exceed the maximum number of objects per menu a
  260. warning buzz sounds.  The same object may be added to more than one
  261. Menu, though it is naturally not possible to have the same object
  262. twice in the same Menu.  Dropping an object on the Menu's handle
  263. sends it to the top, otherwise the new object is positioned
  264. immediately below the one on which it is dropped.
  265.  
  266.  
  267.                                                               Page 5
  268.                                                              
  269.     6.2  Select objects
  270.  
  271. As with the Filer, clicking Select on an object selects it and
  272. clicking Adjust allows additional objects to be selected/deselected.
  273. Alternatively, use drag with Select or Adjust on the background
  274. (left edge of object name) to select/deselect a group of objects.
  275. All the objects in a Menu may be selected and cleared in one go from
  276. the menu by choosing 'Menu - Alter' followed by 'Select' or 'Clear'. 
  277. Providing MenuBar has the input focus the same result can be
  278. achieved (for the most-recently active Menu) by Shift+S or Shift+Z.
  279.  
  280. Making selections is useful if you want to execute several objects
  281. at once.  For example, you might select all the objects in your DTP
  282. Menu in order to run them all with a single drag to the icon bar. 
  283. Or you might want to remove several objects from a Menu. 
  284.  
  285.     6.3  Remove objects
  286.  
  287. To remove an object (or a selection) click menu on it and choose
  288. 'Remove' from the object menu.  This does not, of course, delete the
  289. object from your disc. 
  290.  
  291.     6.4  Move objects 
  292.  
  293. To reposition an object (or a selection) within a Menu drag the
  294. source object and drop it on the destination object.  Moved
  295. object(s) are inserted below the object at pointer position and any
  296. intermediate objects are shunted up or down to make space.
  297.  
  298.     6.5  Drag objects 
  299.  
  300. A single object or a selection of objects may be dragged:
  301.   
  302.   - to a Filer window (objects are copied)  
  303.   - to a compatible Application (window or icon bar icon)
  304.   - to the Pinboard (objects are pinned)
  305.   - to the Icon Bar (objects are executed)
  306.  
  307. Dragging with Shift held down removes the object from the Menu after
  308. the drag is completed (but never deletes the source).  Dragging with
  309. Adjust closes the Menu when the operation is complete. 
  310.  
  311.     6.6  Execute objects by double-clicking
  312.  
  313. Double-clicking Select on an object opens directories and runs files
  314. or applications, as with the Filer.  To open an application
  315. directory, hold down shift and double-click Select. Double-clicking
  316. with Adjust closes the Menu afterwards. 
  317.  
  318.     6.7  Object information
  319.  
  320. To find out more about an object click the menu button on it and
  321. slide off the object name.  You can then slide off 'Pathname' or
  322. 'Info'. 
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                                               Page 6
  334.  
  335.     6.8  Find objects 
  336.  
  337. Slide off 'Bar - Find' followed by 'Leaf' or 'Path' and enter the
  338. search string.  Press Return and a search will be made of all the
  339. Menus for any objects containing the search string.  Depending on
  340. the menu choice the search will include the whole pathname or be
  341. confined to the leafname.  The search ignores case.  Any matching
  342. objects are highlighted and their Menus fully opened.  At the end of
  343. the search a beep sounds if the string is found or a buzz if not.
  344.  
  345.     6.9  Object not found 
  346.  
  347. If, having placed an object in a Menu, you subsequently move, delete
  348. or rename that object, then MenuBar will be unable to locate it.  In
  349. this case the drag icon will be replaced by a red cross.  If you
  350. subsequently re-launch MenuBar then the file icon will also be
  351. replaced by a red cross.  Executing such an object produces a
  352. warning buzz.
  353.  
  354.     6.10  Disc not found
  355.  
  356. In the unlikely event of a disc not being found, perhaps because you
  357. have included an object which resides on an absent floppy disc, or
  358. renamed your hard disc and not stripped the HD4 name from the data
  359. file, then the Filer will issue a 'Please insert disc...' message. 
  360. Respond by either inserting the disc or pressing 'Cancel'.  In the
  361. latter case MenuBar will offer you the option of re-loading the
  362. previous Bar or quitting.  This is to prevent a situation where the
  363. Filer could issue a 'Disc not found...' message for every single
  364. object on the Bar.
  365.  
  366.     6.11  Open Filer  
  367.  
  368. To open the Filer window of the directory containing a Menu object,
  369. click the menu button on it and slide off the object name.  Then
  370. choose 'Open Parent'. 
  371.  
  372.     6.12  Launch Applications and load data file simultaneously
  373.  
  374. When you double-click on a file, MenuBar broadcasts a message to all
  375. the active tasks to see whether any of them wishes to load it.  For
  376. example, double-clicking on a Sprite file will probably load it into
  377. Paint. If Paint is not active, then it will be installed before the
  378. data is loaded.  Sometimes, however, you specifically want to load
  379. the file into a different Application.  You may, for instance, wish
  380. to load the Sprite file into Ovation. 
  381.  
  382. You can achieve this with MenuBar by holding down Alt and dragging a
  383. suitable file to an Application on a Menu.  The file may be dragged
  384. from another Menu or from a Filer window.
  385.  
  386. Note that this feature depends on MenuBar being able to identify the
  387. task name (as displayed in the task window) from the application's
  388. filename.  Normally these are the same, but if not (for example a
  389. taskname has a space in it or is longer than 10 characters) then
  390. Alt-dragging will not work as intended.  To overcome this, each time
  391. MenuBar is launched it looks in its application directory for a file
  392. called AppNames and builds a name translation table.  By editing
  393. this textfile you can add items to the names translation table, up
  394. to a maximum of 30 names. The format is <filename>:<taskname><LF>. 
  395.  
  396.  
  397.  
  398.  
  399.                                                               Page 7
  400.  
  401. Note also that before the Risc PC (RO 3.5), the name in the task
  402. manager had a maximum of 19 characters, eg Publisher would be
  403. 'Impression Publishe', but from the Risc PC onwards the name can be
  404. longer (ie 'Impression Publisher').  This AppNames file is currently
  405. set up for use on a Risc PC. 
  406.  
  407.  
  408.                              7. Menus
  409.                              --------
  410.                              
  411.     7.1  Add Menus
  412.  
  413. Choose 'Bar - Add Menu' and an empty menu will be added at the right
  414. of the Menu Bar.  The Bar is re-centred.  If you have already added
  415. the maximum number of Menus, this option is greyed out.
  416.  
  417.     7.2  Scroll Menus
  418.  
  419. If the screen resolution is such that the Menus will not all fit
  420. then the whole Bar can be scrolled by holding down Ctrl and moving
  421. the pointer to the extreme left or right of the Bar.  Alternatively,
  422. you can use the left or right cursor keys provided MenuBar has the
  423. input focus.
  424.  
  425.     7.3  Open/Close/Front/Back Menus
  426.  
  427. The Menus may be opened, closed, moved to the front or moved to the
  428. back in a variety of ways.  The operation may be applied to the
  429. whole Menu Bar or just a single Menu.
  430.  
  431. Whole Bar:  The simplest method is to click on the button with
  432. Select+Shift to open the Bar and Select+Adjust to close it. 
  433. Select+Ctrl brings the Bar to the front and Adjust+Ctrl sends it to
  434. the back.  Alternatively, from the menu choose 'Menu - Alter'
  435. followed by 'Open', 'Close', 'Front' or 'Back'.  If MenuBar has the
  436. input focus the same results can be achieved by Ctrl+O, Ctrl+C,
  437. Ctrl+F, or Ctrl+B.  The first method is probably the best since it
  438. is not necessary for MenuBar to have the input focus.  A quick way
  439. to send the Bar to the back if it is obscuring a window's title bar
  440. is to click menu with the pointer at the very top of the screen.
  441.  
  442. Single Menu:  A single Menu may be opened by double-clicking Select
  443. on its handle, or closed by double-clicking Adjust.  Or you can
  444. simply drag the handle.  In case the handle is obscured, you can
  445. also drag the Menu by placing the pointer close to its right-hand
  446. edge. Clicking Select on a Menu's handle (or on its extreme right
  447. edge) brings it to the front.  Alternatively, from the menu choose
  448. 'Bar - Alter' followed by 'Open', or 'Close'.  If MenuBar has the
  449. input focus the same results can be achieved by Shift+O, or Shift+C.
  450.  
  451.     7.4  Name Menus
  452.  
  453. Each Menu can be given a more meaningful name.  Click the menu
  454. button on the appropriate Menu and slide off the Menu name.  Then
  455. slide off the 'Rename' item on the submenu to reveal a writable icon
  456. where you can edit the existing name, using up to twelve characters.
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                                               Page 8
  466.  
  467.     7.5  Remove Menus
  468.  
  469. Choose 'Remove Menu' from the appropriate menu and the Menu will be
  470. removed from the Bar.  Any gaps are closed and the Menu Bar is
  471. re-centred.  After saving, only those Menus which remain will be
  472. loaded on the next occasion.  It is not possible to remove the last
  473. Menu. 
  474.  
  475.     7.6  Move Menus
  476.  
  477. To reposition a Menu on the Bar, hold down Alt and drag the source
  478. Menu handle, dropping the drag icon on the destination Menu.  Any
  479. intermediate Menus are shunted along to make space.  In case the
  480. handle is obscured, you can also drag the Menu by doing an Alt-drag
  481. starting with the pointer close to the its right-hand edge.
  482.  
  483.     7.7  Save Menus
  484.  
  485. Choose 'Bar - Save', and a data file and text file are saved in
  486. sub-directories within the 'Library' directory.  The text file is a
  487. readable listing of the pathnames of all the objects in each Menu -
  488. very useful if you ever need to re-create your Menus see Section
  489. 12).
  490.  
  491.     7.8  Sort Menus 
  492.  
  493. You can sort objects by name or by type, for all Menus or just one,
  494. by clicking the menu button and making the appropriate choice.  As
  495. with the Filer, sorting by name is alphabetical and sorting by type
  496. is in the order directories-applications-files.  Under 'Choices' you
  497. can set an option to cause automatic sorting whenever an object is
  498. added.  Alternatively, you can arrange the objects in any order you
  499. choose by dragging (see 'Move object').
  500.  
  501.  
  502.                             8.  Sprites
  503.                             -----------
  504.  
  505. If your Menus include applications which have not been seen by the
  506. Filer, the generic Application icon sprite will be shown.  This does
  507. not adversely affect the operation of MenuBar, but displaying the
  508. applications' own icons does look more attractive.  There are
  509. several ways of doing this.
  510.  
  511. For a single object double-clicking or clicking-and-holding (ie
  512. starting a drag) performs a Filer_Boot on the application to display
  513. the correct sprite.
  514.  
  515. For a whole Menu, the same result may be obtained by choosing 'Menu
  516. - FilerBoot', and for the whole Bar by choosing 'Bar - FilerBoot'. 
  517. Note that the FilerBoot operation, which can be quite lengthy, may
  518. be aborted by pressing Escape.
  519.  
  520. However, the best method is to save the required sprites by choosing
  521. 'Sprites - Save' from the button menu.  In order to do this you must
  522. first perform a FilerBoot on the whole Bar (and indeed every Bar if
  523. you have more than one - see the section on Library).  This places
  524. the required sprites in the Wimp Pool.  'Sprites  - Save' does a
  525. selective save, keeping only the required sprites and discarding the
  526. large version when a small one exists.  It thus keeps the extra
  527. storage requirements to a minimum.
  528.  
  529.  
  530.  
  531.                                                              Page 9
  532.  
  533. When MenuBar is next launched, the Sprites file (which is located in
  534. the Library directory) is automatically merged into the Wimp Pool so
  535. that the correct sprites are displayed in the Menus.  This is very
  536. fast provided the Wimp Pool is not already fairly full, which is
  537. another good reason for launching MenuBar in your Boot sequence. 
  538. You can force the Sprites file to load at any time by choosing
  539. 'Sprites - Load' but this should not normally be necessary.
  540.  
  541. Once you have created the Sprites file all you need to do when you
  542. add other applications which show a generic icon sprite is to click
  543. and hold to get the correct sprite then do a 'Sprites - Save'.
  544.  
  545.  
  546.                       9.  System Variables
  547.                       --------------------
  548.  
  549. System variables are used to store various pieces of information
  550. which affect the way in which the computer works.  For example, a
  551. system variable can tell the computer which application should load
  552. a particular type of file; another contains details of the date
  553. format.  A set of default system variables is present when the
  554. computer is first turned on, but the list is added to by many
  555. applications, typically when their !Boot file is run.
  556.  
  557. Double-clicking a file which does not have an appropriate system
  558. variable set results in the common error message 'An application
  559. that loads a file of this type has not been seen by the Filer...'.
  560.  
  561. MenuBar provides the means of saving and re-loading all current
  562. system variables.  Before saving the system variables for the first
  563. time you should perform a FilerBoot on the whole Bar (and indeed
  564. every Bar if you have more than one) in order to set the required
  565. system variables. Then choose 'SysVars - Save' from the button menu. 
  566. This saves an Obey file 'SysVars' in the Library directory and when
  567. MenuBar is next launched this file is automatically run, thus
  568. overcoming problems such as the one mentioned above.
  569.  
  570. To update the 'SysVars' file you can either re-save it from the
  571. menu, or (if you know what you are doing!) amend it by hand.  The
  572. file may be re-loaded at any time from the menu.
  573.  
  574.  
  575.                             10.  Choices
  576.                             ------------
  577.  
  578. 'Choices' is available from the button menu and leads to a window in
  579. which you can choose colours and other options.
  580.  
  581. To change the colours first select the colour you want by clicking
  582. on the palette.  The currently-selected colour is shown below the
  583. palette.  Then click on the appropriate place in the small replica
  584. of MenuBar below the palette.  You can set the background/foreground
  585. of the Menu and its handle, and (separately) the foreground colour
  586. of an empty menu.  Note that each Bar can have its own colours.
  587.  
  588. Automatic sorting, either by name or by type may be set and causes
  589. the menu items to be sorted each time an object is added.
  590.  
  591. You may set MenuBar's drag sprite to be either solid or dithered.
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                                                              Page 10
  598.  
  599. Click 'Set' to activate any changes with immediate effect or 'Save'
  600. to save the settings in a Choices file for future use.   'Cancel'
  601. closes the window leaving the previous settings intact.  Clicking on
  602. Choices from the top level menu opens the window and closes the menu
  603. so that the dialogue box remains in place until you explicitly close
  604. it by clicking on one of the action buttons.
  605.  
  606.  
  607.                             11.  Library
  608.                             ------------
  609.  
  610. Up to 30 separate Bars may be created and saved in a Library for
  611. loading as required.
  612.  
  613. The Library is controlled from the button menu.  Sliding off
  614. 'Library' opens a sub menu listing all the available Bars, with the
  615. active one shown in red.  Below this, in grey, is a count of the
  616. number of actual and maximum Bars.  This is followed by the
  617. remaining two entries - 'Open Lib.' and 'Create'.
  618.  
  619. To create a new Bar slide off 'Create', enter a name for the Bar,
  620. and click Select.  A new Bar appears, comprising five empty Menus,
  621. and you can proceed to build the Menu Bar as described in Section 4.
  622.  
  623. By sliding off the name of any Bar you open a sub-menu with five
  624. items:
  625.  
  626.  'Load' replaces the active Bar with the new one.  A warning is
  627. issued if the active Bar contains unsaved data.  A quick way of
  628. loading a Bar is just to click on its name in the menu.
  629.  
  630.  'Default' establishes the active Bar as the default, so that it is
  631. loaded when MenuBar is launched.  The default Bar is ticked. 
  632. Choosing the default name again de-selects it.  If no default Bar is
  633. selected then a NewBar is offered on start-up.
  634.  'Delete' prompts for confirmation then deletes the Bar from the
  635. disc. Note that if you delete the current Bar, it remains 'active'
  636. in memory (and can be re-saved) until it is replaced by another Bar.
  637.  'Rename' changes the Bar name.
  638.  'Copy as' copies a Bar under a new name for further editing, which
  639. may be quicker than creating a new Bar.
  640.  
  641. Finally, you can open the Library directory by clicking on 'Open
  642. Lib.' where you will see the data and text files stored in separate
  643. sub-directories.  A text file 'Default' records the name of the
  644. default Bar, if any.  If you need to force MenuBar to re-read the
  645. library data you can achieve this by clicking on 'Library' in the
  646. menu.
  647.  
  648.  
  649.                            12.  Passwords
  650.                            --------------
  651.  
  652. With schools in mind, it is possible to protect each Bar with a
  653. password. The idea is that the teacher retains control of a separate
  654. Password application, secretly entering each child's chosen
  655. password, after which it is not possible to open the Bar without
  656. typing in the correct password.
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                                                              Page 11
  664.  
  665. In the 'Utils' directory is an application called '!Password'. 
  666. Running this installs its icon on the icon bar and opens its window. 
  667. Just drag the '....Library.Data' directory on to the application and
  668. all the Bar names are displayed.  You can now enter a password for
  669. each Bar and click the option button to make it active.  Clicking on
  670. 'Save' encrypts the data files with the password.  Passwords can be
  671. changed or rendered inactive by the same process.
  672.  
  673. Now, when you try to load a protected Bar a window pops up prompting
  674. for the password.  If an incorrect password is entered a buzz
  675. sounds, and the user is forced to click on 'Cancel'.  Note that
  676. passwords are case-sensitive.
  677.  
  678.  
  679.                         13.  Data conversion
  680.                         --------------------
  681.  
  682. In the 'Utils' directory is an application called '!Convert', which
  683. changes MenuBar text files to data files, and vice-versa.  You will
  684. not normally need to use this but it could be invaluable if by some
  685. mischance a data file is lost or corrupted, or to convert a file
  686. created using the demo version for use with the full version. 
  687. Providing you still have the corresponding text file you can
  688. re-create the data file.
  689.  
  690. Running the program  installs its icon on the icon bar and opens its
  691. window.  Locate the source file in the 'Library' directory and drag
  692. it onto the application.  The message shows 'Text-to-Data' or
  693. 'Data-to-Text' as appropriate, and the save icon becomes type Data
  694. or type Text.  Drag the save icon to the appropriate sub-directory
  695. in the 'Library' directory, click on 'Library', and it will appear
  696. on the Library menu.
  697.  
  698.  
  699.                          14.  Miscellaneous
  700.                          ------------------
  701.  
  702. (1)  Note that copying is interactive if this is configured (use the
  703. RISC OS !Configure), and that the options (Confirm etc.) will be
  704. according to your settings.  Also note that solid sprite dragging
  705. applies if your CMOS is appropriately configured (ie. bit 1 of byte
  706. 28 is set); otherwise 'rotating boxes' apply.  A separate utility
  707. 'SolidDrag' is included in the 'Utils' directory to simplify the
  708. setting/unsetting of solid sprite dragging.
  709.  
  710. (2) A summary of the shortcuts may be obtained by choosing 'Help...'
  711. from the button menu.
  712.  
  713. (3) You are prevented from inadvertently running more than one copy
  714. of MenuBar at the same time.
  715.                                                               (4)
  716. MenuBar's own error/message window may be dragged with Select or
  717. Adjust when the pointer is on the body of the window. 
  718.  
  719. (5) There is a Public Domain program called !LongFiles by Jason
  720. Tribbeck which allows filenames of up to 55 characters to be
  721. created.  MenuBar is compatible with this utility, though naturally
  722. the filenames are truncated to fit into the Menus.
  723.  
  724. (6) Clicking Adjust on the button loses the input focus.  This is
  725. useful to allow other tasks to process 'hot keys'
  726.  
  727.  
  728.  
  729.                                                              Page 12
  730.  
  731. (7) MenuBar can usefully contain Command/Obey files to carry out
  732. prescribed actions when you double-click them.  For example the
  733. following lines will get rid of a stuck Hourglass:
  734.  
  735.              BASIC 
  736.              SYS "Hourglass_Smash" 
  737.              *DeskTop
  738.  
  739.  
  740.                   15.  Changes since version 1.00
  741.                   -------------------------------
  742.  
  743.  1.00 (15 Oct 1995)
  744.  ------------------
  745.  First release for Acorn World show (27-29 Oct 1995)
  746.  
  747.  2.00 (11 Sep 1996)
  748.  ------------------
  749.  Major new release as shareware for Acorn World show (4-6 Nov 1996)
  750.  
  751. New button to left of Bar to act as 'icon bar icon'.  Menus
  752. simplified, and count added where relevant.  Can drag the version 1
  753. '!MenuData' application to button to add to Library and load it
  754. (especially useful when upgrading).
  755.  
  756. New Library system to allow up to 30 Bars for loading as needed.
  757.  
  758. Sprites may be saved/loaded (button menu option).  Saving only saves
  759. our sprites from the Wimp pool.
  760.  
  761. New colour picker and other options in Choices window.  Colour
  762. choices saved separately with data for each Menu.
  763.  
  764. Use of virtual memory techniques makes it possible for MenuBar to
  765. run in a smaller Wimp Slot.
  766.  
  767. Object(s) dragged onto a Menu or moved within it are inserted below
  768. the object at the pointer position, whether moved up or down.  If
  769. dropped on handle then go to top.  Menu no longer opens fully when
  770. adding or removing item.
  771.  
  772. When App is double-clicked/dragged Filer_Boot is done and sprite
  773. updated (a bit array keeps track of Filer_Booted icons so they are
  774. not done twice).
  775.  
  776. New design of message window allowing longer action button strings.
  777.  
  778. Can now Alt-drag multiple objects to App on Menu (formerly just
  779. one).
  780.  
  781. Can now press Esc to abort lengthy Filer_boot.
  782.  
  783. Much faster sorting (using OS_HeapSort).
  784.  
  785. Password protection available on each Bar - separate App controls
  786. it.
  787.  
  788. Oversize Bar now scrolls instead of being telescoped.
  789.  
  790. OpenWindow event in the wimp poll loop confined to non-Menu windows
  791. thus allowing the Bar to remain in place whichever area of the
  792. virtual desktop is selected in Julian Smith's excellent PD program
  793. MultiDesk.
  794.  
  795.                                                             Page 13
  796.  
  797.  2.01 (12 Oct 1996)
  798.  ------------------
  799.  
  800. Improved multi-file loading to App (can release Alt). Ensure task is
  801. active before trying to load files (allows for Ovation Plus which is
  802. actually TWO tasks).
  803.  
  804.  2.02 (17 Oct 1996)
  805.  ------------------
  806.  
  807. Disabled overlays.   Removed rootpath-stripping.
  808.  
  809.  2.03 (23 Oct 1996)
  810.  ------------------
  811.  
  812. Overlays re-enabled. 
  813.  
  814.  2.04 (24 Oct 1996)
  815.  ------------------
  816.  
  817. Bug fixed in DEFPROCencrypt (was overwriting max bars, menus,
  818. items).
  819.  
  820.  2.05 (4 Nov 1996)
  821.  ------------------
  822.  
  823. Menu at top of screen sends MB to back.
  824. Horizontal line in message window now icon, not sprite.
  825. F3 in bar menu moved further to right.
  826.  
  827.  2.06 (24 Nov 1996)
  828.  ------------------
  829.  
  830. Added facility to save/load System Variables.
  831.  
  832.  2.07 (1 Dec 1996)
  833.  ------------------
  834.  
  835. Removed need for user to register. Done in advance.
  836. 'User' file renamed 'Register' and moved to Library dir.
  837. Select click on button toggles input focus.
  838. Adjust click pops op misc info window.
  839.  
  840.  2.08 (12 Dec 1996)
  841.  ------------------
  842.  
  843. Fixed bug whereby wouldn't run in Boot sequence on A5000.
  844. Improved handling of 'notfound' objects. (No single drags, etc).
  845.  
  846.  2.09 (7 Jan 1997)
  847.  ----------------
  848.  
  849. Tried again to fix bug whereby wouldn't run in Boot sequence on
  850. A5000, this time by rewriting DEFFNname.  Highly bizarre!
  851. Fixed bug whereby clicking menu at top of screen failed to back the
  852. Bar on A5000.
  853.  
  854.  
  855.  
  856.  
  857. --------------------------------------------------------------------
  858.  
  859. I hope you find MenuBar useful and satisfying, and shall be pleased
  860. to receive any comments, criticisms or suggestions.
  861.  
  862.  
  863.   
  864.                             Graham Crow
  865.  Crow Associates, Manor Lodge, Llangattock, Monmouth, Gwent NP5 4NG
  866.              Telephone and Fax:  Monmouth (01600) 772532
  867.                         e-mail:  gmcrow@argonet.co.uk
  868.  
  869.  
  870.  Copyright (c) Crow Associates 1995,1996,1997
  871.  
  872. --------------------------------------------------------------------
  873.  
  874.  
  875.  
  876.                                                              Page 14
  877.  
  878.  
  879.  
  880.  
  881.                       MenuBar Registration Document
  882.                       =============================
  883.  
  884. Name:
  885.  
  886.  
  887. Address:
  888.  
  889.  
  890.  
  891.  
  892.  
  893. Postcode:
  894.                       
  895. Telephone:
  896.  
  897. Fax:
  898.  
  899. E-mail:
  900.  
  901. I obtained my evaluation copy of MenuBar from:
  902.  
  903.  
  904.  
  905. Register as:  (e.g. your name or your organisation's name)
  906.  
  907.  
  908.  
  909.  
  910. I enclose 15.00 pounds (new users)
  911.  
  912. I enclose 7.50 pounds and my MenuBar 1 program disc (existing users)
  913.  
  914. (No credit cards: cheques payable to Graham Crow)
  915.  
  916.  
  917. Comments on Demo version:
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925. Signed:
  926.  
  927.  
  928.  
  929. Date:
  930. --------------------------------------------------------------------
  931.