Home » Archimedes archive » Acorn User » AU 1998-09.adf » Features » DesktopPD/Director/!Director/!Help

DesktopPD/Director/!Director/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1998-09.adf » Features
Filename: DesktopPD/Director/!Director/!Help
Read OK: ✔
File size: C9E1 bytes
Load address: 0000
Exec address: 0000
Duplicates

There is 1 duplicate copy of this file in the archive:

File contents
� Help file for Director version 0.21
=====================================

Director is Copyright (C) Nick Craig-Wood 1994

If you are reading this in !Edit then you might like to do Expand tabs on the
Edit menu to turn those [09]'s into something useful!

At the start of each section title is a � character (ALT-164 if your keyboard
doesn't have it) which can be used to search this file.


� Contents
==========

- Contents
- License
- Introduction
- Motivation
- Switching from Pinboard+ to Director
- Switching from TreeMenu (or DirMenu) to Director
- Upgrading from Director 0.11 (first public release)
- Menus
- Showing a Menu
- System Variables
- GSTrans
- Special forms of Menus and Commands
- Memoriser
- MenuMenu
- Pinboard
- SaveBox
- Keys
- Colours
- Dynamic Menus
- Icons
- Directory Menus
- Filters
- Other Features
- Other Commands
- External Interface
- SWIs
- Debugging your Menus
- Oddities
- Utils
- Planned Extensions
- Thanks
- Contacts
	

� License
=========

Director (The Software) is Copyright (C) Nick Craig-Wood 1994 (NCW) and may
not be used or copied except as in accord with the terms and conditions
below.

You may NOT Make the Software available to any third party EXCEPT with these
terms and conditions imposed on said party.

You may NOT Make the Software available to any third party EXCEPT at no
benefit to yourself or any third party, excepting that benefit contained
within the Software.

You MUST make sure the Software is distributed whole, intact and unmodified,
including all the files in the original distribution.

You may NOT may not sell, hire or include the Software in a package which is
sold or hired, modify, translate, disassemble, decompile, reverse engineer,
or create derivative works based upon the Software or include whole or part
of the Software into other works. 

The Software is supplied "as is", NCW makes no warranty, express or implied,
as to the merchantability or its fitness for any particular purpose.  It may
or may not perform in accordance with the documentation or your expectations.

In no circumstances will NCW be liable for any damage, loss of profits,
goodwill or for any indirect or consequential loss arising out of the use of
the Software, or inability to use the Software, even if NCW has been advised
of the possibility of such loss.

These conditions supersede any prior agreement, oral or written, between you
and NCW relating to the Software.

You agree that except for written separate agreements between NCW and you,
this agreement is a complete and exclusive statement of the rights and
liabilities of the parties.

You acknowledge that you have read this agreement, that you understand this
agreement, and by loading, running or copying the Software you agree to be
bound by this agreement's terms and conditions.


� Introduction
==============

Director is a general purpose desktop tool.  It allows you to customise your
desktop by creating menus of useful commands and icons to attach the menus
to.  Any number of menus or icons can be created and attached in any order to
each other.

Director also allows an alternative and faster view onto files in the form of
directory menus and allows these menus to be attached to other menus also.

Director has some other useful features such as remembering the most recently
used files, the ability to add key strokes into the keyboard buffer and the
ability to produce directory menus over drive icons.

Director is fully customisable by the user, and can do many or all of the
functions of Pinboard+, TreeMenu (AKA DirMenu), Filer-, QuickDir, DeskUtils,
Memorizer, Menon and some of the functions of Filer+.

Director will only run on RISC OS 3.10 or later.


� Motivation
============

Director was initially conceived as a replacement for Pinboard+ (by Thomas
Olsson).  For those of you who don't know, Pinboard+ is a replacement
Pinboard module which allows user definable menus when clicking menu over the
backdrop.

The initial design of Director was in order to overcome the fact that
Pinboard+ needed a replacement pinboard module loaded (which did not work
fully under RISCOS 3.5) and the fact that there was no easy way of specifying
that you wanted the contents of a directory as a sub menu.

This then led on to the idea of incorporating the functions of TreeMenu (by
Julian Smith) into Director.  This would then enable a directory tree listing
to be attached to a menu at any point.

These ideas led onto Director being more of a general purpose program,
merging several utilities into one compact package.

Memory usage was another of the main reasons for coding Director.  Here's a
before and after on the memory front.

Before:

TreeMenu          65,536
Pinboard+         18,812 (module)
                  43,324 (menu)
DeskUtils         32,768
Memorizer         14,128
������������������������
Total            174,568 Bytes

After:

Program code      18,672
Workspace          3,600
Heap              18,416 (119 blocks)
������������������������
Total             40,688 Bytes

Thus giving a saving of 133,880 bytes or 130 kBytes!

Director will use a dynamic area if they are available.  (This has several
advantages, the main one being less RMA fragmentation.)

Director also includes some ideas from Filer+ (by Jens H. Ovesen), Filer- (by
Franz Philipps), and Memorizer (by Ben Summers).

Director is written entirely in ObjAsm assembler for its compactness and ease
of making module tasks.

Although not all the ideas may have been my own, the coding is all mine
(including all the bugs)!


� Switching from Pinboard+ to Director
======================================

If you run the ExpandMenu program in the Utils directory you can convert your
old Pinboard+ menus into the new form expected by Director.  This is a
textual form based on the Obey file and is a lot easier to maintain than a
graphical form.  However if you prefer you can maintain your menus using the
Pinboard+ menu designer and ExpandMenu, however some of the new features of
Director will be unavailable to you.


� Switching from TreeMenu (or DirMenu) to Director
==================================================

Director has almost all the features of TreeMenu.  By default it will enable
Directory menus over title bars of filer windows and other windows.  You may
create icons as per TreeMenu also, see the section on Icons, and also the
example Menus.


� Upgrading from Director 0.11 (first public release)
=====================================================

The major change is Filters, so you will need to read that section.  You will
also need to add the DirectorFilter commands at the start of the example menu
to your own menu otherwise lots of things won't work.

A number of problems have been fixed and a number of new features
introduced.  See the ChangeLog for full details.  But in brief

	Added	OpenFiles and Tasks dynamic menus
	Changed	MenuMenu improving its speed and function
	Fixed	Director + Filer Short cuts interaction
	Fixed	"Please insert disc..." messages on Memoriser:
	Fixed 	(with work around) problems with CDFS
	Added	lots of features to Memoriser:
	Added	dynamic area support if available
	Added	DirectorShowMenu to show a menu immediately
	Added	-remove options to DirectorIcon and Menu
	Added	colours and icon numbers to Menu.Aliases
	Added	DirectorFilter for versatile desktop enhancements!
	Added	Director_Enumerate & menus/icons/filters menus to main menu
	Added	Director_Memory & menu to display the result
	Removed	DirectorMemory and ListMenus as they are now redundant
	Added	-dragto and dragfrom to DirectorIcon
	Added	-file to DirectorMouseDir


� Menus
=======

Menus are referred to by name (case insensitive), either by the text of the
menu title or an alias as given by you.  There can only be one menu of any
given name, and if you attempt to create a menu with the same name as an
existing one then the existing menu will be deleted without warning.  This is
useful because you can update your menus at any time you like, or even create
new menus on the fly.

Director keeps a list of menus which you can see from Director's main menu. 
Menus can be temporary or permanent.  Temporary menus are created by Director
for making Directory Menus and then deleted afterwards.  Permanent Menus are
created by you.

To create a menu you need to create an Obey file with the following format.
(Indentation and spacing are generally unimportant.  The menus are described
indented here to aid comprehension of the structure.)

	Menu ...
		Option ...
			Command ...
		Option ...
			Command ...
	Dash
		.
		.
		.
		Option ...
	EndMenu

The Menu command signals to Director to start a new Menu with the name and
alias you give it.

	Syntax: Menu <title> [<alias>] [-key <key>] [-temp] [-remove]

Possible examples are,

	Menu "Mode"
		Starts a menu with title and internal name both "Mode"
	Menu Mode
		Same as above.  In general if you want to supply a string
		to a command, you can supply it with or without quotes.
		However if the string has spaces in it it must be supplied
		with quotes.
	Menu "Lots of Modes" Mode
		Starts a menu with title "Lots of Modes" and internal name
		"Mode"
	Menu "DDE" -key ^D
		Starts a menu called DDE with internal name DDE to be opened
		on a CTRL-D key press (see the section called Keys for more
		on what is allowed as a parameter to -keys)
	Menu "Temporary" -temp
		This will make a menu which will be displayed only once and
		then destroyed.  This is useful for dynamic menus, and for
		menus displayed with DirectorShowMenu
	Menu "DDE" -remove
		This will remove from director's memory the menu called
		"DDE".  This is useful for tidying up.  If the menu named
		isn't found then it will not return an error

The EndMenu command signals to Director to stop making the menu.  The menu is
available for display as soon as the Menu command has been issued though.

	Syntax: EndMenu

The Dash command writes a dashed line across the menu at that point in the
menu structure.  It is useful for organising large menus.

	Syntax: Dash

The Option command is at the heart of Director's menus.  It has many options
which you won't need immediately, but which may become useful later.

	Syntax: Option <text> | -path <file|directory>
		[-tick]
		[-bg <col>]
		[-fg <col>]
		[-sub [<menu>|*]]
		[-len <len>]
		[-dash]
		[-grey]
		[-key <number>]
		[-up]
		[-nosprite]
		[-sprite <name>]

The Option command must be supplied with a text or a path or both.  For
example

	Option "Mode 31"
		Will produce a menu entry with the text "Mode 31" which could
		have a command attached (see later).
	Option -path ADFS::4.$.Apps
		Will produce a menu entry with a directory icon in it and the
		Apps directory attached.  If the Apps directory is not
		present then it will produce a greyed out menu option with
		an unknown file icon.  Director will use the leaf name of
		the path for the text of the menu (in this case Apps) minus
		an initial !.
	Option "Applications" -path ADFS::4.$.Apps
		As above except the text in the menu option will be
		"Applications" rather than "Apps".

A text option may have a 0, 1 or 2 Commands attached (see later) or a
SubMenu.

	Option "Modes" -sub "Modes"
		This produces a menu entry with the text "Modes" and a right
		pointing arrow.  When pointer moves over the arrow the Menu
		"Modes" will be opened as a sub menu.  If the user clicks on
		the item (or uses a hotkey) the "Modes" menu will be opened
		as the root menu.
	Option "Modes" -sub *
		This is equivalent to the Option above.  It is quite common
		to have a SubMenu with the same name as the Option which
		activates it, so this is shorthand for that.

A menu option may be activated by a key, eg

	Option -path ADFS::4.$.Apps -key ^A
		Opens the Apps directory on CTRL-A
	Option "Modes" -sub * -key M
		Opens the modes SubMenu (if no command attached) or does the
		attached command if M is pressed.
	Option "Command" -key �^Z
		If a command is attached then it does it on SHIFT-CTRL-Z
		otherwise it does nothing.

A menu option may have its foreground and background colours defined (see the
section on colours for details of which numbers make which colours).  If the
colours are not defined then they default foreground Black and background
White.

	Option "Format" -fg 11
		Produces Red text on the default background
	Option "Boot" -fg 0 -bg 8
		Produces White text on a Dark Blue background

Any menu can be made writable by including a -len option.  The parameter to
len is the maximum length of the string writable into the icon.  When the
item is selected the text is written into the system variable <MenuText>
which can be used in commands.  In fact <MenuText> is written for
non-writable items and when creating a submenu too.

	Option "13" -len 3
		Might be used for typing in a mode number of maximum length 3
		characters.  The command attached would then use <MenuText>
		to set the actual mode.  The string "13" is the default text.
	Option "" -len 200
		Might be used by a general purpose command (eg the New Task
		option in the TaskManager).  The default string is empty.
		It must be supplied though or Director will complain.

-tick Ticks the menu item (useful for when you have 2 attached commands, this
provides the initial ticked state).

-dash Writes a dash under the menu item.  This is equivalent to the Dash
command.

-grey Makes the menu entry grey and unselectable.  Useful occasionally.

-up Makes -path have the directories above the path (Up Menus - see Directory
Menus section) in the menu.  If -up is applied to a file then it will have a
submenu arrow.

-nosprite Stops a sprite appearing in a -path menu.  It also stops the menu
entry being greyed out if the path did not exist.

-sprite adds the named sprite into the menu entry.  The sprite must be the
correct size (the same size as small filer icons).  If it is not found it is
replaced with a file_xxx sprite (a blank white square).

The Command command is for attaching commands to menu options.  Only text
type menu options (ie not -path options) may have Commands attached.  You may
have both SubMenus and commands attached to a menu option.

	Syntax: Command <*command>

For example

	Option "Mode 13"
		Command WimpMode 13
			Sets Mode 13 when clicked on
	Option "13" -len 3
		Command WimpMode <MenuText>
			Sets the mode typed in when clicked on
	Option "" -len 200
		Command <MenuText>
			Runs the command typed in when clicked on.

A menu option may have two commands attached.  Which command is run depends
upon the ticked state of the option.

For example

	Option "A"
		Command FontInstall Fonts:!A.
		Command FontRemove Fonts:!A.

When this it not ticked then the first command will be run.  This will
install the fonts in !A and to show that they have been installed the menu
option will be ticked.  To remove the fonts the option is clicked again and
the second command is run, removing the fonts, and returning the menu to the
non-ticked state.

Commands are GSTransed before being run (see the section on GSTrans for more
info) as a WimpTask.  Running commands as a WimpTask means that they don't
interfere with Director, however if the command produces an error, an
anonymous error box is produced.

This also means that multiple OS commands can be put on one line by
separating them with |M.  For example

	Option "Reset SysFont"
		Command fx 20|MSWI Wimp_CommandWindow -1

Which resets the system font with *FX 20 and then redraws the screen with the
SWI Wimp_CommandWindow.


� Showing a Menu
================

A menu can be shown immediately with the command

	DirectorShowMenu <menu_name>

This will open the menu named immediately.  You can make obey files which
define menus and then open them immediately with this command.  If you add
-temp to the menu then it will be deleted after it has been shown.


� System Variables
==================

These system variables are set whenever a path sub menu is opened or a path
item is chosen

	Director$CurrentPath
		full path of object
	Director$CurrentDir
		directory object lives in
	Director$CurrentLeaf
		leaf name of object
    
If the object is a root directory (eg ADFS::4.$ or Root:) then CurrentPath =
CurrentDir = CurrentLeaf


The last Command that was run can be seen in the system variable

	Alias$DirectorRun

So issue *Show Alias$DirectorRun at the command line to see what it was.


Whenever a text option is chosen

	MenuText

Is set to the text of that option


Whenever menu is clicked over the File 'xxx' option in a Filer Menu

	Leaf

is set to the leaf name of the file ("xxx" in this case).


� GSTrans
=========

If you are uncertain what GSTrans is, look it up in the index of your user
guide.  The few pages referenced will teach you the basics (I won't attempt
to explain them here).

As a rule every string parameter passed to Director is GSTransed when it is
parsed.  This means that

	Option -path <Wimp$Scrap>

Will be GSTransed into (something like)

	Option -path ADFS::HardDisc4.$.!Boot.!Scrap.ScrapDirs.ScrapFile

Which means that if Wimp$Scrap changes, the option won't be looking in the
right place.  The menu text will read "ScrapFile".  Better is

	Option -path |<Wimp$Scrap>

Which GSTranses into

	Option -path <Wimp$Scrap>

which is what you want.  The menu text will read "<Wimp$Scrap>".  Probably
best (for this use) is

	Option "Scrap" -path |<Wimp$Scrap>

Which has the menu text "Scrap" but is otherwise identical to the one above.

The only strings which don't get GSTransed on their way into Director are the
parameters to Command.  These are GSTransed just before being run.

	Option "13" -len 3
		Command WimpMode <MenuText>

The above command will only be GSTransed when it is run with the actual value
of MenuText, not the value of MenuText when the command was installed.

	Option "Open App"
		Command Filer_OpenDir <Obey$Dir>
	Option "Open App"
		Command Filer_OpenDir |<Obey$Dir>

These two commands in practice do the same thing.  This is because in the
first Command the <Obey$Dir> is GSTransed (when the Command is being
prepared) to the proper path which is then passed to Filer_OpenDir.  In the
second case |<Obey$Dir> is GSTransed to <Obey$Dir> and passed to
Filer_OpenDir.  Filer_OpenDir GSTranses the argument and comes up with the
same answer.

If the commands had been Filer_Run in the above example then they would have
done two different things.  The first would have worked (running the
application) and the second would not because Filer_Run does not GSTrans its
input.  (In fact the second command would have opened a directory onto the
application for some obscure reason, with the Filer title set to <Obey$Dir>
which should not normally be allowed.)


� Special forms of Menus and Commands
=====================================

Whenever a Menu, SubMenu or Command is specified it may take one of several
special forms.  These enable Director to be much more general, running
commands instead of opening a sub menu or vice versa.  It also means that
Commands can be attached to clicks on icons as well as menus.

When a Menu, SubMenu or Command is being processed, it is first checked to
see if it is prefixed in one of the ways below.  If it is then its action is
modified.

"Text"		For normal command or sub-menu (ie action unchanged)

"Menu:Name"	To bring up named menu

"Save:Path"	For save box of the given Path (*)

"Path:Path"	For a directory menu of that Path (*)

"Command:Text"	Runs the Text as if it were a command

"Quit:"		Quits Director

"Info:"		Brings up Director's info window

"OldMenu:"	To open the last filtered menu (for getting pinboard menu)

"MenuMenu:Path"	Takes Path, adds .<leaf> to it and opens the MenuMenu
		pointing at that file.  Used internally. (*)

"Memoriser:"	Opens a menu of recently used files.
		(See Memoriser section.)

"Dynamic:Text"	Runs the Text as if it were a command.  When the command
		returns Director tries to open the menu whose name is in
		the system variable Director$Menu.

"GSTrans:Text"	GSTranses the Text and then reinterprets it as an extended
		command.

(*) If the path is missing eg "Path:" or "Save:" then it will use the path of
the window that the pointer is over.  If the path is present it is GS_Transed
before use.

For example

	Option "Floppy" -sub "Path:ADFS::0.$"

This will make a directory menu of the floppy disc drive if you click on the
option or move the pointer over the SubMenu.  This is better than

	Option "Floppy" -path ADFS::0.$

because this will produce a greyed out path with an unknown file icon if the
floppy is empty when the Option is run.

	Option "Root" -sub "Command:Filer_OpenDir ADFS::4.$"

This will open a filer window of your root directory if you click on the
option or move the pointer over the SubMenu.

	Option "Pinboard" -sub "OldMenu:"

This will open the menu that should have been opened when you clicked the
pointer.  So if you opened the menu over the pinboard, but wanted to see the
pinboard menu then you could click or slide this option.

	Option Here -sub "Path:<Director$CurrentDir>"
	Option Copy -sub "Save:<Director$CurrentPath>"

These options are useful for the MenuMenu (see the section titled MenuMenu
and the section titled SaveBox).

	Option Info -sub Info:
	Option Quit
		Command Quit:

Helps bring an air of normality to Director by providing the standard Quit
and Info choices!


� Memoriser
===========

Director notices whenever you load a file or click on a drive and keeps a
record of the fact.

If you then ask for the menu Memoriser: to be opened then you will get a menu
with these files or directories in it.

This acts exactly like a normal directory Menu, except it has all your most
recently used files/directories in it.

This is exceedingly useful when you traverse a large directory tree, open a
file to have a look at it, close it, and then realise that you want to see
the file again.  All you have to do is open the Memoriser menu and it will be
there sitting at the top.  If in the mean time you have deleted the file then
it will not be shown in the menu.

It is possible to make the memoriser display only applications, directories
or files by adding a numeric parameter after the Memoriser:

	Memoriser:1 - memoriser shows applications
	Memoriser:2 - memoriser shows directories and images
	Memoriser:4 - memoriser shows files

The parameters can be combined in a linear fashion, eg Memoriser:6 shows
directories, images and applications but not files.

The total number of items that are kept in the Memoriser menu is definable
with the command

	Syntax: MemoriserItems <number>

This will not affect the currently built up number of items.  If you set it
to 0 then no more items will be added to the menu.  This effectively turns
the feature off.  0 is the default value.

You can save and restore the memoriser with

	MemoriserSave <file>
	MemoriserLoad <file>

This will save the contents of the memoriser or replace it with that in the
file.  The file is a simple text file with a file path on each line.  You
could use this to prime the memoriser with often used files or to save and
restore it.


� MenuMenu
==========

A menu with name defined by the system variable Director$MenuMenu (defined by
you) is opened whenever you click Menu on a path item or click Menu on the
second option in a Filer Menu (the one that reads "File '!Run'" or
"Selection") provided one and only one file is selected in the Filer window.

This menu deals with files and directories.  You should put on it things
which you want to do to files.

Here is an example of a MenuMenu

Set Director$MenuMenu MenuMenu

Menu "File�Menu" "MenuMenu"
	Option Here -sub "Path:|<Director$CurrentDir>"

This allows you to see a directory Menu of where the selected file or
directory is.  (See the section on GSTrans for the reason behind the | in the
-sub string.)

	Option Copy -sub "Save:|<Director$CurrentPath>"

This allows the current file or directory to be copied to a filer window,
dragged to an application or pinned to the pinboard (drag the icon onto the
pinboard).

	Option "Set CSD"
		Command Dir <Director$CurrentDir>

Sets the Current Directory to the directory in which the file or directory
was found.

	Option "Open Directory"
		Command Filer_OpenDir <Director$CurrentDir>

This opens a Filer Window onto the directory in which the file or directory
was found.

	Option "Filer_Run"
		Command Filer_Run <Director$CurrentPath>

This is equivalent to double clicking on the File or Directory.

	Option "Pin"
		Command SWI OS_Mouse TO x y|M
			Pin <Director$CurrentPath> |<x>-90 |<y>+45

This pins the file or Directory to the pinboard. (The command should be
written all on one line).  It uses the SWI Module to read the current
position of the mouse and then pins the centre of the icon there.  (Note the
|<x>, this is GSTransed to at run time <x> when the Command is being
prepared, which is then GSTransed to the mouse x co-ordinate when the Pin
command is run.)

	Option "IconSprites"
		Command IconSprites <Director$CurrentPath>

This IconSprites the file or directory.  (Only really useful over a sprite
file.)

EndMenu

There are many other possibilities for the MenuMenu, such as SetType,
ToolSprites, Delete, Wipe, Access etc.  A MenuMenu is perhaps best defined as
a dynamic Menu.


� Pinboard
==========

A menu of this name (defined by you) is opened whenever you click Menu on the
pinboard backdrop or on a TinyDirs icon.

If the pinboard module isn't loaded or running, no error is produced, but
none of the things in this section will work.

If you want to use the Pinboard's menu then you can press any of SHIFT, CTRL,
ALT when clicking Menu and the old Menu will appear.

Alternatively on your Pinboard menu you can have an option

	Option Pinboard -sub OldMenu:

Which when clicked on or slid over will open the menu that would have been
opened if Pinboard had been left to its own devices.  It will also move the
pointer to be in the correct place.

(I debated long and hard about moving the pointer (which I dislike), but
decided this was the least confusing option.  Try it for yourself!)


� SaveBox
=========

Read the section on special forms of Menus and commands if you haven't
already done so.

The SaveBox is not like a true SaveBox it is more like a miniature Filer
window (except you can't (yet) double click on the icon).

You may drag the icon from a SaveBox to an application (equivalent to
dragging it from the Filer) the pinboard (ditto) or a Filer window, which
will copy the File in the way you have configured (possibly bringing up a
Filer Action window etc).

You may also drag files to the SaveBox from the pinboard or Filer and it will
update to show the file you dragged.

There is only one SaveBox and if you try to open it twice the first one
disappears/changes into the new file/directory.


� Keys
======

Any Menu or Menu Option can have a hot key assigned.

A hot key assigned to a menu (in the Menu command) will open the Menu when
used and a hot key assigned to a Menu Option will be equivalent to clicking
with select on a Menu Option when used.

Keys are added by name and possibly with a modifier.

A single letter key refers to that key eg -key M or -key 8.  Keys are case
insensitive (and independent of CapsLock) so -key m is equivalent to -key M.

Some keys are referred to by name (case insensitive), and these are

	Home, Return, Ret, Enter, Backspace, BkSp, Space, Delete,
	Del, Esc, Print, Pnt, F1, F2, F3, F4, F5, F6, F7, F8, F9,
	Tab, Copy, Cpy, End, Left, Right, Down, Up, PageDown, PgDn,
	PageUp, PgUp, F10, F11, F12, Insert, Ins

Some of them are named twice for your convenience.  So -key F1, -key f1 or
-Key Insert would be valid.

Possible modifiers are

	�	SHIFT
	^ 	CTRL
	~ 	ALT

(To get the � symbol, hold down ALT, type 139 on the numeric keypad and
release ALT.  Alternatively map character 139 to a key in your favourite
editor (CTRL-6 is a good mapping).)

These can be added (in any order) before a key name, indicating that you have
to press the modifier keys indicated with the main key in order to activate
the hot key.  eg

	^M		CTRL-M
	�A		SHIFT-A
	^�F1 = �^F1	SHIFT-CTRL-F1

Note that -key �A = -key �a which is not equal to -key A = -key a.

Some key combinations don't work, eg

	CTRL Number keys don't work, CTRL KeyPad numbers should
	No keys work with ALT!

These may be fixed in a future release!

If an Option or a Menu has a key definition it is added to the text/title
with a space before it.  If you want the items to line up then you will have
to add spaces after the text/title.  RISCOS 3.5 will line them up for you
provided the key definitions starts with ^ or � or is one of the long form
named keys above.


� Colours
=========

Any colours in Director are specified numerically from the 16 Wimp colours. 
These colours can be seen by clicking on the Palette icon (supplied with
versions of RISCOS < 3.5).  The numbers of each colour are given below.

White	0	Grey4	4	Blue	8	Cream	12
Grey1	1	Grey5	5	Yellow	9	Khaki	13
Grey2	2	Grey6	6	Green	10	Orange	14
Grey3	3	Black	7	Red	11	Cyan	15

These names are defined in the file Director:Library.!Core and are defined by
default so you may use these names wherever a colour is needed, eg

	Option "Unreadable" -bg Red -fg Khaki


� Dynamic Menus
===============

These are menus that are created just before the menu is opened rather than
when you run Director.

They are used from an extended menu "Dynamic:Filename".  When this command is
run the file or command "Filename" is run.  When the command or file finishes
executing Director will try to open the menu whose name is in the system
variable Director$Menu.

A simple example of a dynamic menu would be this

	Option "Time" -sub "Dynamic:DirectorObey Director:Menus.Time"

This will run the command "DirectorObey Director:Menus.Time" when this menu
option is run.  The contents this file might be

	Menu "" Time -temp
		Option "**The�Time�Was**" -fg 11
		Option "���<Sys$Time>���"
		Option "<Sys$Date>�<Sys$Year>"
	EndMenu

	Set Director$Menu Time

This creates a temporary menu called Time with the current time and date in
it and returns the string "Time" in Director$Menu for Director to use as the
name of a menu to open.

Because the menu was created as a temporary menu it will be deleted once it
has been displayed to conserve memory (since it is rebuilt each time it is
needed).

Dynamic menus are very useful for displaying lists of things that could vary
whilst Director is running (such as modules or filetypes).  A few examples of
dynamic menus are provided in the Menus directory inside Director.

It would be possible to simulate most of the other features of Director using
dynamic menus, however in their current implementation they require a disc
access per use.  It would be possible to register the dynamic menu files in
the resource filing system to avoid this and maybe a future version of
Director will do this for you.

Dynamic menus set Director$Window and Director$Icon to the window handle and
icon number that the request was over respectively.  This is useful for more
advanced menus like the CloseBox menu example.


� Icons
=======

Icons are created in a similar way to menus.  Each one must be named (case
insensitive) by its sprite name or an alias name provided by you and there
can only be one of each name.  If you create an icon with the name of an
already existing one then the existing icon will be deleted without warning
and the new one created.

You may attach menus for Select, Adjust and Menu for the icon.  Remember that
the menus can also be commands (see the section on Special forms of Menus and
Commands)

This creates a new icon bar icon with attached menus. The icon is referred to
by the name of its sprite or the alias name if supplied.

	Syntax: *DirectorIcon
		<sprite>
			Name of the sprite, must be provided and exist in the
			Wimp sprite pool
		[-alias <name>]
			Internal name of the Icon.  If this is not supplied
			then the icon is referred to by its sprite name.
		[-text <text>]
			Text to go under the Icon.  Optional.  If the -time
			option is used then this Text defines the length of
			the time string.
		[-left|-right]
			Whether the icon goes on the left of the Icon bar or
			the right.  If omitted will default to -left.
		[-priority <priority>]
			This controls the positioning of the icon.  Larger
			numbers are to the outside of the icon bar. Range
			from 0 (inside) - &7FFFFFFF (outside).  Experiment to
			see where your icons gets placed or look at 3-98 in
			the RISCOS 3 PRMs.
		[-time <format>]
			This makes the text under the icon be interpreted as
			a time, which is updated once per second.  The
			length of the time is set by the -text option which
			must be given a string which is as long as the
			longest time string, and preferably of the same
			format, eg 00:00 for %24:%mi.  See the Applications
			Guide, under !Alarm, "Time and date formats" for
			more details or the RISCOS 3 PRMs 1-402.
		[-menu <menu>]
		[-select <menu>]
		[-adjust <menu>]
			These allow you to attach menus or commands to the 3
			mouse buttons.
		[-dragto <menu>]
			This specifies a menu to be run when a file is
			dragged onto the icon.    The path of the object
			dragged can be found from Director$CurrentPath �Leaf
			and �Dir.
		[-dragfrom <path>|*<menu>]
			This either takes a path which then acts exactly like
			the SaveBox or takes a menu preceded by * which will
			be run with Director$CurrentPath �Leaf and �Dir set
			up.
		[-remove]
			If this is specified then the icon named is removed
			rather than created.

For example (these should be typed in on 1 line, but have been split for
clarity)

	DirectorIcon romapps Apps -left -priority &50000000
		-menu "Path:Resources:$"
		-select "Command:Filer_OpenDir Resources:$.Apps"
		-adjust Pinboard

This provides a replacement Apps icon which has the Pinboard menu on Adjust,
does the normal thing on select, and on menu (which would normally say
"Open�$") produce a directory menu of the whole of Resources which is usually
much more useful.

	DirectorIcon !Director "00:00:00" -left -priority &0E000000
		-menu IconMenu
		-select IconClick
		-adjust Pinboard
		-time <37>24:%MI:%SE

This produces an icon with Director's own icon, the current time in 24 hour
format and 3 menus, IconClick, IconMenu and Pinboard.

[NB <37> GSTranses to %.  This odd looking construction is necessary because
%2 refers to the second argument supplied (when Obeying the file, not in
DirectorObey).  Since no arguments were supplied then the time string is
converted to 4:%MI:%SE which is not what was required!  <37> is used rather
than %% so the file will work with Obey and DirectorObey]

	DirectorIcon trashcan -left
		-dragto "Command:Wipe |<Director$CurrentPath> ~CFR~V"

This will create a trash can icon which will delete all the items dragged
onto it.

	DirectorIcon directory -left
		-dragfrom "*Command:Dir |<Director$CurrentPath>"

This when you drag the directory icon from the icon bar to a filer window
then it will set the current directory.

	DirectorIcon file_fff Text
		-select "Filer_Run $.Text"
		-dragfrom "$.Text"

This will make an icon which works quite like a TinyDir but for one file
$.Text.  You can drag the icon to copy the file or put it into a document and
click on the icon to run the file (in the case of a text file load it into a
text editor).


� Directory Menus
=================

Directory menus are automatically created and destroyed by Director when you
click with Menu on the title bar of a Filer or other window with a valid path
in it (eg an Edit window) in the default set up.  They are also produced by
-path "directory" or Command "Path:Directory" etc.

A menu will appear with all the files that are in the directory in it.  It is
intended to be complementary to the Filer, quicker to use, but not as
powerful.

Each item in the menu has the name of a file or directory and its icon.  This
is very similar to a filer window with sort by name, small icons and adjusted
to be tall and thin.

Items in the menu that are directories (or image files) will have a SubMenu
arrow by them.  You may traverse this arrow to see the next directory down.

Clicking with Select or Adjust is equivalent to double clicking the file in a
filer window.

Clicking with Menu over an Item will bring up the MenuMenu (see that section
for more details).  If a MenuMenu is not defined then it will do nothing.

Directory menus come in 2 flavours, with and without "Up Menus".  Up Menus
are the directories above the dotted line.  These show the directories up to
the root from where you are now.  The first item above the dotted line never
has a sub-menu because the item or the contents of that item are always
visible.

A directory menu made by "Path:" has Up Menus (eg the ones produced by
clicking Menu over a title bar).  A directory menu made by -path does not
have Up Menus by default unless you use the -up switch.


� Filters
=========

Filters are a powerful way to change the appearance of your desktop.  You may
add new menus or commands to existing desktop features without having to
patch anything.  For instance you could add a new menu onto the task switcher
icon or cause menu over any close icon to come up with a menu.

Filters are referred to by name (case insensitive) as supplied in the
command.  There can only be one filter of any given name, and if you attempt
to create a filter with the same name as an existing one then the existing
filter will be deleted without warning.

	DirectorFilter <name> <task> <menu>
		[-icon <n>]
		[-select] [-menu] [-adjust]
		[-shift] [-ctrl] [-alt]
		[-remove]

<name> is the name of the filter to be defined

<task> is the name of the task to filter on or * for all tasks.  This task
does not not have to be running when the command is executed and director
will keep track of the task if it is shut down and re-started.

<menu> is the menu (or command) to be executed by the filter

-icon <n> defines an icon number for the filter to execute.  If this number
is >= 0 then it will define a normal icon (load the template of the window
you are interested in into a template editor to discover the icon number or
use trial and error).  The file Director:Menus.Aliases contains names for a
number special icons which are probably more useful

WorkArea		- background of a window with no icons
BackIcon		- back icon in the top left of a window
CloseIcon		- close icon in the top left of a window
TitleBar		- title bar at the top of a window
ToggleSizeIcon		- toggle size icon at the top right of a window
ScrollUpArrow		- scroll up arrow
VerticalScrollBar	- vertical scroll bar
ScrollDownArrow		- scroll down arrow
AdjustSizeIcon		- adjust size icon at the bottom right of a window
ScrollLeftArrow		- scroll left arrow
HorizontalScrollBar	- horizontal scroll bar
ScrollRightArrow	- scroll right arrow
OuterWindowFrame	- outer frame of the window (1 pixel wide)
IconBar			- an icon bar icon only

-select -menu -adjust -shift -ctrl -alt are the conditions in which the
filter executes.  The button named must be down for the command to execute. 
They may be used in any combination and are exclusive (ie -shift -adjust will
only execute if SHIFT and ADJUST are pressed and not if SHIFT ALT ADJUST are
pressed ).

-remove removes a filter from director's memory and stops it executing.

Examples (these have been split over lines for readability but should be
entered on one line)

	DirectorFilter "Title Bar Directory" * Path: -icon TitleBar -menu
		This filter makes a directory menu when you press menu over
		the title bar of any window.
	DirectorFilter "Alt Menu Directory" Filer Path: -menu -alt
		This filter makes a directory menu when you press ALT MENU
		over a filer window
	DirectorFilter "Pinboard" Pinboard Pinboard -icon WorkArea -menu
		This opens a menu called pinboard when menu is pressed over
		the work area of the pinboard.  If you press menu over an
		icon on the pinboard then you will get the pinboard menu.
	DirectorFilter "Close Icon" *
		"Dynamic:DirectorObey Director:Menus.System.Close"
		-icon CloseIcon -menu
		This makes a menu appear when you press menu over any close
		box.  The menu is a dynamic menu because it adjusts itself to
		the window it was used over using  Director$Window and
		Director$Icon.
	DirectorFilter "Display Manager Adjust" "Display Manager" "Mode"
		-icon IconBar -adjust
		This adds an extra menu to the display manager icon bar icon
		when it is clicked with adjust.
	DirectorFilter "Task Manager Adjust" "Task Manager"
		"Dynamic:DirectorObey Director:Menus.System.Time"
		-icon IconBar -adjust
		This shows the time when adjust is clicked over the switcher
		icon

You may attach the original action of the filtered object by including
OldMenu: as an option in the filter menu.


� Other Features
================

If you do an Adjust click on a drive icon on the icon bar it should open a
Directory Menu rather than a Filer window.  Works for ADFS, Acorn SCSI, MOFS,
RAMFS, Memphis, CFS, CDFS, ICS�s IDEFS and Resources.  It will work for other
filing systems provided they have been written in the way suggested in the
PRMs!


� Other Commands
================

	Syntax: *DirectorObey <file> [-verbose]

This command is equivalent to *Obey except it searches for Director *commands
with high priority.  Obey is quite slow when processing lots of commands so
this speeds up loading a file with lots of Director commands in it. 
DirectorObey cut the loading time of a 14k menu from 5.2 seconds (with Obey)
to 0.75 seconds, ie a speed up of nearly 7 times!

It should be exactly equivalent to Obey, excepting the fact that it doesn't
substitute arguments (eg %0 and %%).  This means you have to be a bit careful
with %'s if you want your menus to work with Obey and DirectorObey.  (See the
Icons section about -time for an example.) The -verbose or -v option is
useful for debugging.

	Syntax: *MenuProcessing <On|Off|1|0|Yes|No>

This stops and restarts the processing of Menu, EndMenu, Option, Command and
Dash (ie all the menu commands).  This is so that you can comment out bits of
your menus.  For example if the machine you are running the menu on has no
SCSI card installed then there is no point having the SCSI menus installed
and you could check for this at menu load time.

	Syntax: *DirectorDo <command>

This GSTrans the command line and then runs it.  This is useful for commands
such as Filer_Run which don't GSTrans their input, but you want to give a
string with a system variable in it.  You can also run a command from a
system variable with this command.

	Syntax: *ProcessKeys [[�][^]<key>|"<string>"]^

This sends the parameters to the current input focus, or hot key grabber.  It
should work outside the Wimp, provided the keys are mapped as in the Wimp. 
It takes a space separated list of either strings to be put into the keyboard
buffer or key descriptions (see Keys section). You can of course map these
onto keys for hot key actions.  For example

	ProcessKeys "Modules" Return
	ProcessKeys F6 ^Left Down F6 ^Up ^V
	ProcessKeys "Show Obey$Dir" ^M
	ProcessKeys "42 Solution Road" ^M "Toytown" ^M "Shireshire" ^M
	ProcessKeys TAB "Option -path "

A chars menu could be provided using this, or a menu of frequently used
commands for command based application.

	Syntax: *DirectorEdit <file>

This loads the file given into an text editor (if one is loaded).  It is
useful for transferring files that are not type Text to an editor.

	Syntax: *DirectorParsePath <path>

This parses the path supplied into 3 system variables Director$CurrentPath
Director$Leaf and Director$Dir.  This is the routine that is used internally
by Director to set these variables and can occasionally be useful externally.

	Syntax: *DirectorMouseDir <var_name> [-file]

This sets the supplied system variable to the path of the window the pointer
is over.  This is used to set the current directory from a key in the default
menu.  It also works over Edit or Zap windows and will return the directory
that the file is in.  If the pointer is not over a window with a valid path
in the title then the system variable will be set to the null string ("").

If -file is specified then the system variable may be set to point to a file
(if over an Edit or Zap window for example), otherwise it will be set to the
directory in which the file resides.


� External Interface
====================

If you Broadcast the following UserMessage

0	Total length of message rounded up to nearest 4
12	0
16	&4A100
20	X Co-ord
24	Y Co-ord
28	Mouse button state
32	Window handle
36	Icon number
40	Null terminated menu name (or extended menu)

Director will display the menu (or run the command etc) at the position
specified.

Note bytes 20-39 are as returned from Wimp_GetPointerInfo.


� SWIs
======

&4A100	Director_Menu
&4A101	Director_EndMenu
&4A102	Director_Option
&4A103	Director_Dash
&4A104	Director_Command

	Entry
		r0 = pointer to the command line for the equivalent *command
	Exit

These are defined because processing star commands is very slow and in
dynamic menus especially it is important that items can be added to menus
quickly.

&4A105	Director_Enumerate

	This enumerates lists held by director

	Entry
		r0 = pointer to block or to start
			0 = stored menus
			1 = displayed menus
			2 = icons
			3 = filters
	Exit
		r0 = new pointer to block (0 for end)
		r1 = pointer to name of block

Dynamic menus to view these lists and act on them can be found on Director's
main menu.

&4A106	Director_Memory

	This returns the memory used by director

	Entry
	Exit
		r0	module size (constant)
		r1	main workspace size (constant)
		r2	total size of all allocated blocks
		r3	number of blocks allocated
		r4	dynamic area size (0 for no dynamic area)
		r5	bytes free in dynamic area
		r6	largest block in dynamic area

A dynamic menu to display this information can be found on Director's main
menu


� Debugging your Menus
======================

If you are having trouble with your menus when you load them (they give a
funny error and you don't know why) try opening a TaskWindow (CTRL-F12) type
in "DirectorObey -v " and SHIFT drag your menu file to the window.  This will
print out commands as they are executed and you should be able to spot
exactly when it goes wrong.

	Option "Debug"
		Command TaskWindow "DirectorObey -v Director:Menus.Menu"

Would put this on a Director menu for you!  (Substitute the correct name and
path of your Menu.)

Another thing to bear in mind is that if you reference a menu that you
haven't created eg

	Option "Hello" -sub "NotThere"

Where menu "NotThere" hasn't been created, this will not produce an error at
load time, and at run time it will just fail to produce the menu (not
producing an error either).  Originally it produced an error, but this proved
very annoying in other circumstances (eg when you haven't defined a Pinboard
menu because you don't want one).

You may refer to one menu more than once in a menu tree, however menus can
only be on the screen once so if you tried to open a SubMenu of a Menu that
was already displayed then nothing would happen.  However if you clicked on
the Option (provided it had no Command attached) it would then open the Menu
referred to.


� Oddities
==========

If you are running RISCOS 3.5 and wonder why your Menu titles are justified
all wrong (my menu is called "Nick's Menu" and the Menu gets right justified)
it is because you have included a reserved key name as the last word.  This
is RISCOS being helpful and lining up your key short cuts in Menus.  It
doesn't line up a key short cut of M for instance and will attempt to line up
anything with the last word "Menu"!  The solution is to put a hard space
before the "Menu" (hard space is ALT-SPACE).

If you put a -path <Director$CurrentDir> on your MenuMenu then beware,
looking at this Directory Menu will cause Director$CurrentDir and
Director$CurrentPath to change, so if you look at it again, you will be
looking up one level in the directory viewer.  This can be fixed by using a
dynamic menu as your MenuMenu (the default menu can be configured to do this,
look at its start).

Director menus with sprites in are sometimes the wrong width under
RISCOS�3.5.  I think this is a bug in the OS.  If you re-open the menu then
it may correct itself.

If you put Director in your boot sequence, make sure that you Filer_Run it
(not just Run) otherwise it won't start up properly.


� Utils
=======

There are a few utilities provided with Director to make Commands more
powerful and to make your life easier.

	ExpandMenu	For converting old Pinboard+ menus to Director form
	RunFilerAc	For starting off Filer_Action tasks (see examples)
	SwiModule	To be able to issue SWIs from the command line
	IfPodule	For finding out whether a podule is installed
	IfThereIs	For finding out whether a file/directory exists
	DriveName	For discovering the name of a drive from a path

You'll find these in the Utils directory within Director.  See there for
further documentation.

The SWI Module is very useful for building interesting commands but is not
essential to the operation of Director so you can stop it being loaded by
default by commenting out that line in the !Run file if you desire.


� Planned Extensions
====================

These go from will do definitely, to probably won't ever do, but nice idea!

A command to add options to previously created menu (technically very easy).

Save and restore memoriser settings automatically.

A command to define menu colours for permanent and temporary menus.  Should
be able to define the title bar colours as well.

Auto scrolling for menus.

Auto IconSprites or Filer_Boot applications
	1) Never
	2) When building permanent menus
	3) All the time

Holding down CTRL when making an auto menu could Filer_Boot the applications
within.

A Command run when Menu is pressed over a normal text item.

Make Director menus into windows.  Make the path options draggable and the
menu options clickable.  Make the menus persistent if torn off.


� Thanks
========

For interesting menu options, bug reports, comments, ideas, donations or even
just telling me that they were using Director, thanks are due to :-

Stefan Wiesner, Sam Kington, Paul Hedderly, Denis Howe, Kevin Bagust,
Ferro Marco, Brian Howlett, Simon Hatliff, Dominic Symes, Chris Knight,
Sergio Monesi, Jonathan Mist, James Freeman, Colin Hogben, Aidan Corey,
Mike Brown, Julian Smith, Matthew Bloch, Andrew Garrard, Bernhard Ege,
Simon Middleton, Trevor Johnson, Richard Payne, Paul Moore, Ian Hinder,
Reuben Thomas

Thomas Olsson, Julian Smith, Ben Summers, Jens Ovesen and Franz Philipps for
writing a set of excellent utilities which gave me lots of ideas for
Director.

Jonathan Coxhead for OSLib.

Julian Smith for generously supplying the source code for auto scrolling
menus (which I haven't had time to implement yet).

Jens Ovesen for very kindly allowing me to distribute his excellent and
indispensable SWI module with this application.

Dominic Symes for Zap.  No programmer should be without it.

Phil Slingsby for thinking of the name.

Dave Lawrence for testing, the original idea (and code) of creating Pinboard+
menus from a textual form, ExpandMenu, IfPodule, IfThereIs, DriveName and
loads of other ideas and suggestions (some of which I've almost certainly
credited to myself ;-)

My wife Loveday.


� Contacts
==========

Post:	Nick Craig-Wood
	Chalk Barton
	Shere Road
	West Horsley
	LEATHERHEAD
	Surrey KT24 6EW

EMail:	director@axis.demon.co.uk

BBS:	Arcade (0181 654 2212), User 939 (Nick Craig-Wood)

Any bug reports, ideas or donations gratefully received.

00000000  a4 20 48 65 6c 70 20 66  69 6c 65 20 66 6f 72 20  |. Help file for |
00000010  44 69 72 65 63 74 6f 72  20 76 65 72 73 69 6f 6e  |Director version|
00000020  20 30 2e 32 31 0a 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  | 0.21.==========|
00000030  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00000040  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 0a 0a 44 69 72  |===========..Dir|
00000050  65 63 74 6f 72 20 69 73  20 43 6f 70 79 72 69 67  |ector is Copyrig|
00000060  68 74 20 28 43 29 20 4e  69 63 6b 20 43 72 61 69  |ht (C) Nick Crai|
00000070  67 2d 57 6f 6f 64 20 31  39 39 34 0a 0a 49 66 20  |g-Wood 1994..If |
00000080  79 6f 75 20 61 72 65 20  72 65 61 64 69 6e 67 20  |you are reading |
00000090  74 68 69 73 20 69 6e 20  21 45 64 69 74 20 74 68  |this in !Edit th|
000000a0  65 6e 20 79 6f 75 20 6d  69 67 68 74 20 6c 69 6b  |en you might lik|
000000b0  65 20 74 6f 20 64 6f 20  45 78 70 61 6e 64 20 74  |e to do Expand t|
000000c0  61 62 73 20 6f 6e 20 74  68 65 0a 45 64 69 74 20  |abs on the.Edit |
000000d0  6d 65 6e 75 20 74 6f 20  74 75 72 6e 20 74 68 6f  |menu to turn tho|
000000e0  73 65 20 5b 30 39 5d 27  73 20 69 6e 74 6f 20 73  |se [09]'s into s|
000000f0  6f 6d 65 74 68 69 6e 67  20 75 73 65 66 75 6c 21  |omething useful!|
00000100  0a 0a 41 74 20 74 68 65  20 73 74 61 72 74 20 6f  |..At the start o|
00000110  66 20 65 61 63 68 20 73  65 63 74 69 6f 6e 20 74  |f each section t|
00000120  69 74 6c 65 20 69 73 20  61 20 a4 20 63 68 61 72  |itle is a . char|
00000130  61 63 74 65 72 20 28 41  4c 54 2d 31 36 34 20 69  |acter (ALT-164 i|
00000140  66 20 79 6f 75 72 20 6b  65 79 62 6f 61 72 64 0a  |f your keyboard.|
00000150  64 6f 65 73 6e 27 74 20  68 61 76 65 20 69 74 29  |doesn't have it)|
00000160  20 77 68 69 63 68 20 63  61 6e 20 62 65 20 75 73  | which can be us|
00000170  65 64 20 74 6f 20 73 65  61 72 63 68 20 74 68 69  |ed to search thi|
00000180  73 20 66 69 6c 65 2e 0a  0a 0a a4 20 43 6f 6e 74  |s file..... Cont|
00000190  65 6e 74 73 0a 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |ents.==========.|
000001a0  0a 2d 20 43 6f 6e 74 65  6e 74 73 0a 2d 20 4c 69  |.- Contents.- Li|
000001b0  63 65 6e 73 65 0a 2d 20  49 6e 74 72 6f 64 75 63  |cense.- Introduc|
000001c0  74 69 6f 6e 0a 2d 20 4d  6f 74 69 76 61 74 69 6f  |tion.- Motivatio|
000001d0  6e 0a 2d 20 53 77 69 74  63 68 69 6e 67 20 66 72  |n.- Switching fr|
000001e0  6f 6d 20 50 69 6e 62 6f  61 72 64 2b 20 74 6f 20  |om Pinboard+ to |
000001f0  44 69 72 65 63 74 6f 72  0a 2d 20 53 77 69 74 63  |Director.- Switc|
00000200  68 69 6e 67 20 66 72 6f  6d 20 54 72 65 65 4d 65  |hing from TreeMe|
00000210  6e 75 20 28 6f 72 20 44  69 72 4d 65 6e 75 29 20  |nu (or DirMenu) |
00000220  74 6f 20 44 69 72 65 63  74 6f 72 0a 2d 20 55 70  |to Director.- Up|
00000230  67 72 61 64 69 6e 67 20  66 72 6f 6d 20 44 69 72  |grading from Dir|
00000240  65 63 74 6f 72 20 30 2e  31 31 20 28 66 69 72 73  |ector 0.11 (firs|
00000250  74 20 70 75 62 6c 69 63  20 72 65 6c 65 61 73 65  |t public release|
00000260  29 0a 2d 20 4d 65 6e 75  73 0a 2d 20 53 68 6f 77  |).- Menus.- Show|
00000270  69 6e 67 20 61 20 4d 65  6e 75 0a 2d 20 53 79 73  |ing a Menu.- Sys|
00000280  74 65 6d 20 56 61 72 69  61 62 6c 65 73 0a 2d 20  |tem Variables.- |
00000290  47 53 54 72 61 6e 73 0a  2d 20 53 70 65 63 69 61  |GSTrans.- Specia|
000002a0  6c 20 66 6f 72 6d 73 20  6f 66 20 4d 65 6e 75 73  |l forms of Menus|
000002b0  20 61 6e 64 20 43 6f 6d  6d 61 6e 64 73 0a 2d 20  | and Commands.- |
000002c0  4d 65 6d 6f 72 69 73 65  72 0a 2d 20 4d 65 6e 75  |Memoriser.- Menu|
000002d0  4d 65 6e 75 0a 2d 20 50  69 6e 62 6f 61 72 64 0a  |Menu.- Pinboard.|
000002e0  2d 20 53 61 76 65 42 6f  78 0a 2d 20 4b 65 79 73  |- SaveBox.- Keys|
000002f0  0a 2d 20 43 6f 6c 6f 75  72 73 0a 2d 20 44 79 6e  |.- Colours.- Dyn|
00000300  61 6d 69 63 20 4d 65 6e  75 73 0a 2d 20 49 63 6f  |amic Menus.- Ico|
00000310  6e 73 0a 2d 20 44 69 72  65 63 74 6f 72 79 20 4d  |ns.- Directory M|
00000320  65 6e 75 73 0a 2d 20 46  69 6c 74 65 72 73 0a 2d  |enus.- Filters.-|
00000330  20 4f 74 68 65 72 20 46  65 61 74 75 72 65 73 0a  | Other Features.|
00000340  2d 20 4f 74 68 65 72 20  43 6f 6d 6d 61 6e 64 73  |- Other Commands|
00000350  0a 2d 20 45 78 74 65 72  6e 61 6c 20 49 6e 74 65  |.- External Inte|
00000360  72 66 61 63 65 0a 2d 20  53 57 49 73 0a 2d 20 44  |rface.- SWIs.- D|
00000370  65 62 75 67 67 69 6e 67  20 79 6f 75 72 20 4d 65  |ebugging your Me|
00000380  6e 75 73 0a 2d 20 4f 64  64 69 74 69 65 73 0a 2d  |nus.- Oddities.-|
00000390  20 55 74 69 6c 73 0a 2d  20 50 6c 61 6e 6e 65 64  | Utils.- Planned|
000003a0  20 45 78 74 65 6e 73 69  6f 6e 73 0a 2d 20 54 68  | Extensions.- Th|
000003b0  61 6e 6b 73 0a 2d 20 43  6f 6e 74 61 63 74 73 0a  |anks.- Contacts.|
000003c0  09 0a 0a a4 20 4c 69 63  65 6e 73 65 0a 3d 3d 3d  |.... License.===|
000003d0  3d 3d 3d 3d 3d 3d 0a 0a  44 69 72 65 63 74 6f 72  |======..Director|
000003e0  20 28 54 68 65 20 53 6f  66 74 77 61 72 65 29 20  | (The Software) |
000003f0  69 73 20 43 6f 70 79 72  69 67 68 74 20 28 43 29  |is Copyright (C)|
00000400  20 4e 69 63 6b 20 43 72  61 69 67 2d 57 6f 6f 64  | Nick Craig-Wood|
00000410  20 31 39 39 34 20 28 4e  43 57 29 20 61 6e 64 20  | 1994 (NCW) and |
00000420  6d 61 79 0a 6e 6f 74 20  62 65 20 75 73 65 64 20  |may.not be used |
00000430  6f 72 20 63 6f 70 69 65  64 20 65 78 63 65 70 74  |or copied except|
00000440  20 61 73 20 69 6e 20 61  63 63 6f 72 64 20 77 69  | as in accord wi|
00000450  74 68 20 74 68 65 20 74  65 72 6d 73 20 61 6e 64  |th the terms and|
00000460  20 63 6f 6e 64 69 74 69  6f 6e 73 0a 62 65 6c 6f  | conditions.belo|
00000470  77 2e 0a 0a 59 6f 75 20  6d 61 79 20 4e 4f 54 20  |w...You may NOT |
00000480  4d 61 6b 65 20 74 68 65  20 53 6f 66 74 77 61 72  |Make the Softwar|
00000490  65 20 61 76 61 69 6c 61  62 6c 65 20 74 6f 20 61  |e available to a|
000004a0  6e 79 20 74 68 69 72 64  20 70 61 72 74 79 20 45  |ny third party E|
000004b0  58 43 45 50 54 20 77 69  74 68 20 74 68 65 73 65  |XCEPT with these|
000004c0  0a 74 65 72 6d 73 20 61  6e 64 20 63 6f 6e 64 69  |.terms and condi|
000004d0  74 69 6f 6e 73 20 69 6d  70 6f 73 65 64 20 6f 6e  |tions imposed on|
000004e0  20 73 61 69 64 20 70 61  72 74 79 2e 0a 0a 59 6f  | said party...Yo|
000004f0  75 20 6d 61 79 20 4e 4f  54 20 4d 61 6b 65 20 74  |u may NOT Make t|
00000500  68 65 20 53 6f 66 74 77  61 72 65 20 61 76 61 69  |he Software avai|
00000510  6c 61 62 6c 65 20 74 6f  20 61 6e 79 20 74 68 69  |lable to any thi|
00000520  72 64 20 70 61 72 74 79  20 45 58 43 45 50 54 20  |rd party EXCEPT |
00000530  61 74 20 6e 6f 0a 62 65  6e 65 66 69 74 20 74 6f  |at no.benefit to|
00000540  20 79 6f 75 72 73 65 6c  66 20 6f 72 20 61 6e 79  | yourself or any|
00000550  20 74 68 69 72 64 20 70  61 72 74 79 2c 20 65 78  | third party, ex|
00000560  63 65 70 74 69 6e 67 20  74 68 61 74 20 62 65 6e  |cepting that ben|
00000570  65 66 69 74 20 63 6f 6e  74 61 69 6e 65 64 0a 77  |efit contained.w|
00000580  69 74 68 69 6e 20 74 68  65 20 53 6f 66 74 77 61  |ithin the Softwa|
00000590  72 65 2e 0a 0a 59 6f 75  20 4d 55 53 54 20 6d 61  |re...You MUST ma|
000005a0  6b 65 20 73 75 72 65 20  74 68 65 20 53 6f 66 74  |ke sure the Soft|
000005b0  77 61 72 65 20 69 73 20  64 69 73 74 72 69 62 75  |ware is distribu|
000005c0  74 65 64 20 77 68 6f 6c  65 2c 20 69 6e 74 61 63  |ted whole, intac|
000005d0  74 20 61 6e 64 20 75 6e  6d 6f 64 69 66 69 65 64  |t and unmodified|
000005e0  2c 0a 69 6e 63 6c 75 64  69 6e 67 20 61 6c 6c 20  |,.including all |
000005f0  74 68 65 20 66 69 6c 65  73 20 69 6e 20 74 68 65  |the files in the|
00000600  20 6f 72 69 67 69 6e 61  6c 20 64 69 73 74 72 69  | original distri|
00000610  62 75 74 69 6f 6e 2e 0a  0a 59 6f 75 20 6d 61 79  |bution...You may|
00000620  20 4e 4f 54 20 6d 61 79  20 6e 6f 74 20 73 65 6c  | NOT may not sel|
00000630  6c 2c 20 68 69 72 65 20  6f 72 20 69 6e 63 6c 75  |l, hire or inclu|
00000640  64 65 20 74 68 65 20 53  6f 66 74 77 61 72 65 20  |de the Software |
00000650  69 6e 20 61 20 70 61 63  6b 61 67 65 20 77 68 69  |in a package whi|
00000660  63 68 20 69 73 0a 73 6f  6c 64 20 6f 72 20 68 69  |ch is.sold or hi|
00000670  72 65 64 2c 20 6d 6f 64  69 66 79 2c 20 74 72 61  |red, modify, tra|
00000680  6e 73 6c 61 74 65 2c 20  64 69 73 61 73 73 65 6d  |nslate, disassem|
00000690  62 6c 65 2c 20 64 65 63  6f 6d 70 69 6c 65 2c 20  |ble, decompile, |
000006a0  72 65 76 65 72 73 65 20  65 6e 67 69 6e 65 65 72  |reverse engineer|
000006b0  2c 0a 6f 72 20 63 72 65  61 74 65 20 64 65 72 69  |,.or create deri|
000006c0  76 61 74 69 76 65 20 77  6f 72 6b 73 20 62 61 73  |vative works bas|
000006d0  65 64 20 75 70 6f 6e 20  74 68 65 20 53 6f 66 74  |ed upon the Soft|
000006e0  77 61 72 65 20 6f 72 20  69 6e 63 6c 75 64 65 20  |ware or include |
000006f0  77 68 6f 6c 65 20 6f 72  20 70 61 72 74 0a 6f 66  |whole or part.of|
00000700  20 74 68 65 20 53 6f 66  74 77 61 72 65 20 69 6e  | the Software in|
00000710  74 6f 20 6f 74 68 65 72  20 77 6f 72 6b 73 2e 20  |to other works. |
00000720  0a 0a 54 68 65 20 53 6f  66 74 77 61 72 65 20 69  |..The Software i|
00000730  73 20 73 75 70 70 6c 69  65 64 20 22 61 73 20 69  |s supplied "as i|
00000740  73 22 2c 20 4e 43 57 20  6d 61 6b 65 73 20 6e 6f  |s", NCW makes no|
00000750  20 77 61 72 72 61 6e 74  79 2c 20 65 78 70 72 65  | warranty, expre|
00000760  73 73 20 6f 72 20 69 6d  70 6c 69 65 64 2c 0a 61  |ss or implied,.a|
00000770  73 20 74 6f 20 74 68 65  20 6d 65 72 63 68 61 6e  |s to the merchan|
00000780  74 61 62 69 6c 69 74 79  20 6f 72 20 69 74 73 20  |tability or its |
00000790  66 69 74 6e 65 73 73 20  66 6f 72 20 61 6e 79 20  |fitness for any |
000007a0  70 61 72 74 69 63 75 6c  61 72 20 70 75 72 70 6f  |particular purpo|
000007b0  73 65 2e 20 20 49 74 20  6d 61 79 0a 6f 72 20 6d  |se.  It may.or m|
000007c0  61 79 20 6e 6f 74 20 70  65 72 66 6f 72 6d 20 69  |ay not perform i|
000007d0  6e 20 61 63 63 6f 72 64  61 6e 63 65 20 77 69 74  |n accordance wit|
000007e0  68 20 74 68 65 20 64 6f  63 75 6d 65 6e 74 61 74  |h the documentat|
000007f0  69 6f 6e 20 6f 72 20 79  6f 75 72 20 65 78 70 65  |ion or your expe|
00000800  63 74 61 74 69 6f 6e 73  2e 0a 0a 49 6e 20 6e 6f  |ctations...In no|
00000810  20 63 69 72 63 75 6d 73  74 61 6e 63 65 73 20 77  | circumstances w|
00000820  69 6c 6c 20 4e 43 57 20  62 65 20 6c 69 61 62 6c  |ill NCW be liabl|
00000830  65 20 66 6f 72 20 61 6e  79 20 64 61 6d 61 67 65  |e for any damage|
00000840  2c 20 6c 6f 73 73 20 6f  66 20 70 72 6f 66 69 74  |, loss of profit|
00000850  73 2c 0a 67 6f 6f 64 77  69 6c 6c 20 6f 72 20 66  |s,.goodwill or f|
00000860  6f 72 20 61 6e 79 20 69  6e 64 69 72 65 63 74 20  |or any indirect |
00000870  6f 72 20 63 6f 6e 73 65  71 75 65 6e 74 69 61 6c  |or consequential|
00000880  20 6c 6f 73 73 20 61 72  69 73 69 6e 67 20 6f 75  | loss arising ou|
00000890  74 20 6f 66 20 74 68 65  20 75 73 65 20 6f 66 0a  |t of the use of.|
000008a0  74 68 65 20 53 6f 66 74  77 61 72 65 2c 20 6f 72  |the Software, or|
000008b0  20 69 6e 61 62 69 6c 69  74 79 20 74 6f 20 75 73  | inability to us|
000008c0  65 20 74 68 65 20 53 6f  66 74 77 61 72 65 2c 20  |e the Software, |
000008d0  65 76 65 6e 20 69 66 20  4e 43 57 20 68 61 73 20  |even if NCW has |
000008e0  62 65 65 6e 20 61 64 76  69 73 65 64 0a 6f 66 20  |been advised.of |
000008f0  74 68 65 20 70 6f 73 73  69 62 69 6c 69 74 79 20  |the possibility |
00000900  6f 66 20 73 75 63 68 20  6c 6f 73 73 2e 0a 0a 54  |of such loss...T|
00000910  68 65 73 65 20 63 6f 6e  64 69 74 69 6f 6e 73 20  |hese conditions |
00000920  73 75 70 65 72 73 65 64  65 20 61 6e 79 20 70 72  |supersede any pr|
00000930  69 6f 72 20 61 67 72 65  65 6d 65 6e 74 2c 20 6f  |ior agreement, o|
00000940  72 61 6c 20 6f 72 20 77  72 69 74 74 65 6e 2c 20  |ral or written, |
00000950  62 65 74 77 65 65 6e 20  79 6f 75 0a 61 6e 64 20  |between you.and |
00000960  4e 43 57 20 72 65 6c 61  74 69 6e 67 20 74 6f 20  |NCW relating to |
00000970  74 68 65 20 53 6f 66 74  77 61 72 65 2e 0a 0a 59  |the Software...Y|
00000980  6f 75 20 61 67 72 65 65  20 74 68 61 74 20 65 78  |ou agree that ex|
00000990  63 65 70 74 20 66 6f 72  20 77 72 69 74 74 65 6e  |cept for written|
000009a0  20 73 65 70 61 72 61 74  65 20 61 67 72 65 65 6d  | separate agreem|
000009b0  65 6e 74 73 20 62 65 74  77 65 65 6e 20 4e 43 57  |ents between NCW|
000009c0  20 61 6e 64 20 79 6f 75  2c 0a 74 68 69 73 20 61  | and you,.this a|
000009d0  67 72 65 65 6d 65 6e 74  20 69 73 20 61 20 63 6f  |greement is a co|
000009e0  6d 70 6c 65 74 65 20 61  6e 64 20 65 78 63 6c 75  |mplete and exclu|
000009f0  73 69 76 65 20 73 74 61  74 65 6d 65 6e 74 20 6f  |sive statement o|
00000a00  66 20 74 68 65 20 72 69  67 68 74 73 20 61 6e 64  |f the rights and|
00000a10  0a 6c 69 61 62 69 6c 69  74 69 65 73 20 6f 66 20  |.liabilities of |
00000a20  74 68 65 20 70 61 72 74  69 65 73 2e 0a 0a 59 6f  |the parties...Yo|
00000a30  75 20 61 63 6b 6e 6f 77  6c 65 64 67 65 20 74 68  |u acknowledge th|
00000a40  61 74 20 79 6f 75 20 68  61 76 65 20 72 65 61 64  |at you have read|
00000a50  20 74 68 69 73 20 61 67  72 65 65 6d 65 6e 74 2c  | this agreement,|
00000a60  20 74 68 61 74 20 79 6f  75 20 75 6e 64 65 72 73  | that you unders|
00000a70  74 61 6e 64 20 74 68 69  73 0a 61 67 72 65 65 6d  |tand this.agreem|
00000a80  65 6e 74 2c 20 61 6e 64  20 62 79 20 6c 6f 61 64  |ent, and by load|
00000a90  69 6e 67 2c 20 72 75 6e  6e 69 6e 67 20 6f 72 20  |ing, running or |
00000aa0  63 6f 70 79 69 6e 67 20  74 68 65 20 53 6f 66 74  |copying the Soft|
00000ab0  77 61 72 65 20 79 6f 75  20 61 67 72 65 65 20 74  |ware you agree t|
00000ac0  6f 20 62 65 0a 62 6f 75  6e 64 20 62 79 20 74 68  |o be.bound by th|
00000ad0  69 73 20 61 67 72 65 65  6d 65 6e 74 27 73 20 74  |is agreement's t|
00000ae0  65 72 6d 73 20 61 6e 64  20 63 6f 6e 64 69 74 69  |erms and conditi|
00000af0  6f 6e 73 2e 0a 0a 0a a4  20 49 6e 74 72 6f 64 75  |ons..... Introdu|
00000b00  63 74 69 6f 6e 0a 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |ction.==========|
00000b10  3d 3d 3d 3d 0a 0a 44 69  72 65 63 74 6f 72 20 69  |====..Director i|
00000b20  73 20 61 20 67 65 6e 65  72 61 6c 20 70 75 72 70  |s a general purp|
00000b30  6f 73 65 20 64 65 73 6b  74 6f 70 20 74 6f 6f 6c  |ose desktop tool|
00000b40  2e 20 20 49 74 20 61 6c  6c 6f 77 73 20 79 6f 75  |.  It allows you|
00000b50  20 74 6f 20 63 75 73 74  6f 6d 69 73 65 20 79 6f  | to customise yo|
00000b60  75 72 0a 64 65 73 6b 74  6f 70 20 62 79 20 63 72  |ur.desktop by cr|
00000b70  65 61 74 69 6e 67 20 6d  65 6e 75 73 20 6f 66 20  |eating menus of |
00000b80  75 73 65 66 75 6c 20 63  6f 6d 6d 61 6e 64 73 20  |useful commands |
00000b90  61 6e 64 20 69 63 6f 6e  73 20 74 6f 20 61 74 74  |and icons to att|
00000ba0  61 63 68 20 74 68 65 20  6d 65 6e 75 73 0a 74 6f  |ach the menus.to|
00000bb0  2e 20 20 41 6e 79 20 6e  75 6d 62 65 72 20 6f 66  |.  Any number of|
00000bc0  20 6d 65 6e 75 73 20 6f  72 20 69 63 6f 6e 73 20  | menus or icons |
00000bd0  63 61 6e 20 62 65 20 63  72 65 61 74 65 64 20 61  |can be created a|
00000be0  6e 64 20 61 74 74 61 63  68 65 64 20 69 6e 20 61  |nd attached in a|
00000bf0  6e 79 20 6f 72 64 65 72  20 74 6f 0a 65 61 63 68  |ny order to.each|
00000c00  20 6f 74 68 65 72 2e 0a  0a 44 69 72 65 63 74 6f  | other...Directo|
00000c10  72 20 61 6c 73 6f 20 61  6c 6c 6f 77 73 20 61 6e  |r also allows an|
00000c20  20 61 6c 74 65 72 6e 61  74 69 76 65 20 61 6e 64  | alternative and|
00000c30  20 66 61 73 74 65 72 20  76 69 65 77 20 6f 6e 74  | faster view ont|
00000c40  6f 20 66 69 6c 65 73 20  69 6e 20 74 68 65 20 66  |o files in the f|
00000c50  6f 72 6d 20 6f 66 0a 64  69 72 65 63 74 6f 72 79  |orm of.directory|
00000c60  20 6d 65 6e 75 73 20 61  6e 64 20 61 6c 6c 6f 77  | menus and allow|
00000c70  73 20 74 68 65 73 65 20  6d 65 6e 75 73 20 74 6f  |s these menus to|
00000c80  20 62 65 20 61 74 74 61  63 68 65 64 20 74 6f 20  | be attached to |
00000c90  6f 74 68 65 72 20 6d 65  6e 75 73 20 61 6c 73 6f  |other menus also|
00000ca0  2e 0a 0a 44 69 72 65 63  74 6f 72 20 68 61 73 20  |...Director has |
00000cb0  73 6f 6d 65 20 6f 74 68  65 72 20 75 73 65 66 75  |some other usefu|
00000cc0  6c 20 66 65 61 74 75 72  65 73 20 73 75 63 68 20  |l features such |
00000cd0  61 73 20 72 65 6d 65 6d  62 65 72 69 6e 67 20 74  |as remembering t|
00000ce0  68 65 20 6d 6f 73 74 20  72 65 63 65 6e 74 6c 79  |he most recently|
00000cf0  0a 75 73 65 64 20 66 69  6c 65 73 2c 20 74 68 65  |.used files, the|
00000d00  20 61 62 69 6c 69 74 79  20 74 6f 20 61 64 64 20  | ability to add |
00000d10  6b 65 79 20 73 74 72 6f  6b 65 73 20 69 6e 74 6f  |key strokes into|
00000d20  20 74 68 65 20 6b 65 79  62 6f 61 72 64 20 62 75  | the keyboard bu|
00000d30  66 66 65 72 20 61 6e 64  20 74 68 65 0a 61 62 69  |ffer and the.abi|
00000d40  6c 69 74 79 20 74 6f 20  70 72 6f 64 75 63 65 20  |lity to produce |
00000d50  64 69 72 65 63 74 6f 72  79 20 6d 65 6e 75 73 20  |directory menus |
00000d60  6f 76 65 72 20 64 72 69  76 65 20 69 63 6f 6e 73  |over drive icons|
00000d70  2e 0a 0a 44 69 72 65 63  74 6f 72 20 69 73 20 66  |...Director is f|
00000d80  75 6c 6c 79 20 63 75 73  74 6f 6d 69 73 61 62 6c  |ully customisabl|
00000d90  65 20 62 79 20 74 68 65  20 75 73 65 72 2c 20 61  |e by the user, a|
00000da0  6e 64 20 63 61 6e 20 64  6f 20 6d 61 6e 79 20 6f  |nd can do many o|
00000db0  72 20 61 6c 6c 20 6f 66  20 74 68 65 0a 66 75 6e  |r all of the.fun|
00000dc0  63 74 69 6f 6e 73 20 6f  66 20 50 69 6e 62 6f 61  |ctions of Pinboa|
00000dd0  72 64 2b 2c 20 54 72 65  65 4d 65 6e 75 20 28 41  |rd+, TreeMenu (A|
00000de0  4b 41 20 44 69 72 4d 65  6e 75 29 2c 20 46 69 6c  |KA DirMenu), Fil|
00000df0  65 72 2d 2c 20 51 75 69  63 6b 44 69 72 2c 20 44  |er-, QuickDir, D|
00000e00  65 73 6b 55 74 69 6c 73  2c 0a 4d 65 6d 6f 72 69  |eskUtils,.Memori|
00000e10  7a 65 72 2c 20 4d 65 6e  6f 6e 20 61 6e 64 20 73  |zer, Menon and s|
00000e20  6f 6d 65 20 6f 66 20 74  68 65 20 66 75 6e 63 74  |ome of the funct|
00000e30  69 6f 6e 73 20 6f 66 20  46 69 6c 65 72 2b 2e 0a  |ions of Filer+..|
00000e40  0a 44 69 72 65 63 74 6f  72 20 77 69 6c 6c 20 6f  |.Director will o|
00000e50  6e 6c 79 20 72 75 6e 20  6f 6e 20 52 49 53 43 20  |nly run on RISC |
00000e60  4f 53 20 33 2e 31 30 20  6f 72 20 6c 61 74 65 72  |OS 3.10 or later|
00000e70  2e 0a 0a 0a a4 20 4d 6f  74 69 76 61 74 69 6f 6e  |..... Motivation|
00000e80  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 44  |.============..D|
00000e90  69 72 65 63 74 6f 72 20  77 61 73 20 69 6e 69 74  |irector was init|
00000ea0  69 61 6c 6c 79 20 63 6f  6e 63 65 69 76 65 64 20  |ially conceived |
00000eb0  61 73 20 61 20 72 65 70  6c 61 63 65 6d 65 6e 74  |as a replacement|
00000ec0  20 66 6f 72 20 50 69 6e  62 6f 61 72 64 2b 20 28  | for Pinboard+ (|
00000ed0  62 79 20 54 68 6f 6d 61  73 0a 4f 6c 73 73 6f 6e  |by Thomas.Olsson|
00000ee0  29 2e 20 20 46 6f 72 20  74 68 6f 73 65 20 6f 66  |).  For those of|
00000ef0  20 79 6f 75 20 77 68 6f  20 64 6f 6e 27 74 20 6b  | you who don't k|
00000f00  6e 6f 77 2c 20 50 69 6e  62 6f 61 72 64 2b 20 69  |now, Pinboard+ i|
00000f10  73 20 61 20 72 65 70 6c  61 63 65 6d 65 6e 74 0a  |s a replacement.|
00000f20  50 69 6e 62 6f 61 72 64  20 6d 6f 64 75 6c 65 20  |Pinboard module |
00000f30  77 68 69 63 68 20 61 6c  6c 6f 77 73 20 75 73 65  |which allows use|
00000f40  72 20 64 65 66 69 6e 61  62 6c 65 20 6d 65 6e 75  |r definable menu|
00000f50  73 20 77 68 65 6e 20 63  6c 69 63 6b 69 6e 67 20  |s when clicking |
00000f60  6d 65 6e 75 20 6f 76 65  72 20 74 68 65 0a 62 61  |menu over the.ba|
00000f70  63 6b 64 72 6f 70 2e 0a  0a 54 68 65 20 69 6e 69  |ckdrop...The ini|
00000f80  74 69 61 6c 20 64 65 73  69 67 6e 20 6f 66 20 44  |tial design of D|
00000f90  69 72 65 63 74 6f 72 20  77 61 73 20 69 6e 20 6f  |irector was in o|
00000fa0  72 64 65 72 20 74 6f 20  6f 76 65 72 63 6f 6d 65  |rder to overcome|
00000fb0  20 74 68 65 20 66 61 63  74 20 74 68 61 74 0a 50  | the fact that.P|
00000fc0  69 6e 62 6f 61 72 64 2b  20 6e 65 65 64 65 64 20  |inboard+ needed |
00000fd0  61 20 72 65 70 6c 61 63  65 6d 65 6e 74 20 70 69  |a replacement pi|
00000fe0  6e 62 6f 61 72 64 20 6d  6f 64 75 6c 65 20 6c 6f  |nboard module lo|
00000ff0  61 64 65 64 20 28 77 68  69 63 68 20 64 69 64 20  |aded (which did |
00001000  6e 6f 74 20 77 6f 72 6b  0a 66 75 6c 6c 79 20 75  |not work.fully u|
00001010  6e 64 65 72 20 52 49 53  43 4f 53 20 33 2e 35 29  |nder RISCOS 3.5)|
00001020  20 61 6e 64 20 74 68 65  20 66 61 63 74 20 74 68  | and the fact th|
00001030  61 74 20 74 68 65 72 65  20 77 61 73 20 6e 6f 20  |at there was no |
00001040  65 61 73 79 20 77 61 79  20 6f 66 20 73 70 65 63  |easy way of spec|
00001050  69 66 79 69 6e 67 0a 74  68 61 74 20 79 6f 75 20  |ifying.that you |
00001060  77 61 6e 74 65 64 20 74  68 65 20 63 6f 6e 74 65  |wanted the conte|
00001070  6e 74 73 20 6f 66 20 61  20 64 69 72 65 63 74 6f  |nts of a directo|
00001080  72 79 20 61 73 20 61 20  73 75 62 20 6d 65 6e 75  |ry as a sub menu|
00001090  2e 0a 0a 54 68 69 73 20  74 68 65 6e 20 6c 65 64  |...This then led|
000010a0  20 6f 6e 20 74 6f 20 74  68 65 20 69 64 65 61 20  | on to the idea |
000010b0  6f 66 20 69 6e 63 6f 72  70 6f 72 61 74 69 6e 67  |of incorporating|
000010c0  20 74 68 65 20 66 75 6e  63 74 69 6f 6e 73 20 6f  | the functions o|
000010d0  66 20 54 72 65 65 4d 65  6e 75 20 28 62 79 0a 4a  |f TreeMenu (by.J|
000010e0  75 6c 69 61 6e 20 53 6d  69 74 68 29 20 69 6e 74  |ulian Smith) int|
000010f0  6f 20 44 69 72 65 63 74  6f 72 2e 20 20 54 68 69  |o Director.  Thi|
00001100  73 20 77 6f 75 6c 64 20  74 68 65 6e 20 65 6e 61  |s would then ena|
00001110  62 6c 65 20 61 20 64 69  72 65 63 74 6f 72 79 20  |ble a directory |
00001120  74 72 65 65 20 6c 69 73  74 69 6e 67 0a 74 6f 20  |tree listing.to |
00001130  62 65 20 61 74 74 61 63  68 65 64 20 74 6f 20 61  |be attached to a|
00001140  20 6d 65 6e 75 20 61 74  20 61 6e 79 20 70 6f 69  | menu at any poi|
00001150  6e 74 2e 0a 0a 54 68 65  73 65 20 69 64 65 61 73  |nt...These ideas|
00001160  20 6c 65 64 20 6f 6e 74  6f 20 44 69 72 65 63 74  | led onto Direct|
00001170  6f 72 20 62 65 69 6e 67  20 6d 6f 72 65 20 6f 66  |or being more of|
00001180  20 61 20 67 65 6e 65 72  61 6c 20 70 75 72 70 6f  | a general purpo|
00001190  73 65 20 70 72 6f 67 72  61 6d 2c 0a 6d 65 72 67  |se program,.merg|
000011a0  69 6e 67 20 73 65 76 65  72 61 6c 20 75 74 69 6c  |ing several util|
000011b0  69 74 69 65 73 20 69 6e  74 6f 20 6f 6e 65 20 63  |ities into one c|
000011c0  6f 6d 70 61 63 74 20 70  61 63 6b 61 67 65 2e 0a  |ompact package..|
000011d0  0a 4d 65 6d 6f 72 79 20  75 73 61 67 65 20 77 61  |.Memory usage wa|
000011e0  73 20 61 6e 6f 74 68 65  72 20 6f 66 20 74 68 65  |s another of the|
000011f0  20 6d 61 69 6e 20 72 65  61 73 6f 6e 73 20 66 6f  | main reasons fo|
00001200  72 20 63 6f 64 69 6e 67  20 44 69 72 65 63 74 6f  |r coding Directo|
00001210  72 2e 20 20 48 65 72 65  27 73 20 61 0a 62 65 66  |r.  Here's a.bef|
00001220  6f 72 65 20 61 6e 64 20  61 66 74 65 72 20 6f 6e  |ore and after on|
00001230  20 74 68 65 20 6d 65 6d  6f 72 79 20 66 72 6f 6e  | the memory fron|
00001240  74 2e 0a 0a 42 65 66 6f  72 65 3a 0a 0a 54 72 65  |t...Before:..Tre|
00001250  65 4d 65 6e 75 20 20 20  20 20 20 20 20 20 20 36  |eMenu          6|
00001260  35 2c 35 33 36 0a 50 69  6e 62 6f 61 72 64 2b 20  |5,536.Pinboard+ |
00001270  20 20 20 20 20 20 20 20  31 38 2c 38 31 32 20 28  |        18,812 (|
00001280  6d 6f 64 75 6c 65 29 0a  20 20 20 20 20 20 20 20  |module).        |
00001290  20 20 20 20 20 20 20 20  20 20 34 33 2c 33 32 34  |          43,324|
000012a0  20 28 6d 65 6e 75 29 0a  44 65 73 6b 55 74 69 6c  | (menu).DeskUtil|
000012b0  73 20 20 20 20 20 20 20  20 20 33 32 2c 37 36 38  |s         32,768|
000012c0  0a 4d 65 6d 6f 72 69 7a  65 72 20 20 20 20 20 20  |.Memorizer      |
000012d0  20 20 20 31 34 2c 31 32  38 0a 98 98 98 98 98 98  |   14,128.......|
000012e0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
000012f0  98 98 0a 54 6f 74 61 6c  20 20 20 20 20 20 20 20  |...Total        |
00001300  20 20 20 20 31 37 34 2c  35 36 38 20 42 79 74 65  |    174,568 Byte|
00001310  73 0a 0a 41 66 74 65 72  3a 0a 0a 50 72 6f 67 72  |s..After:..Progr|
00001320  61 6d 20 63 6f 64 65 20  20 20 20 20 20 31 38 2c  |am code      18,|
00001330  36 37 32 0a 57 6f 72 6b  73 70 61 63 65 20 20 20  |672.Workspace   |
00001340  20 20 20 20 20 20 20 33  2c 36 30 30 0a 48 65 61  |       3,600.Hea|
00001350  70 20 20 20 20 20 20 20  20 20 20 20 20 20 20 31  |p              1|
00001360  38 2c 34 31 36 20 28 31  31 39 20 62 6c 6f 63 6b  |8,416 (119 block|
00001370  73 29 0a 98 98 98 98 98  98 98 98 98 98 98 98 98  |s)..............|
00001380  98 98 98 98 98 98 98 98  98 98 98 0a 54 6f 74 61  |............Tota|
00001390  6c 20 20 20 20 20 20 20  20 20 20 20 20 20 34 30  |l             40|
000013a0  2c 36 38 38 20 42 79 74  65 73 0a 0a 54 68 75 73  |,688 Bytes..Thus|
000013b0  20 67 69 76 69 6e 67 20  61 20 73 61 76 69 6e 67  | giving a saving|
000013c0  20 6f 66 20 31 33 33 2c  38 38 30 20 62 79 74 65  | of 133,880 byte|
000013d0  73 20 6f 72 20 31 33 30  20 6b 42 79 74 65 73 21  |s or 130 kBytes!|
000013e0  0a 0a 44 69 72 65 63 74  6f 72 20 77 69 6c 6c 20  |..Director will |
000013f0  75 73 65 20 61 20 64 79  6e 61 6d 69 63 20 61 72  |use a dynamic ar|
00001400  65 61 20 69 66 20 74 68  65 79 20 61 72 65 20 61  |ea if they are a|
00001410  76 61 69 6c 61 62 6c 65  2e 20 20 28 54 68 69 73  |vailable.  (This|
00001420  20 68 61 73 20 73 65 76  65 72 61 6c 0a 61 64 76  | has several.adv|
00001430  61 6e 74 61 67 65 73 2c  20 74 68 65 20 6d 61 69  |antages, the mai|
00001440  6e 20 6f 6e 65 20 62 65  69 6e 67 20 6c 65 73 73  |n one being less|
00001450  20 52 4d 41 20 66 72 61  67 6d 65 6e 74 61 74 69  | RMA fragmentati|
00001460  6f 6e 2e 29 0a 0a 44 69  72 65 63 74 6f 72 20 61  |on.)..Director a|
00001470  6c 73 6f 20 69 6e 63 6c  75 64 65 73 20 73 6f 6d  |lso includes som|
00001480  65 20 69 64 65 61 73 20  66 72 6f 6d 20 46 69 6c  |e ideas from Fil|
00001490  65 72 2b 20 28 62 79 20  4a 65 6e 73 20 48 2e 20  |er+ (by Jens H. |
000014a0  4f 76 65 73 65 6e 29 2c  20 46 69 6c 65 72 2d 20  |Ovesen), Filer- |
000014b0  28 62 79 0a 46 72 61 6e  7a 20 50 68 69 6c 69 70  |(by.Franz Philip|
000014c0  70 73 29 2c 20 61 6e 64  20 4d 65 6d 6f 72 69 7a  |ps), and Memoriz|
000014d0  65 72 20 28 62 79 20 42  65 6e 20 53 75 6d 6d 65  |er (by Ben Summe|
000014e0  72 73 29 2e 0a 0a 44 69  72 65 63 74 6f 72 20 69  |rs)...Director i|
000014f0  73 20 77 72 69 74 74 65  6e 20 65 6e 74 69 72 65  |s written entire|
00001500  6c 79 20 69 6e 20 4f 62  6a 41 73 6d 20 61 73 73  |ly in ObjAsm ass|
00001510  65 6d 62 6c 65 72 20 66  6f 72 20 69 74 73 20 63  |embler for its c|
00001520  6f 6d 70 61 63 74 6e 65  73 73 20 61 6e 64 20 65  |ompactness and e|
00001530  61 73 65 0a 6f 66 20 6d  61 6b 69 6e 67 20 6d 6f  |ase.of making mo|
00001540  64 75 6c 65 20 74 61 73  6b 73 2e 0a 0a 41 6c 74  |dule tasks...Alt|
00001550  68 6f 75 67 68 20 6e 6f  74 20 61 6c 6c 20 74 68  |hough not all th|
00001560  65 20 69 64 65 61 73 20  6d 61 79 20 68 61 76 65  |e ideas may have|
00001570  20 62 65 65 6e 20 6d 79  20 6f 77 6e 2c 20 74 68  | been my own, th|
00001580  65 20 63 6f 64 69 6e 67  20 69 73 20 61 6c 6c 20  |e coding is all |
00001590  6d 69 6e 65 0a 28 69 6e  63 6c 75 64 69 6e 67 20  |mine.(including |
000015a0  61 6c 6c 20 74 68 65 20  62 75 67 73 29 21 0a 0a  |all the bugs)!..|
000015b0  0a a4 20 53 77 69 74 63  68 69 6e 67 20 66 72 6f  |.. Switching fro|
000015c0  6d 20 50 69 6e 62 6f 61  72 64 2b 20 74 6f 20 44  |m Pinboard+ to D|
000015d0  69 72 65 63 74 6f 72 0a  3d 3d 3d 3d 3d 3d 3d 3d  |irector.========|
000015e0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
000015f0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |==============..|
00001600  49 66 20 79 6f 75 20 72  75 6e 20 74 68 65 20 45  |If you run the E|
00001610  78 70 61 6e 64 4d 65 6e  75 20 70 72 6f 67 72 61  |xpandMenu progra|
00001620  6d 20 69 6e 20 74 68 65  20 55 74 69 6c 73 20 64  |m in the Utils d|
00001630  69 72 65 63 74 6f 72 79  20 79 6f 75 20 63 61 6e  |irectory you can|
00001640  20 63 6f 6e 76 65 72 74  20 79 6f 75 72 0a 6f 6c  | convert your.ol|
00001650  64 20 50 69 6e 62 6f 61  72 64 2b 20 6d 65 6e 75  |d Pinboard+ menu|
00001660  73 20 69 6e 74 6f 20 74  68 65 20 6e 65 77 20 66  |s into the new f|
00001670  6f 72 6d 20 65 78 70 65  63 74 65 64 20 62 79 20  |orm expected by |
00001680  44 69 72 65 63 74 6f 72  2e 20 20 54 68 69 73 20  |Director.  This |
00001690  69 73 20 61 0a 74 65 78  74 75 61 6c 20 66 6f 72  |is a.textual for|
000016a0  6d 20 62 61 73 65 64 20  6f 6e 20 74 68 65 20 4f  |m based on the O|
000016b0  62 65 79 20 66 69 6c 65  20 61 6e 64 20 69 73 20  |bey file and is |
000016c0  61 20 6c 6f 74 20 65 61  73 69 65 72 20 74 6f 20  |a lot easier to |
000016d0  6d 61 69 6e 74 61 69 6e  20 74 68 61 6e 20 61 0a  |maintain than a.|
000016e0  67 72 61 70 68 69 63 61  6c 20 66 6f 72 6d 2e 20  |graphical form. |
000016f0  20 48 6f 77 65 76 65 72  20 69 66 20 79 6f 75 20  | However if you |
00001700  70 72 65 66 65 72 20 79  6f 75 20 63 61 6e 20 6d  |prefer you can m|
00001710  61 69 6e 74 61 69 6e 20  79 6f 75 72 20 6d 65 6e  |aintain your men|
00001720  75 73 20 75 73 69 6e 67  20 74 68 65 0a 50 69 6e  |us using the.Pin|
00001730  62 6f 61 72 64 2b 20 6d  65 6e 75 20 64 65 73 69  |board+ menu desi|
00001740  67 6e 65 72 20 61 6e 64  20 45 78 70 61 6e 64 4d  |gner and ExpandM|
00001750  65 6e 75 2c 20 68 6f 77  65 76 65 72 20 73 6f 6d  |enu, however som|
00001760  65 20 6f 66 20 74 68 65  20 6e 65 77 20 66 65 61  |e of the new fea|
00001770  74 75 72 65 73 20 6f 66  0a 44 69 72 65 63 74 6f  |tures of.Directo|
00001780  72 20 77 69 6c 6c 20 62  65 20 75 6e 61 76 61 69  |r will be unavai|
00001790  6c 61 62 6c 65 20 74 6f  20 79 6f 75 2e 0a 0a 0a  |lable to you....|
000017a0  a4 20 53 77 69 74 63 68  69 6e 67 20 66 72 6f 6d  |. Switching from|
000017b0  20 54 72 65 65 4d 65 6e  75 20 28 6f 72 20 44 69  | TreeMenu (or Di|
000017c0  72 4d 65 6e 75 29 20 74  6f 20 44 69 72 65 63 74  |rMenu) to Direct|
000017d0  6f 72 0a 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |or.=============|
000017e0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001800  3d 3d 3d 3d 3d 0a 0a 44  69 72 65 63 74 6f 72 20  |=====..Director |
00001810  68 61 73 20 61 6c 6d 6f  73 74 20 61 6c 6c 20 74  |has almost all t|
00001820  68 65 20 66 65 61 74 75  72 65 73 20 6f 66 20 54  |he features of T|
00001830  72 65 65 4d 65 6e 75 2e  20 20 42 79 20 64 65 66  |reeMenu.  By def|
00001840  61 75 6c 74 20 69 74 20  77 69 6c 6c 20 65 6e 61  |ault it will ena|
00001850  62 6c 65 0a 44 69 72 65  63 74 6f 72 79 20 6d 65  |ble.Directory me|
00001860  6e 75 73 20 6f 76 65 72  20 74 69 74 6c 65 20 62  |nus over title b|
00001870  61 72 73 20 6f 66 20 66  69 6c 65 72 20 77 69 6e  |ars of filer win|
00001880  64 6f 77 73 20 61 6e 64  20 6f 74 68 65 72 20 77  |dows and other w|
00001890  69 6e 64 6f 77 73 2e 20  20 59 6f 75 20 6d 61 79  |indows.  You may|
000018a0  0a 63 72 65 61 74 65 20  69 63 6f 6e 73 20 61 73  |.create icons as|
000018b0  20 70 65 72 20 54 72 65  65 4d 65 6e 75 20 61 6c  | per TreeMenu al|
000018c0  73 6f 2c 20 73 65 65 20  74 68 65 20 73 65 63 74  |so, see the sect|
000018d0  69 6f 6e 20 6f 6e 20 49  63 6f 6e 73 2c 20 61 6e  |ion on Icons, an|
000018e0  64 20 61 6c 73 6f 20 74  68 65 0a 65 78 61 6d 70  |d also the.examp|
000018f0  6c 65 20 4d 65 6e 75 73  2e 0a 0a 0a a4 20 55 70  |le Menus..... Up|
00001900  67 72 61 64 69 6e 67 20  66 72 6f 6d 20 44 69 72  |grading from Dir|
00001910  65 63 74 6f 72 20 30 2e  31 31 20 28 66 69 72 73  |ector 0.11 (firs|
00001920  74 20 70 75 62 6c 69 63  20 72 65 6c 65 61 73 65  |t public release|
00001930  29 0a 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |).==============|
00001940  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001960  3d 3d 3d 3d 3d 3d 3d 0a  0a 54 68 65 20 6d 61 6a  |=======..The maj|
00001970  6f 72 20 63 68 61 6e 67  65 20 69 73 20 46 69 6c  |or change is Fil|
00001980  74 65 72 73 2c 20 73 6f  20 79 6f 75 20 77 69 6c  |ters, so you wil|
00001990  6c 20 6e 65 65 64 20 74  6f 20 72 65 61 64 20 74  |l need to read t|
000019a0  68 61 74 20 73 65 63 74  69 6f 6e 2e 20 20 59 6f  |hat section.  Yo|
000019b0  75 20 77 69 6c 6c 0a 61  6c 73 6f 20 6e 65 65 64  |u will.also need|
000019c0  20 74 6f 20 61 64 64 20  74 68 65 20 44 69 72 65  | to add the Dire|
000019d0  63 74 6f 72 46 69 6c 74  65 72 20 63 6f 6d 6d 61  |ctorFilter comma|
000019e0  6e 64 73 20 61 74 20 74  68 65 20 73 74 61 72 74  |nds at the start|
000019f0  20 6f 66 20 74 68 65 20  65 78 61 6d 70 6c 65 20  | of the example |
00001a00  6d 65 6e 75 0a 74 6f 20  79 6f 75 72 20 6f 77 6e  |menu.to your own|
00001a10  20 6d 65 6e 75 20 6f 74  68 65 72 77 69 73 65 20  | menu otherwise |
00001a20  6c 6f 74 73 20 6f 66 20  74 68 69 6e 67 73 20 77  |lots of things w|
00001a30  6f 6e 27 74 20 77 6f 72  6b 2e 0a 0a 41 20 6e 75  |on't work...A nu|
00001a40  6d 62 65 72 20 6f 66 20  70 72 6f 62 6c 65 6d 73  |mber of problems|
00001a50  20 68 61 76 65 20 62 65  65 6e 20 66 69 78 65 64  | have been fixed|
00001a60  20 61 6e 64 20 61 20 6e  75 6d 62 65 72 20 6f 66  | and a number of|
00001a70  20 6e 65 77 20 66 65 61  74 75 72 65 73 0a 69 6e  | new features.in|
00001a80  74 72 6f 64 75 63 65 64  2e 20 20 53 65 65 20 74  |troduced.  See t|
00001a90  68 65 20 43 68 61 6e 67  65 4c 6f 67 20 66 6f 72  |he ChangeLog for|
00001aa0  20 66 75 6c 6c 20 64 65  74 61 69 6c 73 2e 20 20  | full details.  |
00001ab0  42 75 74 20 69 6e 20 62  72 69 65 66 0a 0a 09 41  |But in brief...A|
00001ac0  64 64 65 64 09 4f 70 65  6e 46 69 6c 65 73 20 61  |dded.OpenFiles a|
00001ad0  6e 64 20 54 61 73 6b 73  20 64 79 6e 61 6d 69 63  |nd Tasks dynamic|
00001ae0  20 6d 65 6e 75 73 0a 09  43 68 61 6e 67 65 64 09  | menus..Changed.|
00001af0  4d 65 6e 75 4d 65 6e 75  20 69 6d 70 72 6f 76 69  |MenuMenu improvi|
00001b00  6e 67 20 69 74 73 20 73  70 65 65 64 20 61 6e 64  |ng its speed and|
00001b10  20 66 75 6e 63 74 69 6f  6e 0a 09 46 69 78 65 64  | function..Fixed|
00001b20  09 44 69 72 65 63 74 6f  72 20 2b 20 46 69 6c 65  |.Director + File|
00001b30  72 20 53 68 6f 72 74 20  63 75 74 73 20 69 6e 74  |r Short cuts int|
00001b40  65 72 61 63 74 69 6f 6e  0a 09 46 69 78 65 64 09  |eraction..Fixed.|
00001b50  22 50 6c 65 61 73 65 20  69 6e 73 65 72 74 20 64  |"Please insert d|
00001b60  69 73 63 2e 2e 2e 22 20  6d 65 73 73 61 67 65 73  |isc..." messages|
00001b70  20 6f 6e 20 4d 65 6d 6f  72 69 73 65 72 3a 0a 09  | on Memoriser:..|
00001b80  46 69 78 65 64 20 09 28  77 69 74 68 20 77 6f 72  |Fixed .(with wor|
00001b90  6b 20 61 72 6f 75 6e 64  29 20 70 72 6f 62 6c 65  |k around) proble|
00001ba0  6d 73 20 77 69 74 68 20  43 44 46 53 0a 09 41 64  |ms with CDFS..Ad|
00001bb0  64 65 64 09 6c 6f 74 73  20 6f 66 20 66 65 61 74  |ded.lots of feat|
00001bc0  75 72 65 73 20 74 6f 20  4d 65 6d 6f 72 69 73 65  |ures to Memorise|
00001bd0  72 3a 0a 09 41 64 64 65  64 09 64 79 6e 61 6d 69  |r:..Added.dynami|
00001be0  63 20 61 72 65 61 20 73  75 70 70 6f 72 74 20 69  |c area support i|
00001bf0  66 20 61 76 61 69 6c 61  62 6c 65 0a 09 41 64 64  |f available..Add|
00001c00  65 64 09 44 69 72 65 63  74 6f 72 53 68 6f 77 4d  |ed.DirectorShowM|
00001c10  65 6e 75 20 74 6f 20 73  68 6f 77 20 61 20 6d 65  |enu to show a me|
00001c20  6e 75 20 69 6d 6d 65 64  69 61 74 65 6c 79 0a 09  |nu immediately..|
00001c30  41 64 64 65 64 09 2d 72  65 6d 6f 76 65 20 6f 70  |Added.-remove op|
00001c40  74 69 6f 6e 73 20 74 6f  20 44 69 72 65 63 74 6f  |tions to Directo|
00001c50  72 49 63 6f 6e 20 61 6e  64 20 4d 65 6e 75 0a 09  |rIcon and Menu..|
00001c60  41 64 64 65 64 09 63 6f  6c 6f 75 72 73 20 61 6e  |Added.colours an|
00001c70  64 20 69 63 6f 6e 20 6e  75 6d 62 65 72 73 20 74  |d icon numbers t|
00001c80  6f 20 4d 65 6e 75 2e 41  6c 69 61 73 65 73 0a 09  |o Menu.Aliases..|
00001c90  41 64 64 65 64 09 44 69  72 65 63 74 6f 72 46 69  |Added.DirectorFi|
00001ca0  6c 74 65 72 20 66 6f 72  20 76 65 72 73 61 74 69  |lter for versati|
00001cb0  6c 65 20 64 65 73 6b 74  6f 70 20 65 6e 68 61 6e  |le desktop enhan|
00001cc0  63 65 6d 65 6e 74 73 21  0a 09 41 64 64 65 64 09  |cements!..Added.|
00001cd0  44 69 72 65 63 74 6f 72  5f 45 6e 75 6d 65 72 61  |Director_Enumera|
00001ce0  74 65 20 26 20 6d 65 6e  75 73 2f 69 63 6f 6e 73  |te & menus/icons|
00001cf0  2f 66 69 6c 74 65 72 73  20 6d 65 6e 75 73 20 74  |/filters menus t|
00001d00  6f 20 6d 61 69 6e 20 6d  65 6e 75 0a 09 41 64 64  |o main menu..Add|
00001d10  65 64 09 44 69 72 65 63  74 6f 72 5f 4d 65 6d 6f  |ed.Director_Memo|
00001d20  72 79 20 26 20 6d 65 6e  75 20 74 6f 20 64 69 73  |ry & menu to dis|
00001d30  70 6c 61 79 20 74 68 65  20 72 65 73 75 6c 74 0a  |play the result.|
00001d40  09 52 65 6d 6f 76 65 64  09 44 69 72 65 63 74 6f  |.Removed.Directo|
00001d50  72 4d 65 6d 6f 72 79 20  61 6e 64 20 4c 69 73 74  |rMemory and List|
00001d60  4d 65 6e 75 73 20 61 73  20 74 68 65 79 20 61 72  |Menus as they ar|
00001d70  65 20 6e 6f 77 20 72 65  64 75 6e 64 61 6e 74 0a  |e now redundant.|
00001d80  09 41 64 64 65 64 09 2d  64 72 61 67 74 6f 20 61  |.Added.-dragto a|
00001d90  6e 64 20 64 72 61 67 66  72 6f 6d 20 74 6f 20 44  |nd dragfrom to D|
00001da0  69 72 65 63 74 6f 72 49  63 6f 6e 0a 09 41 64 64  |irectorIcon..Add|
00001db0  65 64 09 2d 66 69 6c 65  20 74 6f 20 44 69 72 65  |ed.-file to Dire|
00001dc0  63 74 6f 72 4d 6f 75 73  65 44 69 72 0a 0a 0a a4  |ctorMouseDir....|
00001dd0  20 4d 65 6e 75 73 0a 3d  3d 3d 3d 3d 3d 3d 0a 0a  | Menus.=======..|
00001de0  4d 65 6e 75 73 20 61 72  65 20 72 65 66 65 72 72  |Menus are referr|
00001df0  65 64 20 74 6f 20 62 79  20 6e 61 6d 65 20 28 63  |ed to by name (c|
00001e00  61 73 65 20 69 6e 73 65  6e 73 69 74 69 76 65 29  |ase insensitive)|
00001e10  2c 20 65 69 74 68 65 72  20 62 79 20 74 68 65 20  |, either by the |
00001e20  74 65 78 74 20 6f 66 20  74 68 65 0a 6d 65 6e 75  |text of the.menu|
00001e30  20 74 69 74 6c 65 20 6f  72 20 61 6e 20 61 6c 69  | title or an ali|
00001e40  61 73 20 61 73 20 67 69  76 65 6e 20 62 79 20 79  |as as given by y|
00001e50  6f 75 2e 20 20 54 68 65  72 65 20 63 61 6e 20 6f  |ou.  There can o|
00001e60  6e 6c 79 20 62 65 20 6f  6e 65 20 6d 65 6e 75 20  |nly be one menu |
00001e70  6f 66 20 61 6e 79 0a 67  69 76 65 6e 20 6e 61 6d  |of any.given nam|
00001e80  65 2c 20 61 6e 64 20 69  66 20 79 6f 75 20 61 74  |e, and if you at|
00001e90  74 65 6d 70 74 20 74 6f  20 63 72 65 61 74 65 20  |tempt to create |
00001ea0  61 20 6d 65 6e 75 20 77  69 74 68 20 74 68 65 20  |a menu with the |
00001eb0  73 61 6d 65 20 6e 61 6d  65 20 61 73 20 61 6e 0a  |same name as an.|
00001ec0  65 78 69 73 74 69 6e 67  20 6f 6e 65 20 74 68 65  |existing one the|
00001ed0  6e 20 74 68 65 20 65 78  69 73 74 69 6e 67 20 6d  |n the existing m|
00001ee0  65 6e 75 20 77 69 6c 6c  20 62 65 20 64 65 6c 65  |enu will be dele|
00001ef0  74 65 64 20 77 69 74 68  6f 75 74 20 77 61 72 6e  |ted without warn|
00001f00  69 6e 67 2e 20 20 54 68  69 73 20 69 73 0a 75 73  |ing.  This is.us|
00001f10  65 66 75 6c 20 62 65 63  61 75 73 65 20 79 6f 75  |eful because you|
00001f20  20 63 61 6e 20 75 70 64  61 74 65 20 79 6f 75 72  | can update your|
00001f30  20 6d 65 6e 75 73 20 61  74 20 61 6e 79 20 74 69  | menus at any ti|
00001f40  6d 65 20 79 6f 75 20 6c  69 6b 65 2c 20 6f 72 20  |me you like, or |
00001f50  65 76 65 6e 20 63 72 65  61 74 65 0a 6e 65 77 20  |even create.new |
00001f60  6d 65 6e 75 73 20 6f 6e  20 74 68 65 20 66 6c 79  |menus on the fly|
00001f70  2e 0a 0a 44 69 72 65 63  74 6f 72 20 6b 65 65 70  |...Director keep|
00001f80  73 20 61 20 6c 69 73 74  20 6f 66 20 6d 65 6e 75  |s a list of menu|
00001f90  73 20 77 68 69 63 68 20  79 6f 75 20 63 61 6e 20  |s which you can |
00001fa0  73 65 65 20 66 72 6f 6d  20 44 69 72 65 63 74 6f  |see from Directo|
00001fb0  72 27 73 20 6d 61 69 6e  20 6d 65 6e 75 2e 20 0a  |r's main menu. .|
00001fc0  4d 65 6e 75 73 20 63 61  6e 20 62 65 20 74 65 6d  |Menus can be tem|
00001fd0  70 6f 72 61 72 79 20 6f  72 20 70 65 72 6d 61 6e  |porary or perman|
00001fe0  65 6e 74 2e 20 20 54 65  6d 70 6f 72 61 72 79 20  |ent.  Temporary |
00001ff0  6d 65 6e 75 73 20 61 72  65 20 63 72 65 61 74 65  |menus are create|
00002000  64 20 62 79 20 44 69 72  65 63 74 6f 72 0a 66 6f  |d by Director.fo|
00002010  72 20 6d 61 6b 69 6e 67  20 44 69 72 65 63 74 6f  |r making Directo|
00002020  72 79 20 4d 65 6e 75 73  20 61 6e 64 20 74 68 65  |ry Menus and the|
00002030  6e 20 64 65 6c 65 74 65  64 20 61 66 74 65 72 77  |n deleted afterw|
00002040  61 72 64 73 2e 20 20 50  65 72 6d 61 6e 65 6e 74  |ards.  Permanent|
00002050  20 4d 65 6e 75 73 20 61  72 65 0a 63 72 65 61 74  | Menus are.creat|
00002060  65 64 20 62 79 20 79 6f  75 2e 0a 0a 54 6f 20 63  |ed by you...To c|
00002070  72 65 61 74 65 20 61 20  6d 65 6e 75 20 79 6f 75  |reate a menu you|
00002080  20 6e 65 65 64 20 74 6f  20 63 72 65 61 74 65 20  | need to create |
00002090  61 6e 20 4f 62 65 79 20  66 69 6c 65 20 77 69 74  |an Obey file wit|
000020a0  68 20 74 68 65 20 66 6f  6c 6c 6f 77 69 6e 67 20  |h the following |
000020b0  66 6f 72 6d 61 74 2e 0a  28 49 6e 64 65 6e 74 61  |format..(Indenta|
000020c0  74 69 6f 6e 20 61 6e 64  20 73 70 61 63 69 6e 67  |tion and spacing|
000020d0  20 61 72 65 20 67 65 6e  65 72 61 6c 6c 79 20 75  | are generally u|
000020e0  6e 69 6d 70 6f 72 74 61  6e 74 2e 20 20 54 68 65  |nimportant.  The|
000020f0  20 6d 65 6e 75 73 20 61  72 65 20 64 65 73 63 72  | menus are descr|
00002100  69 62 65 64 0a 69 6e 64  65 6e 74 65 64 20 68 65  |ibed.indented he|
00002110  72 65 20 74 6f 20 61 69  64 20 63 6f 6d 70 72 65  |re to aid compre|
00002120  68 65 6e 73 69 6f 6e 20  6f 66 20 74 68 65 20 73  |hension of the s|
00002130  74 72 75 63 74 75 72 65  2e 29 0a 0a 09 4d 65 6e  |tructure.)...Men|
00002140  75 20 2e 2e 2e 0a 09 09  4f 70 74 69 6f 6e 20 2e  |u ......Option .|
00002150  2e 2e 0a 09 09 09 43 6f  6d 6d 61 6e 64 20 2e 2e  |......Command ..|
00002160  2e 0a 09 09 4f 70 74 69  6f 6e 20 2e 2e 2e 0a 09  |....Option .....|
00002170  09 09 43 6f 6d 6d 61 6e  64 20 2e 2e 2e 0a 09 44  |..Command .....D|
00002180  61 73 68 0a 09 09 2e 0a  09 09 2e 0a 09 09 2e 0a  |ash.............|
00002190  09 09 4f 70 74 69 6f 6e  20 2e 2e 2e 0a 09 45 6e  |..Option .....En|
000021a0  64 4d 65 6e 75 0a 0a 54  68 65 20 4d 65 6e 75 20  |dMenu..The Menu |
000021b0  63 6f 6d 6d 61 6e 64 20  73 69 67 6e 61 6c 73 20  |command signals |
000021c0  74 6f 20 44 69 72 65 63  74 6f 72 20 74 6f 20 73  |to Director to s|
000021d0  74 61 72 74 20 61 20 6e  65 77 20 4d 65 6e 75 20  |tart a new Menu |
000021e0  77 69 74 68 20 74 68 65  20 6e 61 6d 65 20 61 6e  |with the name an|
000021f0  64 0a 61 6c 69 61 73 20  79 6f 75 20 67 69 76 65  |d.alias you give|
00002200  20 69 74 2e 0a 0a 09 53  79 6e 74 61 78 3a 20 4d  | it....Syntax: M|
00002210  65 6e 75 20 3c 74 69 74  6c 65 3e 20 5b 3c 61 6c  |enu <title> [<al|
00002220  69 61 73 3e 5d 20 5b 2d  6b 65 79 20 3c 6b 65 79  |ias>] [-key <key|
00002230  3e 5d 20 5b 2d 74 65 6d  70 5d 20 5b 2d 72 65 6d  |>] [-temp] [-rem|
00002240  6f 76 65 5d 0a 0a 50 6f  73 73 69 62 6c 65 20 65  |ove]..Possible e|
00002250  78 61 6d 70 6c 65 73 20  61 72 65 2c 0a 0a 09 4d  |xamples are,...M|
00002260  65 6e 75 20 22 4d 6f 64  65 22 0a 09 09 53 74 61  |enu "Mode"...Sta|
00002270  72 74 73 20 61 20 6d 65  6e 75 20 77 69 74 68 20  |rts a menu with |
00002280  74 69 74 6c 65 20 61 6e  64 20 69 6e 74 65 72 6e  |title and intern|
00002290  61 6c 20 6e 61 6d 65 20  62 6f 74 68 20 22 4d 6f  |al name both "Mo|
000022a0  64 65 22 0a 09 4d 65 6e  75 20 4d 6f 64 65 0a 09  |de"..Menu Mode..|
000022b0  09 53 61 6d 65 20 61 73  20 61 62 6f 76 65 2e 20  |.Same as above. |
000022c0  20 49 6e 20 67 65 6e 65  72 61 6c 20 69 66 20 79  | In general if y|
000022d0  6f 75 20 77 61 6e 74 20  74 6f 20 73 75 70 70 6c  |ou want to suppl|
000022e0  79 20 61 20 73 74 72 69  6e 67 0a 09 09 74 6f 20  |y a string...to |
000022f0  61 20 63 6f 6d 6d 61 6e  64 2c 20 79 6f 75 20 63  |a command, you c|
00002300  61 6e 20 73 75 70 70 6c  79 20 69 74 20 77 69 74  |an supply it wit|
00002310  68 20 6f 72 20 77 69 74  68 6f 75 74 20 71 75 6f  |h or without quo|
00002320  74 65 73 2e 0a 09 09 48  6f 77 65 76 65 72 20 69  |tes....However i|
00002330  66 20 74 68 65 20 73 74  72 69 6e 67 20 68 61 73  |f the string has|
00002340  20 73 70 61 63 65 73 20  69 6e 20 69 74 20 69 74  | spaces in it it|
00002350  20 6d 75 73 74 20 62 65  20 73 75 70 70 6c 69 65  | must be supplie|
00002360  64 0a 09 09 77 69 74 68  20 71 75 6f 74 65 73 2e  |d...with quotes.|
00002370  0a 09 4d 65 6e 75 20 22  4c 6f 74 73 20 6f 66 20  |..Menu "Lots of |
00002380  4d 6f 64 65 73 22 20 4d  6f 64 65 0a 09 09 53 74  |Modes" Mode...St|
00002390  61 72 74 73 20 61 20 6d  65 6e 75 20 77 69 74 68  |arts a menu with|
000023a0  20 74 69 74 6c 65 20 22  4c 6f 74 73 20 6f 66 20  | title "Lots of |
000023b0  4d 6f 64 65 73 22 20 61  6e 64 20 69 6e 74 65 72  |Modes" and inter|
000023c0  6e 61 6c 20 6e 61 6d 65  0a 09 09 22 4d 6f 64 65  |nal name..."Mode|
000023d0  22 0a 09 4d 65 6e 75 20  22 44 44 45 22 20 2d 6b  |"..Menu "DDE" -k|
000023e0  65 79 20 5e 44 0a 09 09  53 74 61 72 74 73 20 61  |ey ^D...Starts a|
000023f0  20 6d 65 6e 75 20 63 61  6c 6c 65 64 20 44 44 45  | menu called DDE|
00002400  20 77 69 74 68 20 69 6e  74 65 72 6e 61 6c 20 6e  | with internal n|
00002410  61 6d 65 20 44 44 45 20  74 6f 20 62 65 20 6f 70  |ame DDE to be op|
00002420  65 6e 65 64 0a 09 09 6f  6e 20 61 20 43 54 52 4c  |ened...on a CTRL|
00002430  2d 44 20 6b 65 79 20 70  72 65 73 73 20 28 73 65  |-D key press (se|
00002440  65 20 74 68 65 20 73 65  63 74 69 6f 6e 20 63 61  |e the section ca|
00002450  6c 6c 65 64 20 4b 65 79  73 20 66 6f 72 20 6d 6f  |lled Keys for mo|
00002460  72 65 0a 09 09 6f 6e 20  77 68 61 74 20 69 73 20  |re...on what is |
00002470  61 6c 6c 6f 77 65 64 20  61 73 20 61 20 70 61 72  |allowed as a par|
00002480  61 6d 65 74 65 72 20 74  6f 20 2d 6b 65 79 73 29  |ameter to -keys)|
00002490  0a 09 4d 65 6e 75 20 22  54 65 6d 70 6f 72 61 72  |..Menu "Temporar|
000024a0  79 22 20 2d 74 65 6d 70  0a 09 09 54 68 69 73 20  |y" -temp...This |
000024b0  77 69 6c 6c 20 6d 61 6b  65 20 61 20 6d 65 6e 75  |will make a menu|
000024c0  20 77 68 69 63 68 20 77  69 6c 6c 20 62 65 20 64  | which will be d|
000024d0  69 73 70 6c 61 79 65 64  20 6f 6e 6c 79 20 6f 6e  |isplayed only on|
000024e0  63 65 20 61 6e 64 0a 09  09 74 68 65 6e 20 64 65  |ce and...then de|
000024f0  73 74 72 6f 79 65 64 2e  20 20 54 68 69 73 20 69  |stroyed.  This i|
00002500  73 20 75 73 65 66 75 6c  20 66 6f 72 20 64 79 6e  |s useful for dyn|
00002510  61 6d 69 63 20 6d 65 6e  75 73 2c 20 61 6e 64 20  |amic menus, and |
00002520  66 6f 72 0a 09 09 6d 65  6e 75 73 20 64 69 73 70  |for...menus disp|
00002530  6c 61 79 65 64 20 77 69  74 68 20 44 69 72 65 63  |layed with Direc|
00002540  74 6f 72 53 68 6f 77 4d  65 6e 75 0a 09 4d 65 6e  |torShowMenu..Men|
00002550  75 20 22 44 44 45 22 20  2d 72 65 6d 6f 76 65 0a  |u "DDE" -remove.|
00002560  09 09 54 68 69 73 20 77  69 6c 6c 20 72 65 6d 6f  |..This will remo|
00002570  76 65 20 66 72 6f 6d 20  64 69 72 65 63 74 6f 72  |ve from director|
00002580  27 73 20 6d 65 6d 6f 72  79 20 74 68 65 20 6d 65  |'s memory the me|
00002590  6e 75 20 63 61 6c 6c 65  64 0a 09 09 22 44 44 45  |nu called..."DDE|
000025a0  22 2e 20 20 54 68 69 73  20 69 73 20 75 73 65 66  |".  This is usef|
000025b0  75 6c 20 66 6f 72 20 74  69 64 79 69 6e 67 20 75  |ul for tidying u|
000025c0  70 2e 20 20 49 66 20 74  68 65 20 6d 65 6e 75 20  |p.  If the menu |
000025d0  6e 61 6d 65 64 0a 09 09  69 73 6e 27 74 20 66 6f  |named...isn't fo|
000025e0  75 6e 64 20 74 68 65 6e  20 69 74 20 77 69 6c 6c  |und then it will|
000025f0  20 6e 6f 74 20 72 65 74  75 72 6e 20 61 6e 20 65  | not return an e|
00002600  72 72 6f 72 0a 0a 54 68  65 20 45 6e 64 4d 65 6e  |rror..The EndMen|
00002610  75 20 63 6f 6d 6d 61 6e  64 20 73 69 67 6e 61 6c  |u command signal|
00002620  73 20 74 6f 20 44 69 72  65 63 74 6f 72 20 74 6f  |s to Director to|
00002630  20 73 74 6f 70 20 6d 61  6b 69 6e 67 20 74 68 65  | stop making the|
00002640  20 6d 65 6e 75 2e 20 20  54 68 65 20 6d 65 6e 75  | menu.  The menu|
00002650  20 69 73 0a 61 76 61 69  6c 61 62 6c 65 20 66 6f  | is.available fo|
00002660  72 20 64 69 73 70 6c 61  79 20 61 73 20 73 6f 6f  |r display as soo|
00002670  6e 20 61 73 20 74 68 65  20 4d 65 6e 75 20 63 6f  |n as the Menu co|
00002680  6d 6d 61 6e 64 20 68 61  73 20 62 65 65 6e 20 69  |mmand has been i|
00002690  73 73 75 65 64 20 74 68  6f 75 67 68 2e 0a 0a 09  |ssued though....|
000026a0  53 79 6e 74 61 78 3a 20  45 6e 64 4d 65 6e 75 0a  |Syntax: EndMenu.|
000026b0  0a 54 68 65 20 44 61 73  68 20 63 6f 6d 6d 61 6e  |.The Dash comman|
000026c0  64 20 77 72 69 74 65 73  20 61 20 64 61 73 68 65  |d writes a dashe|
000026d0  64 20 6c 69 6e 65 20 61  63 72 6f 73 73 20 74 68  |d line across th|
000026e0  65 20 6d 65 6e 75 20 61  74 20 74 68 61 74 20 70  |e menu at that p|
000026f0  6f 69 6e 74 20 69 6e 20  74 68 65 0a 6d 65 6e 75  |oint in the.menu|
00002700  20 73 74 72 75 63 74 75  72 65 2e 20 20 49 74 20  | structure.  It |
00002710  69 73 20 75 73 65 66 75  6c 20 66 6f 72 20 6f 72  |is useful for or|
00002720  67 61 6e 69 73 69 6e 67  20 6c 61 72 67 65 20 6d  |ganising large m|
00002730  65 6e 75 73 2e 0a 0a 09  53 79 6e 74 61 78 3a 20  |enus....Syntax: |
00002740  44 61 73 68 0a 0a 54 68  65 20 4f 70 74 69 6f 6e  |Dash..The Option|
00002750  20 63 6f 6d 6d 61 6e 64  20 69 73 20 61 74 20 74  | command is at t|
00002760  68 65 20 68 65 61 72 74  20 6f 66 20 44 69 72 65  |he heart of Dire|
00002770  63 74 6f 72 27 73 20 6d  65 6e 75 73 2e 20 20 49  |ctor's menus.  I|
00002780  74 20 68 61 73 20 6d 61  6e 79 20 6f 70 74 69 6f  |t has many optio|
00002790  6e 73 0a 77 68 69 63 68  20 79 6f 75 20 77 6f 6e  |ns.which you won|
000027a0  27 74 20 6e 65 65 64 20  69 6d 6d 65 64 69 61 74  |'t need immediat|
000027b0  65 6c 79 2c 20 62 75 74  20 77 68 69 63 68 20 6d  |ely, but which m|
000027c0  61 79 20 62 65 63 6f 6d  65 20 75 73 65 66 75 6c  |ay become useful|
000027d0  20 6c 61 74 65 72 2e 0a  0a 09 53 79 6e 74 61 78  | later....Syntax|
000027e0  3a 20 4f 70 74 69 6f 6e  20 3c 74 65 78 74 3e 20  |: Option <text> |
000027f0  7c 20 2d 70 61 74 68 20  3c 66 69 6c 65 7c 64 69  || -path <file|di|
00002800  72 65 63 74 6f 72 79 3e  0a 09 09 5b 2d 74 69 63  |rectory>...[-tic|
00002810  6b 5d 0a 09 09 5b 2d 62  67 20 3c 63 6f 6c 3e 5d  |k]...[-bg <col>]|
00002820  0a 09 09 5b 2d 66 67 20  3c 63 6f 6c 3e 5d 0a 09  |...[-fg <col>]..|
00002830  09 5b 2d 73 75 62 20 5b  3c 6d 65 6e 75 3e 7c 2a  |.[-sub [<menu>|*|
00002840  5d 5d 0a 09 09 5b 2d 6c  65 6e 20 3c 6c 65 6e 3e  |]]...[-len <len>|
00002850  5d 0a 09 09 5b 2d 64 61  73 68 5d 0a 09 09 5b 2d  |]...[-dash]...[-|
00002860  67 72 65 79 5d 0a 09 09  5b 2d 6b 65 79 20 3c 6e  |grey]...[-key <n|
00002870  75 6d 62 65 72 3e 5d 0a  09 09 5b 2d 75 70 5d 0a  |umber>]...[-up].|
00002880  09 09 5b 2d 6e 6f 73 70  72 69 74 65 5d 0a 09 09  |..[-nosprite]...|
00002890  5b 2d 73 70 72 69 74 65  20 3c 6e 61 6d 65 3e 5d  |[-sprite <name>]|
000028a0  0a 0a 54 68 65 20 4f 70  74 69 6f 6e 20 63 6f 6d  |..The Option com|
000028b0  6d 61 6e 64 20 6d 75 73  74 20 62 65 20 73 75 70  |mand must be sup|
000028c0  70 6c 69 65 64 20 77 69  74 68 20 61 20 74 65 78  |plied with a tex|
000028d0  74 20 6f 72 20 61 20 70  61 74 68 20 6f 72 20 62  |t or a path or b|
000028e0  6f 74 68 2e 20 20 46 6f  72 0a 65 78 61 6d 70 6c  |oth.  For.exampl|
000028f0  65 0a 0a 09 4f 70 74 69  6f 6e 20 22 4d 6f 64 65  |e...Option "Mode|
00002900  20 33 31 22 0a 09 09 57  69 6c 6c 20 70 72 6f 64  | 31"...Will prod|
00002910  75 63 65 20 61 20 6d 65  6e 75 20 65 6e 74 72 79  |uce a menu entry|
00002920  20 77 69 74 68 20 74 68  65 20 74 65 78 74 20 22  | with the text "|
00002930  4d 6f 64 65 20 33 31 22  20 77 68 69 63 68 20 63  |Mode 31" which c|
00002940  6f 75 6c 64 0a 09 09 68  61 76 65 20 61 20 63 6f  |ould...have a co|
00002950  6d 6d 61 6e 64 20 61 74  74 61 63 68 65 64 20 28  |mmand attached (|
00002960  73 65 65 20 6c 61 74 65  72 29 2e 0a 09 4f 70 74  |see later)...Opt|
00002970  69 6f 6e 20 2d 70 61 74  68 20 41 44 46 53 3a 3a  |ion -path ADFS::|
00002980  34 2e 24 2e 41 70 70 73  0a 09 09 57 69 6c 6c 20  |4.$.Apps...Will |
00002990  70 72 6f 64 75 63 65 20  61 20 6d 65 6e 75 20 65  |produce a menu e|
000029a0  6e 74 72 79 20 77 69 74  68 20 61 20 64 69 72 65  |ntry with a dire|
000029b0  63 74 6f 72 79 20 69 63  6f 6e 20 69 6e 20 69 74  |ctory icon in it|
000029c0  20 61 6e 64 20 74 68 65  0a 09 09 41 70 70 73 20  | and the...Apps |
000029d0  64 69 72 65 63 74 6f 72  79 20 61 74 74 61 63 68  |directory attach|
000029e0  65 64 2e 20 20 49 66 20  74 68 65 20 41 70 70 73  |ed.  If the Apps|
000029f0  20 64 69 72 65 63 74 6f  72 79 20 69 73 20 6e 6f  | directory is no|
00002a00  74 0a 09 09 70 72 65 73  65 6e 74 20 74 68 65 6e  |t...present then|
00002a10  20 69 74 20 77 69 6c 6c  20 70 72 6f 64 75 63 65  | it will produce|
00002a20  20 61 20 67 72 65 79 65  64 20 6f 75 74 20 6d 65  | a greyed out me|
00002a30  6e 75 20 6f 70 74 69 6f  6e 20 77 69 74 68 0a 09  |nu option with..|
00002a40  09 61 6e 20 75 6e 6b 6e  6f 77 6e 20 66 69 6c 65  |.an unknown file|
00002a50  20 69 63 6f 6e 2e 20 20  44 69 72 65 63 74 6f 72  | icon.  Director|
00002a60  20 77 69 6c 6c 20 75 73  65 20 74 68 65 20 6c 65  | will use the le|
00002a70  61 66 20 6e 61 6d 65 20  6f 66 0a 09 09 74 68 65  |af name of...the|
00002a80  20 70 61 74 68 20 66 6f  72 20 74 68 65 20 74 65  | path for the te|
00002a90  78 74 20 6f 66 20 74 68  65 20 6d 65 6e 75 20 28  |xt of the menu (|
00002aa0  69 6e 20 74 68 69 73 20  63 61 73 65 20 41 70 70  |in this case App|
00002ab0  73 29 20 6d 69 6e 75 73  0a 09 09 61 6e 20 69 6e  |s) minus...an in|
00002ac0  69 74 69 61 6c 20 21 2e  0a 09 4f 70 74 69 6f 6e  |itial !...Option|
00002ad0  20 22 41 70 70 6c 69 63  61 74 69 6f 6e 73 22 20  | "Applications" |
00002ae0  2d 70 61 74 68 20 41 44  46 53 3a 3a 34 2e 24 2e  |-path ADFS::4.$.|
00002af0  41 70 70 73 0a 09 09 41  73 20 61 62 6f 76 65 20  |Apps...As above |
00002b00  65 78 63 65 70 74 20 74  68 65 20 74 65 78 74 20  |except the text |
00002b10  69 6e 20 74 68 65 20 6d  65 6e 75 20 6f 70 74 69  |in the menu opti|
00002b20  6f 6e 20 77 69 6c 6c 20  62 65 0a 09 09 22 41 70  |on will be..."Ap|
00002b30  70 6c 69 63 61 74 69 6f  6e 73 22 20 72 61 74 68  |plications" rath|
00002b40  65 72 20 74 68 61 6e 20  22 41 70 70 73 22 2e 0a  |er than "Apps"..|
00002b50  0a 41 20 74 65 78 74 20  6f 70 74 69 6f 6e 20 6d  |.A text option m|
00002b60  61 79 20 68 61 76 65 20  61 20 30 2c 20 31 20 6f  |ay have a 0, 1 o|
00002b70  72 20 32 20 43 6f 6d 6d  61 6e 64 73 20 61 74 74  |r 2 Commands att|
00002b80  61 63 68 65 64 20 28 73  65 65 20 6c 61 74 65 72  |ached (see later|
00002b90  29 20 6f 72 20 61 0a 53  75 62 4d 65 6e 75 2e 0a  |) or a.SubMenu..|
00002ba0  0a 09 4f 70 74 69 6f 6e  20 22 4d 6f 64 65 73 22  |..Option "Modes"|
00002bb0  20 2d 73 75 62 20 22 4d  6f 64 65 73 22 0a 09 09  | -sub "Modes"...|
00002bc0  54 68 69 73 20 70 72 6f  64 75 63 65 73 20 61 20  |This produces a |
00002bd0  6d 65 6e 75 20 65 6e 74  72 79 20 77 69 74 68 20  |menu entry with |
00002be0  74 68 65 20 74 65 78 74  20 22 4d 6f 64 65 73 22  |the text "Modes"|
00002bf0  20 61 6e 64 20 61 20 72  69 67 68 74 0a 09 09 70  | and a right...p|
00002c00  6f 69 6e 74 69 6e 67 20  61 72 72 6f 77 2e 20 20  |ointing arrow.  |
00002c10  57 68 65 6e 20 70 6f 69  6e 74 65 72 20 6d 6f 76  |When pointer mov|
00002c20  65 73 20 6f 76 65 72 20  74 68 65 20 61 72 72 6f  |es over the arro|
00002c30  77 20 74 68 65 20 4d 65  6e 75 0a 09 09 22 4d 6f  |w the Menu..."Mo|
00002c40  64 65 73 22 20 77 69 6c  6c 20 62 65 20 6f 70 65  |des" will be ope|
00002c50  6e 65 64 20 61 73 20 61  20 73 75 62 20 6d 65 6e  |ned as a sub men|
00002c60  75 2e 20 20 49 66 20 74  68 65 20 75 73 65 72 20  |u.  If the user |
00002c70  63 6c 69 63 6b 73 20 6f  6e 0a 09 09 74 68 65 20  |clicks on...the |
00002c80  69 74 65 6d 20 28 6f 72  20 75 73 65 73 20 61 20  |item (or uses a |
00002c90  68 6f 74 6b 65 79 29 20  74 68 65 20 22 4d 6f 64  |hotkey) the "Mod|
00002ca0  65 73 22 20 6d 65 6e 75  20 77 69 6c 6c 20 62 65  |es" menu will be|
00002cb0  20 6f 70 65 6e 65 64 0a  09 09 61 73 20 74 68 65  | opened...as the|
00002cc0  20 72 6f 6f 74 20 6d 65  6e 75 2e 0a 09 4f 70 74  | root menu...Opt|
00002cd0  69 6f 6e 20 22 4d 6f 64  65 73 22 20 2d 73 75 62  |ion "Modes" -sub|
00002ce0  20 2a 0a 09 09 54 68 69  73 20 69 73 20 65 71 75  | *...This is equ|
00002cf0  69 76 61 6c 65 6e 74 20  74 6f 20 74 68 65 20 4f  |ivalent to the O|
00002d00  70 74 69 6f 6e 20 61 62  6f 76 65 2e 20 20 49 74  |ption above.  It|
00002d10  20 69 73 20 71 75 69 74  65 20 63 6f 6d 6d 6f 6e  | is quite common|
00002d20  0a 09 09 74 6f 20 68 61  76 65 20 61 20 53 75 62  |...to have a Sub|
00002d30  4d 65 6e 75 20 77 69 74  68 20 74 68 65 20 73 61  |Menu with the sa|
00002d40  6d 65 20 6e 61 6d 65 20  61 73 20 74 68 65 20 4f  |me name as the O|
00002d50  70 74 69 6f 6e 20 77 68  69 63 68 0a 09 09 61 63  |ption which...ac|
00002d60  74 69 76 61 74 65 73 20  69 74 2c 20 73 6f 20 74  |tivates it, so t|
00002d70  68 69 73 20 69 73 20 73  68 6f 72 74 68 61 6e 64  |his is shorthand|
00002d80  20 66 6f 72 20 74 68 61  74 2e 0a 0a 41 20 6d 65  | for that...A me|
00002d90  6e 75 20 6f 70 74 69 6f  6e 20 6d 61 79 20 62 65  |nu option may be|
00002da0  20 61 63 74 69 76 61 74  65 64 20 62 79 20 61 20  | activated by a |
00002db0  6b 65 79 2c 20 65 67 0a  0a 09 4f 70 74 69 6f 6e  |key, eg...Option|
00002dc0  20 2d 70 61 74 68 20 41  44 46 53 3a 3a 34 2e 24  | -path ADFS::4.$|
00002dd0  2e 41 70 70 73 20 2d 6b  65 79 20 5e 41 0a 09 09  |.Apps -key ^A...|
00002de0  4f 70 65 6e 73 20 74 68  65 20 41 70 70 73 20 64  |Opens the Apps d|
00002df0  69 72 65 63 74 6f 72 79  20 6f 6e 20 43 54 52 4c  |irectory on CTRL|
00002e00  2d 41 0a 09 4f 70 74 69  6f 6e 20 22 4d 6f 64 65  |-A..Option "Mode|
00002e10  73 22 20 2d 73 75 62 20  2a 20 2d 6b 65 79 20 4d  |s" -sub * -key M|
00002e20  0a 09 09 4f 70 65 6e 73  20 74 68 65 20 6d 6f 64  |...Opens the mod|
00002e30  65 73 20 53 75 62 4d 65  6e 75 20 28 69 66 20 6e  |es SubMenu (if n|
00002e40  6f 20 63 6f 6d 6d 61 6e  64 20 61 74 74 61 63 68  |o command attach|
00002e50  65 64 29 20 6f 72 20 64  6f 65 73 20 74 68 65 0a  |ed) or does the.|
00002e60  09 09 61 74 74 61 63 68  65 64 20 63 6f 6d 6d 61  |..attached comma|
00002e70  6e 64 20 69 66 20 4d 20  69 73 20 70 72 65 73 73  |nd if M is press|
00002e80  65 64 2e 0a 09 4f 70 74  69 6f 6e 20 22 43 6f 6d  |ed...Option "Com|
00002e90  6d 61 6e 64 22 20 2d 6b  65 79 20 8b 5e 5a 0a 09  |mand" -key .^Z..|
00002ea0  09 49 66 20 61 20 63 6f  6d 6d 61 6e 64 20 69 73  |.If a command is|
00002eb0  20 61 74 74 61 63 68 65  64 20 74 68 65 6e 20 69  | attached then i|
00002ec0  74 20 64 6f 65 73 20 69  74 20 6f 6e 20 53 48 49  |t does it on SHI|
00002ed0  46 54 2d 43 54 52 4c 2d  5a 0a 09 09 6f 74 68 65  |FT-CTRL-Z...othe|
00002ee0  72 77 69 73 65 20 69 74  20 64 6f 65 73 20 6e 6f  |rwise it does no|
00002ef0  74 68 69 6e 67 2e 0a 0a  41 20 6d 65 6e 75 20 6f  |thing...A menu o|
00002f00  70 74 69 6f 6e 20 6d 61  79 20 68 61 76 65 20 69  |ption may have i|
00002f10  74 73 20 66 6f 72 65 67  72 6f 75 6e 64 20 61 6e  |ts foreground an|
00002f20  64 20 62 61 63 6b 67 72  6f 75 6e 64 20 63 6f 6c  |d background col|
00002f30  6f 75 72 73 20 64 65 66  69 6e 65 64 20 28 73 65  |ours defined (se|
00002f40  65 20 74 68 65 0a 73 65  63 74 69 6f 6e 20 6f 6e  |e the.section on|
00002f50  20 63 6f 6c 6f 75 72 73  20 66 6f 72 20 64 65 74  | colours for det|
00002f60  61 69 6c 73 20 6f 66 20  77 68 69 63 68 20 6e 75  |ails of which nu|
00002f70  6d 62 65 72 73 20 6d 61  6b 65 20 77 68 69 63 68  |mbers make which|
00002f80  20 63 6f 6c 6f 75 72 73  29 2e 20 20 49 66 20 74  | colours).  If t|
00002f90  68 65 0a 63 6f 6c 6f 75  72 73 20 61 72 65 20 6e  |he.colours are n|
00002fa0  6f 74 20 64 65 66 69 6e  65 64 20 74 68 65 6e 20  |ot defined then |
00002fb0  74 68 65 79 20 64 65 66  61 75 6c 74 20 66 6f 72  |they default for|
00002fc0  65 67 72 6f 75 6e 64 20  42 6c 61 63 6b 20 61 6e  |eground Black an|
00002fd0  64 20 62 61 63 6b 67 72  6f 75 6e 64 0a 57 68 69  |d background.Whi|
00002fe0  74 65 2e 0a 0a 09 4f 70  74 69 6f 6e 20 22 46 6f  |te....Option "Fo|
00002ff0  72 6d 61 74 22 20 2d 66  67 20 31 31 0a 09 09 50  |rmat" -fg 11...P|
00003000  72 6f 64 75 63 65 73 20  52 65 64 20 74 65 78 74  |roduces Red text|
00003010  20 6f 6e 20 74 68 65 20  64 65 66 61 75 6c 74 20  | on the default |
00003020  62 61 63 6b 67 72 6f 75  6e 64 0a 09 4f 70 74 69  |background..Opti|
00003030  6f 6e 20 22 42 6f 6f 74  22 20 2d 66 67 20 30 20  |on "Boot" -fg 0 |
00003040  2d 62 67 20 38 0a 09 09  50 72 6f 64 75 63 65 73  |-bg 8...Produces|
00003050  20 57 68 69 74 65 20 74  65 78 74 20 6f 6e 20 61  | White text on a|
00003060  20 44 61 72 6b 20 42 6c  75 65 20 62 61 63 6b 67  | Dark Blue backg|
00003070  72 6f 75 6e 64 0a 0a 41  6e 79 20 6d 65 6e 75 20  |round..Any menu |
00003080  63 61 6e 20 62 65 20 6d  61 64 65 20 77 72 69 74  |can be made writ|
00003090  61 62 6c 65 20 62 79 20  69 6e 63 6c 75 64 69 6e  |able by includin|
000030a0  67 20 61 20 2d 6c 65 6e  20 6f 70 74 69 6f 6e 2e  |g a -len option.|
000030b0  20 20 54 68 65 20 70 61  72 61 6d 65 74 65 72 20  |  The parameter |
000030c0  74 6f 0a 6c 65 6e 20 69  73 20 74 68 65 20 6d 61  |to.len is the ma|
000030d0  78 69 6d 75 6d 20 6c 65  6e 67 74 68 20 6f 66 20  |ximum length of |
000030e0  74 68 65 20 73 74 72 69  6e 67 20 77 72 69 74 61  |the string writa|
000030f0  62 6c 65 20 69 6e 74 6f  20 74 68 65 20 69 63 6f  |ble into the ico|
00003100  6e 2e 20 20 57 68 65 6e  20 74 68 65 0a 69 74 65  |n.  When the.ite|
00003110  6d 20 69 73 20 73 65 6c  65 63 74 65 64 20 74 68  |m is selected th|
00003120  65 20 74 65 78 74 20 69  73 20 77 72 69 74 74 65  |e text is writte|
00003130  6e 20 69 6e 74 6f 20 74  68 65 20 73 79 73 74 65  |n into the syste|
00003140  6d 20 76 61 72 69 61 62  6c 65 20 3c 4d 65 6e 75  |m variable <Menu|
00003150  54 65 78 74 3e 0a 77 68  69 63 68 20 63 61 6e 20  |Text>.which can |
00003160  62 65 20 75 73 65 64 20  69 6e 20 63 6f 6d 6d 61  |be used in comma|
00003170  6e 64 73 2e 20 20 49 6e  20 66 61 63 74 20 3c 4d  |nds.  In fact <M|
00003180  65 6e 75 54 65 78 74 3e  20 69 73 20 77 72 69 74  |enuText> is writ|
00003190  74 65 6e 20 66 6f 72 0a  6e 6f 6e 2d 77 72 69 74  |ten for.non-writ|
000031a0  61 62 6c 65 20 69 74 65  6d 73 20 61 6e 64 20 77  |able items and w|
000031b0  68 65 6e 20 63 72 65 61  74 69 6e 67 20 61 20 73  |hen creating a s|
000031c0  75 62 6d 65 6e 75 20 74  6f 6f 2e 0a 0a 09 4f 70  |ubmenu too....Op|
000031d0  74 69 6f 6e 20 22 31 33  22 20 2d 6c 65 6e 20 33  |tion "13" -len 3|
000031e0  0a 09 09 4d 69 67 68 74  20 62 65 20 75 73 65 64  |...Might be used|
000031f0  20 66 6f 72 20 74 79 70  69 6e 67 20 69 6e 20 61  | for typing in a|
00003200  20 6d 6f 64 65 20 6e 75  6d 62 65 72 20 6f 66 20  | mode number of |
00003210  6d 61 78 69 6d 75 6d 20  6c 65 6e 67 74 68 20 33  |maximum length 3|
00003220  0a 09 09 63 68 61 72 61  63 74 65 72 73 2e 20 20  |...characters.  |
00003230  54 68 65 20 63 6f 6d 6d  61 6e 64 20 61 74 74 61  |The command atta|
00003240  63 68 65 64 20 77 6f 75  6c 64 20 74 68 65 6e 20  |ched would then |
00003250  75 73 65 20 3c 4d 65 6e  75 54 65 78 74 3e 0a 09  |use <MenuText>..|
00003260  09 74 6f 20 73 65 74 20  74 68 65 20 61 63 74 75  |.to set the actu|
00003270  61 6c 20 6d 6f 64 65 2e  20 20 54 68 65 20 73 74  |al mode.  The st|
00003280  72 69 6e 67 20 22 31 33  22 20 69 73 20 74 68 65  |ring "13" is the|
00003290  20 64 65 66 61 75 6c 74  20 74 65 78 74 2e 0a 09  | default text...|
000032a0  4f 70 74 69 6f 6e 20 22  22 20 2d 6c 65 6e 20 32  |Option "" -len 2|
000032b0  30 30 0a 09 09 4d 69 67  68 74 20 62 65 20 75 73  |00...Might be us|
000032c0  65 64 20 62 79 20 61 20  67 65 6e 65 72 61 6c 20  |ed by a general |
000032d0  70 75 72 70 6f 73 65 20  63 6f 6d 6d 61 6e 64 20  |purpose command |
000032e0  28 65 67 20 74 68 65 20  4e 65 77 20 54 61 73 6b  |(eg the New Task|
000032f0  0a 09 09 6f 70 74 69 6f  6e 20 69 6e 20 74 68 65  |...option in the|
00003300  20 54 61 73 6b 4d 61 6e  61 67 65 72 29 2e 20 20  | TaskManager).  |
00003310  54 68 65 20 64 65 66 61  75 6c 74 20 73 74 72 69  |The default stri|
00003320  6e 67 20 69 73 20 65 6d  70 74 79 2e 0a 09 09 49  |ng is empty....I|
00003330  74 20 6d 75 73 74 20 62  65 20 73 75 70 70 6c 69  |t must be suppli|
00003340  65 64 20 74 68 6f 75 67  68 20 6f 72 20 44 69 72  |ed though or Dir|
00003350  65 63 74 6f 72 20 77 69  6c 6c 20 63 6f 6d 70 6c  |ector will compl|
00003360  61 69 6e 2e 0a 0a 2d 74  69 63 6b 20 54 69 63 6b  |ain...-tick Tick|
00003370  73 20 74 68 65 20 6d 65  6e 75 20 69 74 65 6d 20  |s the menu item |
00003380  28 75 73 65 66 75 6c 20  66 6f 72 20 77 68 65 6e  |(useful for when|
00003390  20 79 6f 75 20 68 61 76  65 20 32 20 61 74 74 61  | you have 2 atta|
000033a0  63 68 65 64 20 63 6f 6d  6d 61 6e 64 73 2c 20 74  |ched commands, t|
000033b0  68 69 73 0a 70 72 6f 76  69 64 65 73 20 74 68 65  |his.provides the|
000033c0  20 69 6e 69 74 69 61 6c  20 74 69 63 6b 65 64 20  | initial ticked |
000033d0  73 74 61 74 65 29 2e 0a  0a 2d 64 61 73 68 20 57  |state)...-dash W|
000033e0  72 69 74 65 73 20 61 20  64 61 73 68 20 75 6e 64  |rites a dash und|
000033f0  65 72 20 74 68 65 20 6d  65 6e 75 20 69 74 65 6d  |er the menu item|
00003400  2e 20 20 54 68 69 73 20  69 73 20 65 71 75 69 76  |.  This is equiv|
00003410  61 6c 65 6e 74 20 74 6f  20 74 68 65 20 44 61 73  |alent to the Das|
00003420  68 0a 63 6f 6d 6d 61 6e  64 2e 0a 0a 2d 67 72 65  |h.command...-gre|
00003430  79 20 4d 61 6b 65 73 20  74 68 65 20 6d 65 6e 75  |y Makes the menu|
00003440  20 65 6e 74 72 79 20 67  72 65 79 20 61 6e 64 20  | entry grey and |
00003450  75 6e 73 65 6c 65 63 74  61 62 6c 65 2e 20 20 55  |unselectable.  U|
00003460  73 65 66 75 6c 20 6f 63  63 61 73 69 6f 6e 61 6c  |seful occasional|
00003470  6c 79 2e 0a 0a 2d 75 70  20 4d 61 6b 65 73 20 2d  |ly...-up Makes -|
00003480  70 61 74 68 20 68 61 76  65 20 74 68 65 20 64 69  |path have the di|
00003490  72 65 63 74 6f 72 69 65  73 20 61 62 6f 76 65 20  |rectories above |
000034a0  74 68 65 20 70 61 74 68  20 28 55 70 20 4d 65 6e  |the path (Up Men|
000034b0  75 73 20 2d 20 73 65 65  20 44 69 72 65 63 74 6f  |us - see Directo|
000034c0  72 79 0a 4d 65 6e 75 73  20 73 65 63 74 69 6f 6e  |ry.Menus section|
000034d0  29 20 69 6e 20 74 68 65  20 6d 65 6e 75 2e 20 20  |) in the menu.  |
000034e0  49 66 20 2d 75 70 20 69  73 20 61 70 70 6c 69 65  |If -up is applie|
000034f0  64 20 74 6f 20 61 20 66  69 6c 65 20 74 68 65 6e  |d to a file then|
00003500  20 69 74 20 77 69 6c 6c  20 68 61 76 65 20 61 0a  | it will have a.|
00003510  73 75 62 6d 65 6e 75 20  61 72 72 6f 77 2e 0a 0a  |submenu arrow...|
00003520  2d 6e 6f 73 70 72 69 74  65 20 53 74 6f 70 73 20  |-nosprite Stops |
00003530  61 20 73 70 72 69 74 65  20 61 70 70 65 61 72 69  |a sprite appeari|
00003540  6e 67 20 69 6e 20 61 20  2d 70 61 74 68 20 6d 65  |ng in a -path me|
00003550  6e 75 2e 20 20 49 74 20  61 6c 73 6f 20 73 74 6f  |nu.  It also sto|
00003560  70 73 20 74 68 65 20 6d  65 6e 75 0a 65 6e 74 72  |ps the menu.entr|
00003570  79 20 62 65 69 6e 67 20  67 72 65 79 65 64 20 6f  |y being greyed o|
00003580  75 74 20 69 66 20 74 68  65 20 70 61 74 68 20 64  |ut if the path d|
00003590  69 64 20 6e 6f 74 20 65  78 69 73 74 2e 0a 0a 2d  |id not exist...-|
000035a0  73 70 72 69 74 65 20 61  64 64 73 20 74 68 65 20  |sprite adds the |
000035b0  6e 61 6d 65 64 20 73 70  72 69 74 65 20 69 6e 74  |named sprite int|
000035c0  6f 20 74 68 65 20 6d 65  6e 75 20 65 6e 74 72 79  |o the menu entry|
000035d0  2e 20 20 54 68 65 20 73  70 72 69 74 65 20 6d 75  |.  The sprite mu|
000035e0  73 74 20 62 65 20 74 68  65 0a 63 6f 72 72 65 63  |st be the.correc|
000035f0  74 20 73 69 7a 65 20 28  74 68 65 20 73 61 6d 65  |t size (the same|
00003600  20 73 69 7a 65 20 61 73  20 73 6d 61 6c 6c 20 66  | size as small f|
00003610  69 6c 65 72 20 69 63 6f  6e 73 29 2e 20 20 49 66  |iler icons).  If|
00003620  20 69 74 20 69 73 20 6e  6f 74 20 66 6f 75 6e 64  | it is not found|
00003630  20 69 74 20 69 73 0a 72  65 70 6c 61 63 65 64 20  | it is.replaced |
00003640  77 69 74 68 20 61 20 66  69 6c 65 5f 78 78 78 20  |with a file_xxx |
00003650  73 70 72 69 74 65 20 28  61 20 62 6c 61 6e 6b 20  |sprite (a blank |
00003660  77 68 69 74 65 20 73 71  75 61 72 65 29 2e 0a 0a  |white square)...|
00003670  54 68 65 20 43 6f 6d 6d  61 6e 64 20 63 6f 6d 6d  |The Command comm|
00003680  61 6e 64 20 69 73 20 66  6f 72 20 61 74 74 61 63  |and is for attac|
00003690  68 69 6e 67 20 63 6f 6d  6d 61 6e 64 73 20 74 6f  |hing commands to|
000036a0  20 6d 65 6e 75 20 6f 70  74 69 6f 6e 73 2e 20 20  | menu options.  |
000036b0  4f 6e 6c 79 20 74 65 78  74 0a 74 79 70 65 20 6d  |Only text.type m|
000036c0  65 6e 75 20 6f 70 74 69  6f 6e 73 20 28 69 65 20  |enu options (ie |
000036d0  6e 6f 74 20 2d 70 61 74  68 20 6f 70 74 69 6f 6e  |not -path option|
000036e0  73 29 20 6d 61 79 20 68  61 76 65 20 43 6f 6d 6d  |s) may have Comm|
000036f0  61 6e 64 73 20 61 74 74  61 63 68 65 64 2e 20 20  |ands attached.  |
00003700  59 6f 75 20 6d 61 79 0a  68 61 76 65 20 62 6f 74  |You may.have bot|
00003710  68 20 53 75 62 4d 65 6e  75 73 20 61 6e 64 20 63  |h SubMenus and c|
00003720  6f 6d 6d 61 6e 64 73 20  61 74 74 61 63 68 65 64  |ommands attached|
00003730  20 74 6f 20 61 20 6d 65  6e 75 20 6f 70 74 69 6f  | to a menu optio|
00003740  6e 2e 0a 0a 09 53 79 6e  74 61 78 3a 20 43 6f 6d  |n....Syntax: Com|
00003750  6d 61 6e 64 20 3c 2a 63  6f 6d 6d 61 6e 64 3e 0a  |mand <*command>.|
00003760  0a 46 6f 72 20 65 78 61  6d 70 6c 65 0a 0a 09 4f  |.For example...O|
00003770  70 74 69 6f 6e 20 22 4d  6f 64 65 20 31 33 22 0a  |ption "Mode 13".|
00003780  09 09 43 6f 6d 6d 61 6e  64 20 57 69 6d 70 4d 6f  |..Command WimpMo|
00003790  64 65 20 31 33 0a 09 09  09 53 65 74 73 20 4d 6f  |de 13....Sets Mo|
000037a0  64 65 20 31 33 20 77 68  65 6e 20 63 6c 69 63 6b  |de 13 when click|
000037b0  65 64 20 6f 6e 0a 09 4f  70 74 69 6f 6e 20 22 31  |ed on..Option "1|
000037c0  33 22 20 2d 6c 65 6e 20  33 0a 09 09 43 6f 6d 6d  |3" -len 3...Comm|
000037d0  61 6e 64 20 57 69 6d 70  4d 6f 64 65 20 3c 4d 65  |and WimpMode <Me|
000037e0  6e 75 54 65 78 74 3e 0a  09 09 09 53 65 74 73 20  |nuText>....Sets |
000037f0  74 68 65 20 6d 6f 64 65  20 74 79 70 65 64 20 69  |the mode typed i|
00003800  6e 20 77 68 65 6e 20 63  6c 69 63 6b 65 64 20 6f  |n when clicked o|
00003810  6e 0a 09 4f 70 74 69 6f  6e 20 22 22 20 2d 6c 65  |n..Option "" -le|
00003820  6e 20 32 30 30 0a 09 09  43 6f 6d 6d 61 6e 64 20  |n 200...Command |
00003830  3c 4d 65 6e 75 54 65 78  74 3e 0a 09 09 09 52 75  |<MenuText>....Ru|
00003840  6e 73 20 74 68 65 20 63  6f 6d 6d 61 6e 64 20 74  |ns the command t|
00003850  79 70 65 64 20 69 6e 20  77 68 65 6e 20 63 6c 69  |yped in when cli|
00003860  63 6b 65 64 20 6f 6e 2e  0a 0a 41 20 6d 65 6e 75  |cked on...A menu|
00003870  20 6f 70 74 69 6f 6e 20  6d 61 79 20 68 61 76 65  | option may have|
00003880  20 74 77 6f 20 63 6f 6d  6d 61 6e 64 73 20 61 74  | two commands at|
00003890  74 61 63 68 65 64 2e 20  20 57 68 69 63 68 20 63  |tached.  Which c|
000038a0  6f 6d 6d 61 6e 64 20 69  73 20 72 75 6e 20 64 65  |ommand is run de|
000038b0  70 65 6e 64 73 0a 75 70  6f 6e 20 74 68 65 20 74  |pends.upon the t|
000038c0  69 63 6b 65 64 20 73 74  61 74 65 20 6f 66 20 74  |icked state of t|
000038d0  68 65 20 6f 70 74 69 6f  6e 2e 0a 0a 46 6f 72 20  |he option...For |
000038e0  65 78 61 6d 70 6c 65 0a  0a 09 4f 70 74 69 6f 6e  |example...Option|
000038f0  20 22 41 22 0a 09 09 43  6f 6d 6d 61 6e 64 20 46  | "A"...Command F|
00003900  6f 6e 74 49 6e 73 74 61  6c 6c 20 46 6f 6e 74 73  |ontInstall Fonts|
00003910  3a 21 41 2e 0a 09 09 43  6f 6d 6d 61 6e 64 20 46  |:!A....Command F|
00003920  6f 6e 74 52 65 6d 6f 76  65 20 46 6f 6e 74 73 3a  |ontRemove Fonts:|
00003930  21 41 2e 0a 0a 57 68 65  6e 20 74 68 69 73 20 69  |!A...When this i|
00003940  74 20 6e 6f 74 20 74 69  63 6b 65 64 20 74 68 65  |t not ticked the|
00003950  6e 20 74 68 65 20 66 69  72 73 74 20 63 6f 6d 6d  |n the first comm|
00003960  61 6e 64 20 77 69 6c 6c  20 62 65 20 72 75 6e 2e  |and will be run.|
00003970  20 20 54 68 69 73 20 77  69 6c 6c 0a 69 6e 73 74  |  This will.inst|
00003980  61 6c 6c 20 74 68 65 20  66 6f 6e 74 73 20 69 6e  |all the fonts in|
00003990  20 21 41 20 61 6e 64 20  74 6f 20 73 68 6f 77 20  | !A and to show |
000039a0  74 68 61 74 20 74 68 65  79 20 68 61 76 65 20 62  |that they have b|
000039b0  65 65 6e 20 69 6e 73 74  61 6c 6c 65 64 20 74 68  |een installed th|
000039c0  65 20 6d 65 6e 75 0a 6f  70 74 69 6f 6e 20 77 69  |e menu.option wi|
000039d0  6c 6c 20 62 65 20 74 69  63 6b 65 64 2e 20 20 54  |ll be ticked.  T|
000039e0  6f 20 72 65 6d 6f 76 65  20 74 68 65 20 66 6f 6e  |o remove the fon|
000039f0  74 73 20 74 68 65 20 6f  70 74 69 6f 6e 20 69 73  |ts the option is|
00003a00  20 63 6c 69 63 6b 65 64  20 61 67 61 69 6e 20 61  | clicked again a|
00003a10  6e 64 0a 74 68 65 20 73  65 63 6f 6e 64 20 63 6f  |nd.the second co|
00003a20  6d 6d 61 6e 64 20 69 73  20 72 75 6e 2c 20 72 65  |mmand is run, re|
00003a30  6d 6f 76 69 6e 67 20 74  68 65 20 66 6f 6e 74 73  |moving the fonts|
00003a40  2c 20 61 6e 64 20 72 65  74 75 72 6e 69 6e 67 20  |, and returning |
00003a50  74 68 65 20 6d 65 6e 75  20 74 6f 20 74 68 65 0a  |the menu to the.|
00003a60  6e 6f 6e 2d 74 69 63 6b  65 64 20 73 74 61 74 65  |non-ticked state|
00003a70  2e 0a 0a 43 6f 6d 6d 61  6e 64 73 20 61 72 65 20  |...Commands are |
00003a80  47 53 54 72 61 6e 73 65  64 20 62 65 66 6f 72 65  |GSTransed before|
00003a90  20 62 65 69 6e 67 20 72  75 6e 20 28 73 65 65 20  | being run (see |
00003aa0  74 68 65 20 73 65 63 74  69 6f 6e 20 6f 6e 20 47  |the section on G|
00003ab0  53 54 72 61 6e 73 20 66  6f 72 20 6d 6f 72 65 0a  |STrans for more.|
00003ac0  69 6e 66 6f 29 20 61 73  20 61 20 57 69 6d 70 54  |info) as a WimpT|
00003ad0  61 73 6b 2e 20 20 52 75  6e 6e 69 6e 67 20 63 6f  |ask.  Running co|
00003ae0  6d 6d 61 6e 64 73 20 61  73 20 61 20 57 69 6d 70  |mmands as a Wimp|
00003af0  54 61 73 6b 20 6d 65 61  6e 73 20 74 68 61 74 20  |Task means that |
00003b00  74 68 65 79 20 64 6f 6e  27 74 0a 69 6e 74 65 72  |they don't.inter|
00003b10  66 65 72 65 20 77 69 74  68 20 44 69 72 65 63 74  |fere with Direct|
00003b20  6f 72 2c 20 68 6f 77 65  76 65 72 20 69 66 20 74  |or, however if t|
00003b30  68 65 20 63 6f 6d 6d 61  6e 64 20 70 72 6f 64 75  |he command produ|
00003b40  63 65 73 20 61 6e 20 65  72 72 6f 72 2c 20 61 6e  |ces an error, an|
00003b50  0a 61 6e 6f 6e 79 6d 6f  75 73 20 65 72 72 6f 72  |.anonymous error|
00003b60  20 62 6f 78 20 69 73 20  70 72 6f 64 75 63 65 64  | box is produced|
00003b70  2e 0a 0a 54 68 69 73 20  61 6c 73 6f 20 6d 65 61  |...This also mea|
00003b80  6e 73 20 74 68 61 74 20  6d 75 6c 74 69 70 6c 65  |ns that multiple|
00003b90  20 4f 53 20 63 6f 6d 6d  61 6e 64 73 20 63 61 6e  | OS commands can|
00003ba0  20 62 65 20 70 75 74 20  6f 6e 20 6f 6e 65 20 6c  | be put on one l|
00003bb0  69 6e 65 20 62 79 0a 73  65 70 61 72 61 74 69 6e  |ine by.separatin|
00003bc0  67 20 74 68 65 6d 20 77  69 74 68 20 7c 4d 2e 20  |g them with |M. |
00003bd0  20 46 6f 72 20 65 78 61  6d 70 6c 65 0a 0a 09 4f  | For example...O|
00003be0  70 74 69 6f 6e 20 22 52  65 73 65 74 20 53 79 73  |ption "Reset Sys|
00003bf0  46 6f 6e 74 22 0a 09 09  43 6f 6d 6d 61 6e 64 20  |Font"...Command |
00003c00  66 78 20 32 30 7c 4d 53  57 49 20 57 69 6d 70 5f  |fx 20|MSWI Wimp_|
00003c10  43 6f 6d 6d 61 6e 64 57  69 6e 64 6f 77 20 2d 31  |CommandWindow -1|
00003c20  0a 0a 57 68 69 63 68 20  72 65 73 65 74 73 20 74  |..Which resets t|
00003c30  68 65 20 73 79 73 74 65  6d 20 66 6f 6e 74 20 77  |he system font w|
00003c40  69 74 68 20 2a 46 58 20  32 30 20 61 6e 64 20 74  |ith *FX 20 and t|
00003c50  68 65 6e 20 72 65 64 72  61 77 73 20 74 68 65 20  |hen redraws the |
00003c60  73 63 72 65 65 6e 20 77  69 74 68 20 74 68 65 0a  |screen with the.|
00003c70  53 57 49 20 57 69 6d 70  5f 43 6f 6d 6d 61 6e 64  |SWI Wimp_Command|
00003c80  57 69 6e 64 6f 77 2e 0a  0a 0a a4 20 53 68 6f 77  |Window..... Show|
00003c90  69 6e 67 20 61 20 4d 65  6e 75 0a 3d 3d 3d 3d 3d  |ing a Menu.=====|
00003ca0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 0a 0a 41 20 6d  |===========..A m|
00003cb0  65 6e 75 20 63 61 6e 20  62 65 20 73 68 6f 77 6e  |enu can be shown|
00003cc0  20 69 6d 6d 65 64 69 61  74 65 6c 79 20 77 69 74  | immediately wit|
00003cd0  68 20 74 68 65 20 63 6f  6d 6d 61 6e 64 0a 0a 09  |h the command...|
00003ce0  44 69 72 65 63 74 6f 72  53 68 6f 77 4d 65 6e 75  |DirectorShowMenu|
00003cf0  20 3c 6d 65 6e 75 5f 6e  61 6d 65 3e 0a 0a 54 68  | <menu_name>..Th|
00003d00  69 73 20 77 69 6c 6c 20  6f 70 65 6e 20 74 68 65  |is will open the|
00003d10  20 6d 65 6e 75 20 6e 61  6d 65 64 20 69 6d 6d 65  | menu named imme|
00003d20  64 69 61 74 65 6c 79 2e  20 20 59 6f 75 20 63 61  |diately.  You ca|
00003d30  6e 20 6d 61 6b 65 20 6f  62 65 79 20 66 69 6c 65  |n make obey file|
00003d40  73 20 77 68 69 63 68 0a  64 65 66 69 6e 65 20 6d  |s which.define m|
00003d50  65 6e 75 73 20 61 6e 64  20 74 68 65 6e 20 6f 70  |enus and then op|
00003d60  65 6e 20 74 68 65 6d 20  69 6d 6d 65 64 69 61 74  |en them immediat|
00003d70  65 6c 79 20 77 69 74 68  20 74 68 69 73 20 63 6f  |ely with this co|
00003d80  6d 6d 61 6e 64 2e 20 20  49 66 20 79 6f 75 20 61  |mmand.  If you a|
00003d90  64 64 0a 2d 74 65 6d 70  20 74 6f 20 74 68 65 20  |dd.-temp to the |
00003da0  6d 65 6e 75 20 74 68 65  6e 20 69 74 20 77 69 6c  |menu then it wil|
00003db0  6c 20 62 65 20 64 65 6c  65 74 65 64 20 61 66 74  |l be deleted aft|
00003dc0  65 72 20 69 74 20 68 61  73 20 62 65 65 6e 20 73  |er it has been s|
00003dd0  68 6f 77 6e 2e 0a 0a 0a  a4 20 53 79 73 74 65 6d  |hown..... System|
00003de0  20 56 61 72 69 61 62 6c  65 73 0a 3d 3d 3d 3d 3d  | Variables.=====|
00003df0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 54  |=============..T|
00003e00  68 65 73 65 20 73 79 73  74 65 6d 20 76 61 72 69  |hese system vari|
00003e10  61 62 6c 65 73 20 61 72  65 20 73 65 74 20 77 68  |ables are set wh|
00003e20  65 6e 65 76 65 72 20 61  20 70 61 74 68 20 73 75  |enever a path su|
00003e30  62 20 6d 65 6e 75 20 69  73 20 6f 70 65 6e 65 64  |b menu is opened|
00003e40  20 6f 72 20 61 20 70 61  74 68 0a 69 74 65 6d 20  | or a path.item |
00003e50  69 73 20 63 68 6f 73 65  6e 0a 0a 09 44 69 72 65  |is chosen...Dire|
00003e60  63 74 6f 72 24 43 75 72  72 65 6e 74 50 61 74 68  |ctor$CurrentPath|
00003e70  0a 09 09 66 75 6c 6c 20  70 61 74 68 20 6f 66 20  |...full path of |
00003e80  6f 62 6a 65 63 74 0a 09  44 69 72 65 63 74 6f 72  |object..Director|
00003e90  24 43 75 72 72 65 6e 74  44 69 72 0a 09 09 64 69  |$CurrentDir...di|
00003ea0  72 65 63 74 6f 72 79 20  6f 62 6a 65 63 74 20 6c  |rectory object l|
00003eb0  69 76 65 73 20 69 6e 0a  09 44 69 72 65 63 74 6f  |ives in..Directo|
00003ec0  72 24 43 75 72 72 65 6e  74 4c 65 61 66 0a 09 09  |r$CurrentLeaf...|
00003ed0  6c 65 61 66 20 6e 61 6d  65 20 6f 66 20 6f 62 6a  |leaf name of obj|
00003ee0  65 63 74 0a 20 20 20 20  0a 49 66 20 74 68 65 20  |ect.    .If the |
00003ef0  6f 62 6a 65 63 74 20 69  73 20 61 20 72 6f 6f 74  |object is a root|
00003f00  20 64 69 72 65 63 74 6f  72 79 20 28 65 67 20 41  | directory (eg A|
00003f10  44 46 53 3a 3a 34 2e 24  20 6f 72 20 52 6f 6f 74  |DFS::4.$ or Root|
00003f20  3a 29 20 74 68 65 6e 20  43 75 72 72 65 6e 74 50  |:) then CurrentP|
00003f30  61 74 68 20 3d 0a 43 75  72 72 65 6e 74 44 69 72  |ath =.CurrentDir|
00003f40  20 3d 20 43 75 72 72 65  6e 74 4c 65 61 66 0a 0a  | = CurrentLeaf..|
00003f50  0a 54 68 65 20 6c 61 73  74 20 43 6f 6d 6d 61 6e  |.The last Comman|
00003f60  64 20 74 68 61 74 20 77  61 73 20 72 75 6e 20 63  |d that was run c|
00003f70  61 6e 20 62 65 20 73 65  65 6e 20 69 6e 20 74 68  |an be seen in th|
00003f80  65 20 73 79 73 74 65 6d  20 76 61 72 69 61 62 6c  |e system variabl|
00003f90  65 0a 0a 09 41 6c 69 61  73 24 44 69 72 65 63 74  |e...Alias$Direct|
00003fa0  6f 72 52 75 6e 0a 0a 53  6f 20 69 73 73 75 65 20  |orRun..So issue |
00003fb0  2a 53 68 6f 77 20 41 6c  69 61 73 24 44 69 72 65  |*Show Alias$Dire|
00003fc0  63 74 6f 72 52 75 6e 20  61 74 20 74 68 65 20 63  |ctorRun at the c|
00003fd0  6f 6d 6d 61 6e 64 20 6c  69 6e 65 20 74 6f 20 73  |ommand line to s|
00003fe0  65 65 20 77 68 61 74 20  69 74 20 77 61 73 2e 0a  |ee what it was..|
00003ff0  0a 0a 57 68 65 6e 65 76  65 72 20 61 20 74 65 78  |..Whenever a tex|
00004000  74 20 6f 70 74 69 6f 6e  20 69 73 20 63 68 6f 73  |t option is chos|
00004010  65 6e 0a 0a 09 4d 65 6e  75 54 65 78 74 0a 0a 49  |en...MenuText..I|
00004020  73 20 73 65 74 20 74 6f  20 74 68 65 20 74 65 78  |s set to the tex|
00004030  74 20 6f 66 20 74 68 61  74 20 6f 70 74 69 6f 6e  |t of that option|
00004040  0a 0a 0a 57 68 65 6e 65  76 65 72 20 6d 65 6e 75  |...Whenever menu|
00004050  20 69 73 20 63 6c 69 63  6b 65 64 20 6f 76 65 72  | is clicked over|
00004060  20 74 68 65 20 46 69 6c  65 20 27 78 78 78 27 20  | the File 'xxx' |
00004070  6f 70 74 69 6f 6e 20 69  6e 20 61 20 46 69 6c 65  |option in a File|
00004080  72 20 4d 65 6e 75 0a 0a  09 4c 65 61 66 0a 0a 69  |r Menu...Leaf..i|
00004090  73 20 73 65 74 20 74 6f  20 74 68 65 20 6c 65 61  |s set to the lea|
000040a0  66 20 6e 61 6d 65 20 6f  66 20 74 68 65 20 66 69  |f name of the fi|
000040b0  6c 65 20 28 22 78 78 78  22 20 69 6e 20 74 68 69  |le ("xxx" in thi|
000040c0  73 20 63 61 73 65 29 2e  0a 0a 0a a4 20 47 53 54  |s case)..... GST|
000040d0  72 61 6e 73 0a 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |rans.=========..|
000040e0  49 66 20 79 6f 75 20 61  72 65 20 75 6e 63 65 72  |If you are uncer|
000040f0  74 61 69 6e 20 77 68 61  74 20 47 53 54 72 61 6e  |tain what GSTran|
00004100  73 20 69 73 2c 20 6c 6f  6f 6b 20 69 74 20 75 70  |s is, look it up|
00004110  20 69 6e 20 74 68 65 20  69 6e 64 65 78 20 6f 66  | in the index of|
00004120  20 79 6f 75 72 20 75 73  65 72 0a 67 75 69 64 65  | your user.guide|
00004130  2e 20 20 54 68 65 20 66  65 77 20 70 61 67 65 73  |.  The few pages|
00004140  20 72 65 66 65 72 65 6e  63 65 64 20 77 69 6c 6c  | referenced will|
00004150  20 74 65 61 63 68 20 79  6f 75 20 74 68 65 20 62  | teach you the b|
00004160  61 73 69 63 73 20 28 49  20 77 6f 6e 27 74 20 61  |asics (I won't a|
00004170  74 74 65 6d 70 74 0a 74  6f 20 65 78 70 6c 61 69  |ttempt.to explai|
00004180  6e 20 74 68 65 6d 20 68  65 72 65 29 2e 0a 0a 41  |n them here)...A|
00004190  73 20 61 20 72 75 6c 65  20 65 76 65 72 79 20 73  |s a rule every s|
000041a0  74 72 69 6e 67 20 70 61  72 61 6d 65 74 65 72 20  |tring parameter |
000041b0  70 61 73 73 65 64 20 74  6f 20 44 69 72 65 63 74  |passed to Direct|
000041c0  6f 72 20 69 73 20 47 53  54 72 61 6e 73 65 64 20  |or is GSTransed |
000041d0  77 68 65 6e 20 69 74 20  69 73 0a 70 61 72 73 65  |when it is.parse|
000041e0  64 2e 20 20 54 68 69 73  20 6d 65 61 6e 73 20 74  |d.  This means t|
000041f0  68 61 74 0a 0a 09 4f 70  74 69 6f 6e 20 2d 70 61  |hat...Option -pa|
00004200  74 68 20 3c 57 69 6d 70  24 53 63 72 61 70 3e 0a  |th <Wimp$Scrap>.|
00004210  0a 57 69 6c 6c 20 62 65  20 47 53 54 72 61 6e 73  |.Will be GSTrans|
00004220  65 64 20 69 6e 74 6f 20  28 73 6f 6d 65 74 68 69  |ed into (somethi|
00004230  6e 67 20 6c 69 6b 65 29  0a 0a 09 4f 70 74 69 6f  |ng like)...Optio|
00004240  6e 20 2d 70 61 74 68 20  41 44 46 53 3a 3a 48 61  |n -path ADFS::Ha|
00004250  72 64 44 69 73 63 34 2e  24 2e 21 42 6f 6f 74 2e  |rdDisc4.$.!Boot.|
00004260  21 53 63 72 61 70 2e 53  63 72 61 70 44 69 72 73  |!Scrap.ScrapDirs|
00004270  2e 53 63 72 61 70 46 69  6c 65 0a 0a 57 68 69 63  |.ScrapFile..Whic|
00004280  68 20 6d 65 61 6e 73 20  74 68 61 74 20 69 66 20  |h means that if |
00004290  57 69 6d 70 24 53 63 72  61 70 20 63 68 61 6e 67  |Wimp$Scrap chang|
000042a0  65 73 2c 20 74 68 65 20  6f 70 74 69 6f 6e 20 77  |es, the option w|
000042b0  6f 6e 27 74 20 62 65 20  6c 6f 6f 6b 69 6e 67 20  |on't be looking |
000042c0  69 6e 20 74 68 65 0a 72  69 67 68 74 20 70 6c 61  |in the.right pla|
000042d0  63 65 2e 20 20 54 68 65  20 6d 65 6e 75 20 74 65  |ce.  The menu te|
000042e0  78 74 20 77 69 6c 6c 20  72 65 61 64 20 22 53 63  |xt will read "Sc|
000042f0  72 61 70 46 69 6c 65 22  2e 20 20 42 65 74 74 65  |rapFile".  Bette|
00004300  72 20 69 73 0a 0a 09 4f  70 74 69 6f 6e 20 2d 70  |r is...Option -p|
00004310  61 74 68 20 7c 3c 57 69  6d 70 24 53 63 72 61 70  |ath |<Wimp$Scrap|
00004320  3e 0a 0a 57 68 69 63 68  20 47 53 54 72 61 6e 73  |>..Which GSTrans|
00004330  65 73 20 69 6e 74 6f 0a  0a 09 4f 70 74 69 6f 6e  |es into...Option|
00004340  20 2d 70 61 74 68 20 3c  57 69 6d 70 24 53 63 72  | -path <Wimp$Scr|
00004350  61 70 3e 0a 0a 77 68 69  63 68 20 69 73 20 77 68  |ap>..which is wh|
00004360  61 74 20 79 6f 75 20 77  61 6e 74 2e 20 20 54 68  |at you want.  Th|
00004370  65 20 6d 65 6e 75 20 74  65 78 74 20 77 69 6c 6c  |e menu text will|
00004380  20 72 65 61 64 20 22 3c  57 69 6d 70 24 53 63 72  | read "<Wimp$Scr|
00004390  61 70 3e 22 2e 20 20 50  72 6f 62 61 62 6c 79 0a  |ap>".  Probably.|
000043a0  62 65 73 74 20 28 66 6f  72 20 74 68 69 73 20 75  |best (for this u|
000043b0  73 65 29 20 69 73 0a 0a  09 4f 70 74 69 6f 6e 20  |se) is...Option |
000043c0  22 53 63 72 61 70 22 20  2d 70 61 74 68 20 7c 3c  |"Scrap" -path |<|
000043d0  57 69 6d 70 24 53 63 72  61 70 3e 0a 0a 57 68 69  |Wimp$Scrap>..Whi|
000043e0  63 68 20 68 61 73 20 74  68 65 20 6d 65 6e 75 20  |ch has the menu |
000043f0  74 65 78 74 20 22 53 63  72 61 70 22 20 62 75 74  |text "Scrap" but|
00004400  20 69 73 20 6f 74 68 65  72 77 69 73 65 20 69 64  | is otherwise id|
00004410  65 6e 74 69 63 61 6c 20  74 6f 20 74 68 65 20 6f  |entical to the o|
00004420  6e 65 20 61 62 6f 76 65  2e 0a 0a 54 68 65 20 6f  |ne above...The o|
00004430  6e 6c 79 20 73 74 72 69  6e 67 73 20 77 68 69 63  |nly strings whic|
00004440  68 20 64 6f 6e 27 74 20  67 65 74 20 47 53 54 72  |h don't get GSTr|
00004450  61 6e 73 65 64 20 6f 6e  20 74 68 65 69 72 20 77  |ansed on their w|
00004460  61 79 20 69 6e 74 6f 20  44 69 72 65 63 74 6f 72  |ay into Director|
00004470  20 61 72 65 20 74 68 65  0a 70 61 72 61 6d 65 74  | are the.paramet|
00004480  65 72 73 20 74 6f 20 43  6f 6d 6d 61 6e 64 2e 20  |ers to Command. |
00004490  20 54 68 65 73 65 20 61  72 65 20 47 53 54 72 61  | These are GSTra|
000044a0  6e 73 65 64 20 6a 75 73  74 20 62 65 66 6f 72 65  |nsed just before|
000044b0  20 62 65 69 6e 67 20 72  75 6e 2e 0a 0a 09 4f 70  | being run....Op|
000044c0  74 69 6f 6e 20 22 31 33  22 20 2d 6c 65 6e 20 33  |tion "13" -len 3|
000044d0  0a 09 09 43 6f 6d 6d 61  6e 64 20 57 69 6d 70 4d  |...Command WimpM|
000044e0  6f 64 65 20 3c 4d 65 6e  75 54 65 78 74 3e 0a 0a  |ode <MenuText>..|
000044f0  54 68 65 20 61 62 6f 76  65 20 63 6f 6d 6d 61 6e  |The above comman|
00004500  64 20 77 69 6c 6c 20 6f  6e 6c 79 20 62 65 20 47  |d will only be G|
00004510  53 54 72 61 6e 73 65 64  20 77 68 65 6e 20 69 74  |STransed when it|
00004520  20 69 73 20 72 75 6e 20  77 69 74 68 20 74 68 65  | is run with the|
00004530  20 61 63 74 75 61 6c 20  76 61 6c 75 65 0a 6f 66  | actual value.of|
00004540  20 4d 65 6e 75 54 65 78  74 2c 20 6e 6f 74 20 74  | MenuText, not t|
00004550  68 65 20 76 61 6c 75 65  20 6f 66 20 4d 65 6e 75  |he value of Menu|
00004560  54 65 78 74 20 77 68 65  6e 20 74 68 65 20 63 6f  |Text when the co|
00004570  6d 6d 61 6e 64 20 77 61  73 20 69 6e 73 74 61 6c  |mmand was instal|
00004580  6c 65 64 2e 0a 0a 09 4f  70 74 69 6f 6e 20 22 4f  |led....Option "O|
00004590  70 65 6e 20 41 70 70 22  0a 09 09 43 6f 6d 6d 61  |pen App"...Comma|
000045a0  6e 64 20 46 69 6c 65 72  5f 4f 70 65 6e 44 69 72  |nd Filer_OpenDir|
000045b0  20 3c 4f 62 65 79 24 44  69 72 3e 0a 09 4f 70 74  | <Obey$Dir>..Opt|
000045c0  69 6f 6e 20 22 4f 70 65  6e 20 41 70 70 22 0a 09  |ion "Open App"..|
000045d0  09 43 6f 6d 6d 61 6e 64  20 46 69 6c 65 72 5f 4f  |.Command Filer_O|
000045e0  70 65 6e 44 69 72 20 7c  3c 4f 62 65 79 24 44 69  |penDir |<Obey$Di|
000045f0  72 3e 0a 0a 54 68 65 73  65 20 74 77 6f 20 63 6f  |r>..These two co|
00004600  6d 6d 61 6e 64 73 20 69  6e 20 70 72 61 63 74 69  |mmands in practi|
00004610  63 65 20 64 6f 20 74 68  65 20 73 61 6d 65 20 74  |ce do the same t|
00004620  68 69 6e 67 2e 20 20 54  68 69 73 20 69 73 20 62  |hing.  This is b|
00004630  65 63 61 75 73 65 20 69  6e 20 74 68 65 0a 66 69  |ecause in the.fi|
00004640  72 73 74 20 43 6f 6d 6d  61 6e 64 20 74 68 65 20  |rst Command the |
00004650  3c 4f 62 65 79 24 44 69  72 3e 20 69 73 20 47 53  |<Obey$Dir> is GS|
00004660  54 72 61 6e 73 65 64 20  28 77 68 65 6e 20 74 68  |Transed (when th|
00004670  65 20 43 6f 6d 6d 61 6e  64 20 69 73 20 62 65 69  |e Command is bei|
00004680  6e 67 0a 70 72 65 70 61  72 65 64 29 20 74 6f 20  |ng.prepared) to |
00004690  74 68 65 20 70 72 6f 70  65 72 20 70 61 74 68 20  |the proper path |
000046a0  77 68 69 63 68 20 69 73  20 74 68 65 6e 20 70 61  |which is then pa|
000046b0  73 73 65 64 20 74 6f 20  46 69 6c 65 72 5f 4f 70  |ssed to Filer_Op|
000046c0  65 6e 44 69 72 2e 20 20  49 6e 20 74 68 65 0a 73  |enDir.  In the.s|
000046d0  65 63 6f 6e 64 20 63 61  73 65 20 7c 3c 4f 62 65  |econd case |<Obe|
000046e0  79 24 44 69 72 3e 20 69  73 20 47 53 54 72 61 6e  |y$Dir> is GSTran|
000046f0  73 65 64 20 74 6f 20 3c  4f 62 65 79 24 44 69 72  |sed to <Obey$Dir|
00004700  3e 20 61 6e 64 20 70 61  73 73 65 64 20 74 6f 0a  |> and passed to.|
00004710  46 69 6c 65 72 5f 4f 70  65 6e 44 69 72 2e 20 20  |Filer_OpenDir.  |
00004720  46 69 6c 65 72 5f 4f 70  65 6e 44 69 72 20 47 53  |Filer_OpenDir GS|
00004730  54 72 61 6e 73 65 73 20  74 68 65 20 61 72 67 75  |Transes the argu|
00004740  6d 65 6e 74 20 61 6e 64  20 63 6f 6d 65 73 20 75  |ment and comes u|
00004750  70 20 77 69 74 68 20 74  68 65 0a 73 61 6d 65 20  |p with the.same |
00004760  61 6e 73 77 65 72 2e 0a  0a 49 66 20 74 68 65 20  |answer...If the |
00004770  63 6f 6d 6d 61 6e 64 73  20 68 61 64 20 62 65 65  |commands had bee|
00004780  6e 20 46 69 6c 65 72 5f  52 75 6e 20 69 6e 20 74  |n Filer_Run in t|
00004790  68 65 20 61 62 6f 76 65  20 65 78 61 6d 70 6c 65  |he above example|
000047a0  20 74 68 65 6e 20 74 68  65 79 20 77 6f 75 6c 64  | then they would|
000047b0  20 68 61 76 65 0a 64 6f  6e 65 20 74 77 6f 20 64  | have.done two d|
000047c0  69 66 66 65 72 65 6e 74  20 74 68 69 6e 67 73 2e  |ifferent things.|
000047d0  20 20 54 68 65 20 66 69  72 73 74 20 77 6f 75 6c  |  The first woul|
000047e0  64 20 68 61 76 65 20 77  6f 72 6b 65 64 20 28 72  |d have worked (r|
000047f0  75 6e 6e 69 6e 67 20 74  68 65 0a 61 70 70 6c 69  |unning the.appli|
00004800  63 61 74 69 6f 6e 29 20  61 6e 64 20 74 68 65 20  |cation) and the |
00004810  73 65 63 6f 6e 64 20 77  6f 75 6c 64 20 6e 6f 74  |second would not|
00004820  20 62 65 63 61 75 73 65  20 46 69 6c 65 72 5f 52  | because Filer_R|
00004830  75 6e 20 64 6f 65 73 20  6e 6f 74 20 47 53 54 72  |un does not GSTr|
00004840  61 6e 73 20 69 74 73 0a  69 6e 70 75 74 2e 20 20  |ans its.input.  |
00004850  28 49 6e 20 66 61 63 74  20 74 68 65 20 73 65 63  |(In fact the sec|
00004860  6f 6e 64 20 63 6f 6d 6d  61 6e 64 20 77 6f 75 6c  |ond command woul|
00004870  64 20 68 61 76 65 20 6f  70 65 6e 65 64 20 61 20  |d have opened a |
00004880  64 69 72 65 63 74 6f 72  79 20 6f 6e 74 6f 20 74  |directory onto t|
00004890  68 65 0a 61 70 70 6c 69  63 61 74 69 6f 6e 20 66  |he.application f|
000048a0  6f 72 20 73 6f 6d 65 20  6f 62 73 63 75 72 65 20  |or some obscure |
000048b0  72 65 61 73 6f 6e 2c 20  77 69 74 68 20 74 68 65  |reason, with the|
000048c0  20 46 69 6c 65 72 20 74  69 74 6c 65 20 73 65 74  | Filer title set|
000048d0  20 74 6f 20 3c 4f 62 65  79 24 44 69 72 3e 0a 77  | to <Obey$Dir>.w|
000048e0  68 69 63 68 20 73 68 6f  75 6c 64 20 6e 6f 74 20  |hich should not |
000048f0  6e 6f 72 6d 61 6c 6c 79  20 62 65 20 61 6c 6c 6f  |normally be allo|
00004900  77 65 64 2e 29 0a 0a 0a  a4 20 53 70 65 63 69 61  |wed.).... Specia|
00004910  6c 20 66 6f 72 6d 73 20  6f 66 20 4d 65 6e 75 73  |l forms of Menus|
00004920  20 61 6e 64 20 43 6f 6d  6d 61 6e 64 73 0a 3d 3d  | and Commands.==|
00004930  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00004950  3d 3d 3d 0a 0a 57 68 65  6e 65 76 65 72 20 61 20  |===..Whenever a |
00004960  4d 65 6e 75 2c 20 53 75  62 4d 65 6e 75 20 6f 72  |Menu, SubMenu or|
00004970  20 43 6f 6d 6d 61 6e 64  20 69 73 20 73 70 65 63  | Command is spec|
00004980  69 66 69 65 64 20 69 74  20 6d 61 79 20 74 61 6b  |ified it may tak|
00004990  65 20 6f 6e 65 20 6f 66  20 73 65 76 65 72 61 6c  |e one of several|
000049a0  0a 73 70 65 63 69 61 6c  20 66 6f 72 6d 73 2e 20  |.special forms. |
000049b0  20 54 68 65 73 65 20 65  6e 61 62 6c 65 20 44 69  | These enable Di|
000049c0  72 65 63 74 6f 72 20 74  6f 20 62 65 20 6d 75 63  |rector to be muc|
000049d0  68 20 6d 6f 72 65 20 67  65 6e 65 72 61 6c 2c 20  |h more general, |
000049e0  72 75 6e 6e 69 6e 67 0a  63 6f 6d 6d 61 6e 64 73  |running.commands|
000049f0  20 69 6e 73 74 65 61 64  20 6f 66 20 6f 70 65 6e  | instead of open|
00004a00  69 6e 67 20 61 20 73 75  62 20 6d 65 6e 75 20 6f  |ing a sub menu o|
00004a10  72 20 76 69 63 65 20 76  65 72 73 61 2e 20 20 49  |r vice versa.  I|
00004a20  74 20 61 6c 73 6f 20 6d  65 61 6e 73 20 74 68 61  |t also means tha|
00004a30  74 0a 43 6f 6d 6d 61 6e  64 73 20 63 61 6e 20 62  |t.Commands can b|
00004a40  65 20 61 74 74 61 63 68  65 64 20 74 6f 20 63 6c  |e attached to cl|
00004a50  69 63 6b 73 20 6f 6e 20  69 63 6f 6e 73 20 61 73  |icks on icons as|
00004a60  20 77 65 6c 6c 20 61 73  20 6d 65 6e 75 73 2e 0a  | well as menus..|
00004a70  0a 57 68 65 6e 20 61 20  4d 65 6e 75 2c 20 53 75  |.When a Menu, Su|
00004a80  62 4d 65 6e 75 20 6f 72  20 43 6f 6d 6d 61 6e 64  |bMenu or Command|
00004a90  20 69 73 20 62 65 69 6e  67 20 70 72 6f 63 65 73  | is being proces|
00004aa0  73 65 64 2c 20 69 74 20  69 73 20 66 69 72 73 74  |sed, it is first|
00004ab0  20 63 68 65 63 6b 65 64  20 74 6f 0a 73 65 65 20  | checked to.see |
00004ac0  69 66 20 69 74 20 69 73  20 70 72 65 66 69 78 65  |if it is prefixe|
00004ad0  64 20 69 6e 20 6f 6e 65  20 6f 66 20 74 68 65 20  |d in one of the |
00004ae0  77 61 79 73 20 62 65 6c  6f 77 2e 20 20 49 66 20  |ways below.  If |
00004af0  69 74 20 69 73 20 74 68  65 6e 20 69 74 73 20 61  |it is then its a|
00004b00  63 74 69 6f 6e 20 69 73  0a 6d 6f 64 69 66 69 65  |ction is.modifie|
00004b10  64 2e 0a 0a 22 54 65 78  74 22 09 09 46 6f 72 20  |d..."Text"..For |
00004b20  6e 6f 72 6d 61 6c 20 63  6f 6d 6d 61 6e 64 20 6f  |normal command o|
00004b30  72 20 73 75 62 2d 6d 65  6e 75 20 28 69 65 20 61  |r sub-menu (ie a|
00004b40  63 74 69 6f 6e 20 75 6e  63 68 61 6e 67 65 64 29  |ction unchanged)|
00004b50  0a 0a 22 4d 65 6e 75 3a  4e 61 6d 65 22 09 54 6f  |.."Menu:Name".To|
00004b60  20 62 72 69 6e 67 20 75  70 20 6e 61 6d 65 64 20  | bring up named |
00004b70  6d 65 6e 75 0a 0a 22 53  61 76 65 3a 50 61 74 68  |menu.."Save:Path|
00004b80  22 09 46 6f 72 20 73 61  76 65 20 62 6f 78 20 6f  |".For save box o|
00004b90  66 20 74 68 65 20 67 69  76 65 6e 20 50 61 74 68  |f the given Path|
00004ba0  20 28 2a 29 0a 0a 22 50  61 74 68 3a 50 61 74 68  | (*).."Path:Path|
00004bb0  22 09 46 6f 72 20 61 20  64 69 72 65 63 74 6f 72  |".For a director|
00004bc0  79 20 6d 65 6e 75 20 6f  66 20 74 68 61 74 20 50  |y menu of that P|
00004bd0  61 74 68 20 28 2a 29 0a  0a 22 43 6f 6d 6d 61 6e  |ath (*).."Comman|
00004be0  64 3a 54 65 78 74 22 09  52 75 6e 73 20 74 68 65  |d:Text".Runs the|
00004bf0  20 54 65 78 74 20 61 73  20 69 66 20 69 74 20 77  | Text as if it w|
00004c00  65 72 65 20 61 20 63 6f  6d 6d 61 6e 64 0a 0a 22  |ere a command.."|
00004c10  51 75 69 74 3a 22 09 09  51 75 69 74 73 20 44 69  |Quit:"..Quits Di|
00004c20  72 65 63 74 6f 72 0a 0a  22 49 6e 66 6f 3a 22 09  |rector.."Info:".|
00004c30  09 42 72 69 6e 67 73 20  75 70 20 44 69 72 65 63  |.Brings up Direc|
00004c40  74 6f 72 27 73 20 69 6e  66 6f 20 77 69 6e 64 6f  |tor's info windo|
00004c50  77 0a 0a 22 4f 6c 64 4d  65 6e 75 3a 22 09 54 6f  |w.."OldMenu:".To|
00004c60  20 6f 70 65 6e 20 74 68  65 20 6c 61 73 74 20 66  | open the last f|
00004c70  69 6c 74 65 72 65 64 20  6d 65 6e 75 20 28 66 6f  |iltered menu (fo|
00004c80  72 20 67 65 74 74 69 6e  67 20 70 69 6e 62 6f 61  |r getting pinboa|
00004c90  72 64 20 6d 65 6e 75 29  0a 0a 22 4d 65 6e 75 4d  |rd menu).."MenuM|
00004ca0  65 6e 75 3a 50 61 74 68  22 09 54 61 6b 65 73 20  |enu:Path".Takes |
00004cb0  50 61 74 68 2c 20 61 64  64 73 20 2e 3c 6c 65 61  |Path, adds .<lea|
00004cc0  66 3e 20 74 6f 20 69 74  20 61 6e 64 20 6f 70 65  |f> to it and ope|
00004cd0  6e 73 20 74 68 65 20 4d  65 6e 75 4d 65 6e 75 0a  |ns the MenuMenu.|
00004ce0  09 09 70 6f 69 6e 74 69  6e 67 20 61 74 20 74 68  |..pointing at th|
00004cf0  61 74 20 66 69 6c 65 2e  20 20 55 73 65 64 20 69  |at file.  Used i|
00004d00  6e 74 65 72 6e 61 6c 6c  79 2e 20 28 2a 29 0a 0a  |nternally. (*)..|
00004d10  22 4d 65 6d 6f 72 69 73  65 72 3a 22 09 4f 70 65  |"Memoriser:".Ope|
00004d20  6e 73 20 61 20 6d 65 6e  75 20 6f 66 20 72 65 63  |ns a menu of rec|
00004d30  65 6e 74 6c 79 20 75 73  65 64 20 66 69 6c 65 73  |ently used files|
00004d40  2e 0a 09 09 28 53 65 65  20 4d 65 6d 6f 72 69 73  |....(See Memoris|
00004d50  65 72 20 73 65 63 74 69  6f 6e 2e 29 0a 0a 22 44  |er section.).."D|
00004d60  79 6e 61 6d 69 63 3a 54  65 78 74 22 09 52 75 6e  |ynamic:Text".Run|
00004d70  73 20 74 68 65 20 54 65  78 74 20 61 73 20 69 66  |s the Text as if|
00004d80  20 69 74 20 77 65 72 65  20 61 20 63 6f 6d 6d 61  | it were a comma|
00004d90  6e 64 2e 20 20 57 68 65  6e 20 74 68 65 20 63 6f  |nd.  When the co|
00004da0  6d 6d 61 6e 64 0a 09 09  72 65 74 75 72 6e 73 20  |mmand...returns |
00004db0  44 69 72 65 63 74 6f 72  20 74 72 69 65 73 20 74  |Director tries t|
00004dc0  6f 20 6f 70 65 6e 20 74  68 65 20 6d 65 6e 75 20  |o open the menu |
00004dd0  77 68 6f 73 65 20 6e 61  6d 65 20 69 73 20 69 6e  |whose name is in|
00004de0  0a 09 09 74 68 65 20 73  79 73 74 65 6d 20 76 61  |...the system va|
00004df0  72 69 61 62 6c 65 20 44  69 72 65 63 74 6f 72 24  |riable Director$|
00004e00  4d 65 6e 75 2e 0a 0a 22  47 53 54 72 61 6e 73 3a  |Menu..."GSTrans:|
00004e10  54 65 78 74 22 09 47 53  54 72 61 6e 73 65 73 20  |Text".GSTranses |
00004e20  74 68 65 20 54 65 78 74  20 61 6e 64 20 74 68 65  |the Text and the|
00004e30  6e 20 72 65 69 6e 74 65  72 70 72 65 74 73 20 69  |n reinterprets i|
00004e40  74 20 61 73 20 61 6e 20  65 78 74 65 6e 64 65 64  |t as an extended|
00004e50  0a 09 09 63 6f 6d 6d 61  6e 64 2e 0a 0a 28 2a 29  |...command...(*)|
00004e60  20 49 66 20 74 68 65 20  70 61 74 68 20 69 73 20  | If the path is |
00004e70  6d 69 73 73 69 6e 67 20  65 67 20 22 50 61 74 68  |missing eg "Path|
00004e80  3a 22 20 6f 72 20 22 53  61 76 65 3a 22 20 74 68  |:" or "Save:" th|
00004e90  65 6e 20 69 74 20 77 69  6c 6c 20 75 73 65 20 74  |en it will use t|
00004ea0  68 65 20 70 61 74 68 20  6f 66 0a 74 68 65 20 77  |he path of.the w|
00004eb0  69 6e 64 6f 77 20 74 68  61 74 20 74 68 65 20 70  |indow that the p|
00004ec0  6f 69 6e 74 65 72 20 69  73 20 6f 76 65 72 2e 20  |ointer is over. |
00004ed0  20 49 66 20 74 68 65 20  70 61 74 68 20 69 73 20  | If the path is |
00004ee0  70 72 65 73 65 6e 74 20  69 74 20 69 73 20 47 53  |present it is GS|
00004ef0  5f 54 72 61 6e 73 65 64  0a 62 65 66 6f 72 65 20  |_Transed.before |
00004f00  75 73 65 2e 0a 0a 46 6f  72 20 65 78 61 6d 70 6c  |use...For exampl|
00004f10  65 0a 0a 09 4f 70 74 69  6f 6e 20 22 46 6c 6f 70  |e...Option "Flop|
00004f20  70 79 22 20 2d 73 75 62  20 22 50 61 74 68 3a 41  |py" -sub "Path:A|
00004f30  44 46 53 3a 3a 30 2e 24  22 0a 0a 54 68 69 73 20  |DFS::0.$"..This |
00004f40  77 69 6c 6c 20 6d 61 6b  65 20 61 20 64 69 72 65  |will make a dire|
00004f50  63 74 6f 72 79 20 6d 65  6e 75 20 6f 66 20 74 68  |ctory menu of th|
00004f60  65 20 66 6c 6f 70 70 79  20 64 69 73 63 20 64 72  |e floppy disc dr|
00004f70  69 76 65 20 69 66 20 79  6f 75 20 63 6c 69 63 6b  |ive if you click|
00004f80  20 6f 6e 20 74 68 65 0a  6f 70 74 69 6f 6e 20 6f  | on the.option o|
00004f90  72 20 6d 6f 76 65 20 74  68 65 20 70 6f 69 6e 74  |r move the point|
00004fa0  65 72 20 6f 76 65 72 20  74 68 65 20 53 75 62 4d  |er over the SubM|
00004fb0  65 6e 75 2e 20 20 54 68  69 73 20 69 73 20 62 65  |enu.  This is be|
00004fc0  74 74 65 72 20 74 68 61  6e 0a 0a 09 4f 70 74 69  |tter than...Opti|
00004fd0  6f 6e 20 22 46 6c 6f 70  70 79 22 20 2d 70 61 74  |on "Floppy" -pat|
00004fe0  68 20 41 44 46 53 3a 3a  30 2e 24 0a 0a 62 65 63  |h ADFS::0.$..bec|
00004ff0  61 75 73 65 20 74 68 69  73 20 77 69 6c 6c 20 70  |ause this will p|
00005000  72 6f 64 75 63 65 20 61  20 67 72 65 79 65 64 20  |roduce a greyed |
00005010  6f 75 74 20 70 61 74 68  20 77 69 74 68 20 61 6e  |out path with an|
00005020  20 75 6e 6b 6e 6f 77 6e  20 66 69 6c 65 20 69 63  | unknown file ic|
00005030  6f 6e 20 69 66 20 74 68  65 0a 66 6c 6f 70 70 79  |on if the.floppy|
00005040  20 69 73 20 65 6d 70 74  79 20 77 68 65 6e 20 74  | is empty when t|
00005050  68 65 20 4f 70 74 69 6f  6e 20 69 73 20 72 75 6e  |he Option is run|
00005060  2e 0a 0a 09 4f 70 74 69  6f 6e 20 22 52 6f 6f 74  |....Option "Root|
00005070  22 20 2d 73 75 62 20 22  43 6f 6d 6d 61 6e 64 3a  |" -sub "Command:|
00005080  46 69 6c 65 72 5f 4f 70  65 6e 44 69 72 20 41 44  |Filer_OpenDir AD|
00005090  46 53 3a 3a 34 2e 24 22  0a 0a 54 68 69 73 20 77  |FS::4.$"..This w|
000050a0  69 6c 6c 20 6f 70 65 6e  20 61 20 66 69 6c 65 72  |ill open a filer|
000050b0  20 77 69 6e 64 6f 77 20  6f 66 20 79 6f 75 72 20  | window of your |
000050c0  72 6f 6f 74 20 64 69 72  65 63 74 6f 72 79 20 69  |root directory i|
000050d0  66 20 79 6f 75 20 63 6c  69 63 6b 20 6f 6e 20 74  |f you click on t|
000050e0  68 65 0a 6f 70 74 69 6f  6e 20 6f 72 20 6d 6f 76  |he.option or mov|
000050f0  65 20 74 68 65 20 70 6f  69 6e 74 65 72 20 6f 76  |e the pointer ov|
00005100  65 72 20 74 68 65 20 53  75 62 4d 65 6e 75 2e 0a  |er the SubMenu..|
00005110  0a 09 4f 70 74 69 6f 6e  20 22 50 69 6e 62 6f 61  |..Option "Pinboa|
00005120  72 64 22 20 2d 73 75 62  20 22 4f 6c 64 4d 65 6e  |rd" -sub "OldMen|
00005130  75 3a 22 0a 0a 54 68 69  73 20 77 69 6c 6c 20 6f  |u:"..This will o|
00005140  70 65 6e 20 74 68 65 20  6d 65 6e 75 20 74 68 61  |pen the menu tha|
00005150  74 20 73 68 6f 75 6c 64  20 68 61 76 65 20 62 65  |t should have be|
00005160  65 6e 20 6f 70 65 6e 65  64 20 77 68 65 6e 20 79  |en opened when y|
00005170  6f 75 20 63 6c 69 63 6b  65 64 20 74 68 65 0a 70  |ou clicked the.p|
00005180  6f 69 6e 74 65 72 2e 20  20 53 6f 20 69 66 20 79  |ointer.  So if y|
00005190  6f 75 20 6f 70 65 6e 65  64 20 74 68 65 20 6d 65  |ou opened the me|
000051a0  6e 75 20 6f 76 65 72 20  74 68 65 20 70 69 6e 62  |nu over the pinb|
000051b0  6f 61 72 64 2c 20 62 75  74 20 77 61 6e 74 65 64  |oard, but wanted|
000051c0  20 74 6f 20 73 65 65 20  74 68 65 0a 70 69 6e 62  | to see the.pinb|
000051d0  6f 61 72 64 20 6d 65 6e  75 20 74 68 65 6e 20 79  |oard menu then y|
000051e0  6f 75 20 63 6f 75 6c 64  20 63 6c 69 63 6b 20 6f  |ou could click o|
000051f0  72 20 73 6c 69 64 65 20  74 68 69 73 20 6f 70 74  |r slide this opt|
00005200  69 6f 6e 2e 0a 0a 09 4f  70 74 69 6f 6e 20 48 65  |ion....Option He|
00005210  72 65 20 2d 73 75 62 20  22 50 61 74 68 3a 3c 44  |re -sub "Path:<D|
00005220  69 72 65 63 74 6f 72 24  43 75 72 72 65 6e 74 44  |irector$CurrentD|
00005230  69 72 3e 22 0a 09 4f 70  74 69 6f 6e 20 43 6f 70  |ir>"..Option Cop|
00005240  79 20 2d 73 75 62 20 22  53 61 76 65 3a 3c 44 69  |y -sub "Save:<Di|
00005250  72 65 63 74 6f 72 24 43  75 72 72 65 6e 74 50 61  |rector$CurrentPa|
00005260  74 68 3e 22 0a 0a 54 68  65 73 65 20 6f 70 74 69  |th>"..These opti|
00005270  6f 6e 73 20 61 72 65 20  75 73 65 66 75 6c 20 66  |ons are useful f|
00005280  6f 72 20 74 68 65 20 4d  65 6e 75 4d 65 6e 75 20  |or the MenuMenu |
00005290  28 73 65 65 20 74 68 65  20 73 65 63 74 69 6f 6e  |(see the section|
000052a0  20 74 69 74 6c 65 64 20  4d 65 6e 75 4d 65 6e 75  | titled MenuMenu|
000052b0  0a 61 6e 64 20 74 68 65  20 73 65 63 74 69 6f 6e  |.and the section|
000052c0  20 74 69 74 6c 65 64 20  53 61 76 65 42 6f 78 29  | titled SaveBox)|
000052d0  2e 0a 0a 09 4f 70 74 69  6f 6e 20 49 6e 66 6f 20  |....Option Info |
000052e0  2d 73 75 62 20 49 6e 66  6f 3a 0a 09 4f 70 74 69  |-sub Info:..Opti|
000052f0  6f 6e 20 51 75 69 74 0a  09 09 43 6f 6d 6d 61 6e  |on Quit...Comman|
00005300  64 20 51 75 69 74 3a 0a  0a 48 65 6c 70 73 20 62  |d Quit:..Helps b|
00005310  72 69 6e 67 20 61 6e 20  61 69 72 20 6f 66 20 6e  |ring an air of n|
00005320  6f 72 6d 61 6c 69 74 79  20 74 6f 20 44 69 72 65  |ormality to Dire|
00005330  63 74 6f 72 20 62 79 20  70 72 6f 76 69 64 69 6e  |ctor by providin|
00005340  67 20 74 68 65 20 73 74  61 6e 64 61 72 64 20 51  |g the standard Q|
00005350  75 69 74 0a 61 6e 64 20  49 6e 66 6f 20 63 68 6f  |uit.and Info cho|
00005360  69 63 65 73 21 0a 0a 0a  a4 20 4d 65 6d 6f 72 69  |ices!.... Memori|
00005370  73 65 72 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |ser.===========.|
00005380  0a 44 69 72 65 63 74 6f  72 20 6e 6f 74 69 63 65  |.Director notice|
00005390  73 20 77 68 65 6e 65 76  65 72 20 79 6f 75 20 6c  |s whenever you l|
000053a0  6f 61 64 20 61 20 66 69  6c 65 20 6f 72 20 63 6c  |oad a file or cl|
000053b0  69 63 6b 20 6f 6e 20 61  20 64 72 69 76 65 20 61  |ick on a drive a|
000053c0  6e 64 20 6b 65 65 70 73  20 61 0a 72 65 63 6f 72  |nd keeps a.recor|
000053d0  64 20 6f 66 20 74 68 65  20 66 61 63 74 2e 0a 0a  |d of the fact...|
000053e0  49 66 20 79 6f 75 20 74  68 65 6e 20 61 73 6b 20  |If you then ask |
000053f0  66 6f 72 20 74 68 65 20  6d 65 6e 75 20 4d 65 6d  |for the menu Mem|
00005400  6f 72 69 73 65 72 3a 20  74 6f 20 62 65 20 6f 70  |oriser: to be op|
00005410  65 6e 65 64 20 74 68 65  6e 20 79 6f 75 20 77 69  |ened then you wi|
00005420  6c 6c 20 67 65 74 20 61  20 6d 65 6e 75 0a 77 69  |ll get a menu.wi|
00005430  74 68 20 74 68 65 73 65  20 66 69 6c 65 73 20 6f  |th these files o|
00005440  72 20 64 69 72 65 63 74  6f 72 69 65 73 20 69 6e  |r directories in|
00005450  20 69 74 2e 0a 0a 54 68  69 73 20 61 63 74 73 20  | it...This acts |
00005460  65 78 61 63 74 6c 79 20  6c 69 6b 65 20 61 20 6e  |exactly like a n|
00005470  6f 72 6d 61 6c 20 64 69  72 65 63 74 6f 72 79 20  |ormal directory |
00005480  4d 65 6e 75 2c 20 65 78  63 65 70 74 20 69 74 20  |Menu, except it |
00005490  68 61 73 20 61 6c 6c 20  79 6f 75 72 20 6d 6f 73  |has all your mos|
000054a0  74 0a 72 65 63 65 6e 74  6c 79 20 75 73 65 64 20  |t.recently used |
000054b0  66 69 6c 65 73 2f 64 69  72 65 63 74 6f 72 69 65  |files/directorie|
000054c0  73 20 69 6e 20 69 74 2e  0a 0a 54 68 69 73 20 69  |s in it...This i|
000054d0  73 20 65 78 63 65 65 64  69 6e 67 6c 79 20 75 73  |s exceedingly us|
000054e0  65 66 75 6c 20 77 68 65  6e 20 79 6f 75 20 74 72  |eful when you tr|
000054f0  61 76 65 72 73 65 20 61  20 6c 61 72 67 65 20 64  |averse a large d|
00005500  69 72 65 63 74 6f 72 79  20 74 72 65 65 2c 20 6f  |irectory tree, o|
00005510  70 65 6e 20 61 0a 66 69  6c 65 20 74 6f 20 68 61  |pen a.file to ha|
00005520  76 65 20 61 20 6c 6f 6f  6b 20 61 74 20 69 74 2c  |ve a look at it,|
00005530  20 63 6c 6f 73 65 20 69  74 2c 20 61 6e 64 20 74  | close it, and t|
00005540  68 65 6e 20 72 65 61 6c  69 73 65 20 74 68 61 74  |hen realise that|
00005550  20 79 6f 75 20 77 61 6e  74 20 74 6f 20 73 65 65  | you want to see|
00005560  0a 74 68 65 20 66 69 6c  65 20 61 67 61 69 6e 2e  |.the file again.|
00005570  20 20 41 6c 6c 20 79 6f  75 20 68 61 76 65 20 74  |  All you have t|
00005580  6f 20 64 6f 20 69 73 20  6f 70 65 6e 20 74 68 65  |o do is open the|
00005590  20 4d 65 6d 6f 72 69 73  65 72 20 6d 65 6e 75 20  | Memoriser menu |
000055a0  61 6e 64 20 69 74 20 77  69 6c 6c 20 62 65 0a 74  |and it will be.t|
000055b0  68 65 72 65 20 73 69 74  74 69 6e 67 20 61 74 20  |here sitting at |
000055c0  74 68 65 20 74 6f 70 2e  20 20 49 66 20 69 6e 20  |the top.  If in |
000055d0  74 68 65 20 6d 65 61 6e  20 74 69 6d 65 20 79 6f  |the mean time yo|
000055e0  75 20 68 61 76 65 20 64  65 6c 65 74 65 64 20 74  |u have deleted t|
000055f0  68 65 20 66 69 6c 65 20  74 68 65 6e 0a 69 74 20  |he file then.it |
00005600  77 69 6c 6c 20 6e 6f 74  20 62 65 20 73 68 6f 77  |will not be show|
00005610  6e 20 69 6e 20 74 68 65  20 6d 65 6e 75 2e 0a 0a  |n in the menu...|
00005620  49 74 20 69 73 20 70 6f  73 73 69 62 6c 65 20 74  |It is possible t|
00005630  6f 20 6d 61 6b 65 20 74  68 65 20 6d 65 6d 6f 72  |o make the memor|
00005640  69 73 65 72 20 64 69 73  70 6c 61 79 20 6f 6e 6c  |iser display onl|
00005650  79 20 61 70 70 6c 69 63  61 74 69 6f 6e 73 2c 20  |y applications, |
00005660  64 69 72 65 63 74 6f 72  69 65 73 0a 6f 72 20 66  |directories.or f|
00005670  69 6c 65 73 20 62 79 20  61 64 64 69 6e 67 20 61  |iles by adding a|
00005680  20 6e 75 6d 65 72 69 63  20 70 61 72 61 6d 65 74  | numeric paramet|
00005690  65 72 20 61 66 74 65 72  20 74 68 65 20 4d 65 6d  |er after the Mem|
000056a0  6f 72 69 73 65 72 3a 0a  0a 09 4d 65 6d 6f 72 69  |oriser:...Memori|
000056b0  73 65 72 3a 31 20 2d 20  6d 65 6d 6f 72 69 73 65  |ser:1 - memorise|
000056c0  72 20 73 68 6f 77 73 20  61 70 70 6c 69 63 61 74  |r shows applicat|
000056d0  69 6f 6e 73 0a 09 4d 65  6d 6f 72 69 73 65 72 3a  |ions..Memoriser:|
000056e0  32 20 2d 20 6d 65 6d 6f  72 69 73 65 72 20 73 68  |2 - memoriser sh|
000056f0  6f 77 73 20 64 69 72 65  63 74 6f 72 69 65 73 20  |ows directories |
00005700  61 6e 64 20 69 6d 61 67  65 73 0a 09 4d 65 6d 6f  |and images..Memo|
00005710  72 69 73 65 72 3a 34 20  2d 20 6d 65 6d 6f 72 69  |riser:4 - memori|
00005720  73 65 72 20 73 68 6f 77  73 20 66 69 6c 65 73 0a  |ser shows files.|
00005730  0a 54 68 65 20 70 61 72  61 6d 65 74 65 72 73 20  |.The parameters |
00005740  63 61 6e 20 62 65 20 63  6f 6d 62 69 6e 65 64 20  |can be combined |
00005750  69 6e 20 61 20 6c 69 6e  65 61 72 20 66 61 73 68  |in a linear fash|
00005760  69 6f 6e 2c 20 65 67 20  4d 65 6d 6f 72 69 73 65  |ion, eg Memorise|
00005770  72 3a 36 20 73 68 6f 77  73 0a 64 69 72 65 63 74  |r:6 shows.direct|
00005780  6f 72 69 65 73 2c 20 69  6d 61 67 65 73 20 61 6e  |ories, images an|
00005790  64 20 61 70 70 6c 69 63  61 74 69 6f 6e 73 20 62  |d applications b|
000057a0  75 74 20 6e 6f 74 20 66  69 6c 65 73 2e 0a 0a 54  |ut not files...T|
000057b0  68 65 20 74 6f 74 61 6c  20 6e 75 6d 62 65 72 20  |he total number |
000057c0  6f 66 20 69 74 65 6d 73  20 74 68 61 74 20 61 72  |of items that ar|
000057d0  65 20 6b 65 70 74 20 69  6e 20 74 68 65 20 4d 65  |e kept in the Me|
000057e0  6d 6f 72 69 73 65 72 20  6d 65 6e 75 20 69 73 20  |moriser menu is |
000057f0  64 65 66 69 6e 61 62 6c  65 0a 77 69 74 68 20 74  |definable.with t|
00005800  68 65 20 63 6f 6d 6d 61  6e 64 0a 0a 09 53 79 6e  |he command...Syn|
00005810  74 61 78 3a 20 4d 65 6d  6f 72 69 73 65 72 49 74  |tax: MemoriserIt|
00005820  65 6d 73 20 3c 6e 75 6d  62 65 72 3e 0a 0a 54 68  |ems <number>..Th|
00005830  69 73 20 77 69 6c 6c 20  6e 6f 74 20 61 66 66 65  |is will not affe|
00005840  63 74 20 74 68 65 20 63  75 72 72 65 6e 74 6c 79  |ct the currently|
00005850  20 62 75 69 6c 74 20 75  70 20 6e 75 6d 62 65 72  | built up number|
00005860  20 6f 66 20 69 74 65 6d  73 2e 20 20 49 66 20 79  | of items.  If y|
00005870  6f 75 20 73 65 74 20 69  74 0a 74 6f 20 30 20 74  |ou set it.to 0 t|
00005880  68 65 6e 20 6e 6f 20 6d  6f 72 65 20 69 74 65 6d  |hen no more item|
00005890  73 20 77 69 6c 6c 20 62  65 20 61 64 64 65 64 20  |s will be added |
000058a0  74 6f 20 74 68 65 20 6d  65 6e 75 2e 20 20 54 68  |to the menu.  Th|
000058b0  69 73 20 65 66 66 65 63  74 69 76 65 6c 79 20 74  |is effectively t|
000058c0  75 72 6e 73 0a 74 68 65  20 66 65 61 74 75 72 65  |urns.the feature|
000058d0  20 6f 66 66 2e 20 20 30  20 69 73 20 74 68 65 20  | off.  0 is the |
000058e0  64 65 66 61 75 6c 74 20  76 61 6c 75 65 2e 0a 0a  |default value...|
000058f0  59 6f 75 20 63 61 6e 20  73 61 76 65 20 61 6e 64  |You can save and|
00005900  20 72 65 73 74 6f 72 65  20 74 68 65 20 6d 65 6d  | restore the mem|
00005910  6f 72 69 73 65 72 20 77  69 74 68 0a 0a 09 4d 65  |oriser with...Me|
00005920  6d 6f 72 69 73 65 72 53  61 76 65 20 3c 66 69 6c  |moriserSave <fil|
00005930  65 3e 0a 09 4d 65 6d 6f  72 69 73 65 72 4c 6f 61  |e>..MemoriserLoa|
00005940  64 20 3c 66 69 6c 65 3e  0a 0a 54 68 69 73 20 77  |d <file>..This w|
00005950  69 6c 6c 20 73 61 76 65  20 74 68 65 20 63 6f 6e  |ill save the con|
00005960  74 65 6e 74 73 20 6f 66  20 74 68 65 20 6d 65 6d  |tents of the mem|
00005970  6f 72 69 73 65 72 20 6f  72 20 72 65 70 6c 61 63  |oriser or replac|
00005980  65 20 69 74 20 77 69 74  68 20 74 68 61 74 20 69  |e it with that i|
00005990  6e 20 74 68 65 0a 66 69  6c 65 2e 20 20 54 68 65  |n the.file.  The|
000059a0  20 66 69 6c 65 20 69 73  20 61 20 73 69 6d 70 6c  | file is a simpl|
000059b0  65 20 74 65 78 74 20 66  69 6c 65 20 77 69 74 68  |e text file with|
000059c0  20 61 20 66 69 6c 65 20  70 61 74 68 20 6f 6e 20  | a file path on |
000059d0  65 61 63 68 20 6c 69 6e  65 2e 20 20 59 6f 75 0a  |each line.  You.|
000059e0  63 6f 75 6c 64 20 75 73  65 20 74 68 69 73 20 74  |could use this t|
000059f0  6f 20 70 72 69 6d 65 20  74 68 65 20 6d 65 6d 6f  |o prime the memo|
00005a00  72 69 73 65 72 20 77 69  74 68 20 6f 66 74 65 6e  |riser with often|
00005a10  20 75 73 65 64 20 66 69  6c 65 73 20 6f 72 20 74  | used files or t|
00005a20  6f 20 73 61 76 65 20 61  6e 64 0a 72 65 73 74 6f  |o save and.resto|
00005a30  72 65 20 69 74 2e 0a 0a  0a a4 20 4d 65 6e 75 4d  |re it..... MenuM|
00005a40  65 6e 75 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |enu.==========..|
00005a50  41 20 6d 65 6e 75 20 77  69 74 68 20 6e 61 6d 65  |A menu with name|
00005a60  20 64 65 66 69 6e 65 64  20 62 79 20 74 68 65 20  | defined by the |
00005a70  73 79 73 74 65 6d 20 76  61 72 69 61 62 6c 65 20  |system variable |
00005a80  44 69 72 65 63 74 6f 72  24 4d 65 6e 75 4d 65 6e  |Director$MenuMen|
00005a90  75 20 28 64 65 66 69 6e  65 64 20 62 79 0a 79 6f  |u (defined by.yo|
00005aa0  75 29 20 69 73 20 6f 70  65 6e 65 64 20 77 68 65  |u) is opened whe|
00005ab0  6e 65 76 65 72 20 79 6f  75 20 63 6c 69 63 6b 20  |never you click |
00005ac0  4d 65 6e 75 20 6f 6e 20  61 20 70 61 74 68 20 69  |Menu on a path i|
00005ad0  74 65 6d 20 6f 72 20 63  6c 69 63 6b 20 4d 65 6e  |tem or click Men|
00005ae0  75 20 6f 6e 20 74 68 65  0a 73 65 63 6f 6e 64 20  |u on the.second |
00005af0  6f 70 74 69 6f 6e 20 69  6e 20 61 20 46 69 6c 65  |option in a File|
00005b00  72 20 4d 65 6e 75 20 28  74 68 65 20 6f 6e 65 20  |r Menu (the one |
00005b10  74 68 61 74 20 72 65 61  64 73 20 22 46 69 6c 65  |that reads "File|
00005b20  20 27 21 52 75 6e 27 22  20 6f 72 0a 22 53 65 6c  | '!Run'" or."Sel|
00005b30  65 63 74 69 6f 6e 22 29  20 70 72 6f 76 69 64 65  |ection") provide|
00005b40  64 20 6f 6e 65 20 61 6e  64 20 6f 6e 6c 79 20 6f  |d one and only o|
00005b50  6e 65 20 66 69 6c 65 20  69 73 20 73 65 6c 65 63  |ne file is selec|
00005b60  74 65 64 20 69 6e 20 74  68 65 20 46 69 6c 65 72  |ted in the Filer|
00005b70  20 77 69 6e 64 6f 77 2e  0a 0a 54 68 69 73 20 6d  | window...This m|
00005b80  65 6e 75 20 64 65 61 6c  73 20 77 69 74 68 20 66  |enu deals with f|
00005b90  69 6c 65 73 20 61 6e 64  20 64 69 72 65 63 74 6f  |iles and directo|
00005ba0  72 69 65 73 2e 20 20 59  6f 75 20 73 68 6f 75 6c  |ries.  You shoul|
00005bb0  64 20 70 75 74 20 6f 6e  20 69 74 20 74 68 69 6e  |d put on it thin|
00005bc0  67 73 0a 77 68 69 63 68  20 79 6f 75 20 77 61 6e  |gs.which you wan|
00005bd0  74 20 74 6f 20 64 6f 20  74 6f 20 66 69 6c 65 73  |t to do to files|
00005be0  2e 0a 0a 48 65 72 65 20  69 73 20 61 6e 20 65 78  |...Here is an ex|
00005bf0  61 6d 70 6c 65 20 6f 66  20 61 20 4d 65 6e 75 4d  |ample of a MenuM|
00005c00  65 6e 75 0a 0a 53 65 74  20 44 69 72 65 63 74 6f  |enu..Set Directo|
00005c10  72 24 4d 65 6e 75 4d 65  6e 75 20 4d 65 6e 75 4d  |r$MenuMenu MenuM|
00005c20  65 6e 75 0a 0a 4d 65 6e  75 20 22 46 69 6c 65 a0  |enu..Menu "File.|
00005c30  4d 65 6e 75 22 20 22 4d  65 6e 75 4d 65 6e 75 22  |Menu" "MenuMenu"|
00005c40  0a 09 4f 70 74 69 6f 6e  20 48 65 72 65 20 2d 73  |..Option Here -s|
00005c50  75 62 20 22 50 61 74 68  3a 7c 3c 44 69 72 65 63  |ub "Path:|<Direc|
00005c60  74 6f 72 24 43 75 72 72  65 6e 74 44 69 72 3e 22  |tor$CurrentDir>"|
00005c70  0a 0a 54 68 69 73 20 61  6c 6c 6f 77 73 20 79 6f  |..This allows yo|
00005c80  75 20 74 6f 20 73 65 65  20 61 20 64 69 72 65 63  |u to see a direc|
00005c90  74 6f 72 79 20 4d 65 6e  75 20 6f 66 20 77 68 65  |tory Menu of whe|
00005ca0  72 65 20 74 68 65 20 73  65 6c 65 63 74 65 64 20  |re the selected |
00005cb0  66 69 6c 65 20 6f 72 0a  64 69 72 65 63 74 6f 72  |file or.director|
00005cc0  79 20 69 73 2e 20 20 28  53 65 65 20 74 68 65 20  |y is.  (See the |
00005cd0  73 65 63 74 69 6f 6e 20  6f 6e 20 47 53 54 72 61  |section on GSTra|
00005ce0  6e 73 20 66 6f 72 20 74  68 65 20 72 65 61 73 6f  |ns for the reaso|
00005cf0  6e 20 62 65 68 69 6e 64  20 74 68 65 20 7c 20 69  |n behind the | i|
00005d00  6e 20 74 68 65 0a 2d 73  75 62 20 73 74 72 69 6e  |n the.-sub strin|
00005d10  67 2e 29 0a 0a 09 4f 70  74 69 6f 6e 20 43 6f 70  |g.)...Option Cop|
00005d20  79 20 2d 73 75 62 20 22  53 61 76 65 3a 7c 3c 44  |y -sub "Save:|<D|
00005d30  69 72 65 63 74 6f 72 24  43 75 72 72 65 6e 74 50  |irector$CurrentP|
00005d40  61 74 68 3e 22 0a 0a 54  68 69 73 20 61 6c 6c 6f  |ath>"..This allo|
00005d50  77 73 20 74 68 65 20 63  75 72 72 65 6e 74 20 66  |ws the current f|
00005d60  69 6c 65 20 6f 72 20 64  69 72 65 63 74 6f 72 79  |ile or directory|
00005d70  20 74 6f 20 62 65 20 63  6f 70 69 65 64 20 74 6f  | to be copied to|
00005d80  20 61 20 66 69 6c 65 72  20 77 69 6e 64 6f 77 2c  | a filer window,|
00005d90  0a 64 72 61 67 67 65 64  20 74 6f 20 61 6e 20 61  |.dragged to an a|
00005da0  70 70 6c 69 63 61 74 69  6f 6e 20 6f 72 20 70 69  |pplication or pi|
00005db0  6e 6e 65 64 20 74 6f 20  74 68 65 20 70 69 6e 62  |nned to the pinb|
00005dc0  6f 61 72 64 20 28 64 72  61 67 20 74 68 65 20 69  |oard (drag the i|
00005dd0  63 6f 6e 20 6f 6e 74 6f  20 74 68 65 0a 70 69 6e  |con onto the.pin|
00005de0  62 6f 61 72 64 29 2e 0a  0a 09 4f 70 74 69 6f 6e  |board)....Option|
00005df0  20 22 53 65 74 20 43 53  44 22 0a 09 09 43 6f 6d  | "Set CSD"...Com|
00005e00  6d 61 6e 64 20 44 69 72  20 3c 44 69 72 65 63 74  |mand Dir <Direct|
00005e10  6f 72 24 43 75 72 72 65  6e 74 44 69 72 3e 0a 0a  |or$CurrentDir>..|
00005e20  53 65 74 73 20 74 68 65  20 43 75 72 72 65 6e 74  |Sets the Current|
00005e30  20 44 69 72 65 63 74 6f  72 79 20 74 6f 20 74 68  | Directory to th|
00005e40  65 20 64 69 72 65 63 74  6f 72 79 20 69 6e 20 77  |e directory in w|
00005e50  68 69 63 68 20 74 68 65  20 66 69 6c 65 20 6f 72  |hich the file or|
00005e60  20 64 69 72 65 63 74 6f  72 79 0a 77 61 73 20 66  | directory.was f|
00005e70  6f 75 6e 64 2e 0a 0a 09  4f 70 74 69 6f 6e 20 22  |ound....Option "|
00005e80  4f 70 65 6e 20 44 69 72  65 63 74 6f 72 79 22 0a  |Open Directory".|
00005e90  09 09 43 6f 6d 6d 61 6e  64 20 46 69 6c 65 72 5f  |..Command Filer_|
00005ea0  4f 70 65 6e 44 69 72 20  3c 44 69 72 65 63 74 6f  |OpenDir <Directo|
00005eb0  72 24 43 75 72 72 65 6e  74 44 69 72 3e 0a 0a 54  |r$CurrentDir>..T|
00005ec0  68 69 73 20 6f 70 65 6e  73 20 61 20 46 69 6c 65  |his opens a File|
00005ed0  72 20 57 69 6e 64 6f 77  20 6f 6e 74 6f 20 74 68  |r Window onto th|
00005ee0  65 20 64 69 72 65 63 74  6f 72 79 20 69 6e 20 77  |e directory in w|
00005ef0  68 69 63 68 20 74 68 65  20 66 69 6c 65 20 6f 72  |hich the file or|
00005f00  20 64 69 72 65 63 74 6f  72 79 0a 77 61 73 20 66  | directory.was f|
00005f10  6f 75 6e 64 2e 0a 0a 09  4f 70 74 69 6f 6e 20 22  |ound....Option "|
00005f20  46 69 6c 65 72 5f 52 75  6e 22 0a 09 09 43 6f 6d  |Filer_Run"...Com|
00005f30  6d 61 6e 64 20 46 69 6c  65 72 5f 52 75 6e 20 3c  |mand Filer_Run <|
00005f40  44 69 72 65 63 74 6f 72  24 43 75 72 72 65 6e 74  |Director$Current|
00005f50  50 61 74 68 3e 0a 0a 54  68 69 73 20 69 73 20 65  |Path>..This is e|
00005f60  71 75 69 76 61 6c 65 6e  74 20 74 6f 20 64 6f 75  |quivalent to dou|
00005f70  62 6c 65 20 63 6c 69 63  6b 69 6e 67 20 6f 6e 20  |ble clicking on |
00005f80  74 68 65 20 46 69 6c 65  20 6f 72 20 44 69 72 65  |the File or Dire|
00005f90  63 74 6f 72 79 2e 0a 0a  09 4f 70 74 69 6f 6e 20  |ctory....Option |
00005fa0  22 50 69 6e 22 0a 09 09  43 6f 6d 6d 61 6e 64 20  |"Pin"...Command |
00005fb0  53 57 49 20 4f 53 5f 4d  6f 75 73 65 20 54 4f 20  |SWI OS_Mouse TO |
00005fc0  78 20 79 7c 4d 0a 09 09  09 50 69 6e 20 3c 44 69  |x y|M....Pin <Di|
00005fd0  72 65 63 74 6f 72 24 43  75 72 72 65 6e 74 50 61  |rector$CurrentPa|
00005fe0  74 68 3e 20 7c 3c 78 3e  2d 39 30 20 7c 3c 79 3e  |th> |<x>-90 |<y>|
00005ff0  2b 34 35 0a 0a 54 68 69  73 20 70 69 6e 73 20 74  |+45..This pins t|
00006000  68 65 20 66 69 6c 65 20  6f 72 20 44 69 72 65 63  |he file or Direc|
00006010  74 6f 72 79 20 74 6f 20  74 68 65 20 70 69 6e 62  |tory to the pinb|
00006020  6f 61 72 64 2e 20 28 54  68 65 20 63 6f 6d 6d 61  |oard. (The comma|
00006030  6e 64 20 73 68 6f 75 6c  64 20 62 65 0a 77 72 69  |nd should be.wri|
00006040  74 74 65 6e 20 61 6c 6c  20 6f 6e 20 6f 6e 65 20  |tten all on one |
00006050  6c 69 6e 65 29 2e 20 20  49 74 20 75 73 65 73 20  |line).  It uses |
00006060  74 68 65 20 53 57 49 20  4d 6f 64 75 6c 65 20 74  |the SWI Module t|
00006070  6f 20 72 65 61 64 20 74  68 65 20 63 75 72 72 65  |o read the curre|
00006080  6e 74 0a 70 6f 73 69 74  69 6f 6e 20 6f 66 20 74  |nt.position of t|
00006090  68 65 20 6d 6f 75 73 65  20 61 6e 64 20 74 68 65  |he mouse and the|
000060a0  6e 20 70 69 6e 73 20 74  68 65 20 63 65 6e 74 72  |n pins the centr|
000060b0  65 20 6f 66 20 74 68 65  20 69 63 6f 6e 20 74 68  |e of the icon th|
000060c0  65 72 65 2e 20 20 28 4e  6f 74 65 20 74 68 65 0a  |ere.  (Note the.|
000060d0  7c 3c 78 3e 2c 20 74 68  69 73 20 69 73 20 47 53  ||<x>, this is GS|
000060e0  54 72 61 6e 73 65 64 20  74 6f 20 61 74 20 72 75  |Transed to at ru|
000060f0  6e 20 74 69 6d 65 20 3c  78 3e 20 77 68 65 6e 20  |n time <x> when |
00006100  74 68 65 20 43 6f 6d 6d  61 6e 64 20 69 73 20 62  |the Command is b|
00006110  65 69 6e 67 0a 70 72 65  70 61 72 65 64 2c 20 77  |eing.prepared, w|
00006120  68 69 63 68 20 69 73 20  74 68 65 6e 20 47 53 54  |hich is then GST|
00006130  72 61 6e 73 65 64 20 74  6f 20 74 68 65 20 6d 6f  |ransed to the mo|
00006140  75 73 65 20 78 20 63 6f  2d 6f 72 64 69 6e 61 74  |use x co-ordinat|
00006150  65 20 77 68 65 6e 20 74  68 65 20 50 69 6e 0a 63  |e when the Pin.c|
00006160  6f 6d 6d 61 6e 64 20 69  73 20 72 75 6e 2e 29 0a  |ommand is run.).|
00006170  0a 09 4f 70 74 69 6f 6e  20 22 49 63 6f 6e 53 70  |..Option "IconSp|
00006180  72 69 74 65 73 22 0a 09  09 43 6f 6d 6d 61 6e 64  |rites"...Command|
00006190  20 49 63 6f 6e 53 70 72  69 74 65 73 20 3c 44 69  | IconSprites <Di|
000061a0  72 65 63 74 6f 72 24 43  75 72 72 65 6e 74 50 61  |rector$CurrentPa|
000061b0  74 68 3e 0a 0a 54 68 69  73 20 49 63 6f 6e 53 70  |th>..This IconSp|
000061c0  72 69 74 65 73 20 74 68  65 20 66 69 6c 65 20 6f  |rites the file o|
000061d0  72 20 64 69 72 65 63 74  6f 72 79 2e 20 20 28 4f  |r directory.  (O|
000061e0  6e 6c 79 20 72 65 61 6c  6c 79 20 75 73 65 66 75  |nly really usefu|
000061f0  6c 20 6f 76 65 72 20 61  20 73 70 72 69 74 65 0a  |l over a sprite.|
00006200  66 69 6c 65 2e 29 0a 0a  45 6e 64 4d 65 6e 75 0a  |file.)..EndMenu.|
00006210  0a 54 68 65 72 65 20 61  72 65 20 6d 61 6e 79 20  |.There are many |
00006220  6f 74 68 65 72 20 70 6f  73 73 69 62 69 6c 69 74  |other possibilit|
00006230  69 65 73 20 66 6f 72 20  74 68 65 20 4d 65 6e 75  |ies for the Menu|
00006240  4d 65 6e 75 2c 20 73 75  63 68 20 61 73 20 53 65  |Menu, such as Se|
00006250  74 54 79 70 65 2c 0a 54  6f 6f 6c 53 70 72 69 74  |tType,.ToolSprit|
00006260  65 73 2c 20 44 65 6c 65  74 65 2c 20 57 69 70 65  |es, Delete, Wipe|
00006270  2c 20 41 63 63 65 73 73  20 65 74 63 2e 20 20 41  |, Access etc.  A|
00006280  20 4d 65 6e 75 4d 65 6e  75 20 69 73 20 70 65 72  | MenuMenu is per|
00006290  68 61 70 73 20 62 65 73  74 20 64 65 66 69 6e 65  |haps best define|
000062a0  64 20 61 73 0a 61 20 64  79 6e 61 6d 69 63 20 4d  |d as.a dynamic M|
000062b0  65 6e 75 2e 0a 0a 0a a4  20 50 69 6e 62 6f 61 72  |enu..... Pinboar|
000062c0  64 0a 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 0a 41 20  |d.==========..A |
000062d0  6d 65 6e 75 20 6f 66 20  74 68 69 73 20 6e 61 6d  |menu of this nam|
000062e0  65 20 28 64 65 66 69 6e  65 64 20 62 79 20 79 6f  |e (defined by yo|
000062f0  75 29 20 69 73 20 6f 70  65 6e 65 64 20 77 68 65  |u) is opened whe|
00006300  6e 65 76 65 72 20 79 6f  75 20 63 6c 69 63 6b 20  |never you click |
00006310  4d 65 6e 75 20 6f 6e 20  74 68 65 0a 70 69 6e 62  |Menu on the.pinb|
00006320  6f 61 72 64 20 62 61 63  6b 64 72 6f 70 20 6f 72  |oard backdrop or|
00006330  20 6f 6e 20 61 20 54 69  6e 79 44 69 72 73 20 69  | on a TinyDirs i|
00006340  63 6f 6e 2e 0a 0a 49 66  20 74 68 65 20 70 69 6e  |con...If the pin|
00006350  62 6f 61 72 64 20 6d 6f  64 75 6c 65 20 69 73 6e  |board module isn|
00006360  27 74 20 6c 6f 61 64 65  64 20 6f 72 20 72 75 6e  |'t loaded or run|
00006370  6e 69 6e 67 2c 20 6e 6f  20 65 72 72 6f 72 20 69  |ning, no error i|
00006380  73 20 70 72 6f 64 75 63  65 64 2c 20 62 75 74 0a  |s produced, but.|
00006390  6e 6f 6e 65 20 6f 66 20  74 68 65 20 74 68 69 6e  |none of the thin|
000063a0  67 73 20 69 6e 20 74 68  69 73 20 73 65 63 74 69  |gs in this secti|
000063b0  6f 6e 20 77 69 6c 6c 20  77 6f 72 6b 2e 0a 0a 49  |on will work...I|
000063c0  66 20 79 6f 75 20 77 61  6e 74 20 74 6f 20 75 73  |f you want to us|
000063d0  65 20 74 68 65 20 50 69  6e 62 6f 61 72 64 27 73  |e the Pinboard's|
000063e0  20 6d 65 6e 75 20 74 68  65 6e 20 79 6f 75 20 63  | menu then you c|
000063f0  61 6e 20 70 72 65 73 73  20 61 6e 79 20 6f 66 20  |an press any of |
00006400  53 48 49 46 54 2c 20 43  54 52 4c 2c 0a 41 4c 54  |SHIFT, CTRL,.ALT|
00006410  20 77 68 65 6e 20 63 6c  69 63 6b 69 6e 67 20 4d  | when clicking M|
00006420  65 6e 75 20 61 6e 64 20  74 68 65 20 6f 6c 64 20  |enu and the old |
00006430  4d 65 6e 75 20 77 69 6c  6c 20 61 70 70 65 61 72  |Menu will appear|
00006440  2e 0a 0a 41 6c 74 65 72  6e 61 74 69 76 65 6c 79  |...Alternatively|
00006450  20 6f 6e 20 79 6f 75 72  20 50 69 6e 62 6f 61 72  | on your Pinboar|
00006460  64 20 6d 65 6e 75 20 79  6f 75 20 63 61 6e 20 68  |d menu you can h|
00006470  61 76 65 20 61 6e 20 6f  70 74 69 6f 6e 0a 0a 09  |ave an option...|
00006480  4f 70 74 69 6f 6e 20 50  69 6e 62 6f 61 72 64 20  |Option Pinboard |
00006490  2d 73 75 62 20 4f 6c 64  4d 65 6e 75 3a 0a 0a 57  |-sub OldMenu:..W|
000064a0  68 69 63 68 20 77 68 65  6e 20 63 6c 69 63 6b 65  |hich when clicke|
000064b0  64 20 6f 6e 20 6f 72 20  73 6c 69 64 20 6f 76 65  |d on or slid ove|
000064c0  72 20 77 69 6c 6c 20 6f  70 65 6e 20 74 68 65 20  |r will open the |
000064d0  6d 65 6e 75 20 74 68 61  74 20 77 6f 75 6c 64 20  |menu that would |
000064e0  68 61 76 65 20 62 65 65  6e 0a 6f 70 65 6e 65 64  |have been.opened|
000064f0  20 69 66 20 50 69 6e 62  6f 61 72 64 20 68 61 64  | if Pinboard had|
00006500  20 62 65 65 6e 20 6c 65  66 74 20 74 6f 20 69 74  | been left to it|
00006510  73 20 6f 77 6e 20 64 65  76 69 63 65 73 2e 20 20  |s own devices.  |
00006520  49 74 20 77 69 6c 6c 20  61 6c 73 6f 20 6d 6f 76  |It will also mov|
00006530  65 20 74 68 65 0a 70 6f  69 6e 74 65 72 20 74 6f  |e the.pointer to|
00006540  20 62 65 20 69 6e 20 74  68 65 20 63 6f 72 72 65  | be in the corre|
00006550  63 74 20 70 6c 61 63 65  2e 0a 0a 28 49 20 64 65  |ct place...(I de|
00006560  62 61 74 65 64 20 6c 6f  6e 67 20 61 6e 64 20 68  |bated long and h|
00006570  61 72 64 20 61 62 6f 75  74 20 6d 6f 76 69 6e 67  |ard about moving|
00006580  20 74 68 65 20 70 6f 69  6e 74 65 72 20 28 77 68  | the pointer (wh|
00006590  69 63 68 20 49 20 64 69  73 6c 69 6b 65 29 2c 20  |ich I dislike), |
000065a0  62 75 74 0a 64 65 63 69  64 65 64 20 74 68 69 73  |but.decided this|
000065b0  20 77 61 73 20 74 68 65  20 6c 65 61 73 74 20 63  | was the least c|
000065c0  6f 6e 66 75 73 69 6e 67  20 6f 70 74 69 6f 6e 2e  |onfusing option.|
000065d0  20 20 54 72 79 20 69 74  20 66 6f 72 20 79 6f 75  |  Try it for you|
000065e0  72 73 65 6c 66 21 29 0a  0a 0a a4 20 53 61 76 65  |rself!).... Save|
000065f0  42 6f 78 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 52  |Box.=========..R|
00006600  65 61 64 20 74 68 65 20  73 65 63 74 69 6f 6e 20  |ead the section |
00006610  6f 6e 20 73 70 65 63 69  61 6c 20 66 6f 72 6d 73  |on special forms|
00006620  20 6f 66 20 4d 65 6e 75  73 20 61 6e 64 20 63 6f  | of Menus and co|
00006630  6d 6d 61 6e 64 73 20 69  66 20 79 6f 75 20 68 61  |mmands if you ha|
00006640  76 65 6e 27 74 0a 61 6c  72 65 61 64 79 20 64 6f  |ven't.already do|
00006650  6e 65 20 73 6f 2e 0a 0a  54 68 65 20 53 61 76 65  |ne so...The Save|
00006660  42 6f 78 20 69 73 20 6e  6f 74 20 6c 69 6b 65 20  |Box is not like |
00006670  61 20 74 72 75 65 20 53  61 76 65 42 6f 78 20 69  |a true SaveBox i|
00006680  74 20 69 73 20 6d 6f 72  65 20 6c 69 6b 65 20 61  |t is more like a|
00006690  20 6d 69 6e 69 61 74 75  72 65 20 46 69 6c 65 72  | miniature Filer|
000066a0  0a 77 69 6e 64 6f 77 20  28 65 78 63 65 70 74 20  |.window (except |
000066b0  79 6f 75 20 63 61 6e 27  74 20 28 79 65 74 29 20  |you can't (yet) |
000066c0  64 6f 75 62 6c 65 20 63  6c 69 63 6b 20 6f 6e 20  |double click on |
000066d0  74 68 65 20 69 63 6f 6e  29 2e 0a 0a 59 6f 75 20  |the icon)...You |
000066e0  6d 61 79 20 64 72 61 67  20 74 68 65 20 69 63 6f  |may drag the ico|
000066f0  6e 20 66 72 6f 6d 20 61  20 53 61 76 65 42 6f 78  |n from a SaveBox|
00006700  20 74 6f 20 61 6e 20 61  70 70 6c 69 63 61 74 69  | to an applicati|
00006710  6f 6e 20 28 65 71 75 69  76 61 6c 65 6e 74 20 74  |on (equivalent t|
00006720  6f 0a 64 72 61 67 67 69  6e 67 20 69 74 20 66 72  |o.dragging it fr|
00006730  6f 6d 20 74 68 65 20 46  69 6c 65 72 29 20 74 68  |om the Filer) th|
00006740  65 20 70 69 6e 62 6f 61  72 64 20 28 64 69 74 74  |e pinboard (ditt|
00006750  6f 29 20 6f 72 20 61 20  46 69 6c 65 72 20 77 69  |o) or a Filer wi|
00006760  6e 64 6f 77 2c 20 77 68  69 63 68 0a 77 69 6c 6c  |ndow, which.will|
00006770  20 63 6f 70 79 20 74 68  65 20 46 69 6c 65 20 69  | copy the File i|
00006780  6e 20 74 68 65 20 77 61  79 20 79 6f 75 20 68 61  |n the way you ha|
00006790  76 65 20 63 6f 6e 66 69  67 75 72 65 64 20 28 70  |ve configured (p|
000067a0  6f 73 73 69 62 6c 79 20  62 72 69 6e 67 69 6e 67  |ossibly bringing|
000067b0  20 75 70 20 61 0a 46 69  6c 65 72 20 41 63 74 69  | up a.Filer Acti|
000067c0  6f 6e 20 77 69 6e 64 6f  77 20 65 74 63 29 2e 0a  |on window etc)..|
000067d0  0a 59 6f 75 20 6d 61 79  20 61 6c 73 6f 20 64 72  |.You may also dr|
000067e0  61 67 20 66 69 6c 65 73  20 74 6f 20 74 68 65 20  |ag files to the |
000067f0  53 61 76 65 42 6f 78 20  66 72 6f 6d 20 74 68 65  |SaveBox from the|
00006800  20 70 69 6e 62 6f 61 72  64 20 6f 72 20 46 69 6c  | pinboard or Fil|
00006810  65 72 20 61 6e 64 20 69  74 20 77 69 6c 6c 0a 75  |er and it will.u|
00006820  70 64 61 74 65 20 74 6f  20 73 68 6f 77 20 74 68  |pdate to show th|
00006830  65 20 66 69 6c 65 20 79  6f 75 20 64 72 61 67 67  |e file you dragg|
00006840  65 64 2e 0a 0a 54 68 65  72 65 20 69 73 20 6f 6e  |ed...There is on|
00006850  6c 79 20 6f 6e 65 20 53  61 76 65 42 6f 78 20 61  |ly one SaveBox a|
00006860  6e 64 20 69 66 20 79 6f  75 20 74 72 79 20 74 6f  |nd if you try to|
00006870  20 6f 70 65 6e 20 69 74  20 74 77 69 63 65 20 74  | open it twice t|
00006880  68 65 20 66 69 72 73 74  20 6f 6e 65 0a 64 69 73  |he first one.dis|
00006890  61 70 70 65 61 72 73 2f  63 68 61 6e 67 65 73 20  |appears/changes |
000068a0  69 6e 74 6f 20 74 68 65  20 6e 65 77 20 66 69 6c  |into the new fil|
000068b0  65 2f 64 69 72 65 63 74  6f 72 79 2e 0a 0a 0a a4  |e/directory.....|
000068c0  20 4b 65 79 73 0a 3d 3d  3d 3d 3d 3d 0a 0a 41 6e  | Keys.======..An|
000068d0  79 20 4d 65 6e 75 20 6f  72 20 4d 65 6e 75 20 4f  |y Menu or Menu O|
000068e0  70 74 69 6f 6e 20 63 61  6e 20 68 61 76 65 20 61  |ption can have a|
000068f0  20 68 6f 74 20 6b 65 79  20 61 73 73 69 67 6e 65  | hot key assigne|
00006900  64 2e 0a 0a 41 20 68 6f  74 20 6b 65 79 20 61 73  |d...A hot key as|
00006910  73 69 67 6e 65 64 20 74  6f 20 61 20 6d 65 6e 75  |signed to a menu|
00006920  20 28 69 6e 20 74 68 65  20 4d 65 6e 75 20 63 6f  | (in the Menu co|
00006930  6d 6d 61 6e 64 29 20 77  69 6c 6c 20 6f 70 65 6e  |mmand) will open|
00006940  20 74 68 65 20 4d 65 6e  75 20 77 68 65 6e 0a 75  | the Menu when.u|
00006950  73 65 64 20 61 6e 64 20  61 20 68 6f 74 20 6b 65  |sed and a hot ke|
00006960  79 20 61 73 73 69 67 6e  65 64 20 74 6f 20 61 20  |y assigned to a |
00006970  4d 65 6e 75 20 4f 70 74  69 6f 6e 20 77 69 6c 6c  |Menu Option will|
00006980  20 62 65 20 65 71 75 69  76 61 6c 65 6e 74 20 74  | be equivalent t|
00006990  6f 20 63 6c 69 63 6b 69  6e 67 0a 77 69 74 68 20  |o clicking.with |
000069a0  73 65 6c 65 63 74 20 6f  6e 20 61 20 4d 65 6e 75  |select on a Menu|
000069b0  20 4f 70 74 69 6f 6e 20  77 68 65 6e 20 75 73 65  | Option when use|
000069c0  64 2e 0a 0a 4b 65 79 73  20 61 72 65 20 61 64 64  |d...Keys are add|
000069d0  65 64 20 62 79 20 6e 61  6d 65 20 61 6e 64 20 70  |ed by name and p|
000069e0  6f 73 73 69 62 6c 79 20  77 69 74 68 20 61 20 6d  |ossibly with a m|
000069f0  6f 64 69 66 69 65 72 2e  0a 0a 41 20 73 69 6e 67  |odifier...A sing|
00006a00  6c 65 20 6c 65 74 74 65  72 20 6b 65 79 20 72 65  |le letter key re|
00006a10  66 65 72 73 20 74 6f 20  74 68 61 74 20 6b 65 79  |fers to that key|
00006a20  20 65 67 20 2d 6b 65 79  20 4d 20 6f 72 20 2d 6b  | eg -key M or -k|
00006a30  65 79 20 38 2e 20 20 4b  65 79 73 20 61 72 65 20  |ey 8.  Keys are |
00006a40  63 61 73 65 0a 69 6e 73  65 6e 73 69 74 69 76 65  |case.insensitive|
00006a50  20 28 61 6e 64 20 69 6e  64 65 70 65 6e 64 65 6e  | (and independen|
00006a60  74 20 6f 66 20 43 61 70  73 4c 6f 63 6b 29 20 73  |t of CapsLock) s|
00006a70  6f 20 2d 6b 65 79 20 6d  20 69 73 20 65 71 75 69  |o -key m is equi|
00006a80  76 61 6c 65 6e 74 20 74  6f 20 2d 6b 65 79 20 4d  |valent to -key M|
00006a90  2e 0a 0a 53 6f 6d 65 20  6b 65 79 73 20 61 72 65  |...Some keys are|
00006aa0  20 72 65 66 65 72 72 65  64 20 74 6f 20 62 79 20  | referred to by |
00006ab0  6e 61 6d 65 20 28 63 61  73 65 20 69 6e 73 65 6e  |name (case insen|
00006ac0  73 69 74 69 76 65 29 2c  20 61 6e 64 20 74 68 65  |sitive), and the|
00006ad0  73 65 20 61 72 65 0a 0a  09 48 6f 6d 65 2c 20 52  |se are...Home, R|
00006ae0  65 74 75 72 6e 2c 20 52  65 74 2c 20 45 6e 74 65  |eturn, Ret, Ente|
00006af0  72 2c 20 42 61 63 6b 73  70 61 63 65 2c 20 42 6b  |r, Backspace, Bk|
00006b00  53 70 2c 20 53 70 61 63  65 2c 20 44 65 6c 65 74  |Sp, Space, Delet|
00006b10  65 2c 0a 09 44 65 6c 2c  20 45 73 63 2c 20 50 72  |e,..Del, Esc, Pr|
00006b20  69 6e 74 2c 20 50 6e 74  2c 20 46 31 2c 20 46 32  |int, Pnt, F1, F2|
00006b30  2c 20 46 33 2c 20 46 34  2c 20 46 35 2c 20 46 36  |, F3, F4, F5, F6|
00006b40  2c 20 46 37 2c 20 46 38  2c 20 46 39 2c 0a 09 54  |, F7, F8, F9,..T|
00006b50  61 62 2c 20 43 6f 70 79  2c 20 43 70 79 2c 20 45  |ab, Copy, Cpy, E|
00006b60  6e 64 2c 20 4c 65 66 74  2c 20 52 69 67 68 74 2c  |nd, Left, Right,|
00006b70  20 44 6f 77 6e 2c 20 55  70 2c 20 50 61 67 65 44  | Down, Up, PageD|
00006b80  6f 77 6e 2c 20 50 67 44  6e 2c 0a 09 50 61 67 65  |own, PgDn,..Page|
00006b90  55 70 2c 20 50 67 55 70  2c 20 46 31 30 2c 20 46  |Up, PgUp, F10, F|
00006ba0  31 31 2c 20 46 31 32 2c  20 49 6e 73 65 72 74 2c  |11, F12, Insert,|
00006bb0  20 49 6e 73 0a 0a 53 6f  6d 65 20 6f 66 20 74 68  | Ins..Some of th|
00006bc0  65 6d 20 61 72 65 20 6e  61 6d 65 64 20 74 77 69  |em are named twi|
00006bd0  63 65 20 66 6f 72 20 79  6f 75 72 20 63 6f 6e 76  |ce for your conv|
00006be0  65 6e 69 65 6e 63 65 2e  20 20 53 6f 20 2d 6b 65  |enience.  So -ke|
00006bf0  79 20 46 31 2c 20 2d 6b  65 79 20 66 31 20 6f 72  |y F1, -key f1 or|
00006c00  0a 2d 4b 65 79 20 49 6e  73 65 72 74 20 77 6f 75  |.-Key Insert wou|
00006c10  6c 64 20 62 65 20 76 61  6c 69 64 2e 0a 0a 50 6f  |ld be valid...Po|
00006c20  73 73 69 62 6c 65 20 6d  6f 64 69 66 69 65 72 73  |ssible modifiers|
00006c30  20 61 72 65 0a 0a 09 8b  09 53 48 49 46 54 0a 09  | are.....SHIFT..|
00006c40  5e 20 09 43 54 52 4c 0a  09 7e 20 09 41 4c 54 0a  |^ .CTRL..~ .ALT.|
00006c50  0a 28 54 6f 20 67 65 74  20 74 68 65 20 8b 20 73  |.(To get the . s|
00006c60  79 6d 62 6f 6c 2c 20 68  6f 6c 64 20 64 6f 77 6e  |ymbol, hold down|
00006c70  20 41 4c 54 2c 20 74 79  70 65 20 31 33 39 20 6f  | ALT, type 139 o|
00006c80  6e 20 74 68 65 20 6e 75  6d 65 72 69 63 20 6b 65  |n the numeric ke|
00006c90  79 70 61 64 20 61 6e 64  0a 72 65 6c 65 61 73 65  |ypad and.release|
00006ca0  20 41 4c 54 2e 20 20 41  6c 74 65 72 6e 61 74 69  | ALT.  Alternati|
00006cb0  76 65 6c 79 20 6d 61 70  20 63 68 61 72 61 63 74  |vely map charact|
00006cc0  65 72 20 31 33 39 20 74  6f 20 61 20 6b 65 79 20  |er 139 to a key |
00006cd0  69 6e 20 79 6f 75 72 20  66 61 76 6f 75 72 69 74  |in your favourit|
00006ce0  65 0a 65 64 69 74 6f 72  20 28 43 54 52 4c 2d 36  |e.editor (CTRL-6|
00006cf0  20 69 73 20 61 20 67 6f  6f 64 20 6d 61 70 70 69  | is a good mappi|
00006d00  6e 67 29 2e 29 0a 0a 54  68 65 73 65 20 63 61 6e  |ng).)..These can|
00006d10  20 62 65 20 61 64 64 65  64 20 28 69 6e 20 61 6e  | be added (in an|
00006d20  79 20 6f 72 64 65 72 29  20 62 65 66 6f 72 65 20  |y order) before |
00006d30  61 20 6b 65 79 20 6e 61  6d 65 2c 20 69 6e 64 69  |a key name, indi|
00006d40  63 61 74 69 6e 67 20 74  68 61 74 20 79 6f 75 20  |cating that you |
00006d50  68 61 76 65 0a 74 6f 20  70 72 65 73 73 20 74 68  |have.to press th|
00006d60  65 20 6d 6f 64 69 66 69  65 72 20 6b 65 79 73 20  |e modifier keys |
00006d70  69 6e 64 69 63 61 74 65  64 20 77 69 74 68 20 74  |indicated with t|
00006d80  68 65 20 6d 61 69 6e 20  6b 65 79 20 69 6e 20 6f  |he main key in o|
00006d90  72 64 65 72 20 74 6f 20  61 63 74 69 76 61 74 65  |rder to activate|
00006da0  0a 74 68 65 20 68 6f 74  20 6b 65 79 2e 20 20 65  |.the hot key.  e|
00006db0  67 0a 0a 09 5e 4d 09 09  43 54 52 4c 2d 4d 0a 09  |g...^M..CTRL-M..|
00006dc0  8b 41 09 09 53 48 49 46  54 2d 41 0a 09 5e 8b 46  |.A..SHIFT-A..^.F|
00006dd0  31 20 3d 20 8b 5e 46 31  09 53 48 49 46 54 2d 43  |1 = .^F1.SHIFT-C|
00006de0  54 52 4c 2d 46 31 0a 0a  4e 6f 74 65 20 74 68 61  |TRL-F1..Note tha|
00006df0  74 20 2d 6b 65 79 20 8b  41 20 3d 20 2d 6b 65 79  |t -key .A = -key|
00006e00  20 8b 61 20 77 68 69 63  68 20 69 73 20 6e 6f 74  | .a which is not|
00006e10  20 65 71 75 61 6c 20 74  6f 20 2d 6b 65 79 20 41  | equal to -key A|
00006e20  20 3d 20 2d 6b 65 79 20  61 2e 0a 0a 53 6f 6d 65  | = -key a...Some|
00006e30  20 6b 65 79 20 63 6f 6d  62 69 6e 61 74 69 6f 6e  | key combination|
00006e40  73 20 64 6f 6e 27 74 20  77 6f 72 6b 2c 20 65 67  |s don't work, eg|
00006e50  0a 0a 09 43 54 52 4c 20  4e 75 6d 62 65 72 20 6b  |...CTRL Number k|
00006e60  65 79 73 20 64 6f 6e 27  74 20 77 6f 72 6b 2c 20  |eys don't work, |
00006e70  43 54 52 4c 20 4b 65 79  50 61 64 20 6e 75 6d 62  |CTRL KeyPad numb|
00006e80  65 72 73 20 73 68 6f 75  6c 64 0a 09 4e 6f 20 6b  |ers should..No k|
00006e90  65 79 73 20 77 6f 72 6b  20 77 69 74 68 20 41 4c  |eys work with AL|
00006ea0  54 21 0a 0a 54 68 65 73  65 20 6d 61 79 20 62 65  |T!..These may be|
00006eb0  20 66 69 78 65 64 20 69  6e 20 61 20 66 75 74 75  | fixed in a futu|
00006ec0  72 65 20 72 65 6c 65 61  73 65 21 0a 0a 49 66 20  |re release!..If |
00006ed0  61 6e 20 4f 70 74 69 6f  6e 20 6f 72 20 61 20 4d  |an Option or a M|
00006ee0  65 6e 75 20 68 61 73 20  61 20 6b 65 79 20 64 65  |enu has a key de|
00006ef0  66 69 6e 69 74 69 6f 6e  20 69 74 20 69 73 20 61  |finition it is a|
00006f00  64 64 65 64 20 74 6f 20  74 68 65 20 74 65 78 74  |dded to the text|
00006f10  2f 74 69 74 6c 65 0a 77  69 74 68 20 61 20 73 70  |/title.with a sp|
00006f20  61 63 65 20 62 65 66 6f  72 65 20 69 74 2e 20 20  |ace before it.  |
00006f30  49 66 20 79 6f 75 20 77  61 6e 74 20 74 68 65 20  |If you want the |
00006f40  69 74 65 6d 73 20 74 6f  20 6c 69 6e 65 20 75 70  |items to line up|
00006f50  20 74 68 65 6e 20 79 6f  75 20 77 69 6c 6c 20 68  | then you will h|
00006f60  61 76 65 0a 74 6f 20 61  64 64 20 73 70 61 63 65  |ave.to add space|
00006f70  73 20 61 66 74 65 72 20  74 68 65 20 74 65 78 74  |s after the text|
00006f80  2f 74 69 74 6c 65 2e 20  20 52 49 53 43 4f 53 20  |/title.  RISCOS |
00006f90  33 2e 35 20 77 69 6c 6c  20 6c 69 6e 65 20 74 68  |3.5 will line th|
00006fa0  65 6d 20 75 70 20 66 6f  72 20 79 6f 75 0a 70 72  |em up for you.pr|
00006fb0  6f 76 69 64 65 64 20 74  68 65 20 6b 65 79 20 64  |ovided the key d|
00006fc0  65 66 69 6e 69 74 69 6f  6e 73 20 73 74 61 72 74  |efinitions start|
00006fd0  73 20 77 69 74 68 20 5e  20 6f 72 20 8b 20 6f 72  |s with ^ or . or|
00006fe0  20 69 73 20 6f 6e 65 20  6f 66 20 74 68 65 20 6c  | is one of the l|
00006ff0  6f 6e 67 20 66 6f 72 6d  0a 6e 61 6d 65 64 20 6b  |ong form.named k|
00007000  65 79 73 20 61 62 6f 76  65 2e 0a 0a 0a a4 20 43  |eys above..... C|
00007010  6f 6c 6f 75 72 73 0a 3d  3d 3d 3d 3d 3d 3d 3d 3d  |olours.=========|
00007020  0a 0a 41 6e 79 20 63 6f  6c 6f 75 72 73 20 69 6e  |..Any colours in|
00007030  20 44 69 72 65 63 74 6f  72 20 61 72 65 20 73 70  | Director are sp|
00007040  65 63 69 66 69 65 64 20  6e 75 6d 65 72 69 63 61  |ecified numerica|
00007050  6c 6c 79 20 66 72 6f 6d  20 74 68 65 20 31 36 20  |lly from the 16 |
00007060  57 69 6d 70 20 63 6f 6c  6f 75 72 73 2e 20 0a 54  |Wimp colours. .T|
00007070  68 65 73 65 20 63 6f 6c  6f 75 72 73 20 63 61 6e  |hese colours can|
00007080  20 62 65 20 73 65 65 6e  20 62 79 20 63 6c 69 63  | be seen by clic|
00007090  6b 69 6e 67 20 6f 6e 20  74 68 65 20 50 61 6c 65  |king on the Pale|
000070a0  74 74 65 20 69 63 6f 6e  20 28 73 75 70 70 6c 69  |tte icon (suppli|
000070b0  65 64 20 77 69 74 68 0a  76 65 72 73 69 6f 6e 73  |ed with.versions|
000070c0  20 6f 66 20 52 49 53 43  4f 53 20 3c 20 33 2e 35  | of RISCOS < 3.5|
000070d0  29 2e 20 20 54 68 65 20  6e 75 6d 62 65 72 73 20  |).  The numbers |
000070e0  6f 66 20 65 61 63 68 20  63 6f 6c 6f 75 72 20 61  |of each colour a|
000070f0  72 65 20 67 69 76 65 6e  20 62 65 6c 6f 77 2e 0a  |re given below..|
00007100  0a 57 68 69 74 65 09 30  09 47 72 65 79 34 09 34  |.White.0.Grey4.4|
00007110  09 42 6c 75 65 09 38 09  43 72 65 61 6d 09 31 32  |.Blue.8.Cream.12|
00007120  0a 47 72 65 79 31 09 31  09 47 72 65 79 35 09 35  |.Grey1.1.Grey5.5|
00007130  09 59 65 6c 6c 6f 77 09  39 09 4b 68 61 6b 69 09  |.Yellow.9.Khaki.|
00007140  31 33 0a 47 72 65 79 32  09 32 09 47 72 65 79 36  |13.Grey2.2.Grey6|
00007150  09 36 09 47 72 65 65 6e  09 31 30 09 4f 72 61 6e  |.6.Green.10.Oran|
00007160  67 65 09 31 34 0a 47 72  65 79 33 09 33 09 42 6c  |ge.14.Grey3.3.Bl|
00007170  61 63 6b 09 37 09 52 65  64 09 31 31 09 43 79 61  |ack.7.Red.11.Cya|
00007180  6e 09 31 35 0a 0a 54 68  65 73 65 20 6e 61 6d 65  |n.15..These name|
00007190  73 20 61 72 65 20 64 65  66 69 6e 65 64 20 69 6e  |s are defined in|
000071a0  20 74 68 65 20 66 69 6c  65 20 44 69 72 65 63 74  | the file Direct|
000071b0  6f 72 3a 4c 69 62 72 61  72 79 2e 21 43 6f 72 65  |or:Library.!Core|
000071c0  20 61 6e 64 20 61 72 65  20 64 65 66 69 6e 65 64  | and are defined|
000071d0  20 62 79 0a 64 65 66 61  75 6c 74 20 73 6f 20 79  | by.default so y|
000071e0  6f 75 20 6d 61 79 20 75  73 65 20 74 68 65 73 65  |ou may use these|
000071f0  20 6e 61 6d 65 73 20 77  68 65 72 65 76 65 72 20  | names wherever |
00007200  61 20 63 6f 6c 6f 75 72  20 69 73 20 6e 65 65 64  |a colour is need|
00007210  65 64 2c 20 65 67 0a 0a  09 4f 70 74 69 6f 6e 20  |ed, eg...Option |
00007220  22 55 6e 72 65 61 64 61  62 6c 65 22 20 2d 62 67  |"Unreadable" -bg|
00007230  20 52 65 64 20 2d 66 67  20 4b 68 61 6b 69 0a 0a  | Red -fg Khaki..|
00007240  0a a4 20 44 79 6e 61 6d  69 63 20 4d 65 6e 75 73  |.. Dynamic Menus|
00007250  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.===============|
00007260  0a 0a 54 68 65 73 65 20  61 72 65 20 6d 65 6e 75  |..These are menu|
00007270  73 20 74 68 61 74 20 61  72 65 20 63 72 65 61 74  |s that are creat|
00007280  65 64 20 6a 75 73 74 20  62 65 66 6f 72 65 20 74  |ed just before t|
00007290  68 65 20 6d 65 6e 75 20  69 73 20 6f 70 65 6e 65  |he menu is opene|
000072a0  64 20 72 61 74 68 65 72  20 74 68 61 6e 0a 77 68  |d rather than.wh|
000072b0  65 6e 20 79 6f 75 20 72  75 6e 20 44 69 72 65 63  |en you run Direc|
000072c0  74 6f 72 2e 0a 0a 54 68  65 79 20 61 72 65 20 75  |tor...They are u|
000072d0  73 65 64 20 66 72 6f 6d  20 61 6e 20 65 78 74 65  |sed from an exte|
000072e0  6e 64 65 64 20 6d 65 6e  75 20 22 44 79 6e 61 6d  |nded menu "Dynam|
000072f0  69 63 3a 46 69 6c 65 6e  61 6d 65 22 2e 20 20 57  |ic:Filename".  W|
00007300  68 65 6e 20 74 68 69 73  20 63 6f 6d 6d 61 6e 64  |hen this command|
00007310  20 69 73 0a 72 75 6e 20  74 68 65 20 66 69 6c 65  | is.run the file|
00007320  20 6f 72 20 63 6f 6d 6d  61 6e 64 20 22 46 69 6c  | or command "Fil|
00007330  65 6e 61 6d 65 22 20 69  73 20 72 75 6e 2e 20 20  |ename" is run.  |
00007340  57 68 65 6e 20 74 68 65  20 63 6f 6d 6d 61 6e 64  |When the command|
00007350  20 6f 72 20 66 69 6c 65  20 66 69 6e 69 73 68 65  | or file finishe|
00007360  73 0a 65 78 65 63 75 74  69 6e 67 20 44 69 72 65  |s.executing Dire|
00007370  63 74 6f 72 20 77 69 6c  6c 20 74 72 79 20 74 6f  |ctor will try to|
00007380  20 6f 70 65 6e 20 74 68  65 20 6d 65 6e 75 20 77  | open the menu w|
00007390  68 6f 73 65 20 6e 61 6d  65 20 69 73 20 69 6e 20  |hose name is in |
000073a0  74 68 65 20 73 79 73 74  65 6d 0a 76 61 72 69 61  |the system.varia|
000073b0  62 6c 65 20 44 69 72 65  63 74 6f 72 24 4d 65 6e  |ble Director$Men|
000073c0  75 2e 0a 0a 41 20 73 69  6d 70 6c 65 20 65 78 61  |u...A simple exa|
000073d0  6d 70 6c 65 20 6f 66 20  61 20 64 79 6e 61 6d 69  |mple of a dynami|
000073e0  63 20 6d 65 6e 75 20 77  6f 75 6c 64 20 62 65 20  |c menu would be |
000073f0  74 68 69 73 0a 0a 09 4f  70 74 69 6f 6e 20 22 54  |this...Option "T|
00007400  69 6d 65 22 20 2d 73 75  62 20 22 44 79 6e 61 6d  |ime" -sub "Dynam|
00007410  69 63 3a 44 69 72 65 63  74 6f 72 4f 62 65 79 20  |ic:DirectorObey |
00007420  44 69 72 65 63 74 6f 72  3a 4d 65 6e 75 73 2e 54  |Director:Menus.T|
00007430  69 6d 65 22 0a 0a 54 68  69 73 20 77 69 6c 6c 20  |ime"..This will |
00007440  72 75 6e 20 74 68 65 20  63 6f 6d 6d 61 6e 64 20  |run the command |
00007450  22 44 69 72 65 63 74 6f  72 4f 62 65 79 20 44 69  |"DirectorObey Di|
00007460  72 65 63 74 6f 72 3a 4d  65 6e 75 73 2e 54 69 6d  |rector:Menus.Tim|
00007470  65 22 20 77 68 65 6e 20  74 68 69 73 20 6d 65 6e  |e" when this men|
00007480  75 0a 6f 70 74 69 6f 6e  20 69 73 20 72 75 6e 2e  |u.option is run.|
00007490  20 20 54 68 65 20 63 6f  6e 74 65 6e 74 73 20 74  |  The contents t|
000074a0  68 69 73 20 66 69 6c 65  20 6d 69 67 68 74 20 62  |his file might b|
000074b0  65 0a 0a 09 4d 65 6e 75  20 22 22 20 54 69 6d 65  |e...Menu "" Time|
000074c0  20 2d 74 65 6d 70 0a 09  09 4f 70 74 69 6f 6e 20  | -temp...Option |
000074d0  22 2a 2a 54 68 65 a0 54  69 6d 65 a0 57 61 73 2a  |"**The.Time.Was*|
000074e0  2a 22 20 2d 66 67 20 31  31 0a 09 09 4f 70 74 69  |*" -fg 11...Opti|
000074f0  6f 6e 20 22 a0 a0 a0 3c  53 79 73 24 54 69 6d 65  |on "...<Sys$Time|
00007500  3e a0 a0 a0 22 0a 09 09  4f 70 74 69 6f 6e 20 22  |>..."...Option "|
00007510  3c 53 79 73 24 44 61 74  65 3e a0 3c 53 79 73 24  |<Sys$Date>.<Sys$|
00007520  59 65 61 72 3e 22 0a 09  45 6e 64 4d 65 6e 75 0a  |Year>"..EndMenu.|
00007530  0a 09 53 65 74 20 44 69  72 65 63 74 6f 72 24 4d  |..Set Director$M|
00007540  65 6e 75 20 54 69 6d 65  0a 0a 54 68 69 73 20 63  |enu Time..This c|
00007550  72 65 61 74 65 73 20 61  20 74 65 6d 70 6f 72 61  |reates a tempora|
00007560  72 79 20 6d 65 6e 75 20  63 61 6c 6c 65 64 20 54  |ry menu called T|
00007570  69 6d 65 20 77 69 74 68  20 74 68 65 20 63 75 72  |ime with the cur|
00007580  72 65 6e 74 20 74 69 6d  65 20 61 6e 64 20 64 61  |rent time and da|
00007590  74 65 20 69 6e 0a 69 74  20 61 6e 64 20 72 65 74  |te in.it and ret|
000075a0  75 72 6e 73 20 74 68 65  20 73 74 72 69 6e 67 20  |urns the string |
000075b0  22 54 69 6d 65 22 20 69  6e 20 44 69 72 65 63 74  |"Time" in Direct|
000075c0  6f 72 24 4d 65 6e 75 20  66 6f 72 20 44 69 72 65  |or$Menu for Dire|
000075d0  63 74 6f 72 20 74 6f 20  75 73 65 20 61 73 20 74  |ctor to use as t|
000075e0  68 65 0a 6e 61 6d 65 20  6f 66 20 61 20 6d 65 6e  |he.name of a men|
000075f0  75 20 74 6f 20 6f 70 65  6e 2e 0a 0a 42 65 63 61  |u to open...Beca|
00007600  75 73 65 20 74 68 65 20  6d 65 6e 75 20 77 61 73  |use the menu was|
00007610  20 63 72 65 61 74 65 64  20 61 73 20 61 20 74 65  | created as a te|
00007620  6d 70 6f 72 61 72 79 20  6d 65 6e 75 20 69 74 20  |mporary menu it |
00007630  77 69 6c 6c 20 62 65 20  64 65 6c 65 74 65 64 20  |will be deleted |
00007640  6f 6e 63 65 20 69 74 0a  68 61 73 20 62 65 65 6e  |once it.has been|
00007650  20 64 69 73 70 6c 61 79  65 64 20 74 6f 20 63 6f  | displayed to co|
00007660  6e 73 65 72 76 65 20 6d  65 6d 6f 72 79 20 28 73  |nserve memory (s|
00007670  69 6e 63 65 20 69 74 20  69 73 20 72 65 62 75 69  |ince it is rebui|
00007680  6c 74 20 65 61 63 68 20  74 69 6d 65 20 69 74 20  |lt each time it |
00007690  69 73 0a 6e 65 65 64 65  64 29 2e 0a 0a 44 79 6e  |is.needed)...Dyn|
000076a0  61 6d 69 63 20 6d 65 6e  75 73 20 61 72 65 20 76  |amic menus are v|
000076b0  65 72 79 20 75 73 65 66  75 6c 20 66 6f 72 20 64  |ery useful for d|
000076c0  69 73 70 6c 61 79 69 6e  67 20 6c 69 73 74 73 20  |isplaying lists |
000076d0  6f 66 20 74 68 69 6e 67  73 20 74 68 61 74 20 63  |of things that c|
000076e0  6f 75 6c 64 20 76 61 72  79 0a 77 68 69 6c 73 74  |ould vary.whilst|
000076f0  20 44 69 72 65 63 74 6f  72 20 69 73 20 72 75 6e  | Director is run|
00007700  6e 69 6e 67 20 28 73 75  63 68 20 61 73 20 6d 6f  |ning (such as mo|
00007710  64 75 6c 65 73 20 6f 72  20 66 69 6c 65 74 79 70  |dules or filetyp|
00007720  65 73 29 2e 20 20 41 20  66 65 77 20 65 78 61 6d  |es).  A few exam|
00007730  70 6c 65 73 20 6f 66 0a  64 79 6e 61 6d 69 63 20  |ples of.dynamic |
00007740  6d 65 6e 75 73 20 61 72  65 20 70 72 6f 76 69 64  |menus are provid|
00007750  65 64 20 69 6e 20 74 68  65 20 4d 65 6e 75 73 20  |ed in the Menus |
00007760  64 69 72 65 63 74 6f 72  79 20 69 6e 73 69 64 65  |directory inside|
00007770  20 44 69 72 65 63 74 6f  72 2e 0a 0a 49 74 20 77  | Director...It w|
00007780  6f 75 6c 64 20 62 65 20  70 6f 73 73 69 62 6c 65  |ould be possible|
00007790  20 74 6f 20 73 69 6d 75  6c 61 74 65 20 6d 6f 73  | to simulate mos|
000077a0  74 20 6f 66 20 74 68 65  20 6f 74 68 65 72 20 66  |t of the other f|
000077b0  65 61 74 75 72 65 73 20  6f 66 20 44 69 72 65 63  |eatures of Direc|
000077c0  74 6f 72 20 75 73 69 6e  67 0a 64 79 6e 61 6d 69  |tor using.dynami|
000077d0  63 20 6d 65 6e 75 73 2c  20 68 6f 77 65 76 65 72  |c menus, however|
000077e0  20 69 6e 20 74 68 65 69  72 20 63 75 72 72 65 6e  | in their curren|
000077f0  74 20 69 6d 70 6c 65 6d  65 6e 74 61 74 69 6f 6e  |t implementation|
00007800  20 74 68 65 79 20 72 65  71 75 69 72 65 20 61 20  | they require a |
00007810  64 69 73 63 0a 61 63 63  65 73 73 20 70 65 72 20  |disc.access per |
00007820  75 73 65 2e 20 20 49 74  20 77 6f 75 6c 64 20 62  |use.  It would b|
00007830  65 20 70 6f 73 73 69 62  6c 65 20 74 6f 20 72 65  |e possible to re|
00007840  67 69 73 74 65 72 20 74  68 65 20 64 79 6e 61 6d  |gister the dynam|
00007850  69 63 20 6d 65 6e 75 20  66 69 6c 65 73 20 69 6e  |ic menu files in|
00007860  0a 74 68 65 20 72 65 73  6f 75 72 63 65 20 66 69  |.the resource fi|
00007870  6c 69 6e 67 20 73 79 73  74 65 6d 20 74 6f 20 61  |ling system to a|
00007880  76 6f 69 64 20 74 68 69  73 20 61 6e 64 20 6d 61  |void this and ma|
00007890  79 62 65 20 61 20 66 75  74 75 72 65 20 76 65 72  |ybe a future ver|
000078a0  73 69 6f 6e 20 6f 66 0a  44 69 72 65 63 74 6f 72  |sion of.Director|
000078b0  20 77 69 6c 6c 20 64 6f  20 74 68 69 73 20 66 6f  | will do this fo|
000078c0  72 20 79 6f 75 2e 0a 0a  44 79 6e 61 6d 69 63 20  |r you...Dynamic |
000078d0  6d 65 6e 75 73 20 73 65  74 20 44 69 72 65 63 74  |menus set Direct|
000078e0  6f 72 24 57 69 6e 64 6f  77 20 61 6e 64 20 44 69  |or$Window and Di|
000078f0  72 65 63 74 6f 72 24 49  63 6f 6e 20 74 6f 20 74  |rector$Icon to t|
00007900  68 65 20 77 69 6e 64 6f  77 20 68 61 6e 64 6c 65  |he window handle|
00007910  20 61 6e 64 0a 69 63 6f  6e 20 6e 75 6d 62 65 72  | and.icon number|
00007920  20 74 68 61 74 20 74 68  65 20 72 65 71 75 65 73  | that the reques|
00007930  74 20 77 61 73 20 6f 76  65 72 20 72 65 73 70 65  |t was over respe|
00007940  63 74 69 76 65 6c 79 2e  20 20 54 68 69 73 20 69  |ctively.  This i|
00007950  73 20 75 73 65 66 75 6c  20 66 6f 72 20 6d 6f 72  |s useful for mor|
00007960  65 0a 61 64 76 61 6e 63  65 64 20 6d 65 6e 75 73  |e.advanced menus|
00007970  20 6c 69 6b 65 20 74 68  65 20 43 6c 6f 73 65 42  | like the CloseB|
00007980  6f 78 20 6d 65 6e 75 20  65 78 61 6d 70 6c 65 2e  |ox menu example.|
00007990  0a 0a 0a a4 20 49 63 6f  6e 73 0a 3d 3d 3d 3d 3d  |.... Icons.=====|
000079a0  3d 3d 0a 0a 49 63 6f 6e  73 20 61 72 65 20 63 72  |==..Icons are cr|
000079b0  65 61 74 65 64 20 69 6e  20 61 20 73 69 6d 69 6c  |eated in a simil|
000079c0  61 72 20 77 61 79 20 74  6f 20 6d 65 6e 75 73 2e  |ar way to menus.|
000079d0  20 20 45 61 63 68 20 6f  6e 65 20 6d 75 73 74 20  |  Each one must |
000079e0  62 65 20 6e 61 6d 65 64  20 28 63 61 73 65 0a 69  |be named (case.i|
000079f0  6e 73 65 6e 73 69 74 69  76 65 29 20 62 79 20 69  |nsensitive) by i|
00007a00  74 73 20 73 70 72 69 74  65 20 6e 61 6d 65 20 6f  |ts sprite name o|
00007a10  72 20 61 6e 20 61 6c 69  61 73 20 6e 61 6d 65 20  |r an alias name |
00007a20  70 72 6f 76 69 64 65 64  20 62 79 20 79 6f 75 20  |provided by you |
00007a30  61 6e 64 20 74 68 65 72  65 0a 63 61 6e 20 6f 6e  |and there.can on|
00007a40  6c 79 20 62 65 20 6f 6e  65 20 6f 66 20 65 61 63  |ly be one of eac|
00007a50  68 20 6e 61 6d 65 2e 20  20 49 66 20 79 6f 75 20  |h name.  If you |
00007a60  63 72 65 61 74 65 20 61  6e 20 69 63 6f 6e 20 77  |create an icon w|
00007a70  69 74 68 20 74 68 65 20  6e 61 6d 65 20 6f 66 20  |ith the name of |
00007a80  61 6e 0a 61 6c 72 65 61  64 79 20 65 78 69 73 74  |an.already exist|
00007a90  69 6e 67 20 6f 6e 65 20  74 68 65 6e 20 74 68 65  |ing one then the|
00007aa0  20 65 78 69 73 74 69 6e  67 20 69 63 6f 6e 20 77  | existing icon w|
00007ab0  69 6c 6c 20 62 65 20 64  65 6c 65 74 65 64 20 77  |ill be deleted w|
00007ac0  69 74 68 6f 75 74 20 77  61 72 6e 69 6e 67 0a 61  |ithout warning.a|
00007ad0  6e 64 20 74 68 65 20 6e  65 77 20 6f 6e 65 20 63  |nd the new one c|
00007ae0  72 65 61 74 65 64 2e 0a  0a 59 6f 75 20 6d 61 79  |reated...You may|
00007af0  20 61 74 74 61 63 68 20  6d 65 6e 75 73 20 66 6f  | attach menus fo|
00007b00  72 20 53 65 6c 65 63 74  2c 20 41 64 6a 75 73 74  |r Select, Adjust|
00007b10  20 61 6e 64 20 4d 65 6e  75 20 66 6f 72 20 74 68  | and Menu for th|
00007b20  65 20 69 63 6f 6e 2e 20  20 52 65 6d 65 6d 62 65  |e icon.  Remembe|
00007b30  72 20 74 68 61 74 0a 74  68 65 20 6d 65 6e 75 73  |r that.the menus|
00007b40  20 63 61 6e 20 61 6c 73  6f 20 62 65 20 63 6f 6d  | can also be com|
00007b50  6d 61 6e 64 73 20 28 73  65 65 20 74 68 65 20 73  |mands (see the s|
00007b60  65 63 74 69 6f 6e 20 6f  6e 20 53 70 65 63 69 61  |ection on Specia|
00007b70  6c 20 66 6f 72 6d 73 20  6f 66 20 4d 65 6e 75 73  |l forms of Menus|
00007b80  20 61 6e 64 0a 43 6f 6d  6d 61 6e 64 73 29 0a 0a  | and.Commands)..|
00007b90  54 68 69 73 20 63 72 65  61 74 65 73 20 61 20 6e  |This creates a n|
00007ba0  65 77 20 69 63 6f 6e 20  62 61 72 20 69 63 6f 6e  |ew icon bar icon|
00007bb0  20 77 69 74 68 20 61 74  74 61 63 68 65 64 20 6d  | with attached m|
00007bc0  65 6e 75 73 2e 20 54 68  65 20 69 63 6f 6e 20 69  |enus. The icon i|
00007bd0  73 20 72 65 66 65 72 72  65 64 20 74 6f 0a 62 79  |s referred to.by|
00007be0  20 74 68 65 20 6e 61 6d  65 20 6f 66 20 69 74 73  | the name of its|
00007bf0  20 73 70 72 69 74 65 20  6f 72 20 74 68 65 20 61  | sprite or the a|
00007c00  6c 69 61 73 20 6e 61 6d  65 20 69 66 20 73 75 70  |lias name if sup|
00007c10  70 6c 69 65 64 2e 0a 0a  09 53 79 6e 74 61 78 3a  |plied....Syntax:|
00007c20  20 2a 44 69 72 65 63 74  6f 72 49 63 6f 6e 0a 09  | *DirectorIcon..|
00007c30  09 3c 73 70 72 69 74 65  3e 0a 09 09 09 4e 61 6d  |.<sprite>....Nam|
00007c40  65 20 6f 66 20 74 68 65  20 73 70 72 69 74 65 2c  |e of the sprite,|
00007c50  20 6d 75 73 74 20 62 65  20 70 72 6f 76 69 64 65  | must be provide|
00007c60  64 20 61 6e 64 20 65 78  69 73 74 20 69 6e 20 74  |d and exist in t|
00007c70  68 65 0a 09 09 09 57 69  6d 70 20 73 70 72 69 74  |he....Wimp sprit|
00007c80  65 20 70 6f 6f 6c 0a 09  09 5b 2d 61 6c 69 61 73  |e pool...[-alias|
00007c90  20 3c 6e 61 6d 65 3e 5d  0a 09 09 09 49 6e 74 65  | <name>]....Inte|
00007ca0  72 6e 61 6c 20 6e 61 6d  65 20 6f 66 20 74 68 65  |rnal name of the|
00007cb0  20 49 63 6f 6e 2e 20 20  49 66 20 74 68 69 73 20  | Icon.  If this |
00007cc0  69 73 20 6e 6f 74 20 73  75 70 70 6c 69 65 64 0a  |is not supplied.|
00007cd0  09 09 09 74 68 65 6e 20  74 68 65 20 69 63 6f 6e  |...then the icon|
00007ce0  20 69 73 20 72 65 66 65  72 72 65 64 20 74 6f 20  | is referred to |
00007cf0  62 79 20 69 74 73 20 73  70 72 69 74 65 20 6e 61  |by its sprite na|
00007d00  6d 65 2e 0a 09 09 5b 2d  74 65 78 74 20 3c 74 65  |me....[-text <te|
00007d10  78 74 3e 5d 0a 09 09 09  54 65 78 74 20 74 6f 20  |xt>]....Text to |
00007d20  67 6f 20 75 6e 64 65 72  20 74 68 65 20 49 63 6f  |go under the Ico|
00007d30  6e 2e 20 20 4f 70 74 69  6f 6e 61 6c 2e 20 20 49  |n.  Optional.  I|
00007d40  66 20 74 68 65 20 2d 74  69 6d 65 0a 09 09 09 6f  |f the -time....o|
00007d50  70 74 69 6f 6e 20 69 73  20 75 73 65 64 20 74 68  |ption is used th|
00007d60  65 6e 20 74 68 69 73 20  54 65 78 74 20 64 65 66  |en this Text def|
00007d70  69 6e 65 73 20 74 68 65  20 6c 65 6e 67 74 68 20  |ines the length |
00007d80  6f 66 0a 09 09 09 74 68  65 20 74 69 6d 65 20 73  |of....the time s|
00007d90  74 72 69 6e 67 2e 0a 09  09 5b 2d 6c 65 66 74 7c  |tring....[-left||
00007da0  2d 72 69 67 68 74 5d 0a  09 09 09 57 68 65 74 68  |-right]....Wheth|
00007db0  65 72 20 74 68 65 20 69  63 6f 6e 20 67 6f 65 73  |er the icon goes|
00007dc0  20 6f 6e 20 74 68 65 20  6c 65 66 74 20 6f 66 20  | on the left of |
00007dd0  74 68 65 20 49 63 6f 6e  20 62 61 72 20 6f 72 0a  |the Icon bar or.|
00007de0  09 09 09 74 68 65 20 72  69 67 68 74 2e 20 20 49  |...the right.  I|
00007df0  66 20 6f 6d 69 74 74 65  64 20 77 69 6c 6c 20 64  |f omitted will d|
00007e00  65 66 61 75 6c 74 20 74  6f 20 2d 6c 65 66 74 2e  |efault to -left.|
00007e10  0a 09 09 5b 2d 70 72 69  6f 72 69 74 79 20 3c 70  |...[-priority <p|
00007e20  72 69 6f 72 69 74 79 3e  5d 0a 09 09 09 54 68 69  |riority>]....Thi|
00007e30  73 20 63 6f 6e 74 72 6f  6c 73 20 74 68 65 20 70  |s controls the p|
00007e40  6f 73 69 74 69 6f 6e 69  6e 67 20 6f 66 20 74 68  |ositioning of th|
00007e50  65 20 69 63 6f 6e 2e 20  20 4c 61 72 67 65 72 0a  |e icon.  Larger.|
00007e60  09 09 09 6e 75 6d 62 65  72 73 20 61 72 65 20 74  |...numbers are t|
00007e70  6f 20 74 68 65 20 6f 75  74 73 69 64 65 20 6f 66  |o the outside of|
00007e80  20 74 68 65 20 69 63 6f  6e 20 62 61 72 2e 20 52  | the icon bar. R|
00007e90  61 6e 67 65 0a 09 09 09  66 72 6f 6d 20 30 20 28  |ange....from 0 (|
00007ea0  69 6e 73 69 64 65 29 20  2d 20 26 37 46 46 46 46  |inside) - &7FFFF|
00007eb0  46 46 46 20 28 6f 75 74  73 69 64 65 29 2e 20 20  |FFF (outside).  |
00007ec0  45 78 70 65 72 69 6d 65  6e 74 20 74 6f 0a 09 09  |Experiment to...|
00007ed0  09 73 65 65 20 77 68 65  72 65 20 79 6f 75 72 20  |.see where your |
00007ee0  69 63 6f 6e 73 20 67 65  74 73 20 70 6c 61 63 65  |icons gets place|
00007ef0  64 20 6f 72 20 6c 6f 6f  6b 20 61 74 20 33 2d 39  |d or look at 3-9|
00007f00  38 20 69 6e 0a 09 09 09  74 68 65 20 52 49 53 43  |8 in....the RISC|
00007f10  4f 53 20 33 20 50 52 4d  73 2e 0a 09 09 5b 2d 74  |OS 3 PRMs....[-t|
00007f20  69 6d 65 20 3c 66 6f 72  6d 61 74 3e 5d 0a 09 09  |ime <format>]...|
00007f30  09 54 68 69 73 20 6d 61  6b 65 73 20 74 68 65 20  |.This makes the |
00007f40  74 65 78 74 20 75 6e 64  65 72 20 74 68 65 20 69  |text under the i|
00007f50  63 6f 6e 20 62 65 20 69  6e 74 65 72 70 72 65 74  |con be interpret|
00007f60  65 64 20 61 73 0a 09 09  09 61 20 74 69 6d 65 2c  |ed as....a time,|
00007f70  20 77 68 69 63 68 20 69  73 20 75 70 64 61 74 65  | which is update|
00007f80  64 20 6f 6e 63 65 20 70  65 72 20 73 65 63 6f 6e  |d once per secon|
00007f90  64 2e 20 20 54 68 65 0a  09 09 09 6c 65 6e 67 74  |d.  The....lengt|
00007fa0  68 20 6f 66 20 74 68 65  20 74 69 6d 65 20 69 73  |h of the time is|
00007fb0  20 73 65 74 20 62 79 20  74 68 65 20 2d 74 65 78  | set by the -tex|
00007fc0  74 20 6f 70 74 69 6f 6e  20 77 68 69 63 68 0a 09  |t option which..|
00007fd0  09 09 6d 75 73 74 20 62  65 20 67 69 76 65 6e 20  |..must be given |
00007fe0  61 20 73 74 72 69 6e 67  20 77 68 69 63 68 20 69  |a string which i|
00007ff0  73 20 61 73 20 6c 6f 6e  67 20 61 73 20 74 68 65  |s as long as the|
00008000  0a 09 09 09 6c 6f 6e 67  65 73 74 20 74 69 6d 65  |....longest time|
00008010  20 73 74 72 69 6e 67 2c  20 61 6e 64 20 70 72 65  | string, and pre|
00008020  66 65 72 61 62 6c 79 20  6f 66 20 74 68 65 20 73  |ferably of the s|
00008030  61 6d 65 0a 09 09 09 66  6f 72 6d 61 74 2c 20 65  |ame....format, e|
00008040  67 20 30 30 3a 30 30 20  66 6f 72 20 25 32 34 3a  |g 00:00 for %24:|
00008050  25 6d 69 2e 20 20 53 65  65 20 74 68 65 20 41 70  |%mi.  See the Ap|
00008060  70 6c 69 63 61 74 69 6f  6e 73 0a 09 09 09 47 75  |plications....Gu|
00008070  69 64 65 2c 20 75 6e 64  65 72 20 21 41 6c 61 72  |ide, under !Alar|
00008080  6d 2c 20 22 54 69 6d 65  20 61 6e 64 20 64 61 74  |m, "Time and dat|
00008090  65 20 66 6f 72 6d 61 74  73 22 20 66 6f 72 0a 09  |e formats" for..|
000080a0  09 09 6d 6f 72 65 20 64  65 74 61 69 6c 73 20 6f  |..more details o|
000080b0  72 20 74 68 65 20 52 49  53 43 4f 53 20 33 20 50  |r the RISCOS 3 P|
000080c0  52 4d 73 20 31 2d 34 30  32 2e 0a 09 09 5b 2d 6d  |RMs 1-402....[-m|
000080d0  65 6e 75 20 3c 6d 65 6e  75 3e 5d 0a 09 09 5b 2d  |enu <menu>]...[-|
000080e0  73 65 6c 65 63 74 20 3c  6d 65 6e 75 3e 5d 0a 09  |select <menu>]..|
000080f0  09 5b 2d 61 64 6a 75 73  74 20 3c 6d 65 6e 75 3e  |.[-adjust <menu>|
00008100  5d 0a 09 09 09 54 68 65  73 65 20 61 6c 6c 6f 77  |]....These allow|
00008110  20 79 6f 75 20 74 6f 20  61 74 74 61 63 68 20 6d  | you to attach m|
00008120  65 6e 75 73 20 6f 72 20  63 6f 6d 6d 61 6e 64 73  |enus or commands|
00008130  20 74 6f 20 74 68 65 20  33 0a 09 09 09 6d 6f 75  | to the 3....mou|
00008140  73 65 20 62 75 74 74 6f  6e 73 2e 0a 09 09 5b 2d  |se buttons....[-|
00008150  64 72 61 67 74 6f 20 3c  6d 65 6e 75 3e 5d 0a 09  |dragto <menu>]..|
00008160  09 09 54 68 69 73 20 73  70 65 63 69 66 69 65 73  |..This specifies|
00008170  20 61 20 6d 65 6e 75 20  74 6f 20 62 65 20 72 75  | a menu to be ru|
00008180  6e 20 77 68 65 6e 20 61  20 66 69 6c 65 20 69 73  |n when a file is|
00008190  0a 09 09 09 64 72 61 67  67 65 64 20 6f 6e 74 6f  |....dragged onto|
000081a0  20 74 68 65 20 69 63 6f  6e 2e 20 20 20 20 54 68  | the icon.    Th|
000081b0  65 20 70 61 74 68 20 6f  66 20 74 68 65 20 6f 62  |e path of the ob|
000081c0  6a 65 63 74 0a 09 09 09  64 72 61 67 67 65 64 20  |ject....dragged |
000081d0  63 61 6e 20 62 65 20 66  6f 75 6e 64 20 66 72 6f  |can be found fro|
000081e0  6d 20 44 69 72 65 63 74  6f 72 24 43 75 72 72 65  |m Director$Curre|
000081f0  6e 74 50 61 74 68 20 8c  4c 65 61 66 0a 09 09 09  |ntPath .Leaf....|
00008200  61 6e 64 20 8c 44 69 72  2e 0a 09 09 5b 2d 64 72  |and .Dir....[-dr|
00008210  61 67 66 72 6f 6d 20 3c  70 61 74 68 3e 7c 2a 3c  |agfrom <path>|*<|
00008220  6d 65 6e 75 3e 5d 0a 09  09 09 54 68 69 73 20 65  |menu>]....This e|
00008230  69 74 68 65 72 20 74 61  6b 65 73 20 61 20 70 61  |ither takes a pa|
00008240  74 68 20 77 68 69 63 68  20 74 68 65 6e 20 61 63  |th which then ac|
00008250  74 73 20 65 78 61 63 74  6c 79 20 6c 69 6b 65 0a  |ts exactly like.|
00008260  09 09 09 74 68 65 20 53  61 76 65 42 6f 78 20 6f  |...the SaveBox o|
00008270  72 20 74 61 6b 65 73 20  61 20 6d 65 6e 75 20 70  |r takes a menu p|
00008280  72 65 63 65 64 65 64 20  62 79 20 2a 20 77 68 69  |receded by * whi|
00008290  63 68 20 77 69 6c 6c 0a  09 09 09 62 65 20 72 75  |ch will....be ru|
000082a0  6e 20 77 69 74 68 20 44  69 72 65 63 74 6f 72 24  |n with Director$|
000082b0  43 75 72 72 65 6e 74 50  61 74 68 20 8c 4c 65 61  |CurrentPath .Lea|
000082c0  66 20 61 6e 64 20 8c 44  69 72 20 73 65 74 0a 09  |f and .Dir set..|
000082d0  09 09 75 70 2e 0a 09 09  5b 2d 72 65 6d 6f 76 65  |..up....[-remove|
000082e0  5d 0a 09 09 09 49 66 20  74 68 69 73 20 69 73 20  |]....If this is |
000082f0  73 70 65 63 69 66 69 65  64 20 74 68 65 6e 20 74  |specified then t|
00008300  68 65 20 69 63 6f 6e 20  6e 61 6d 65 64 20 69 73  |he icon named is|
00008310  20 72 65 6d 6f 76 65 64  0a 09 09 09 72 61 74 68  | removed....rath|
00008320  65 72 20 74 68 61 6e 20  63 72 65 61 74 65 64 2e  |er than created.|
00008330  0a 0a 46 6f 72 20 65 78  61 6d 70 6c 65 20 28 74  |..For example (t|
00008340  68 65 73 65 20 73 68 6f  75 6c 64 20 62 65 20 74  |hese should be t|
00008350  79 70 65 64 20 69 6e 20  6f 6e 20 31 20 6c 69 6e  |yped in on 1 lin|
00008360  65 2c 20 62 75 74 20 68  61 76 65 20 62 65 65 6e  |e, but have been|
00008370  20 73 70 6c 69 74 20 66  6f 72 0a 63 6c 61 72 69  | split for.clari|
00008380  74 79 29 0a 0a 09 44 69  72 65 63 74 6f 72 49 63  |ty)...DirectorIc|
00008390  6f 6e 20 72 6f 6d 61 70  70 73 20 41 70 70 73 20  |on romapps Apps |
000083a0  2d 6c 65 66 74 20 2d 70  72 69 6f 72 69 74 79 20  |-left -priority |
000083b0  26 35 30 30 30 30 30 30  30 0a 09 09 2d 6d 65 6e  |&50000000...-men|
000083c0  75 20 22 50 61 74 68 3a  52 65 73 6f 75 72 63 65  |u "Path:Resource|
000083d0  73 3a 24 22 0a 09 09 2d  73 65 6c 65 63 74 20 22  |s:$"...-select "|
000083e0  43 6f 6d 6d 61 6e 64 3a  46 69 6c 65 72 5f 4f 70  |Command:Filer_Op|
000083f0  65 6e 44 69 72 20 52 65  73 6f 75 72 63 65 73 3a  |enDir Resources:|
00008400  24 2e 41 70 70 73 22 0a  09 09 2d 61 64 6a 75 73  |$.Apps"...-adjus|
00008410  74 20 50 69 6e 62 6f 61  72 64 0a 0a 54 68 69 73  |t Pinboard..This|
00008420  20 70 72 6f 76 69 64 65  73 20 61 20 72 65 70 6c  | provides a repl|
00008430  61 63 65 6d 65 6e 74 20  41 70 70 73 20 69 63 6f  |acement Apps ico|
00008440  6e 20 77 68 69 63 68 20  68 61 73 20 74 68 65 20  |n which has the |
00008450  50 69 6e 62 6f 61 72 64  20 6d 65 6e 75 20 6f 6e  |Pinboard menu on|
00008460  20 41 64 6a 75 73 74 2c  0a 64 6f 65 73 20 74 68  | Adjust,.does th|
00008470  65 20 6e 6f 72 6d 61 6c  20 74 68 69 6e 67 20 6f  |e normal thing o|
00008480  6e 20 73 65 6c 65 63 74  2c 20 61 6e 64 20 6f 6e  |n select, and on|
00008490  20 6d 65 6e 75 20 28 77  68 69 63 68 20 77 6f 75  | menu (which wou|
000084a0  6c 64 20 6e 6f 72 6d 61  6c 6c 79 20 73 61 79 0a  |ld normally say.|
000084b0  22 4f 70 65 6e a0 24 22  29 20 70 72 6f 64 75 63  |"Open.$") produc|
000084c0  65 20 61 20 64 69 72 65  63 74 6f 72 79 20 6d 65  |e a directory me|
000084d0  6e 75 20 6f 66 20 74 68  65 20 77 68 6f 6c 65 20  |nu of the whole |
000084e0  6f 66 20 52 65 73 6f 75  72 63 65 73 20 77 68 69  |of Resources whi|
000084f0  63 68 20 69 73 20 75 73  75 61 6c 6c 79 0a 6d 75  |ch is usually.mu|
00008500  63 68 20 6d 6f 72 65 20  75 73 65 66 75 6c 2e 0a  |ch more useful..|
00008510  0a 09 44 69 72 65 63 74  6f 72 49 63 6f 6e 20 21  |..DirectorIcon !|
00008520  44 69 72 65 63 74 6f 72  20 22 30 30 3a 30 30 3a  |Director "00:00:|
00008530  30 30 22 20 2d 6c 65 66  74 20 2d 70 72 69 6f 72  |00" -left -prior|
00008540  69 74 79 20 26 30 45 30  30 30 30 30 30 0a 09 09  |ity &0E000000...|
00008550  2d 6d 65 6e 75 20 49 63  6f 6e 4d 65 6e 75 0a 09  |-menu IconMenu..|
00008560  09 2d 73 65 6c 65 63 74  20 49 63 6f 6e 43 6c 69  |.-select IconCli|
00008570  63 6b 0a 09 09 2d 61 64  6a 75 73 74 20 50 69 6e  |ck...-adjust Pin|
00008580  62 6f 61 72 64 0a 09 09  2d 74 69 6d 65 20 3c 33  |board...-time <3|
00008590  37 3e 32 34 3a 25 4d 49  3a 25 53 45 0a 0a 54 68  |7>24:%MI:%SE..Th|
000085a0  69 73 20 70 72 6f 64 75  63 65 73 20 61 6e 20 69  |is produces an i|
000085b0  63 6f 6e 20 77 69 74 68  20 44 69 72 65 63 74 6f  |con with Directo|
000085c0  72 27 73 20 6f 77 6e 20  69 63 6f 6e 2c 20 74 68  |r's own icon, th|
000085d0  65 20 63 75 72 72 65 6e  74 20 74 69 6d 65 20 69  |e current time i|
000085e0  6e 20 32 34 20 68 6f 75  72 0a 66 6f 72 6d 61 74  |n 24 hour.format|
000085f0  20 61 6e 64 20 33 20 6d  65 6e 75 73 2c 20 49 63  | and 3 menus, Ic|
00008600  6f 6e 43 6c 69 63 6b 2c  20 49 63 6f 6e 4d 65 6e  |onClick, IconMen|
00008610  75 20 61 6e 64 20 50 69  6e 62 6f 61 72 64 2e 0a  |u and Pinboard..|
00008620  0a 5b 4e 42 20 3c 33 37  3e 20 47 53 54 72 61 6e  |.[NB <37> GSTran|
00008630  73 65 73 20 74 6f 20 25  2e 20 20 54 68 69 73 20  |ses to %.  This |
00008640  6f 64 64 20 6c 6f 6f 6b  69 6e 67 20 63 6f 6e 73  |odd looking cons|
00008650  74 72 75 63 74 69 6f 6e  20 69 73 20 6e 65 63 65  |truction is nece|
00008660  73 73 61 72 79 20 62 65  63 61 75 73 65 0a 25 32  |ssary because.%2|
00008670  20 72 65 66 65 72 73 20  74 6f 20 74 68 65 20 73  | refers to the s|
00008680  65 63 6f 6e 64 20 61 72  67 75 6d 65 6e 74 20 73  |econd argument s|
00008690  75 70 70 6c 69 65 64 20  28 77 68 65 6e 20 4f 62  |upplied (when Ob|
000086a0  65 79 69 6e 67 20 74 68  65 20 66 69 6c 65 2c 20  |eying the file, |
000086b0  6e 6f 74 20 69 6e 0a 44  69 72 65 63 74 6f 72 4f  |not in.DirectorO|
000086c0  62 65 79 29 2e 20 20 53  69 6e 63 65 20 6e 6f 20  |bey).  Since no |
000086d0  61 72 67 75 6d 65 6e 74  73 20 77 65 72 65 20 73  |arguments were s|
000086e0  75 70 70 6c 69 65 64 20  74 68 65 6e 20 74 68 65  |upplied then the|
000086f0  20 74 69 6d 65 20 73 74  72 69 6e 67 20 69 73 0a  | time string is.|
00008700  63 6f 6e 76 65 72 74 65  64 20 74 6f 20 34 3a 25  |converted to 4:%|
00008710  4d 49 3a 25 53 45 20 77  68 69 63 68 20 69 73 20  |MI:%SE which is |
00008720  6e 6f 74 20 77 68 61 74  20 77 61 73 20 72 65 71  |not what was req|
00008730  75 69 72 65 64 21 20 20  3c 33 37 3e 20 69 73 20  |uired!  <37> is |
00008740  75 73 65 64 20 72 61 74  68 65 72 0a 74 68 61 6e  |used rather.than|
00008750  20 25 25 20 73 6f 20 74  68 65 20 66 69 6c 65 20  | %% so the file |
00008760  77 69 6c 6c 20 77 6f 72  6b 20 77 69 74 68 20 4f  |will work with O|
00008770  62 65 79 20 61 6e 64 20  44 69 72 65 63 74 6f 72  |bey and Director|
00008780  4f 62 65 79 5d 0a 0a 09  44 69 72 65 63 74 6f 72  |Obey]...Director|
00008790  49 63 6f 6e 20 74 72 61  73 68 63 61 6e 20 2d 6c  |Icon trashcan -l|
000087a0  65 66 74 0a 09 09 2d 64  72 61 67 74 6f 20 22 43  |eft...-dragto "C|
000087b0  6f 6d 6d 61 6e 64 3a 57  69 70 65 20 7c 3c 44 69  |ommand:Wipe |<Di|
000087c0  72 65 63 74 6f 72 24 43  75 72 72 65 6e 74 50 61  |rector$CurrentPa|
000087d0  74 68 3e 20 7e 43 46 52  7e 56 22 0a 0a 54 68 69  |th> ~CFR~V"..Thi|
000087e0  73 20 77 69 6c 6c 20 63  72 65 61 74 65 20 61 20  |s will create a |
000087f0  74 72 61 73 68 20 63 61  6e 20 69 63 6f 6e 20 77  |trash can icon w|
00008800  68 69 63 68 20 77 69 6c  6c 20 64 65 6c 65 74 65  |hich will delete|
00008810  20 61 6c 6c 20 74 68 65  20 69 74 65 6d 73 20 64  | all the items d|
00008820  72 61 67 67 65 64 0a 6f  6e 74 6f 20 69 74 2e 0a  |ragged.onto it..|
00008830  0a 09 44 69 72 65 63 74  6f 72 49 63 6f 6e 20 64  |..DirectorIcon d|
00008840  69 72 65 63 74 6f 72 79  20 2d 6c 65 66 74 0a 09  |irectory -left..|
00008850  09 2d 64 72 61 67 66 72  6f 6d 20 22 2a 43 6f 6d  |.-dragfrom "*Com|
00008860  6d 61 6e 64 3a 44 69 72  20 7c 3c 44 69 72 65 63  |mand:Dir |<Direc|
00008870  74 6f 72 24 43 75 72 72  65 6e 74 50 61 74 68 3e  |tor$CurrentPath>|
00008880  22 0a 0a 54 68 69 73 20  77 68 65 6e 20 79 6f 75  |"..This when you|
00008890  20 64 72 61 67 20 74 68  65 20 64 69 72 65 63 74  | drag the direct|
000088a0  6f 72 79 20 69 63 6f 6e  20 66 72 6f 6d 20 74 68  |ory icon from th|
000088b0  65 20 69 63 6f 6e 20 62  61 72 20 74 6f 20 61 20  |e icon bar to a |
000088c0  66 69 6c 65 72 20 77 69  6e 64 6f 77 0a 74 68 65  |filer window.the|
000088d0  6e 20 69 74 20 77 69 6c  6c 20 73 65 74 20 74 68  |n it will set th|
000088e0  65 20 63 75 72 72 65 6e  74 20 64 69 72 65 63 74  |e current direct|
000088f0  6f 72 79 2e 0a 0a 09 44  69 72 65 63 74 6f 72 49  |ory....DirectorI|
00008900  63 6f 6e 20 66 69 6c 65  5f 66 66 66 20 54 65 78  |con file_fff Tex|
00008910  74 0a 09 09 2d 73 65 6c  65 63 74 20 22 46 69 6c  |t...-select "Fil|
00008920  65 72 5f 52 75 6e 20 24  2e 54 65 78 74 22 0a 09  |er_Run $.Text"..|
00008930  09 2d 64 72 61 67 66 72  6f 6d 20 22 24 2e 54 65  |.-dragfrom "$.Te|
00008940  78 74 22 0a 0a 54 68 69  73 20 77 69 6c 6c 20 6d  |xt"..This will m|
00008950  61 6b 65 20 61 6e 20 69  63 6f 6e 20 77 68 69 63  |ake an icon whic|
00008960  68 20 77 6f 72 6b 73 20  71 75 69 74 65 20 6c 69  |h works quite li|
00008970  6b 65 20 61 20 54 69 6e  79 44 69 72 20 62 75 74  |ke a TinyDir but|
00008980  20 66 6f 72 20 6f 6e 65  20 66 69 6c 65 0a 24 2e  | for one file.$.|
00008990  54 65 78 74 2e 20 20 59  6f 75 20 63 61 6e 20 64  |Text.  You can d|
000089a0  72 61 67 20 74 68 65 20  69 63 6f 6e 20 74 6f 20  |rag the icon to |
000089b0  63 6f 70 79 20 74 68 65  20 66 69 6c 65 20 6f 72  |copy the file or|
000089c0  20 70 75 74 20 69 74 20  69 6e 74 6f 20 61 20 64  | put it into a d|
000089d0  6f 63 75 6d 65 6e 74 20  61 6e 64 0a 63 6c 69 63  |ocument and.clic|
000089e0  6b 20 6f 6e 20 74 68 65  20 69 63 6f 6e 20 74 6f  |k on the icon to|
000089f0  20 72 75 6e 20 74 68 65  20 66 69 6c 65 20 28 69  | run the file (i|
00008a00  6e 20 74 68 65 20 63 61  73 65 20 6f 66 20 61 20  |n the case of a |
00008a10  74 65 78 74 20 66 69 6c  65 20 6c 6f 61 64 20 69  |text file load i|
00008a20  74 20 69 6e 74 6f 20 61  0a 74 65 78 74 20 65 64  |t into a.text ed|
00008a30  69 74 6f 72 29 2e 0a 0a  0a a4 20 44 69 72 65 63  |itor)..... Direc|
00008a40  74 6f 72 79 20 4d 65 6e  75 73 0a 3d 3d 3d 3d 3d  |tory Menus.=====|
00008a50  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 0a 44 69  |============..Di|
00008a60  72 65 63 74 6f 72 79 20  6d 65 6e 75 73 20 61 72  |rectory menus ar|
00008a70  65 20 61 75 74 6f 6d 61  74 69 63 61 6c 6c 79 20  |e automatically |
00008a80  63 72 65 61 74 65 64 20  61 6e 64 20 64 65 73 74  |created and dest|
00008a90  72 6f 79 65 64 20 62 79  20 44 69 72 65 63 74 6f  |royed by Directo|
00008aa0  72 20 77 68 65 6e 20 79  6f 75 0a 63 6c 69 63 6b  |r when you.click|
00008ab0  20 77 69 74 68 20 4d 65  6e 75 20 6f 6e 20 74 68  | with Menu on th|
00008ac0  65 20 74 69 74 6c 65 20  62 61 72 20 6f 66 20 61  |e title bar of a|
00008ad0  20 46 69 6c 65 72 20 6f  72 20 6f 74 68 65 72 20  | Filer or other |
00008ae0  77 69 6e 64 6f 77 20 77  69 74 68 20 61 20 76 61  |window with a va|
00008af0  6c 69 64 20 70 61 74 68  0a 69 6e 20 69 74 20 28  |lid path.in it (|
00008b00  65 67 20 61 6e 20 45 64  69 74 20 77 69 6e 64 6f  |eg an Edit windo|
00008b10  77 29 20 69 6e 20 74 68  65 20 64 65 66 61 75 6c  |w) in the defaul|
00008b20  74 20 73 65 74 20 75 70  2e 20 20 54 68 65 79 20  |t set up.  They |
00008b30  61 72 65 20 61 6c 73 6f  20 70 72 6f 64 75 63 65  |are also produce|
00008b40  64 20 62 79 0a 2d 70 61  74 68 20 22 64 69 72 65  |d by.-path "dire|
00008b50  63 74 6f 72 79 22 20 6f  72 20 43 6f 6d 6d 61 6e  |ctory" or Comman|
00008b60  64 20 22 50 61 74 68 3a  44 69 72 65 63 74 6f 72  |d "Path:Director|
00008b70  79 22 20 65 74 63 2e 0a  0a 41 20 6d 65 6e 75 20  |y" etc...A menu |
00008b80  77 69 6c 6c 20 61 70 70  65 61 72 20 77 69 74 68  |will appear with|
00008b90  20 61 6c 6c 20 74 68 65  20 66 69 6c 65 73 20 74  | all the files t|
00008ba0  68 61 74 20 61 72 65 20  69 6e 20 74 68 65 20 64  |hat are in the d|
00008bb0  69 72 65 63 74 6f 72 79  20 69 6e 20 69 74 2e 20  |irectory in it. |
00008bc0  20 49 74 20 69 73 0a 69  6e 74 65 6e 64 65 64 20  | It is.intended |
00008bd0  74 6f 20 62 65 20 63 6f  6d 70 6c 65 6d 65 6e 74  |to be complement|
00008be0  61 72 79 20 74 6f 20 74  68 65 20 46 69 6c 65 72  |ary to the Filer|
00008bf0  2c 20 71 75 69 63 6b 65  72 20 74 6f 20 75 73 65  |, quicker to use|
00008c00  2c 20 62 75 74 20 6e 6f  74 20 61 73 0a 70 6f 77  |, but not as.pow|
00008c10  65 72 66 75 6c 2e 0a 0a  45 61 63 68 20 69 74 65  |erful...Each ite|
00008c20  6d 20 69 6e 20 74 68 65  20 6d 65 6e 75 20 68 61  |m in the menu ha|
00008c30  73 20 74 68 65 20 6e 61  6d 65 20 6f 66 20 61 20  |s the name of a |
00008c40  66 69 6c 65 20 6f 72 20  64 69 72 65 63 74 6f 72  |file or director|
00008c50  79 20 61 6e 64 20 69 74  73 20 69 63 6f 6e 2e 20  |y and its icon. |
00008c60  20 54 68 69 73 0a 69 73  20 76 65 72 79 20 73 69  | This.is very si|
00008c70  6d 69 6c 61 72 20 74 6f  20 61 20 66 69 6c 65 72  |milar to a filer|
00008c80  20 77 69 6e 64 6f 77 20  77 69 74 68 20 73 6f 72  | window with sor|
00008c90  74 20 62 79 20 6e 61 6d  65 2c 20 73 6d 61 6c 6c  |t by name, small|
00008ca0  20 69 63 6f 6e 73 20 61  6e 64 20 61 64 6a 75 73  | icons and adjus|
00008cb0  74 65 64 0a 74 6f 20 62  65 20 74 61 6c 6c 20 61  |ted.to be tall a|
00008cc0  6e 64 20 74 68 69 6e 2e  0a 0a 49 74 65 6d 73 20  |nd thin...Items |
00008cd0  69 6e 20 74 68 65 20 6d  65 6e 75 20 74 68 61 74  |in the menu that|
00008ce0  20 61 72 65 20 64 69 72  65 63 74 6f 72 69 65 73  | are directories|
00008cf0  20 28 6f 72 20 69 6d 61  67 65 20 66 69 6c 65 73  | (or image files|
00008d00  29 20 77 69 6c 6c 20 68  61 76 65 20 61 20 53 75  |) will have a Su|
00008d10  62 4d 65 6e 75 0a 61 72  72 6f 77 20 62 79 20 74  |bMenu.arrow by t|
00008d20  68 65 6d 2e 20 20 59 6f  75 20 6d 61 79 20 74 72  |hem.  You may tr|
00008d30  61 76 65 72 73 65 20 74  68 69 73 20 61 72 72 6f  |averse this arro|
00008d40  77 20 74 6f 20 73 65 65  20 74 68 65 20 6e 65 78  |w to see the nex|
00008d50  74 20 64 69 72 65 63 74  6f 72 79 20 64 6f 77 6e  |t directory down|
00008d60  2e 0a 0a 43 6c 69 63 6b  69 6e 67 20 77 69 74 68  |...Clicking with|
00008d70  20 53 65 6c 65 63 74 20  6f 72 20 41 64 6a 75 73  | Select or Adjus|
00008d80  74 20 69 73 20 65 71 75  69 76 61 6c 65 6e 74 20  |t is equivalent |
00008d90  74 6f 20 64 6f 75 62 6c  65 20 63 6c 69 63 6b 69  |to double clicki|
00008da0  6e 67 20 74 68 65 20 66  69 6c 65 20 69 6e 20 61  |ng the file in a|
00008db0  0a 66 69 6c 65 72 20 77  69 6e 64 6f 77 2e 0a 0a  |.filer window...|
00008dc0  43 6c 69 63 6b 69 6e 67  20 77 69 74 68 20 4d 65  |Clicking with Me|
00008dd0  6e 75 20 6f 76 65 72 20  61 6e 20 49 74 65 6d 20  |nu over an Item |
00008de0  77 69 6c 6c 20 62 72 69  6e 67 20 75 70 20 74 68  |will bring up th|
00008df0  65 20 4d 65 6e 75 4d 65  6e 75 20 28 73 65 65 20  |e MenuMenu (see |
00008e00  74 68 61 74 20 73 65 63  74 69 6f 6e 0a 66 6f 72  |that section.for|
00008e10  20 6d 6f 72 65 20 64 65  74 61 69 6c 73 29 2e 20  | more details). |
00008e20  20 49 66 20 61 20 4d 65  6e 75 4d 65 6e 75 20 69  | If a MenuMenu i|
00008e30  73 20 6e 6f 74 20 64 65  66 69 6e 65 64 20 74 68  |s not defined th|
00008e40  65 6e 20 69 74 20 77 69  6c 6c 20 64 6f 20 6e 6f  |en it will do no|
00008e50  74 68 69 6e 67 2e 0a 0a  44 69 72 65 63 74 6f 72  |thing...Director|
00008e60  79 20 6d 65 6e 75 73 20  63 6f 6d 65 20 69 6e 20  |y menus come in |
00008e70  32 20 66 6c 61 76 6f 75  72 73 2c 20 77 69 74 68  |2 flavours, with|
00008e80  20 61 6e 64 20 77 69 74  68 6f 75 74 20 22 55 70  | and without "Up|
00008e90  20 4d 65 6e 75 73 22 2e  20 20 55 70 20 4d 65 6e  | Menus".  Up Men|
00008ea0  75 73 0a 61 72 65 20 74  68 65 20 64 69 72 65 63  |us.are the direc|
00008eb0  74 6f 72 69 65 73 20 61  62 6f 76 65 20 74 68 65  |tories above the|
00008ec0  20 64 6f 74 74 65 64 20  6c 69 6e 65 2e 20 20 54  | dotted line.  T|
00008ed0  68 65 73 65 20 73 68 6f  77 20 74 68 65 20 64 69  |hese show the di|
00008ee0  72 65 63 74 6f 72 69 65  73 20 75 70 20 74 6f 0a  |rectories up to.|
00008ef0  74 68 65 20 72 6f 6f 74  20 66 72 6f 6d 20 77 68  |the root from wh|
00008f00  65 72 65 20 79 6f 75 20  61 72 65 20 6e 6f 77 2e  |ere you are now.|
00008f10  20 20 54 68 65 20 66 69  72 73 74 20 69 74 65 6d  |  The first item|
00008f20  20 61 62 6f 76 65 20 74  68 65 20 64 6f 74 74 65  | above the dotte|
00008f30  64 20 6c 69 6e 65 20 6e  65 76 65 72 0a 68 61 73  |d line never.has|
00008f40  20 61 20 73 75 62 2d 6d  65 6e 75 20 62 65 63 61  | a sub-menu beca|
00008f50  75 73 65 20 74 68 65 20  69 74 65 6d 20 6f 72 20  |use the item or |
00008f60  74 68 65 20 63 6f 6e 74  65 6e 74 73 20 6f 66 20  |the contents of |
00008f70  74 68 61 74 20 69 74 65  6d 20 61 72 65 20 61 6c  |that item are al|
00008f80  77 61 79 73 0a 76 69 73  69 62 6c 65 2e 0a 0a 41  |ways.visible...A|
00008f90  20 64 69 72 65 63 74 6f  72 79 20 6d 65 6e 75 20  | directory menu |
00008fa0  6d 61 64 65 20 62 79 20  22 50 61 74 68 3a 22 20  |made by "Path:" |
00008fb0  68 61 73 20 55 70 20 4d  65 6e 75 73 20 28 65 67  |has Up Menus (eg|
00008fc0  20 74 68 65 20 6f 6e 65  73 20 70 72 6f 64 75 63  | the ones produc|
00008fd0  65 64 20 62 79 0a 63 6c  69 63 6b 69 6e 67 20 4d  |ed by.clicking M|
00008fe0  65 6e 75 20 6f 76 65 72  20 61 20 74 69 74 6c 65  |enu over a title|
00008ff0  20 62 61 72 29 2e 20 20  41 20 64 69 72 65 63 74  | bar).  A direct|
00009000  6f 72 79 20 6d 65 6e 75  20 6d 61 64 65 20 62 79  |ory menu made by|
00009010  20 2d 70 61 74 68 20 64  6f 65 73 20 6e 6f 74 0a  | -path does not.|
00009020  68 61 76 65 20 55 70 20  4d 65 6e 75 73 20 62 79  |have Up Menus by|
00009030  20 64 65 66 61 75 6c 74  20 75 6e 6c 65 73 73 20  | default unless |
00009040  79 6f 75 20 75 73 65 20  74 68 65 20 2d 75 70 20  |you use the -up |
00009050  73 77 69 74 63 68 2e 0a  0a 0a a4 20 46 69 6c 74  |switch..... Filt|
00009060  65 72 73 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 46  |ers.=========..F|
00009070  69 6c 74 65 72 73 20 61  72 65 20 61 20 70 6f 77  |ilters are a pow|
00009080  65 72 66 75 6c 20 77 61  79 20 74 6f 20 63 68 61  |erful way to cha|
00009090  6e 67 65 20 74 68 65 20  61 70 70 65 61 72 61 6e  |nge the appearan|
000090a0  63 65 20 6f 66 20 79 6f  75 72 20 64 65 73 6b 74  |ce of your deskt|
000090b0  6f 70 2e 20 20 59 6f 75  20 6d 61 79 0a 61 64 64  |op.  You may.add|
000090c0  20 6e 65 77 20 6d 65 6e  75 73 20 6f 72 20 63 6f  | new menus or co|
000090d0  6d 6d 61 6e 64 73 20 74  6f 20 65 78 69 73 74 69  |mmands to existi|
000090e0  6e 67 20 64 65 73 6b 74  6f 70 20 66 65 61 74 75  |ng desktop featu|
000090f0  72 65 73 20 77 69 74 68  6f 75 74 20 68 61 76 69  |res without havi|
00009100  6e 67 20 74 6f 0a 70 61  74 63 68 20 61 6e 79 74  |ng to.patch anyt|
00009110  68 69 6e 67 2e 20 20 46  6f 72 20 69 6e 73 74 61  |hing.  For insta|
00009120  6e 63 65 20 79 6f 75 20  63 6f 75 6c 64 20 61 64  |nce you could ad|
00009130  64 20 61 20 6e 65 77 20  6d 65 6e 75 20 6f 6e 74  |d a new menu ont|
00009140  6f 20 74 68 65 20 74 61  73 6b 20 73 77 69 74 63  |o the task switc|
00009150  68 65 72 0a 69 63 6f 6e  20 6f 72 20 63 61 75 73  |her.icon or caus|
00009160  65 20 6d 65 6e 75 20 6f  76 65 72 20 61 6e 79 20  |e menu over any |
00009170  63 6c 6f 73 65 20 69 63  6f 6e 20 74 6f 20 63 6f  |close icon to co|
00009180  6d 65 20 75 70 20 77 69  74 68 20 61 20 6d 65 6e  |me up with a men|
00009190  75 2e 0a 0a 46 69 6c 74  65 72 73 20 61 72 65 20  |u...Filters are |
000091a0  72 65 66 65 72 72 65 64  20 74 6f 20 62 79 20 6e  |referred to by n|
000091b0  61 6d 65 20 28 63 61 73  65 20 69 6e 73 65 6e 73  |ame (case insens|
000091c0  69 74 69 76 65 29 20 61  73 20 73 75 70 70 6c 69  |itive) as suppli|
000091d0  65 64 20 69 6e 20 74 68  65 0a 63 6f 6d 6d 61 6e  |ed in the.comman|
000091e0  64 2e 20 20 54 68 65 72  65 20 63 61 6e 20 6f 6e  |d.  There can on|
000091f0  6c 79 20 62 65 20 6f 6e  65 20 66 69 6c 74 65 72  |ly be one filter|
00009200  20 6f 66 20 61 6e 79 20  67 69 76 65 6e 20 6e 61  | of any given na|
00009210  6d 65 2c 20 61 6e 64 20  69 66 20 79 6f 75 20 61  |me, and if you a|
00009220  74 74 65 6d 70 74 0a 74  6f 20 63 72 65 61 74 65  |ttempt.to create|
00009230  20 61 20 66 69 6c 74 65  72 20 77 69 74 68 20 74  | a filter with t|
00009240  68 65 20 73 61 6d 65 20  6e 61 6d 65 20 61 73 20  |he same name as |
00009250  61 6e 20 65 78 69 73 74  69 6e 67 20 6f 6e 65 20  |an existing one |
00009260  74 68 65 6e 20 74 68 65  20 65 78 69 73 74 69 6e  |then the existin|
00009270  67 0a 66 69 6c 74 65 72  20 77 69 6c 6c 20 62 65  |g.filter will be|
00009280  20 64 65 6c 65 74 65 64  20 77 69 74 68 6f 75 74  | deleted without|
00009290  20 77 61 72 6e 69 6e 67  2e 0a 0a 09 44 69 72 65  | warning....Dire|
000092a0  63 74 6f 72 46 69 6c 74  65 72 20 3c 6e 61 6d 65  |ctorFilter <name|
000092b0  3e 20 3c 74 61 73 6b 3e  20 3c 6d 65 6e 75 3e 0a  |> <task> <menu>.|
000092c0  09 09 5b 2d 69 63 6f 6e  20 3c 6e 3e 5d 0a 09 09  |..[-icon <n>]...|
000092d0  5b 2d 73 65 6c 65 63 74  5d 20 5b 2d 6d 65 6e 75  |[-select] [-menu|
000092e0  5d 20 5b 2d 61 64 6a 75  73 74 5d 0a 09 09 5b 2d  |] [-adjust]...[-|
000092f0  73 68 69 66 74 5d 20 5b  2d 63 74 72 6c 5d 20 5b  |shift] [-ctrl] [|
00009300  2d 61 6c 74 5d 0a 09 09  5b 2d 72 65 6d 6f 76 65  |-alt]...[-remove|
00009310  5d 0a 0a 3c 6e 61 6d 65  3e 20 69 73 20 74 68 65  |]..<name> is the|
00009320  20 6e 61 6d 65 20 6f 66  20 74 68 65 20 66 69 6c  | name of the fil|
00009330  74 65 72 20 74 6f 20 62  65 20 64 65 66 69 6e 65  |ter to be define|
00009340  64 0a 0a 3c 74 61 73 6b  3e 20 69 73 20 74 68 65  |d..<task> is the|
00009350  20 6e 61 6d 65 20 6f 66  20 74 68 65 20 74 61 73  | name of the tas|
00009360  6b 20 74 6f 20 66 69 6c  74 65 72 20 6f 6e 20 6f  |k to filter on o|
00009370  72 20 2a 20 66 6f 72 20  61 6c 6c 20 74 61 73 6b  |r * for all task|
00009380  73 2e 20 20 54 68 69 73  20 74 61 73 6b 0a 64 6f  |s.  This task.do|
00009390  65 73 20 6e 6f 74 20 6e  6f 74 20 68 61 76 65 20  |es not not have |
000093a0  74 6f 20 62 65 20 72 75  6e 6e 69 6e 67 20 77 68  |to be running wh|
000093b0  65 6e 20 74 68 65 20 63  6f 6d 6d 61 6e 64 20 69  |en the command i|
000093c0  73 20 65 78 65 63 75 74  65 64 20 61 6e 64 20 64  |s executed and d|
000093d0  69 72 65 63 74 6f 72 0a  77 69 6c 6c 20 6b 65 65  |irector.will kee|
000093e0  70 20 74 72 61 63 6b 20  6f 66 20 74 68 65 20 74  |p track of the t|
000093f0  61 73 6b 20 69 66 20 69  74 20 69 73 20 73 68 75  |ask if it is shu|
00009400  74 20 64 6f 77 6e 20 61  6e 64 20 72 65 2d 73 74  |t down and re-st|
00009410  61 72 74 65 64 2e 0a 0a  3c 6d 65 6e 75 3e 20 69  |arted...<menu> i|
00009420  73 20 74 68 65 20 6d 65  6e 75 20 28 6f 72 20 63  |s the menu (or c|
00009430  6f 6d 6d 61 6e 64 29 20  74 6f 20 62 65 20 65 78  |ommand) to be ex|
00009440  65 63 75 74 65 64 20 62  79 20 74 68 65 20 66 69  |ecuted by the fi|
00009450  6c 74 65 72 0a 0a 2d 69  63 6f 6e 20 3c 6e 3e 20  |lter..-icon <n> |
00009460  64 65 66 69 6e 65 73 20  61 6e 20 69 63 6f 6e 20  |defines an icon |
00009470  6e 75 6d 62 65 72 20 66  6f 72 20 74 68 65 20 66  |number for the f|
00009480  69 6c 74 65 72 20 74 6f  20 65 78 65 63 75 74 65  |ilter to execute|
00009490  2e 20 20 49 66 20 74 68  69 73 20 6e 75 6d 62 65  |.  If this numbe|
000094a0  72 0a 69 73 20 3e 3d 20  30 20 74 68 65 6e 20 69  |r.is >= 0 then i|
000094b0  74 20 77 69 6c 6c 20 64  65 66 69 6e 65 20 61 20  |t will define a |
000094c0  6e 6f 72 6d 61 6c 20 69  63 6f 6e 20 28 6c 6f 61  |normal icon (loa|
000094d0  64 20 74 68 65 20 74 65  6d 70 6c 61 74 65 20 6f  |d the template o|
000094e0  66 20 74 68 65 20 77 69  6e 64 6f 77 0a 79 6f 75  |f the window.you|
000094f0  20 61 72 65 20 69 6e 74  65 72 65 73 74 65 64 20  | are interested |
00009500  69 6e 20 69 6e 74 6f 20  61 20 74 65 6d 70 6c 61  |in into a templa|
00009510  74 65 20 65 64 69 74 6f  72 20 74 6f 20 64 69 73  |te editor to dis|
00009520  63 6f 76 65 72 20 74 68  65 20 69 63 6f 6e 20 6e  |cover the icon n|
00009530  75 6d 62 65 72 20 6f 72  0a 75 73 65 20 74 72 69  |umber or.use tri|
00009540  61 6c 20 61 6e 64 20 65  72 72 6f 72 29 2e 20 20  |al and error).  |
00009550  54 68 65 20 66 69 6c 65  20 44 69 72 65 63 74 6f  |The file Directo|
00009560  72 3a 4d 65 6e 75 73 2e  41 6c 69 61 73 65 73 20  |r:Menus.Aliases |
00009570  63 6f 6e 74 61 69 6e 73  20 6e 61 6d 65 73 20 66  |contains names f|
00009580  6f 72 20 61 0a 6e 75 6d  62 65 72 20 73 70 65 63  |or a.number spec|
00009590  69 61 6c 20 69 63 6f 6e  73 20 77 68 69 63 68 20  |ial icons which |
000095a0  61 72 65 20 70 72 6f 62  61 62 6c 79 20 6d 6f 72  |are probably mor|
000095b0  65 20 75 73 65 66 75 6c  0a 0a 57 6f 72 6b 41 72  |e useful..WorkAr|
000095c0  65 61 09 09 2d 20 62 61  63 6b 67 72 6f 75 6e 64  |ea..- background|
000095d0  20 6f 66 20 61 20 77 69  6e 64 6f 77 20 77 69 74  | of a window wit|
000095e0  68 20 6e 6f 20 69 63 6f  6e 73 0a 42 61 63 6b 49  |h no icons.BackI|
000095f0  63 6f 6e 09 09 2d 20 62  61 63 6b 20 69 63 6f 6e  |con..- back icon|
00009600  20 69 6e 20 74 68 65 20  74 6f 70 20 6c 65 66 74  | in the top left|
00009610  20 6f 66 20 61 20 77 69  6e 64 6f 77 0a 43 6c 6f  | of a window.Clo|
00009620  73 65 49 63 6f 6e 09 09  2d 20 63 6c 6f 73 65 20  |seIcon..- close |
00009630  69 63 6f 6e 20 69 6e 20  74 68 65 20 74 6f 70 20  |icon in the top |
00009640  6c 65 66 74 20 6f 66 20  61 20 77 69 6e 64 6f 77  |left of a window|
00009650  0a 54 69 74 6c 65 42 61  72 09 09 2d 20 74 69 74  |.TitleBar..- tit|
00009660  6c 65 20 62 61 72 20 61  74 20 74 68 65 20 74 6f  |le bar at the to|
00009670  70 20 6f 66 20 61 20 77  69 6e 64 6f 77 0a 54 6f  |p of a window.To|
00009680  67 67 6c 65 53 69 7a 65  49 63 6f 6e 09 09 2d 20  |ggleSizeIcon..- |
00009690  74 6f 67 67 6c 65 20 73  69 7a 65 20 69 63 6f 6e  |toggle size icon|
000096a0  20 61 74 20 74 68 65 20  74 6f 70 20 72 69 67 68  | at the top righ|
000096b0  74 20 6f 66 20 61 20 77  69 6e 64 6f 77 0a 53 63  |t of a window.Sc|
000096c0  72 6f 6c 6c 55 70 41 72  72 6f 77 09 09 2d 20 73  |rollUpArrow..- s|
000096d0  63 72 6f 6c 6c 20 75 70  20 61 72 72 6f 77 0a 56  |croll up arrow.V|
000096e0  65 72 74 69 63 61 6c 53  63 72 6f 6c 6c 42 61 72  |erticalScrollBar|
000096f0  09 2d 20 76 65 72 74 69  63 61 6c 20 73 63 72 6f  |.- vertical scro|
00009700  6c 6c 20 62 61 72 0a 53  63 72 6f 6c 6c 44 6f 77  |ll bar.ScrollDow|
00009710  6e 41 72 72 6f 77 09 09  2d 20 73 63 72 6f 6c 6c  |nArrow..- scroll|
00009720  20 64 6f 77 6e 20 61 72  72 6f 77 0a 41 64 6a 75  | down arrow.Adju|
00009730  73 74 53 69 7a 65 49 63  6f 6e 09 09 2d 20 61 64  |stSizeIcon..- ad|
00009740  6a 75 73 74 20 73 69 7a  65 20 69 63 6f 6e 20 61  |just size icon a|
00009750  74 20 74 68 65 20 62 6f  74 74 6f 6d 20 72 69 67  |t the bottom rig|
00009760  68 74 20 6f 66 20 61 20  77 69 6e 64 6f 77 0a 53  |ht of a window.S|
00009770  63 72 6f 6c 6c 4c 65 66  74 41 72 72 6f 77 09 09  |crollLeftArrow..|
00009780  2d 20 73 63 72 6f 6c 6c  20 6c 65 66 74 20 61 72  |- scroll left ar|
00009790  72 6f 77 0a 48 6f 72 69  7a 6f 6e 74 61 6c 53 63  |row.HorizontalSc|
000097a0  72 6f 6c 6c 42 61 72 09  2d 20 68 6f 72 69 7a 6f  |rollBar.- horizo|
000097b0  6e 74 61 6c 20 73 63 72  6f 6c 6c 20 62 61 72 0a  |ntal scroll bar.|
000097c0  53 63 72 6f 6c 6c 52 69  67 68 74 41 72 72 6f 77  |ScrollRightArrow|
000097d0  09 2d 20 73 63 72 6f 6c  6c 20 72 69 67 68 74 20  |.- scroll right |
000097e0  61 72 72 6f 77 0a 4f 75  74 65 72 57 69 6e 64 6f  |arrow.OuterWindo|
000097f0  77 46 72 61 6d 65 09 2d  20 6f 75 74 65 72 20 66  |wFrame.- outer f|
00009800  72 61 6d 65 20 6f 66 20  74 68 65 20 77 69 6e 64  |rame of the wind|
00009810  6f 77 20 28 31 20 70 69  78 65 6c 20 77 69 64 65  |ow (1 pixel wide|
00009820  29 0a 49 63 6f 6e 42 61  72 09 09 09 2d 20 61 6e  |).IconBar...- an|
00009830  20 69 63 6f 6e 20 62 61  72 20 69 63 6f 6e 20 6f  | icon bar icon o|
00009840  6e 6c 79 0a 0a 2d 73 65  6c 65 63 74 20 2d 6d 65  |nly..-select -me|
00009850  6e 75 20 2d 61 64 6a 75  73 74 20 2d 73 68 69 66  |nu -adjust -shif|
00009860  74 20 2d 63 74 72 6c 20  2d 61 6c 74 20 61 72 65  |t -ctrl -alt are|
00009870  20 74 68 65 20 63 6f 6e  64 69 74 69 6f 6e 73 20  | the conditions |
00009880  69 6e 20 77 68 69 63 68  20 74 68 65 0a 66 69 6c  |in which the.fil|
00009890  74 65 72 20 65 78 65 63  75 74 65 73 2e 20 20 54  |ter executes.  T|
000098a0  68 65 20 62 75 74 74 6f  6e 20 6e 61 6d 65 64 20  |he button named |
000098b0  6d 75 73 74 20 62 65 20  64 6f 77 6e 20 66 6f 72  |must be down for|
000098c0  20 74 68 65 20 63 6f 6d  6d 61 6e 64 20 74 6f 20  | the command to |
000098d0  65 78 65 63 75 74 65 2e  20 0a 54 68 65 79 20 6d  |execute. .They m|
000098e0  61 79 20 62 65 20 75 73  65 64 20 69 6e 20 61 6e  |ay be used in an|
000098f0  79 20 63 6f 6d 62 69 6e  61 74 69 6f 6e 20 61 6e  |y combination an|
00009900  64 20 61 72 65 20 65 78  63 6c 75 73 69 76 65 20  |d are exclusive |
00009910  28 69 65 20 2d 73 68 69  66 74 20 2d 61 64 6a 75  |(ie -shift -adju|
00009920  73 74 20 77 69 6c 6c 0a  6f 6e 6c 79 20 65 78 65  |st will.only exe|
00009930  63 75 74 65 20 69 66 20  53 48 49 46 54 20 61 6e  |cute if SHIFT an|
00009940  64 20 41 44 4a 55 53 54  20 61 72 65 20 70 72 65  |d ADJUST are pre|
00009950  73 73 65 64 20 61 6e 64  20 6e 6f 74 20 69 66 20  |ssed and not if |
00009960  53 48 49 46 54 20 41 4c  54 20 41 44 4a 55 53 54  |SHIFT ALT ADJUST|
00009970  20 61 72 65 0a 70 72 65  73 73 65 64 20 29 2e 0a  | are.pressed )..|
00009980  0a 2d 72 65 6d 6f 76 65  20 72 65 6d 6f 76 65 73  |.-remove removes|
00009990  20 61 20 66 69 6c 74 65  72 20 66 72 6f 6d 20 64  | a filter from d|
000099a0  69 72 65 63 74 6f 72 27  73 20 6d 65 6d 6f 72 79  |irector's memory|
000099b0  20 61 6e 64 20 73 74 6f  70 73 20 69 74 20 65 78  | and stops it ex|
000099c0  65 63 75 74 69 6e 67 2e  0a 0a 45 78 61 6d 70 6c  |ecuting...Exampl|
000099d0  65 73 20 28 74 68 65 73  65 20 68 61 76 65 20 62  |es (these have b|
000099e0  65 65 6e 20 73 70 6c 69  74 20 6f 76 65 72 20 6c  |een split over l|
000099f0  69 6e 65 73 20 66 6f 72  20 72 65 61 64 61 62 69  |ines for readabi|
00009a00  6c 69 74 79 20 62 75 74  20 73 68 6f 75 6c 64 20  |lity but should |
00009a10  62 65 0a 65 6e 74 65 72  65 64 20 6f 6e 20 6f 6e  |be.entered on on|
00009a20  65 20 6c 69 6e 65 29 0a  0a 09 44 69 72 65 63 74  |e line)...Direct|
00009a30  6f 72 46 69 6c 74 65 72  20 22 54 69 74 6c 65 20  |orFilter "Title |
00009a40  42 61 72 20 44 69 72 65  63 74 6f 72 79 22 20 2a  |Bar Directory" *|
00009a50  20 50 61 74 68 3a 20 2d  69 63 6f 6e 20 54 69 74  | Path: -icon Tit|
00009a60  6c 65 42 61 72 20 2d 6d  65 6e 75 0a 09 09 54 68  |leBar -menu...Th|
00009a70  69 73 20 66 69 6c 74 65  72 20 6d 61 6b 65 73 20  |is filter makes |
00009a80  61 20 64 69 72 65 63 74  6f 72 79 20 6d 65 6e 75  |a directory menu|
00009a90  20 77 68 65 6e 20 79 6f  75 20 70 72 65 73 73 20  | when you press |
00009aa0  6d 65 6e 75 20 6f 76 65  72 0a 09 09 74 68 65 20  |menu over...the |
00009ab0  74 69 74 6c 65 20 62 61  72 20 6f 66 20 61 6e 79  |title bar of any|
00009ac0  20 77 69 6e 64 6f 77 2e  0a 09 44 69 72 65 63 74  | window...Direct|
00009ad0  6f 72 46 69 6c 74 65 72  20 22 41 6c 74 20 4d 65  |orFilter "Alt Me|
00009ae0  6e 75 20 44 69 72 65 63  74 6f 72 79 22 20 46 69  |nu Directory" Fi|
00009af0  6c 65 72 20 50 61 74 68  3a 20 2d 6d 65 6e 75 20  |ler Path: -menu |
00009b00  2d 61 6c 74 0a 09 09 54  68 69 73 20 66 69 6c 74  |-alt...This filt|
00009b10  65 72 20 6d 61 6b 65 73  20 61 20 64 69 72 65 63  |er makes a direc|
00009b20  74 6f 72 79 20 6d 65 6e  75 20 77 68 65 6e 20 79  |tory menu when y|
00009b30  6f 75 20 70 72 65 73 73  20 41 4c 54 20 4d 45 4e  |ou press ALT MEN|
00009b40  55 0a 09 09 6f 76 65 72  20 61 20 66 69 6c 65 72  |U...over a filer|
00009b50  20 77 69 6e 64 6f 77 0a  09 44 69 72 65 63 74 6f  | window..Directo|
00009b60  72 46 69 6c 74 65 72 20  22 50 69 6e 62 6f 61 72  |rFilter "Pinboar|
00009b70  64 22 20 50 69 6e 62 6f  61 72 64 20 50 69 6e 62  |d" Pinboard Pinb|
00009b80  6f 61 72 64 20 2d 69 63  6f 6e 20 57 6f 72 6b 41  |oard -icon WorkA|
00009b90  72 65 61 20 2d 6d 65 6e  75 0a 09 09 54 68 69 73  |rea -menu...This|
00009ba0  20 6f 70 65 6e 73 20 61  20 6d 65 6e 75 20 63 61  | opens a menu ca|
00009bb0  6c 6c 65 64 20 70 69 6e  62 6f 61 72 64 20 77 68  |lled pinboard wh|
00009bc0  65 6e 20 6d 65 6e 75 20  69 73 20 70 72 65 73 73  |en menu is press|
00009bd0  65 64 20 6f 76 65 72 0a  09 09 74 68 65 20 77 6f  |ed over...the wo|
00009be0  72 6b 20 61 72 65 61 20  6f 66 20 74 68 65 20 70  |rk area of the p|
00009bf0  69 6e 62 6f 61 72 64 2e  20 20 49 66 20 79 6f 75  |inboard.  If you|
00009c00  20 70 72 65 73 73 20 6d  65 6e 75 20 6f 76 65 72  | press menu over|
00009c10  20 61 6e 0a 09 09 69 63  6f 6e 20 6f 6e 20 74 68  | an...icon on th|
00009c20  65 20 70 69 6e 62 6f 61  72 64 20 74 68 65 6e 20  |e pinboard then |
00009c30  79 6f 75 20 77 69 6c 6c  20 67 65 74 20 74 68 65  |you will get the|
00009c40  20 70 69 6e 62 6f 61 72  64 20 6d 65 6e 75 2e 0a  | pinboard menu..|
00009c50  09 44 69 72 65 63 74 6f  72 46 69 6c 74 65 72 20  |.DirectorFilter |
00009c60  22 43 6c 6f 73 65 20 49  63 6f 6e 22 20 2a 0a 09  |"Close Icon" *..|
00009c70  09 22 44 79 6e 61 6d 69  63 3a 44 69 72 65 63 74  |."Dynamic:Direct|
00009c80  6f 72 4f 62 65 79 20 44  69 72 65 63 74 6f 72 3a  |orObey Director:|
00009c90  4d 65 6e 75 73 2e 53 79  73 74 65 6d 2e 43 6c 6f  |Menus.System.Clo|
00009ca0  73 65 22 0a 09 09 2d 69  63 6f 6e 20 43 6c 6f 73  |se"...-icon Clos|
00009cb0  65 49 63 6f 6e 20 2d 6d  65 6e 75 0a 09 09 54 68  |eIcon -menu...Th|
00009cc0  69 73 20 6d 61 6b 65 73  20 61 20 6d 65 6e 75 20  |is makes a menu |
00009cd0  61 70 70 65 61 72 20 77  68 65 6e 20 79 6f 75 20  |appear when you |
00009ce0  70 72 65 73 73 20 6d 65  6e 75 20 6f 76 65 72 20  |press menu over |
00009cf0  61 6e 79 20 63 6c 6f 73  65 0a 09 09 62 6f 78 2e  |any close...box.|
00009d00  20 20 54 68 65 20 6d 65  6e 75 20 69 73 20 61 20  |  The menu is a |
00009d10  64 79 6e 61 6d 69 63 20  6d 65 6e 75 20 62 65 63  |dynamic menu bec|
00009d20  61 75 73 65 20 69 74 20  61 64 6a 75 73 74 73 20  |ause it adjusts |
00009d30  69 74 73 65 6c 66 20 74  6f 0a 09 09 74 68 65 20  |itself to...the |
00009d40  77 69 6e 64 6f 77 20 69  74 20 77 61 73 20 75 73  |window it was us|
00009d50  65 64 20 6f 76 65 72 20  75 73 69 6e 67 20 20 44  |ed over using  D|
00009d60  69 72 65 63 74 6f 72 24  57 69 6e 64 6f 77 20 61  |irector$Window a|
00009d70  6e 64 0a 09 09 44 69 72  65 63 74 6f 72 24 49 63  |nd...Director$Ic|
00009d80  6f 6e 2e 0a 09 44 69 72  65 63 74 6f 72 46 69 6c  |on...DirectorFil|
00009d90  74 65 72 20 22 44 69 73  70 6c 61 79 20 4d 61 6e  |ter "Display Man|
00009da0  61 67 65 72 20 41 64 6a  75 73 74 22 20 22 44 69  |ager Adjust" "Di|
00009db0  73 70 6c 61 79 20 4d 61  6e 61 67 65 72 22 20 22  |splay Manager" "|
00009dc0  4d 6f 64 65 22 0a 09 09  2d 69 63 6f 6e 20 49 63  |Mode"...-icon Ic|
00009dd0  6f 6e 42 61 72 20 2d 61  64 6a 75 73 74 0a 09 09  |onBar -adjust...|
00009de0  54 68 69 73 20 61 64 64  73 20 61 6e 20 65 78 74  |This adds an ext|
00009df0  72 61 20 6d 65 6e 75 20  74 6f 20 74 68 65 20 64  |ra menu to the d|
00009e00  69 73 70 6c 61 79 20 6d  61 6e 61 67 65 72 20 69  |isplay manager i|
00009e10  63 6f 6e 20 62 61 72 20  69 63 6f 6e 0a 09 09 77  |con bar icon...w|
00009e20  68 65 6e 20 69 74 20 69  73 20 63 6c 69 63 6b 65  |hen it is clicke|
00009e30  64 20 77 69 74 68 20 61  64 6a 75 73 74 2e 0a 09  |d with adjust...|
00009e40  44 69 72 65 63 74 6f 72  46 69 6c 74 65 72 20 22  |DirectorFilter "|
00009e50  54 61 73 6b 20 4d 61 6e  61 67 65 72 20 41 64 6a  |Task Manager Adj|
00009e60  75 73 74 22 20 22 54 61  73 6b 20 4d 61 6e 61 67  |ust" "Task Manag|
00009e70  65 72 22 0a 09 09 22 44  79 6e 61 6d 69 63 3a 44  |er"..."Dynamic:D|
00009e80  69 72 65 63 74 6f 72 4f  62 65 79 20 44 69 72 65  |irectorObey Dire|
00009e90  63 74 6f 72 3a 4d 65 6e  75 73 2e 53 79 73 74 65  |ctor:Menus.Syste|
00009ea0  6d 2e 54 69 6d 65 22 0a  09 09 2d 69 63 6f 6e 20  |m.Time"...-icon |
00009eb0  49 63 6f 6e 42 61 72 20  2d 61 64 6a 75 73 74 0a  |IconBar -adjust.|
00009ec0  09 09 54 68 69 73 20 73  68 6f 77 73 20 74 68 65  |..This shows the|
00009ed0  20 74 69 6d 65 20 77 68  65 6e 20 61 64 6a 75 73  | time when adjus|
00009ee0  74 20 69 73 20 63 6c 69  63 6b 65 64 20 6f 76 65  |t is clicked ove|
00009ef0  72 20 74 68 65 20 73 77  69 74 63 68 65 72 0a 09  |r the switcher..|
00009f00  09 69 63 6f 6e 0a 0a 59  6f 75 20 6d 61 79 20 61  |.icon..You may a|
00009f10  74 74 61 63 68 20 74 68  65 20 6f 72 69 67 69 6e  |ttach the origin|
00009f20  61 6c 20 61 63 74 69 6f  6e 20 6f 66 20 74 68 65  |al action of the|
00009f30  20 66 69 6c 74 65 72 65  64 20 6f 62 6a 65 63 74  | filtered object|
00009f40  20 62 79 20 69 6e 63 6c  75 64 69 6e 67 0a 4f 6c  | by including.Ol|
00009f50  64 4d 65 6e 75 3a 20 61  73 20 61 6e 20 6f 70 74  |dMenu: as an opt|
00009f60  69 6f 6e 20 69 6e 20 74  68 65 20 66 69 6c 74 65  |ion in the filte|
00009f70  72 20 6d 65 6e 75 2e 0a  0a 0a a4 20 4f 74 68 65  |r menu..... Othe|
00009f80  72 20 46 65 61 74 75 72  65 73 0a 3d 3d 3d 3d 3d  |r Features.=====|
00009f90  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 0a 0a 49 66 20  |===========..If |
00009fa0  79 6f 75 20 64 6f 20 61  6e 20 41 64 6a 75 73 74  |you do an Adjust|
00009fb0  20 63 6c 69 63 6b 20 6f  6e 20 61 20 64 72 69 76  | click on a driv|
00009fc0  65 20 69 63 6f 6e 20 6f  6e 20 74 68 65 20 69 63  |e icon on the ic|
00009fd0  6f 6e 20 62 61 72 20 69  74 20 73 68 6f 75 6c 64  |on bar it should|
00009fe0  20 6f 70 65 6e 20 61 0a  44 69 72 65 63 74 6f 72  | open a.Director|
00009ff0  79 20 4d 65 6e 75 20 72  61 74 68 65 72 20 74 68  |y Menu rather th|
0000a000  61 6e 20 61 20 46 69 6c  65 72 20 77 69 6e 64 6f  |an a Filer windo|
0000a010  77 2e 20 20 57 6f 72 6b  73 20 66 6f 72 20 41 44  |w.  Works for AD|
0000a020  46 53 2c 20 41 63 6f 72  6e 20 53 43 53 49 2c 20  |FS, Acorn SCSI, |
0000a030  4d 4f 46 53 2c 0a 52 41  4d 46 53 2c 20 4d 65 6d  |MOFS,.RAMFS, Mem|
0000a040  70 68 69 73 2c 20 43 46  53 2c 20 43 44 46 53 2c  |phis, CFS, CDFS,|
0000a050  20 49 43 53 91 73 20 49  44 45 46 53 20 61 6e 64  | ICS.s IDEFS and|
0000a060  20 52 65 73 6f 75 72 63  65 73 2e 20 20 49 74 20  | Resources.  It |
0000a070  77 69 6c 6c 20 77 6f 72  6b 20 66 6f 72 20 6f 74  |will work for ot|
0000a080  68 65 72 0a 66 69 6c 69  6e 67 20 73 79 73 74 65  |her.filing syste|
0000a090  6d 73 20 70 72 6f 76 69  64 65 64 20 74 68 65 79  |ms provided they|
0000a0a0  20 68 61 76 65 20 62 65  65 6e 20 77 72 69 74 74  | have been writt|
0000a0b0  65 6e 20 69 6e 20 74 68  65 20 77 61 79 20 73 75  |en in the way su|
0000a0c0  67 67 65 73 74 65 64 20  69 6e 20 74 68 65 0a 50  |ggested in the.P|
0000a0d0  52 4d 73 21 0a 0a 0a a4  20 4f 74 68 65 72 20 43  |RMs!.... Other C|
0000a0e0  6f 6d 6d 61 6e 64 73 0a  3d 3d 3d 3d 3d 3d 3d 3d  |ommands.========|
0000a0f0  3d 3d 3d 3d 3d 3d 3d 3d  0a 0a 09 53 79 6e 74 61  |========...Synta|
0000a100  78 3a 20 2a 44 69 72 65  63 74 6f 72 4f 62 65 79  |x: *DirectorObey|
0000a110  20 3c 66 69 6c 65 3e 20  5b 2d 76 65 72 62 6f 73  | <file> [-verbos|
0000a120  65 5d 0a 0a 54 68 69 73  20 63 6f 6d 6d 61 6e 64  |e]..This command|
0000a130  20 69 73 20 65 71 75 69  76 61 6c 65 6e 74 20 74  | is equivalent t|
0000a140  6f 20 2a 4f 62 65 79 20  65 78 63 65 70 74 20 69  |o *Obey except i|
0000a150  74 20 73 65 61 72 63 68  65 73 20 66 6f 72 20 44  |t searches for D|
0000a160  69 72 65 63 74 6f 72 20  2a 63 6f 6d 6d 61 6e 64  |irector *command|
0000a170  73 0a 77 69 74 68 20 68  69 67 68 20 70 72 69 6f  |s.with high prio|
0000a180  72 69 74 79 2e 20 20 4f  62 65 79 20 69 73 20 71  |rity.  Obey is q|
0000a190  75 69 74 65 20 73 6c 6f  77 20 77 68 65 6e 20 70  |uite slow when p|
0000a1a0  72 6f 63 65 73 73 69 6e  67 20 6c 6f 74 73 20 6f  |rocessing lots o|
0000a1b0  66 20 63 6f 6d 6d 61 6e  64 73 20 73 6f 0a 74 68  |f commands so.th|
0000a1c0  69 73 20 73 70 65 65 64  73 20 75 70 20 6c 6f 61  |is speeds up loa|
0000a1d0  64 69 6e 67 20 61 20 66  69 6c 65 20 77 69 74 68  |ding a file with|
0000a1e0  20 6c 6f 74 73 20 6f 66  20 44 69 72 65 63 74 6f  | lots of Directo|
0000a1f0  72 20 63 6f 6d 6d 61 6e  64 73 20 69 6e 20 69 74  |r commands in it|
0000a200  2e 20 0a 44 69 72 65 63  74 6f 72 4f 62 65 79 20  |. .DirectorObey |
0000a210  63 75 74 20 74 68 65 20  6c 6f 61 64 69 6e 67 20  |cut the loading |
0000a220  74 69 6d 65 20 6f 66 20  61 20 31 34 6b 20 6d 65  |time of a 14k me|
0000a230  6e 75 20 66 72 6f 6d 20  35 2e 32 20 73 65 63 6f  |nu from 5.2 seco|
0000a240  6e 64 73 20 28 77 69 74  68 20 4f 62 65 79 29 0a  |nds (with Obey).|
0000a250  74 6f 20 30 2e 37 35 20  73 65 63 6f 6e 64 73 2c  |to 0.75 seconds,|
0000a260  20 69 65 20 61 20 73 70  65 65 64 20 75 70 20 6f  | ie a speed up o|
0000a270  66 20 6e 65 61 72 6c 79  20 37 20 74 69 6d 65 73  |f nearly 7 times|
0000a280  21 0a 0a 49 74 20 73 68  6f 75 6c 64 20 62 65 20  |!..It should be |
0000a290  65 78 61 63 74 6c 79 20  65 71 75 69 76 61 6c 65  |exactly equivale|
0000a2a0  6e 74 20 74 6f 20 4f 62  65 79 2c 20 65 78 63 65  |nt to Obey, exce|
0000a2b0  70 74 69 6e 67 20 74 68  65 20 66 61 63 74 20 74  |pting the fact t|
0000a2c0  68 61 74 20 69 74 20 64  6f 65 73 6e 27 74 0a 73  |hat it doesn't.s|
0000a2d0  75 62 73 74 69 74 75 74  65 20 61 72 67 75 6d 65  |ubstitute argume|
0000a2e0  6e 74 73 20 28 65 67 20  25 30 20 61 6e 64 20 25  |nts (eg %0 and %|
0000a2f0  25 29 2e 20 20 54 68 69  73 20 6d 65 61 6e 73 20  |%).  This means |
0000a300  79 6f 75 20 68 61 76 65  20 74 6f 20 62 65 20 61  |you have to be a|
0000a310  20 62 69 74 20 63 61 72  65 66 75 6c 0a 77 69 74  | bit careful.wit|
0000a320  68 20 25 27 73 20 69 66  20 79 6f 75 20 77 61 6e  |h %'s if you wan|
0000a330  74 20 79 6f 75 72 20 6d  65 6e 75 73 20 74 6f 20  |t your menus to |
0000a340  77 6f 72 6b 20 77 69 74  68 20 4f 62 65 79 20 61  |work with Obey a|
0000a350  6e 64 20 44 69 72 65 63  74 6f 72 4f 62 65 79 2e  |nd DirectorObey.|
0000a360  20 20 28 53 65 65 20 74  68 65 0a 49 63 6f 6e 73  |  (See the.Icons|
0000a370  20 73 65 63 74 69 6f 6e  20 61 62 6f 75 74 20 2d  | section about -|
0000a380  74 69 6d 65 20 66 6f 72  20 61 6e 20 65 78 61 6d  |time for an exam|
0000a390  70 6c 65 2e 29 20 54 68  65 20 2d 76 65 72 62 6f  |ple.) The -verbo|
0000a3a0  73 65 20 6f 72 20 2d 76  20 6f 70 74 69 6f 6e 20  |se or -v option |
0000a3b0  69 73 0a 75 73 65 66 75  6c 20 66 6f 72 20 64 65  |is.useful for de|
0000a3c0  62 75 67 67 69 6e 67 2e  0a 0a 09 53 79 6e 74 61  |bugging....Synta|
0000a3d0  78 3a 20 2a 4d 65 6e 75  50 72 6f 63 65 73 73 69  |x: *MenuProcessi|
0000a3e0  6e 67 20 3c 4f 6e 7c 4f  66 66 7c 31 7c 30 7c 59  |ng <On|Off|1|0|Y|
0000a3f0  65 73 7c 4e 6f 3e 0a 0a  54 68 69 73 20 73 74 6f  |es|No>..This sto|
0000a400  70 73 20 61 6e 64 20 72  65 73 74 61 72 74 73 20  |ps and restarts |
0000a410  74 68 65 20 70 72 6f 63  65 73 73 69 6e 67 20 6f  |the processing o|
0000a420  66 20 4d 65 6e 75 2c 20  45 6e 64 4d 65 6e 75 2c  |f Menu, EndMenu,|
0000a430  20 4f 70 74 69 6f 6e 2c  20 43 6f 6d 6d 61 6e 64  | Option, Command|
0000a440  20 61 6e 64 0a 44 61 73  68 20 28 69 65 20 61 6c  | and.Dash (ie al|
0000a450  6c 20 74 68 65 20 6d 65  6e 75 20 63 6f 6d 6d 61  |l the menu comma|
0000a460  6e 64 73 29 2e 20 20 54  68 69 73 20 69 73 20 73  |nds).  This is s|
0000a470  6f 20 74 68 61 74 20 79  6f 75 20 63 61 6e 20 63  |o that you can c|
0000a480  6f 6d 6d 65 6e 74 20 6f  75 74 20 62 69 74 73 20  |omment out bits |
0000a490  6f 66 0a 79 6f 75 72 20  6d 65 6e 75 73 2e 20 20  |of.your menus.  |
0000a4a0  46 6f 72 20 65 78 61 6d  70 6c 65 20 69 66 20 74  |For example if t|
0000a4b0  68 65 20 6d 61 63 68 69  6e 65 20 79 6f 75 20 61  |he machine you a|
0000a4c0  72 65 20 72 75 6e 6e 69  6e 67 20 74 68 65 20 6d  |re running the m|
0000a4d0  65 6e 75 20 6f 6e 20 68  61 73 20 6e 6f 0a 53 43  |enu on has no.SC|
0000a4e0  53 49 20 63 61 72 64 20  69 6e 73 74 61 6c 6c 65  |SI card installe|
0000a4f0  64 20 74 68 65 6e 20 74  68 65 72 65 20 69 73 20  |d then there is |
0000a500  6e 6f 20 70 6f 69 6e 74  20 68 61 76 69 6e 67 20  |no point having |
0000a510  74 68 65 20 53 43 53 49  20 6d 65 6e 75 73 20 69  |the SCSI menus i|
0000a520  6e 73 74 61 6c 6c 65 64  0a 61 6e 64 20 79 6f 75  |nstalled.and you|
0000a530  20 63 6f 75 6c 64 20 63  68 65 63 6b 20 66 6f 72  | could check for|
0000a540  20 74 68 69 73 20 61 74  20 6d 65 6e 75 20 6c 6f  | this at menu lo|
0000a550  61 64 20 74 69 6d 65 2e  0a 0a 09 53 79 6e 74 61  |ad time....Synta|
0000a560  78 3a 20 2a 44 69 72 65  63 74 6f 72 44 6f 20 3c  |x: *DirectorDo <|
0000a570  63 6f 6d 6d 61 6e 64 3e  0a 0a 54 68 69 73 20 47  |command>..This G|
0000a580  53 54 72 61 6e 73 20 74  68 65 20 63 6f 6d 6d 61  |STrans the comma|
0000a590  6e 64 20 6c 69 6e 65 20  61 6e 64 20 74 68 65 6e  |nd line and then|
0000a5a0  20 72 75 6e 73 20 69 74  2e 20 20 54 68 69 73 20  | runs it.  This |
0000a5b0  69 73 20 75 73 65 66 75  6c 20 66 6f 72 20 63 6f  |is useful for co|
0000a5c0  6d 6d 61 6e 64 73 0a 73  75 63 68 20 61 73 20 46  |mmands.such as F|
0000a5d0  69 6c 65 72 5f 52 75 6e  20 77 68 69 63 68 20 64  |iler_Run which d|
0000a5e0  6f 6e 27 74 20 47 53 54  72 61 6e 73 20 74 68 65  |on't GSTrans the|
0000a5f0  69 72 20 69 6e 70 75 74  2c 20 62 75 74 20 79 6f  |ir input, but yo|
0000a600  75 20 77 61 6e 74 20 74  6f 20 67 69 76 65 20 61  |u want to give a|
0000a610  0a 73 74 72 69 6e 67 20  77 69 74 68 20 61 20 73  |.string with a s|
0000a620  79 73 74 65 6d 20 76 61  72 69 61 62 6c 65 20 69  |ystem variable i|
0000a630  6e 20 69 74 2e 20 20 59  6f 75 20 63 61 6e 20 61  |n it.  You can a|
0000a640  6c 73 6f 20 72 75 6e 20  61 20 63 6f 6d 6d 61 6e  |lso run a comman|
0000a650  64 20 66 72 6f 6d 20 61  0a 73 79 73 74 65 6d 20  |d from a.system |
0000a660  76 61 72 69 61 62 6c 65  20 77 69 74 68 20 74 68  |variable with th|
0000a670  69 73 20 63 6f 6d 6d 61  6e 64 2e 0a 0a 09 53 79  |is command....Sy|
0000a680  6e 74 61 78 3a 20 2a 50  72 6f 63 65 73 73 4b 65  |ntax: *ProcessKe|
0000a690  79 73 20 5b 5b 8b 5d 5b  5e 5d 3c 6b 65 79 3e 7c  |ys [[.][^]<key>||
0000a6a0  22 3c 73 74 72 69 6e 67  3e 22 5d 5e 0a 0a 54 68  |"<string>"]^..Th|
0000a6b0  69 73 20 73 65 6e 64 73  20 74 68 65 20 70 61 72  |is sends the par|
0000a6c0  61 6d 65 74 65 72 73 20  74 6f 20 74 68 65 20 63  |ameters to the c|
0000a6d0  75 72 72 65 6e 74 20 69  6e 70 75 74 20 66 6f 63  |urrent input foc|
0000a6e0  75 73 2c 20 6f 72 20 68  6f 74 20 6b 65 79 20 67  |us, or hot key g|
0000a6f0  72 61 62 62 65 72 2e 20  20 49 74 0a 73 68 6f 75  |rabber.  It.shou|
0000a700  6c 64 20 77 6f 72 6b 20  6f 75 74 73 69 64 65 20  |ld work outside |
0000a710  74 68 65 20 57 69 6d 70  2c 20 70 72 6f 76 69 64  |the Wimp, provid|
0000a720  65 64 20 74 68 65 20 6b  65 79 73 20 61 72 65 20  |ed the keys are |
0000a730  6d 61 70 70 65 64 20 61  73 20 69 6e 20 74 68 65  |mapped as in the|
0000a740  20 57 69 6d 70 2e 20 0a  49 74 20 74 61 6b 65 73  | Wimp. .It takes|
0000a750  20 61 20 73 70 61 63 65  20 73 65 70 61 72 61 74  | a space separat|
0000a760  65 64 20 6c 69 73 74 20  6f 66 20 65 69 74 68 65  |ed list of eithe|
0000a770  72 20 73 74 72 69 6e 67  73 20 74 6f 20 62 65 20  |r strings to be |
0000a780  70 75 74 20 69 6e 74 6f  20 74 68 65 20 6b 65 79  |put into the key|
0000a790  62 6f 61 72 64 0a 62 75  66 66 65 72 20 6f 72 20  |board.buffer or |
0000a7a0  6b 65 79 20 64 65 73 63  72 69 70 74 69 6f 6e 73  |key descriptions|
0000a7b0  20 28 73 65 65 20 4b 65  79 73 20 73 65 63 74 69  | (see Keys secti|
0000a7c0  6f 6e 29 2e 20 59 6f 75  20 63 61 6e 20 6f 66 20  |on). You can of |
0000a7d0  63 6f 75 72 73 65 20 6d  61 70 20 74 68 65 73 65  |course map these|
0000a7e0  0a 6f 6e 74 6f 20 6b 65  79 73 20 66 6f 72 20 68  |.onto keys for h|
0000a7f0  6f 74 20 6b 65 79 20 61  63 74 69 6f 6e 73 2e 20  |ot key actions. |
0000a800  20 46 6f 72 20 65 78 61  6d 70 6c 65 0a 0a 09 50  | For example...P|
0000a810  72 6f 63 65 73 73 4b 65  79 73 20 22 4d 6f 64 75  |rocessKeys "Modu|
0000a820  6c 65 73 22 20 52 65 74  75 72 6e 0a 09 50 72 6f  |les" Return..Pro|
0000a830  63 65 73 73 4b 65 79 73  20 46 36 20 5e 4c 65 66  |cessKeys F6 ^Lef|
0000a840  74 20 44 6f 77 6e 20 46  36 20 5e 55 70 20 5e 56  |t Down F6 ^Up ^V|
0000a850  0a 09 50 72 6f 63 65 73  73 4b 65 79 73 20 22 53  |..ProcessKeys "S|
0000a860  68 6f 77 20 4f 62 65 79  24 44 69 72 22 20 5e 4d  |how Obey$Dir" ^M|
0000a870  0a 09 50 72 6f 63 65 73  73 4b 65 79 73 20 22 34  |..ProcessKeys "4|
0000a880  32 20 53 6f 6c 75 74 69  6f 6e 20 52 6f 61 64 22  |2 Solution Road"|
0000a890  20 5e 4d 20 22 54 6f 79  74 6f 77 6e 22 20 5e 4d  | ^M "Toytown" ^M|
0000a8a0  20 22 53 68 69 72 65 73  68 69 72 65 22 20 5e 4d  | "Shireshire" ^M|
0000a8b0  0a 09 50 72 6f 63 65 73  73 4b 65 79 73 20 54 41  |..ProcessKeys TA|
0000a8c0  42 20 22 4f 70 74 69 6f  6e 20 2d 70 61 74 68 20  |B "Option -path |
0000a8d0  22 0a 0a 41 20 63 68 61  72 73 20 6d 65 6e 75 20  |"..A chars menu |
0000a8e0  63 6f 75 6c 64 20 62 65  20 70 72 6f 76 69 64 65  |could be provide|
0000a8f0  64 20 75 73 69 6e 67 20  74 68 69 73 2c 20 6f 72  |d using this, or|
0000a900  20 61 20 6d 65 6e 75 20  6f 66 20 66 72 65 71 75  | a menu of frequ|
0000a910  65 6e 74 6c 79 20 75 73  65 64 0a 63 6f 6d 6d 61  |ently used.comma|
0000a920  6e 64 73 20 66 6f 72 20  63 6f 6d 6d 61 6e 64 20  |nds for command |
0000a930  62 61 73 65 64 20 61 70  70 6c 69 63 61 74 69 6f  |based applicatio|
0000a940  6e 2e 0a 0a 09 53 79 6e  74 61 78 3a 20 2a 44 69  |n....Syntax: *Di|
0000a950  72 65 63 74 6f 72 45 64  69 74 20 3c 66 69 6c 65  |rectorEdit <file|
0000a960  3e 0a 0a 54 68 69 73 20  6c 6f 61 64 73 20 74 68  |>..This loads th|
0000a970  65 20 66 69 6c 65 20 67  69 76 65 6e 20 69 6e 74  |e file given int|
0000a980  6f 20 61 6e 20 74 65 78  74 20 65 64 69 74 6f 72  |o an text editor|
0000a990  20 28 69 66 20 6f 6e 65  20 69 73 20 6c 6f 61 64  | (if one is load|
0000a9a0  65 64 29 2e 20 20 49 74  20 69 73 0a 75 73 65 66  |ed).  It is.usef|
0000a9b0  75 6c 20 66 6f 72 20 74  72 61 6e 73 66 65 72 72  |ul for transferr|
0000a9c0  69 6e 67 20 66 69 6c 65  73 20 74 68 61 74 20 61  |ing files that a|
0000a9d0  72 65 20 6e 6f 74 20 74  79 70 65 20 54 65 78 74  |re not type Text|
0000a9e0  20 74 6f 20 61 6e 20 65  64 69 74 6f 72 2e 0a 0a  | to an editor...|
0000a9f0  09 53 79 6e 74 61 78 3a  20 2a 44 69 72 65 63 74  |.Syntax: *Direct|
0000aa00  6f 72 50 61 72 73 65 50  61 74 68 20 3c 70 61 74  |orParsePath <pat|
0000aa10  68 3e 0a 0a 54 68 69 73  20 70 61 72 73 65 73 20  |h>..This parses |
0000aa20  74 68 65 20 70 61 74 68  20 73 75 70 70 6c 69 65  |the path supplie|
0000aa30  64 20 69 6e 74 6f 20 33  20 73 79 73 74 65 6d 20  |d into 3 system |
0000aa40  76 61 72 69 61 62 6c 65  73 20 44 69 72 65 63 74  |variables Direct|
0000aa50  6f 72 24 43 75 72 72 65  6e 74 50 61 74 68 0a 44  |or$CurrentPath.D|
0000aa60  69 72 65 63 74 6f 72 24  4c 65 61 66 20 61 6e 64  |irector$Leaf and|
0000aa70  20 44 69 72 65 63 74 6f  72 24 44 69 72 2e 20 20  | Director$Dir.  |
0000aa80  54 68 69 73 20 69 73 20  74 68 65 20 72 6f 75 74  |This is the rout|
0000aa90  69 6e 65 20 74 68 61 74  20 69 73 20 75 73 65 64  |ine that is used|
0000aaa0  20 69 6e 74 65 72 6e 61  6c 6c 79 0a 62 79 20 44  | internally.by D|
0000aab0  69 72 65 63 74 6f 72 20  74 6f 20 73 65 74 20 74  |irector to set t|
0000aac0  68 65 73 65 20 76 61 72  69 61 62 6c 65 73 20 61  |hese variables a|
0000aad0  6e 64 20 63 61 6e 20 6f  63 63 61 73 69 6f 6e 61  |nd can occasiona|
0000aae0  6c 6c 79 20 62 65 20 75  73 65 66 75 6c 20 65 78  |lly be useful ex|
0000aaf0  74 65 72 6e 61 6c 6c 79  2e 0a 0a 09 53 79 6e 74  |ternally....Synt|
0000ab00  61 78 3a 20 2a 44 69 72  65 63 74 6f 72 4d 6f 75  |ax: *DirectorMou|
0000ab10  73 65 44 69 72 20 3c 76  61 72 5f 6e 61 6d 65 3e  |seDir <var_name>|
0000ab20  20 5b 2d 66 69 6c 65 5d  0a 0a 54 68 69 73 20 73  | [-file]..This s|
0000ab30  65 74 73 20 74 68 65 20  73 75 70 70 6c 69 65 64  |ets the supplied|
0000ab40  20 73 79 73 74 65 6d 20  76 61 72 69 61 62 6c 65  | system variable|
0000ab50  20 74 6f 20 74 68 65 20  70 61 74 68 20 6f 66 20  | to the path of |
0000ab60  74 68 65 20 77 69 6e 64  6f 77 20 74 68 65 20 70  |the window the p|
0000ab70  6f 69 6e 74 65 72 0a 69  73 20 6f 76 65 72 2e 20  |ointer.is over. |
0000ab80  20 54 68 69 73 20 69 73  20 75 73 65 64 20 74 6f  | This is used to|
0000ab90  20 73 65 74 20 74 68 65  20 63 75 72 72 65 6e 74  | set the current|
0000aba0  20 64 69 72 65 63 74 6f  72 79 20 66 72 6f 6d 20  | directory from |
0000abb0  61 20 6b 65 79 20 69 6e  20 74 68 65 20 64 65 66  |a key in the def|
0000abc0  61 75 6c 74 0a 6d 65 6e  75 2e 20 20 49 74 20 61  |ault.menu.  It a|
0000abd0  6c 73 6f 20 77 6f 72 6b  73 20 6f 76 65 72 20 45  |lso works over E|
0000abe0  64 69 74 20 6f 72 20 5a  61 70 20 77 69 6e 64 6f  |dit or Zap windo|
0000abf0  77 73 20 61 6e 64 20 77  69 6c 6c 20 72 65 74 75  |ws and will retu|
0000ac00  72 6e 20 74 68 65 20 64  69 72 65 63 74 6f 72 79  |rn the directory|
0000ac10  0a 74 68 61 74 20 74 68  65 20 66 69 6c 65 20 69  |.that the file i|
0000ac20  73 20 69 6e 2e 20 20 49  66 20 74 68 65 20 70 6f  |s in.  If the po|
0000ac30  69 6e 74 65 72 20 69 73  20 6e 6f 74 20 6f 76 65  |inter is not ove|
0000ac40  72 20 61 20 77 69 6e 64  6f 77 20 77 69 74 68 20  |r a window with |
0000ac50  61 20 76 61 6c 69 64 20  70 61 74 68 0a 69 6e 20  |a valid path.in |
0000ac60  74 68 65 20 74 69 74 6c  65 20 74 68 65 6e 20 74  |the title then t|
0000ac70  68 65 20 73 79 73 74 65  6d 20 76 61 72 69 61 62  |he system variab|
0000ac80  6c 65 20 77 69 6c 6c 20  62 65 20 73 65 74 20 74  |le will be set t|
0000ac90  6f 20 74 68 65 20 6e 75  6c 6c 20 73 74 72 69 6e  |o the null strin|
0000aca0  67 20 28 22 22 29 2e 0a  0a 49 66 20 2d 66 69 6c  |g ("")...If -fil|
0000acb0  65 20 69 73 20 73 70 65  63 69 66 69 65 64 20 74  |e is specified t|
0000acc0  68 65 6e 20 74 68 65 20  73 79 73 74 65 6d 20 76  |hen the system v|
0000acd0  61 72 69 61 62 6c 65 20  6d 61 79 20 62 65 20 73  |ariable may be s|
0000ace0  65 74 20 74 6f 20 70 6f  69 6e 74 20 74 6f 20 61  |et to point to a|
0000acf0  20 66 69 6c 65 0a 28 69  66 20 6f 76 65 72 20 61  | file.(if over a|
0000ad00  6e 20 45 64 69 74 20 6f  72 20 5a 61 70 20 77 69  |n Edit or Zap wi|
0000ad10  6e 64 6f 77 20 66 6f 72  20 65 78 61 6d 70 6c 65  |ndow for example|
0000ad20  29 2c 20 6f 74 68 65 72  77 69 73 65 20 69 74 20  |), otherwise it |
0000ad30  77 69 6c 6c 20 62 65 20  73 65 74 20 74 6f 20 74  |will be set to t|
0000ad40  68 65 0a 64 69 72 65 63  74 6f 72 79 20 69 6e 20  |he.directory in |
0000ad50  77 68 69 63 68 20 74 68  65 20 66 69 6c 65 20 72  |which the file r|
0000ad60  65 73 69 64 65 73 2e 0a  0a 0a a4 20 45 78 74 65  |esides..... Exte|
0000ad70  72 6e 61 6c 20 49 6e 74  65 72 66 61 63 65 0a 3d  |rnal Interface.=|
0000ad80  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
0000ad90  3d 3d 3d 0a 0a 49 66 20  79 6f 75 20 42 72 6f 61  |===..If you Broa|
0000ada0  64 63 61 73 74 20 74 68  65 20 66 6f 6c 6c 6f 77  |dcast the follow|
0000adb0  69 6e 67 20 55 73 65 72  4d 65 73 73 61 67 65 0a  |ing UserMessage.|
0000adc0  0a 30 09 54 6f 74 61 6c  20 6c 65 6e 67 74 68 20  |.0.Total length |
0000add0  6f 66 20 6d 65 73 73 61  67 65 20 72 6f 75 6e 64  |of message round|
0000ade0  65 64 20 75 70 20 74 6f  20 6e 65 61 72 65 73 74  |ed up to nearest|
0000adf0  20 34 0a 31 32 09 30 0a  31 36 09 26 34 41 31 30  | 4.12.0.16.&4A10|
0000ae00  30 0a 32 30 09 58 20 43  6f 2d 6f 72 64 0a 32 34  |0.20.X Co-ord.24|
0000ae10  09 59 20 43 6f 2d 6f 72  64 0a 32 38 09 4d 6f 75  |.Y Co-ord.28.Mou|
0000ae20  73 65 20 62 75 74 74 6f  6e 20 73 74 61 74 65 0a  |se button state.|
0000ae30  33 32 09 57 69 6e 64 6f  77 20 68 61 6e 64 6c 65  |32.Window handle|
0000ae40  0a 33 36 09 49 63 6f 6e  20 6e 75 6d 62 65 72 0a  |.36.Icon number.|
0000ae50  34 30 09 4e 75 6c 6c 20  74 65 72 6d 69 6e 61 74  |40.Null terminat|
0000ae60  65 64 20 6d 65 6e 75 20  6e 61 6d 65 20 28 6f 72  |ed menu name (or|
0000ae70  20 65 78 74 65 6e 64 65  64 20 6d 65 6e 75 29 0a  | extended menu).|
0000ae80  0a 44 69 72 65 63 74 6f  72 20 77 69 6c 6c 20 64  |.Director will d|
0000ae90  69 73 70 6c 61 79 20 74  68 65 20 6d 65 6e 75 20  |isplay the menu |
0000aea0  28 6f 72 20 72 75 6e 20  74 68 65 20 63 6f 6d 6d  |(or run the comm|
0000aeb0  61 6e 64 20 65 74 63 29  20 61 74 20 74 68 65 20  |and etc) at the |
0000aec0  70 6f 73 69 74 69 6f 6e  0a 73 70 65 63 69 66 69  |position.specifi|
0000aed0  65 64 2e 0a 0a 4e 6f 74  65 20 62 79 74 65 73 20  |ed...Note bytes |
0000aee0  32 30 2d 33 39 20 61 72  65 20 61 73 20 72 65 74  |20-39 are as ret|
0000aef0  75 72 6e 65 64 20 66 72  6f 6d 20 57 69 6d 70 5f  |urned from Wimp_|
0000af00  47 65 74 50 6f 69 6e 74  65 72 49 6e 66 6f 2e 0a  |GetPointerInfo..|
0000af10  0a 0a a4 20 53 57 49 73  0a 3d 3d 3d 3d 3d 3d 0a  |... SWIs.======.|
0000af20  0a 26 34 41 31 30 30 09  44 69 72 65 63 74 6f 72  |.&4A100.Director|
0000af30  5f 4d 65 6e 75 0a 26 34  41 31 30 31 09 44 69 72  |_Menu.&4A101.Dir|
0000af40  65 63 74 6f 72 5f 45 6e  64 4d 65 6e 75 0a 26 34  |ector_EndMenu.&4|
0000af50  41 31 30 32 09 44 69 72  65 63 74 6f 72 5f 4f 70  |A102.Director_Op|
0000af60  74 69 6f 6e 0a 26 34 41  31 30 33 09 44 69 72 65  |tion.&4A103.Dire|
0000af70  63 74 6f 72 5f 44 61 73  68 0a 26 34 41 31 30 34  |ctor_Dash.&4A104|
0000af80  09 44 69 72 65 63 74 6f  72 5f 43 6f 6d 6d 61 6e  |.Director_Comman|
0000af90  64 0a 0a 09 45 6e 74 72  79 0a 09 09 72 30 20 3d  |d...Entry...r0 =|
0000afa0  20 70 6f 69 6e 74 65 72  20 74 6f 20 74 68 65 20  | pointer to the |
0000afb0  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 20 66 6f 72  |command line for|
0000afc0  20 74 68 65 20 65 71 75  69 76 61 6c 65 6e 74 20  | the equivalent |
0000afd0  2a 63 6f 6d 6d 61 6e 64  0a 09 45 78 69 74 0a 0a  |*command..Exit..|
0000afe0  54 68 65 73 65 20 61 72  65 20 64 65 66 69 6e 65  |These are define|
0000aff0  64 20 62 65 63 61 75 73  65 20 70 72 6f 63 65 73  |d because proces|
0000b000  73 69 6e 67 20 73 74 61  72 20 63 6f 6d 6d 61 6e  |sing star comman|
0000b010  64 73 20 69 73 20 76 65  72 79 20 73 6c 6f 77 20  |ds is very slow |
0000b020  61 6e 64 20 69 6e 0a 64  79 6e 61 6d 69 63 20 6d  |and in.dynamic m|
0000b030  65 6e 75 73 20 65 73 70  65 63 69 61 6c 6c 79 20  |enus especially |
0000b040  69 74 20 69 73 20 69 6d  70 6f 72 74 61 6e 74 20  |it is important |
0000b050  74 68 61 74 20 69 74 65  6d 73 20 63 61 6e 20 62  |that items can b|
0000b060  65 20 61 64 64 65 64 20  74 6f 20 6d 65 6e 75 73  |e added to menus|
0000b070  0a 71 75 69 63 6b 6c 79  2e 0a 0a 26 34 41 31 30  |.quickly...&4A10|
0000b080  35 09 44 69 72 65 63 74  6f 72 5f 45 6e 75 6d 65  |5.Director_Enume|
0000b090  72 61 74 65 0a 0a 09 54  68 69 73 20 65 6e 75 6d  |rate...This enum|
0000b0a0  65 72 61 74 65 73 20 6c  69 73 74 73 20 68 65 6c  |erates lists hel|
0000b0b0  64 20 62 79 20 64 69 72  65 63 74 6f 72 0a 0a 09  |d by director...|
0000b0c0  45 6e 74 72 79 0a 09 09  72 30 20 3d 20 70 6f 69  |Entry...r0 = poi|
0000b0d0  6e 74 65 72 20 74 6f 20  62 6c 6f 63 6b 20 6f 72  |nter to block or|
0000b0e0  20 74 6f 20 73 74 61 72  74 0a 09 09 09 30 20 3d  | to start....0 =|
0000b0f0  20 73 74 6f 72 65 64 20  6d 65 6e 75 73 0a 09 09  | stored menus...|
0000b100  09 31 20 3d 20 64 69 73  70 6c 61 79 65 64 20 6d  |.1 = displayed m|
0000b110  65 6e 75 73 0a 09 09 09  32 20 3d 20 69 63 6f 6e  |enus....2 = icon|
0000b120  73 0a 09 09 09 33 20 3d  20 66 69 6c 74 65 72 73  |s....3 = filters|
0000b130  0a 09 45 78 69 74 0a 09  09 72 30 20 3d 20 6e 65  |..Exit...r0 = ne|
0000b140  77 20 70 6f 69 6e 74 65  72 20 74 6f 20 62 6c 6f  |w pointer to blo|
0000b150  63 6b 20 28 30 20 66 6f  72 20 65 6e 64 29 0a 09  |ck (0 for end)..|
0000b160  09 72 31 20 3d 20 70 6f  69 6e 74 65 72 20 74 6f  |.r1 = pointer to|
0000b170  20 6e 61 6d 65 20 6f 66  20 62 6c 6f 63 6b 0a 0a  | name of block..|
0000b180  44 79 6e 61 6d 69 63 20  6d 65 6e 75 73 20 74 6f  |Dynamic menus to|
0000b190  20 76 69 65 77 20 74 68  65 73 65 20 6c 69 73 74  | view these list|
0000b1a0  73 20 61 6e 64 20 61 63  74 20 6f 6e 20 74 68 65  |s and act on the|
0000b1b0  6d 20 63 61 6e 20 62 65  20 66 6f 75 6e 64 20 6f  |m can be found o|
0000b1c0  6e 20 44 69 72 65 63 74  6f 72 27 73 0a 6d 61 69  |n Director's.mai|
0000b1d0  6e 20 6d 65 6e 75 2e 0a  0a 26 34 41 31 30 36 09  |n menu...&4A106.|
0000b1e0  44 69 72 65 63 74 6f 72  5f 4d 65 6d 6f 72 79 0a  |Director_Memory.|
0000b1f0  0a 09 54 68 69 73 20 72  65 74 75 72 6e 73 20 74  |..This returns t|
0000b200  68 65 20 6d 65 6d 6f 72  79 20 75 73 65 64 20 62  |he memory used b|
0000b210  79 20 64 69 72 65 63 74  6f 72 0a 0a 09 45 6e 74  |y director...Ent|
0000b220  72 79 0a 09 45 78 69 74  0a 09 09 72 30 09 6d 6f  |ry..Exit...r0.mo|
0000b230  64 75 6c 65 20 73 69 7a  65 20 28 63 6f 6e 73 74  |dule size (const|
0000b240  61 6e 74 29 0a 09 09 72  31 09 6d 61 69 6e 20 77  |ant)...r1.main w|
0000b250  6f 72 6b 73 70 61 63 65  20 73 69 7a 65 20 28 63  |orkspace size (c|
0000b260  6f 6e 73 74 61 6e 74 29  0a 09 09 72 32 09 74 6f  |onstant)...r2.to|
0000b270  74 61 6c 20 73 69 7a 65  20 6f 66 20 61 6c 6c 20  |tal size of all |
0000b280  61 6c 6c 6f 63 61 74 65  64 20 62 6c 6f 63 6b 73  |allocated blocks|
0000b290  0a 09 09 72 33 09 6e 75  6d 62 65 72 20 6f 66 20  |...r3.number of |
0000b2a0  62 6c 6f 63 6b 73 20 61  6c 6c 6f 63 61 74 65 64  |blocks allocated|
0000b2b0  0a 09 09 72 34 09 64 79  6e 61 6d 69 63 20 61 72  |...r4.dynamic ar|
0000b2c0  65 61 20 73 69 7a 65 20  28 30 20 66 6f 72 20 6e  |ea size (0 for n|
0000b2d0  6f 20 64 79 6e 61 6d 69  63 20 61 72 65 61 29 0a  |o dynamic area).|
0000b2e0  09 09 72 35 09 62 79 74  65 73 20 66 72 65 65 20  |..r5.bytes free |
0000b2f0  69 6e 20 64 79 6e 61 6d  69 63 20 61 72 65 61 0a  |in dynamic area.|
0000b300  09 09 72 36 09 6c 61 72  67 65 73 74 20 62 6c 6f  |..r6.largest blo|
0000b310  63 6b 20 69 6e 20 64 79  6e 61 6d 69 63 20 61 72  |ck in dynamic ar|
0000b320  65 61 0a 0a 41 20 64 79  6e 61 6d 69 63 20 6d 65  |ea..A dynamic me|
0000b330  6e 75 20 74 6f 20 64 69  73 70 6c 61 79 20 74 68  |nu to display th|
0000b340  69 73 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 63  |is information c|
0000b350  61 6e 20 62 65 20 66 6f  75 6e 64 20 6f 6e 20 44  |an be found on D|
0000b360  69 72 65 63 74 6f 72 27  73 20 6d 61 69 6e 0a 6d  |irector's main.m|
0000b370  65 6e 75 0a 0a 0a a4 20  44 65 62 75 67 67 69 6e  |enu.... Debuggin|
0000b380  67 20 79 6f 75 72 20 4d  65 6e 75 73 0a 3d 3d 3d  |g your Menus.===|
0000b390  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
0000b3a0  3d 3d 3d 0a 0a 49 66 20  79 6f 75 20 61 72 65 20  |===..If you are |
0000b3b0  68 61 76 69 6e 67 20 74  72 6f 75 62 6c 65 20 77  |having trouble w|
0000b3c0  69 74 68 20 79 6f 75 72  20 6d 65 6e 75 73 20 77  |ith your menus w|
0000b3d0  68 65 6e 20 79 6f 75 20  6c 6f 61 64 20 74 68 65  |hen you load the|
0000b3e0  6d 20 28 74 68 65 79 20  67 69 76 65 20 61 0a 66  |m (they give a.f|
0000b3f0  75 6e 6e 79 20 65 72 72  6f 72 20 61 6e 64 20 79  |unny error and y|
0000b400  6f 75 20 64 6f 6e 27 74  20 6b 6e 6f 77 20 77 68  |ou don't know wh|
0000b410  79 29 20 74 72 79 20 6f  70 65 6e 69 6e 67 20 61  |y) try opening a|
0000b420  20 54 61 73 6b 57 69 6e  64 6f 77 20 28 43 54 52  | TaskWindow (CTR|
0000b430  4c 2d 46 31 32 29 20 74  79 70 65 0a 69 6e 20 22  |L-F12) type.in "|
0000b440  44 69 72 65 63 74 6f 72  4f 62 65 79 20 2d 76 20  |DirectorObey -v |
0000b450  22 20 61 6e 64 20 53 48  49 46 54 20 64 72 61 67  |" and SHIFT drag|
0000b460  20 79 6f 75 72 20 6d 65  6e 75 20 66 69 6c 65 20  | your menu file |
0000b470  74 6f 20 74 68 65 20 77  69 6e 64 6f 77 2e 20 20  |to the window.  |
0000b480  54 68 69 73 20 77 69 6c  6c 0a 70 72 69 6e 74 20  |This will.print |
0000b490  6f 75 74 20 63 6f 6d 6d  61 6e 64 73 20 61 73 20  |out commands as |
0000b4a0  74 68 65 79 20 61 72 65  20 65 78 65 63 75 74 65  |they are execute|
0000b4b0  64 20 61 6e 64 20 79 6f  75 20 73 68 6f 75 6c 64  |d and you should|
0000b4c0  20 62 65 20 61 62 6c 65  20 74 6f 20 73 70 6f 74  | be able to spot|
0000b4d0  0a 65 78 61 63 74 6c 79  20 77 68 65 6e 20 69 74  |.exactly when it|
0000b4e0  20 67 6f 65 73 20 77 72  6f 6e 67 2e 0a 0a 09 4f  | goes wrong....O|
0000b4f0  70 74 69 6f 6e 20 22 44  65 62 75 67 22 0a 09 09  |ption "Debug"...|
0000b500  43 6f 6d 6d 61 6e 64 20  54 61 73 6b 57 69 6e 64  |Command TaskWind|
0000b510  6f 77 20 22 44 69 72 65  63 74 6f 72 4f 62 65 79  |ow "DirectorObey|
0000b520  20 2d 76 20 44 69 72 65  63 74 6f 72 3a 4d 65 6e  | -v Director:Men|
0000b530  75 73 2e 4d 65 6e 75 22  0a 0a 57 6f 75 6c 64 20  |us.Menu"..Would |
0000b540  70 75 74 20 74 68 69 73  20 6f 6e 20 61 20 44 69  |put this on a Di|
0000b550  72 65 63 74 6f 72 20 6d  65 6e 75 20 66 6f 72 20  |rector menu for |
0000b560  79 6f 75 21 20 20 28 53  75 62 73 74 69 74 75 74  |you!  (Substitut|
0000b570  65 20 74 68 65 20 63 6f  72 72 65 63 74 20 6e 61  |e the correct na|
0000b580  6d 65 20 61 6e 64 0a 70  61 74 68 20 6f 66 20 79  |me and.path of y|
0000b590  6f 75 72 20 4d 65 6e 75  2e 29 0a 0a 41 6e 6f 74  |our Menu.)..Anot|
0000b5a0  68 65 72 20 74 68 69 6e  67 20 74 6f 20 62 65 61  |her thing to bea|
0000b5b0  72 20 69 6e 20 6d 69 6e  64 20 69 73 20 74 68 61  |r in mind is tha|
0000b5c0  74 20 69 66 20 79 6f 75  20 72 65 66 65 72 65 6e  |t if you referen|
0000b5d0  63 65 20 61 20 6d 65 6e  75 20 74 68 61 74 20 79  |ce a menu that y|
0000b5e0  6f 75 0a 68 61 76 65 6e  27 74 20 63 72 65 61 74  |ou.haven't creat|
0000b5f0  65 64 20 65 67 0a 0a 09  4f 70 74 69 6f 6e 20 22  |ed eg...Option "|
0000b600  48 65 6c 6c 6f 22 20 2d  73 75 62 20 22 4e 6f 74  |Hello" -sub "Not|
0000b610  54 68 65 72 65 22 0a 0a  57 68 65 72 65 20 6d 65  |There"..Where me|
0000b620  6e 75 20 22 4e 6f 74 54  68 65 72 65 22 20 68 61  |nu "NotThere" ha|
0000b630  73 6e 27 74 20 62 65 65  6e 20 63 72 65 61 74 65  |sn't been create|
0000b640  64 2c 20 74 68 69 73 20  77 69 6c 6c 20 6e 6f 74  |d, this will not|
0000b650  20 70 72 6f 64 75 63 65  20 61 6e 20 65 72 72 6f  | produce an erro|
0000b660  72 20 61 74 0a 6c 6f 61  64 20 74 69 6d 65 2c 20  |r at.load time, |
0000b670  61 6e 64 20 61 74 20 72  75 6e 20 74 69 6d 65 20  |and at run time |
0000b680  69 74 20 77 69 6c 6c 20  6a 75 73 74 20 66 61 69  |it will just fai|
0000b690  6c 20 74 6f 20 70 72 6f  64 75 63 65 20 74 68 65  |l to produce the|
0000b6a0  20 6d 65 6e 75 20 28 6e  6f 74 0a 70 72 6f 64 75  | menu (not.produ|
0000b6b0  63 69 6e 67 20 61 6e 20  65 72 72 6f 72 20 65 69  |cing an error ei|
0000b6c0  74 68 65 72 29 2e 20 20  4f 72 69 67 69 6e 61 6c  |ther).  Original|
0000b6d0  6c 79 20 69 74 20 70 72  6f 64 75 63 65 64 20 61  |ly it produced a|
0000b6e0  6e 20 65 72 72 6f 72 2c  20 62 75 74 20 74 68 69  |n error, but thi|
0000b6f0  73 20 70 72 6f 76 65 64  0a 76 65 72 79 20 61 6e  |s proved.very an|
0000b700  6e 6f 79 69 6e 67 20 69  6e 20 6f 74 68 65 72 20  |noying in other |
0000b710  63 69 72 63 75 6d 73 74  61 6e 63 65 73 20 28 65  |circumstances (e|
0000b720  67 20 77 68 65 6e 20 79  6f 75 20 68 61 76 65 6e  |g when you haven|
0000b730  27 74 20 64 65 66 69 6e  65 64 20 61 20 50 69 6e  |'t defined a Pin|
0000b740  62 6f 61 72 64 0a 6d 65  6e 75 20 62 65 63 61 75  |board.menu becau|
0000b750  73 65 20 79 6f 75 20 64  6f 6e 27 74 20 77 61 6e  |se you don't wan|
0000b760  74 20 6f 6e 65 29 2e 0a  0a 59 6f 75 20 6d 61 79  |t one)...You may|
0000b770  20 72 65 66 65 72 20 74  6f 20 6f 6e 65 20 6d 65  | refer to one me|
0000b780  6e 75 20 6d 6f 72 65 20  74 68 61 6e 20 6f 6e 63  |nu more than onc|
0000b790  65 20 69 6e 20 61 20 6d  65 6e 75 20 74 72 65 65  |e in a menu tree|
0000b7a0  2c 20 68 6f 77 65 76 65  72 20 6d 65 6e 75 73 20  |, however menus |
0000b7b0  63 61 6e 0a 6f 6e 6c 79  20 62 65 20 6f 6e 20 74  |can.only be on t|
0000b7c0  68 65 20 73 63 72 65 65  6e 20 6f 6e 63 65 20 73  |he screen once s|
0000b7d0  6f 20 69 66 20 79 6f 75  20 74 72 69 65 64 20 74  |o if you tried t|
0000b7e0  6f 20 6f 70 65 6e 20 61  20 53 75 62 4d 65 6e 75  |o open a SubMenu|
0000b7f0  20 6f 66 20 61 20 4d 65  6e 75 20 74 68 61 74 0a  | of a Menu that.|
0000b800  77 61 73 20 61 6c 72 65  61 64 79 20 64 69 73 70  |was already disp|
0000b810  6c 61 79 65 64 20 74 68  65 6e 20 6e 6f 74 68 69  |layed then nothi|
0000b820  6e 67 20 77 6f 75 6c 64  20 68 61 70 70 65 6e 2e  |ng would happen.|
0000b830  20 20 48 6f 77 65 76 65  72 20 69 66 20 79 6f 75  |  However if you|
0000b840  20 63 6c 69 63 6b 65 64  20 6f 6e 0a 74 68 65 20  | clicked on.the |
0000b850  4f 70 74 69 6f 6e 20 28  70 72 6f 76 69 64 65 64  |Option (provided|
0000b860  20 69 74 20 68 61 64 20  6e 6f 20 43 6f 6d 6d 61  | it had no Comma|
0000b870  6e 64 20 61 74 74 61 63  68 65 64 29 20 69 74 20  |nd attached) it |
0000b880  77 6f 75 6c 64 20 74 68  65 6e 20 6f 70 65 6e 20  |would then open |
0000b890  74 68 65 20 4d 65 6e 75  0a 72 65 66 65 72 72 65  |the Menu.referre|
0000b8a0  64 20 74 6f 2e 0a 0a 0a  a4 20 4f 64 64 69 74 69  |d to..... Odditi|
0000b8b0  65 73 0a 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 49  |es.==========..I|
0000b8c0  66 20 79 6f 75 20 61 72  65 20 72 75 6e 6e 69 6e  |f you are runnin|
0000b8d0  67 20 52 49 53 43 4f 53  20 33 2e 35 20 61 6e 64  |g RISCOS 3.5 and|
0000b8e0  20 77 6f 6e 64 65 72 20  77 68 79 20 79 6f 75 72  | wonder why your|
0000b8f0  20 4d 65 6e 75 20 74 69  74 6c 65 73 20 61 72 65  | Menu titles are|
0000b900  20 6a 75 73 74 69 66 69  65 64 0a 61 6c 6c 20 77  | justified.all w|
0000b910  72 6f 6e 67 20 28 6d 79  20 6d 65 6e 75 20 69 73  |rong (my menu is|
0000b920  20 63 61 6c 6c 65 64 20  22 4e 69 63 6b 27 73 20  | called "Nick's |
0000b930  4d 65 6e 75 22 20 61 6e  64 20 74 68 65 20 4d 65  |Menu" and the Me|
0000b940  6e 75 20 67 65 74 73 20  72 69 67 68 74 20 6a 75  |nu gets right ju|
0000b950  73 74 69 66 69 65 64 29  0a 69 74 20 69 73 20 62  |stified).it is b|
0000b960  65 63 61 75 73 65 20 79  6f 75 20 68 61 76 65 20  |ecause you have |
0000b970  69 6e 63 6c 75 64 65 64  20 61 20 72 65 73 65 72  |included a reser|
0000b980  76 65 64 20 6b 65 79 20  6e 61 6d 65 20 61 73 20  |ved key name as |
0000b990  74 68 65 20 6c 61 73 74  20 77 6f 72 64 2e 20 20  |the last word.  |
0000b9a0  54 68 69 73 0a 69 73 20  52 49 53 43 4f 53 20 62  |This.is RISCOS b|
0000b9b0  65 69 6e 67 20 68 65 6c  70 66 75 6c 20 61 6e 64  |eing helpful and|
0000b9c0  20 6c 69 6e 69 6e 67 20  75 70 20 79 6f 75 72 20  | lining up your |
0000b9d0  6b 65 79 20 73 68 6f 72  74 20 63 75 74 73 20 69  |key short cuts i|
0000b9e0  6e 20 4d 65 6e 75 73 2e  20 20 49 74 0a 64 6f 65  |n Menus.  It.doe|
0000b9f0  73 6e 27 74 20 6c 69 6e  65 20 75 70 20 61 20 6b  |sn't line up a k|
0000ba00  65 79 20 73 68 6f 72 74  20 63 75 74 20 6f 66 20  |ey short cut of |
0000ba10  4d 20 66 6f 72 20 69 6e  73 74 61 6e 63 65 20 61  |M for instance a|
0000ba20  6e 64 20 77 69 6c 6c 20  61 74 74 65 6d 70 74 20  |nd will attempt |
0000ba30  74 6f 20 6c 69 6e 65 20  75 70 0a 61 6e 79 74 68  |to line up.anyth|
0000ba40  69 6e 67 20 77 69 74 68  20 74 68 65 20 6c 61 73  |ing with the las|
0000ba50  74 20 77 6f 72 64 20 22  4d 65 6e 75 22 21 20 20  |t word "Menu"!  |
0000ba60  54 68 65 20 73 6f 6c 75  74 69 6f 6e 20 69 73 20  |The solution is |
0000ba70  74 6f 20 70 75 74 20 61  20 68 61 72 64 20 73 70  |to put a hard sp|
0000ba80  61 63 65 0a 62 65 66 6f  72 65 20 74 68 65 20 22  |ace.before the "|
0000ba90  4d 65 6e 75 22 20 28 68  61 72 64 20 73 70 61 63  |Menu" (hard spac|
0000baa0  65 20 69 73 20 41 4c 54  2d 53 50 41 43 45 29 2e  |e is ALT-SPACE).|
0000bab0  0a 0a 49 66 20 79 6f 75  20 70 75 74 20 61 20 2d  |..If you put a -|
0000bac0  70 61 74 68 20 3c 44 69  72 65 63 74 6f 72 24 43  |path <Director$C|
0000bad0  75 72 72 65 6e 74 44 69  72 3e 20 6f 6e 20 79 6f  |urrentDir> on yo|
0000bae0  75 72 20 4d 65 6e 75 4d  65 6e 75 20 74 68 65 6e  |ur MenuMenu then|
0000baf0  20 62 65 77 61 72 65 2c  0a 6c 6f 6f 6b 69 6e 67  | beware,.looking|
0000bb00  20 61 74 20 74 68 69 73  20 44 69 72 65 63 74 6f  | at this Directo|
0000bb10  72 79 20 4d 65 6e 75 20  77 69 6c 6c 20 63 61 75  |ry Menu will cau|
0000bb20  73 65 20 44 69 72 65 63  74 6f 72 24 43 75 72 72  |se Director$Curr|
0000bb30  65 6e 74 44 69 72 20 61  6e 64 0a 44 69 72 65 63  |entDir and.Direc|
0000bb40  74 6f 72 24 43 75 72 72  65 6e 74 50 61 74 68 20  |tor$CurrentPath |
0000bb50  74 6f 20 63 68 61 6e 67  65 2c 20 73 6f 20 69 66  |to change, so if|
0000bb60  20 79 6f 75 20 6c 6f 6f  6b 20 61 74 20 69 74 20  | you look at it |
0000bb70  61 67 61 69 6e 2c 20 79  6f 75 20 77 69 6c 6c 20  |again, you will |
0000bb80  62 65 0a 6c 6f 6f 6b 69  6e 67 20 75 70 20 6f 6e  |be.looking up on|
0000bb90  65 20 6c 65 76 65 6c 20  69 6e 20 74 68 65 20 64  |e level in the d|
0000bba0  69 72 65 63 74 6f 72 79  20 76 69 65 77 65 72 2e  |irectory viewer.|
0000bbb0  20 20 54 68 69 73 20 63  61 6e 20 62 65 20 66 69  |  This can be fi|
0000bbc0  78 65 64 20 62 79 20 75  73 69 6e 67 20 61 0a 64  |xed by using a.d|
0000bbd0  79 6e 61 6d 69 63 20 6d  65 6e 75 20 61 73 20 79  |ynamic menu as y|
0000bbe0  6f 75 72 20 4d 65 6e 75  4d 65 6e 75 20 28 74 68  |our MenuMenu (th|
0000bbf0  65 20 64 65 66 61 75 6c  74 20 6d 65 6e 75 20 63  |e default menu c|
0000bc00  61 6e 20 62 65 20 63 6f  6e 66 69 67 75 72 65 64  |an be configured|
0000bc10  20 74 6f 20 64 6f 20 74  68 69 73 2c 0a 6c 6f 6f  | to do this,.loo|
0000bc20  6b 20 61 74 20 69 74 73  20 73 74 61 72 74 29 2e  |k at its start).|
0000bc30  0a 0a 44 69 72 65 63 74  6f 72 20 6d 65 6e 75 73  |..Director menus|
0000bc40  20 77 69 74 68 20 73 70  72 69 74 65 73 20 69 6e  | with sprites in|
0000bc50  20 61 72 65 20 73 6f 6d  65 74 69 6d 65 73 20 74  | are sometimes t|
0000bc60  68 65 20 77 72 6f 6e 67  20 77 69 64 74 68 20 75  |he wrong width u|
0000bc70  6e 64 65 72 0a 52 49 53  43 4f 53 a0 33 2e 35 2e  |nder.RISCOS.3.5.|
0000bc80  20 20 49 20 74 68 69 6e  6b 20 74 68 69 73 20 69  |  I think this i|
0000bc90  73 20 61 20 62 75 67 20  69 6e 20 74 68 65 20 4f  |s a bug in the O|
0000bca0  53 2e 20 20 49 66 20 79  6f 75 20 72 65 2d 6f 70  |S.  If you re-op|
0000bcb0  65 6e 20 74 68 65 20 6d  65 6e 75 20 74 68 65 6e  |en the menu then|
0000bcc0  0a 69 74 20 6d 61 79 20  63 6f 72 72 65 63 74 20  |.it may correct |
0000bcd0  69 74 73 65 6c 66 2e 0a  0a 49 66 20 79 6f 75 20  |itself...If you |
0000bce0  70 75 74 20 44 69 72 65  63 74 6f 72 20 69 6e 20  |put Director in |
0000bcf0  79 6f 75 72 20 62 6f 6f  74 20 73 65 71 75 65 6e  |your boot sequen|
0000bd00  63 65 2c 20 6d 61 6b 65  20 73 75 72 65 20 74 68  |ce, make sure th|
0000bd10  61 74 20 79 6f 75 20 46  69 6c 65 72 5f 52 75 6e  |at you Filer_Run|
0000bd20  20 69 74 0a 28 6e 6f 74  20 6a 75 73 74 20 52 75  | it.(not just Ru|
0000bd30  6e 29 20 6f 74 68 65 72  77 69 73 65 20 69 74 20  |n) otherwise it |
0000bd40  77 6f 6e 27 74 20 73 74  61 72 74 20 75 70 20 70  |won't start up p|
0000bd50  72 6f 70 65 72 6c 79 2e  0a 0a 0a a4 20 55 74 69  |roperly..... Uti|
0000bd60  6c 73 0a 3d 3d 3d 3d 3d  3d 3d 0a 0a 54 68 65 72  |ls.=======..Ther|
0000bd70  65 20 61 72 65 20 61 20  66 65 77 20 75 74 69 6c  |e are a few util|
0000bd80  69 74 69 65 73 20 70 72  6f 76 69 64 65 64 20 77  |ities provided w|
0000bd90  69 74 68 20 44 69 72 65  63 74 6f 72 20 74 6f 20  |ith Director to |
0000bda0  6d 61 6b 65 20 43 6f 6d  6d 61 6e 64 73 20 6d 6f  |make Commands mo|
0000bdb0  72 65 0a 70 6f 77 65 72  66 75 6c 20 61 6e 64 20  |re.powerful and |
0000bdc0  74 6f 20 6d 61 6b 65 20  79 6f 75 72 20 6c 69 66  |to make your lif|
0000bdd0  65 20 65 61 73 69 65 72  2e 0a 0a 09 45 78 70 61  |e easier....Expa|
0000bde0  6e 64 4d 65 6e 75 09 46  6f 72 20 63 6f 6e 76 65  |ndMenu.For conve|
0000bdf0  72 74 69 6e 67 20 6f 6c  64 20 50 69 6e 62 6f 61  |rting old Pinboa|
0000be00  72 64 2b 20 6d 65 6e 75  73 20 74 6f 20 44 69 72  |rd+ menus to Dir|
0000be10  65 63 74 6f 72 20 66 6f  72 6d 0a 09 52 75 6e 46  |ector form..RunF|
0000be20  69 6c 65 72 41 63 09 46  6f 72 20 73 74 61 72 74  |ilerAc.For start|
0000be30  69 6e 67 20 6f 66 66 20  46 69 6c 65 72 5f 41 63  |ing off Filer_Ac|
0000be40  74 69 6f 6e 20 74 61 73  6b 73 20 28 73 65 65 20  |tion tasks (see |
0000be50  65 78 61 6d 70 6c 65 73  29 0a 09 53 77 69 4d 6f  |examples)..SwiMo|
0000be60  64 75 6c 65 09 54 6f 20  62 65 20 61 62 6c 65 20  |dule.To be able |
0000be70  74 6f 20 69 73 73 75 65  20 53 57 49 73 20 66 72  |to issue SWIs fr|
0000be80  6f 6d 20 74 68 65 20 63  6f 6d 6d 61 6e 64 20 6c  |om the command l|
0000be90  69 6e 65 0a 09 49 66 50  6f 64 75 6c 65 09 46 6f  |ine..IfPodule.Fo|
0000bea0  72 20 66 69 6e 64 69 6e  67 20 6f 75 74 20 77 68  |r finding out wh|
0000beb0  65 74 68 65 72 20 61 20  70 6f 64 75 6c 65 20 69  |ether a podule i|
0000bec0  73 20 69 6e 73 74 61 6c  6c 65 64 0a 09 49 66 54  |s installed..IfT|
0000bed0  68 65 72 65 49 73 09 46  6f 72 20 66 69 6e 64 69  |hereIs.For findi|
0000bee0  6e 67 20 6f 75 74 20 77  68 65 74 68 65 72 20 61  |ng out whether a|
0000bef0  20 66 69 6c 65 2f 64 69  72 65 63 74 6f 72 79 20  | file/directory |
0000bf00  65 78 69 73 74 73 0a 09  44 72 69 76 65 4e 61 6d  |exists..DriveNam|
0000bf10  65 09 46 6f 72 20 64 69  73 63 6f 76 65 72 69 6e  |e.For discoverin|
0000bf20  67 20 74 68 65 20 6e 61  6d 65 20 6f 66 20 61 20  |g the name of a |
0000bf30  64 72 69 76 65 20 66 72  6f 6d 20 61 20 70 61 74  |drive from a pat|
0000bf40  68 0a 0a 59 6f 75 27 6c  6c 20 66 69 6e 64 20 74  |h..You'll find t|
0000bf50  68 65 73 65 20 69 6e 20  74 68 65 20 55 74 69 6c  |hese in the Util|
0000bf60  73 20 64 69 72 65 63 74  6f 72 79 20 77 69 74 68  |s directory with|
0000bf70  69 6e 20 44 69 72 65 63  74 6f 72 2e 20 20 53 65  |in Director.  Se|
0000bf80  65 20 74 68 65 72 65 20  66 6f 72 0a 66 75 72 74  |e there for.furt|
0000bf90  68 65 72 20 64 6f 63 75  6d 65 6e 74 61 74 69 6f  |her documentatio|
0000bfa0  6e 2e 0a 0a 54 68 65 20  53 57 49 20 4d 6f 64 75  |n...The SWI Modu|
0000bfb0  6c 65 20 69 73 20 76 65  72 79 20 75 73 65 66 75  |le is very usefu|
0000bfc0  6c 20 66 6f 72 20 62 75  69 6c 64 69 6e 67 20 69  |l for building i|
0000bfd0  6e 74 65 72 65 73 74 69  6e 67 20 63 6f 6d 6d 61  |nteresting comma|
0000bfe0  6e 64 73 20 62 75 74 20  69 73 20 6e 6f 74 0a 65  |nds but is not.e|
0000bff0  73 73 65 6e 74 69 61 6c  20 74 6f 20 74 68 65 20  |ssential to the |
0000c000  6f 70 65 72 61 74 69 6f  6e 20 6f 66 20 44 69 72  |operation of Dir|
0000c010  65 63 74 6f 72 20 73 6f  20 79 6f 75 20 63 61 6e  |ector so you can|
0000c020  20 73 74 6f 70 20 69 74  20 62 65 69 6e 67 20 6c  | stop it being l|
0000c030  6f 61 64 65 64 20 62 79  0a 64 65 66 61 75 6c 74  |oaded by.default|
0000c040  20 62 79 20 63 6f 6d 6d  65 6e 74 69 6e 67 20 6f  | by commenting o|
0000c050  75 74 20 74 68 61 74 20  6c 69 6e 65 20 69 6e 20  |ut that line in |
0000c060  74 68 65 20 21 52 75 6e  20 66 69 6c 65 20 69 66  |the !Run file if|
0000c070  20 79 6f 75 20 64 65 73  69 72 65 2e 0a 0a 0a a4  | you desire.....|
0000c080  20 50 6c 61 6e 6e 65 64  20 45 78 74 65 6e 73 69  | Planned Extensi|
0000c090  6f 6e 73 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |ons.============|
0000c0a0  3d 3d 3d 3d 3d 3d 3d 3d  0a 0a 54 68 65 73 65 20  |========..These |
0000c0b0  67 6f 20 66 72 6f 6d 20  77 69 6c 6c 20 64 6f 20  |go from will do |
0000c0c0  64 65 66 69 6e 69 74 65  6c 79 2c 20 74 6f 20 70  |definitely, to p|
0000c0d0  72 6f 62 61 62 6c 79 20  77 6f 6e 27 74 20 65 76  |robably won't ev|
0000c0e0  65 72 20 64 6f 2c 20 62  75 74 20 6e 69 63 65 20  |er do, but nice |
0000c0f0  69 64 65 61 21 0a 0a 41  20 63 6f 6d 6d 61 6e 64  |idea!..A command|
0000c100  20 74 6f 20 61 64 64 20  6f 70 74 69 6f 6e 73 20  | to add options |
0000c110  74 6f 20 70 72 65 76 69  6f 75 73 6c 79 20 63 72  |to previously cr|
0000c120  65 61 74 65 64 20 6d 65  6e 75 20 28 74 65 63 68  |eated menu (tech|
0000c130  6e 69 63 61 6c 6c 79 20  76 65 72 79 20 65 61 73  |nically very eas|
0000c140  79 29 2e 0a 0a 53 61 76  65 20 61 6e 64 20 72 65  |y)...Save and re|
0000c150  73 74 6f 72 65 20 6d 65  6d 6f 72 69 73 65 72 20  |store memoriser |
0000c160  73 65 74 74 69 6e 67 73  20 61 75 74 6f 6d 61 74  |settings automat|
0000c170  69 63 61 6c 6c 79 2e 0a  0a 41 20 63 6f 6d 6d 61  |ically...A comma|
0000c180  6e 64 20 74 6f 20 64 65  66 69 6e 65 20 6d 65 6e  |nd to define men|
0000c190  75 20 63 6f 6c 6f 75 72  73 20 66 6f 72 20 70 65  |u colours for pe|
0000c1a0  72 6d 61 6e 65 6e 74 20  61 6e 64 20 74 65 6d 70  |rmanent and temp|
0000c1b0  6f 72 61 72 79 20 6d 65  6e 75 73 2e 20 20 53 68  |orary menus.  Sh|
0000c1c0  6f 75 6c 64 0a 62 65 20  61 62 6c 65 20 74 6f 20  |ould.be able to |
0000c1d0  64 65 66 69 6e 65 20 74  68 65 20 74 69 74 6c 65  |define the title|
0000c1e0  20 62 61 72 20 63 6f 6c  6f 75 72 73 20 61 73 20  | bar colours as |
0000c1f0  77 65 6c 6c 2e 0a 0a 41  75 74 6f 20 73 63 72 6f  |well...Auto scro|
0000c200  6c 6c 69 6e 67 20 66 6f  72 20 6d 65 6e 75 73 2e  |lling for menus.|
0000c210  0a 0a 41 75 74 6f 20 49  63 6f 6e 53 70 72 69 74  |..Auto IconSprit|
0000c220  65 73 20 6f 72 20 46 69  6c 65 72 5f 42 6f 6f 74  |es or Filer_Boot|
0000c230  20 61 70 70 6c 69 63 61  74 69 6f 6e 73 0a 09 31  | applications..1|
0000c240  29 20 4e 65 76 65 72 0a  09 32 29 20 57 68 65 6e  |) Never..2) When|
0000c250  20 62 75 69 6c 64 69 6e  67 20 70 65 72 6d 61 6e  | building perman|
0000c260  65 6e 74 20 6d 65 6e 75  73 0a 09 33 29 20 41 6c  |ent menus..3) Al|
0000c270  6c 20 74 68 65 20 74 69  6d 65 0a 0a 48 6f 6c 64  |l the time..Hold|
0000c280  69 6e 67 20 64 6f 77 6e  20 43 54 52 4c 20 77 68  |ing down CTRL wh|
0000c290  65 6e 20 6d 61 6b 69 6e  67 20 61 6e 20 61 75 74  |en making an aut|
0000c2a0  6f 20 6d 65 6e 75 20 63  6f 75 6c 64 20 46 69 6c  |o menu could Fil|
0000c2b0  65 72 5f 42 6f 6f 74 20  74 68 65 20 61 70 70 6c  |er_Boot the appl|
0000c2c0  69 63 61 74 69 6f 6e 73  0a 77 69 74 68 69 6e 2e  |ications.within.|
0000c2d0  0a 0a 41 20 43 6f 6d 6d  61 6e 64 20 72 75 6e 20  |..A Command run |
0000c2e0  77 68 65 6e 20 4d 65 6e  75 20 69 73 20 70 72 65  |when Menu is pre|
0000c2f0  73 73 65 64 20 6f 76 65  72 20 61 20 6e 6f 72 6d  |ssed over a norm|
0000c300  61 6c 20 74 65 78 74 20  69 74 65 6d 2e 0a 0a 4d  |al text item...M|
0000c310  61 6b 65 20 44 69 72 65  63 74 6f 72 20 6d 65 6e  |ake Director men|
0000c320  75 73 20 69 6e 74 6f 20  77 69 6e 64 6f 77 73 2e  |us into windows.|
0000c330  20 20 4d 61 6b 65 20 74  68 65 20 70 61 74 68 20  |  Make the path |
0000c340  6f 70 74 69 6f 6e 73 20  64 72 61 67 67 61 62 6c  |options draggabl|
0000c350  65 20 61 6e 64 20 74 68  65 0a 6d 65 6e 75 20 6f  |e and the.menu o|
0000c360  70 74 69 6f 6e 73 20 63  6c 69 63 6b 61 62 6c 65  |ptions clickable|
0000c370  2e 20 20 4d 61 6b 65 20  74 68 65 20 6d 65 6e 75  |.  Make the menu|
0000c380  73 20 70 65 72 73 69 73  74 65 6e 74 20 69 66 20  |s persistent if |
0000c390  74 6f 72 6e 20 6f 66 66  2e 0a 0a 0a a4 20 54 68  |torn off..... Th|
0000c3a0  61 6e 6b 73 0a 3d 3d 3d  3d 3d 3d 3d 3d 0a 0a 46  |anks.========..F|
0000c3b0  6f 72 20 69 6e 74 65 72  65 73 74 69 6e 67 20 6d  |or interesting m|
0000c3c0  65 6e 75 20 6f 70 74 69  6f 6e 73 2c 20 62 75 67  |enu options, bug|
0000c3d0  20 72 65 70 6f 72 74 73  2c 20 63 6f 6d 6d 65 6e  | reports, commen|
0000c3e0  74 73 2c 20 69 64 65 61  73 2c 20 64 6f 6e 61 74  |ts, ideas, donat|
0000c3f0  69 6f 6e 73 20 6f 72 20  65 76 65 6e 0a 6a 75 73  |ions or even.jus|
0000c400  74 20 74 65 6c 6c 69 6e  67 20 6d 65 20 74 68 61  |t telling me tha|
0000c410  74 20 74 68 65 79 20 77  65 72 65 20 75 73 69 6e  |t they were usin|
0000c420  67 20 44 69 72 65 63 74  6f 72 2c 20 74 68 61 6e  |g Director, than|
0000c430  6b 73 20 61 72 65 20 64  75 65 20 74 6f 20 3a 2d  |ks are due to :-|
0000c440  0a 0a 53 74 65 66 61 6e  20 57 69 65 73 6e 65 72  |..Stefan Wiesner|
0000c450  2c 20 53 61 6d 20 4b 69  6e 67 74 6f 6e 2c 20 50  |, Sam Kington, P|
0000c460  61 75 6c 20 48 65 64 64  65 72 6c 79 2c 20 44 65  |aul Hedderly, De|
0000c470  6e 69 73 20 48 6f 77 65  2c 20 4b 65 76 69 6e 20  |nis Howe, Kevin |
0000c480  42 61 67 75 73 74 2c 0a  46 65 72 72 6f 20 4d 61  |Bagust,.Ferro Ma|
0000c490  72 63 6f 2c 20 42 72 69  61 6e 20 48 6f 77 6c 65  |rco, Brian Howle|
0000c4a0  74 74 2c 20 53 69 6d 6f  6e 20 48 61 74 6c 69 66  |tt, Simon Hatlif|
0000c4b0  66 2c 20 44 6f 6d 69 6e  69 63 20 53 79 6d 65 73  |f, Dominic Symes|
0000c4c0  2c 20 43 68 72 69 73 20  4b 6e 69 67 68 74 2c 0a  |, Chris Knight,.|
0000c4d0  53 65 72 67 69 6f 20 4d  6f 6e 65 73 69 2c 20 4a  |Sergio Monesi, J|
0000c4e0  6f 6e 61 74 68 61 6e 20  4d 69 73 74 2c 20 4a 61  |onathan Mist, Ja|
0000c4f0  6d 65 73 20 46 72 65 65  6d 61 6e 2c 20 43 6f 6c  |mes Freeman, Col|
0000c500  69 6e 20 48 6f 67 62 65  6e 2c 20 41 69 64 61 6e  |in Hogben, Aidan|
0000c510  20 43 6f 72 65 79 2c 0a  4d 69 6b 65 20 42 72 6f  | Corey,.Mike Bro|
0000c520  77 6e 2c 20 4a 75 6c 69  61 6e 20 53 6d 69 74 68  |wn, Julian Smith|
0000c530  2c 20 4d 61 74 74 68 65  77 20 42 6c 6f 63 68 2c  |, Matthew Bloch,|
0000c540  20 41 6e 64 72 65 77 20  47 61 72 72 61 72 64 2c  | Andrew Garrard,|
0000c550  20 42 65 72 6e 68 61 72  64 20 45 67 65 2c 0a 53  | Bernhard Ege,.S|
0000c560  69 6d 6f 6e 20 4d 69 64  64 6c 65 74 6f 6e 2c 20  |imon Middleton, |
0000c570  54 72 65 76 6f 72 20 4a  6f 68 6e 73 6f 6e 2c 20  |Trevor Johnson, |
0000c580  52 69 63 68 61 72 64 20  50 61 79 6e 65 2c 20 50  |Richard Payne, P|
0000c590  61 75 6c 20 4d 6f 6f 72  65 2c 20 49 61 6e 20 48  |aul Moore, Ian H|
0000c5a0  69 6e 64 65 72 2c 0a 52  65 75 62 65 6e 20 54 68  |inder,.Reuben Th|
0000c5b0  6f 6d 61 73 0a 0a 54 68  6f 6d 61 73 20 4f 6c 73  |omas..Thomas Ols|
0000c5c0  73 6f 6e 2c 20 4a 75 6c  69 61 6e 20 53 6d 69 74  |son, Julian Smit|
0000c5d0  68 2c 20 42 65 6e 20 53  75 6d 6d 65 72 73 2c 20  |h, Ben Summers, |
0000c5e0  4a 65 6e 73 20 4f 76 65  73 65 6e 20 61 6e 64 20  |Jens Ovesen and |
0000c5f0  46 72 61 6e 7a 20 50 68  69 6c 69 70 70 73 20 66  |Franz Philipps f|
0000c600  6f 72 0a 77 72 69 74 69  6e 67 20 61 20 73 65 74  |or.writing a set|
0000c610  20 6f 66 20 65 78 63 65  6c 6c 65 6e 74 20 75 74  | of excellent ut|
0000c620  69 6c 69 74 69 65 73 20  77 68 69 63 68 20 67 61  |ilities which ga|
0000c630  76 65 20 6d 65 20 6c 6f  74 73 20 6f 66 20 69 64  |ve me lots of id|
0000c640  65 61 73 20 66 6f 72 0a  44 69 72 65 63 74 6f 72  |eas for.Director|
0000c650  2e 0a 0a 4a 6f 6e 61 74  68 61 6e 20 43 6f 78 68  |...Jonathan Coxh|
0000c660  65 61 64 20 66 6f 72 20  4f 53 4c 69 62 2e 0a 0a  |ead for OSLib...|
0000c670  4a 75 6c 69 61 6e 20 53  6d 69 74 68 20 66 6f 72  |Julian Smith for|
0000c680  20 67 65 6e 65 72 6f 75  73 6c 79 20 73 75 70 70  | generously supp|
0000c690  6c 79 69 6e 67 20 74 68  65 20 73 6f 75 72 63 65  |lying the source|
0000c6a0  20 63 6f 64 65 20 66 6f  72 20 61 75 74 6f 20 73  | code for auto s|
0000c6b0  63 72 6f 6c 6c 69 6e 67  0a 6d 65 6e 75 73 20 28  |crolling.menus (|
0000c6c0  77 68 69 63 68 20 49 20  68 61 76 65 6e 27 74 20  |which I haven't |
0000c6d0  68 61 64 20 74 69 6d 65  20 74 6f 20 69 6d 70 6c  |had time to impl|
0000c6e0  65 6d 65 6e 74 20 79 65  74 29 2e 0a 0a 4a 65 6e  |ement yet)...Jen|
0000c6f0  73 20 4f 76 65 73 65 6e  20 66 6f 72 20 76 65 72  |s Ovesen for ver|
0000c700  79 20 6b 69 6e 64 6c 79  20 61 6c 6c 6f 77 69 6e  |y kindly allowin|
0000c710  67 20 6d 65 20 74 6f 20  64 69 73 74 72 69 62 75  |g me to distribu|
0000c720  74 65 20 68 69 73 20 65  78 63 65 6c 6c 65 6e 74  |te his excellent|
0000c730  20 61 6e 64 0a 69 6e 64  69 73 70 65 6e 73 61 62  | and.indispensab|
0000c740  6c 65 20 53 57 49 20 6d  6f 64 75 6c 65 20 77 69  |le SWI module wi|
0000c750  74 68 20 74 68 69 73 20  61 70 70 6c 69 63 61 74  |th this applicat|
0000c760  69 6f 6e 2e 0a 0a 44 6f  6d 69 6e 69 63 20 53 79  |ion...Dominic Sy|
0000c770  6d 65 73 20 66 6f 72 20  5a 61 70 2e 20 20 4e 6f  |mes for Zap.  No|
0000c780  20 70 72 6f 67 72 61 6d  6d 65 72 20 73 68 6f 75  | programmer shou|
0000c790  6c 64 20 62 65 20 77 69  74 68 6f 75 74 20 69 74  |ld be without it|
0000c7a0  2e 0a 0a 50 68 69 6c 20  53 6c 69 6e 67 73 62 79  |...Phil Slingsby|
0000c7b0  20 66 6f 72 20 74 68 69  6e 6b 69 6e 67 20 6f 66  | for thinking of|
0000c7c0  20 74 68 65 20 6e 61 6d  65 2e 0a 0a 44 61 76 65  | the name...Dave|
0000c7d0  20 4c 61 77 72 65 6e 63  65 20 66 6f 72 20 74 65  | Lawrence for te|
0000c7e0  73 74 69 6e 67 2c 20 74  68 65 20 6f 72 69 67 69  |sting, the origi|
0000c7f0  6e 61 6c 20 69 64 65 61  20 28 61 6e 64 20 63 6f  |nal idea (and co|
0000c800  64 65 29 20 6f 66 20 63  72 65 61 74 69 6e 67 20  |de) of creating |
0000c810  50 69 6e 62 6f 61 72 64  2b 0a 6d 65 6e 75 73 20  |Pinboard+.menus |
0000c820  66 72 6f 6d 20 61 20 74  65 78 74 75 61 6c 20 66  |from a textual f|
0000c830  6f 72 6d 2c 20 45 78 70  61 6e 64 4d 65 6e 75 2c  |orm, ExpandMenu,|
0000c840  20 49 66 50 6f 64 75 6c  65 2c 20 49 66 54 68 65  | IfPodule, IfThe|
0000c850  72 65 49 73 2c 20 44 72  69 76 65 4e 61 6d 65 20  |reIs, DriveName |
0000c860  61 6e 64 0a 6c 6f 61 64  73 20 6f 66 20 6f 74 68  |and.loads of oth|
0000c870  65 72 20 69 64 65 61 73  20 61 6e 64 20 73 75 67  |er ideas and sug|
0000c880  67 65 73 74 69 6f 6e 73  20 28 73 6f 6d 65 20 6f  |gestions (some o|
0000c890  66 20 77 68 69 63 68 20  49 27 76 65 20 61 6c 6d  |f which I've alm|
0000c8a0  6f 73 74 20 63 65 72 74  61 69 6e 6c 79 0a 63 72  |ost certainly.cr|
0000c8b0  65 64 69 74 65 64 20 74  6f 20 6d 79 73 65 6c 66  |edited to myself|
0000c8c0  20 3b 2d 29 0a 0a 4d 79  20 77 69 66 65 20 4c 6f  | ;-)..My wife Lo|
0000c8d0  76 65 64 61 79 2e 0a 0a  0a a4 20 43 6f 6e 74 61  |veday..... Conta|
0000c8e0  63 74 73 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |cts.==========..|
0000c8f0  50 6f 73 74 3a 09 4e 69  63 6b 20 43 72 61 69 67  |Post:.Nick Craig|
0000c900  2d 57 6f 6f 64 0a 09 43  68 61 6c 6b 20 42 61 72  |-Wood..Chalk Bar|
0000c910  74 6f 6e 0a 09 53 68 65  72 65 20 52 6f 61 64 0a  |ton..Shere Road.|
0000c920  09 57 65 73 74 20 48 6f  72 73 6c 65 79 0a 09 4c  |.West Horsley..L|
0000c930  45 41 54 48 45 52 48 45  41 44 0a 09 53 75 72 72  |EATHERHEAD..Surr|
0000c940  65 79 20 4b 54 32 34 20  36 45 57 0a 0a 45 4d 61  |ey KT24 6EW..EMa|
0000c950  69 6c 3a 09 64 69 72 65  63 74 6f 72 40 61 78 69  |il:.director@axi|
0000c960  73 2e 64 65 6d 6f 6e 2e  63 6f 2e 75 6b 0a 0a 42  |s.demon.co.uk..B|
0000c970  42 53 3a 09 41 72 63 61  64 65 20 28 30 31 38 31  |BS:.Arcade (0181|
0000c980  20 36 35 34 20 32 32 31  32 29 2c 20 55 73 65 72  | 654 2212), User|
0000c990  20 39 33 39 20 28 4e 69  63 6b 20 43 72 61 69 67  | 939 (Nick Craig|
0000c9a0  2d 57 6f 6f 64 29 0a 0a  41 6e 79 20 62 75 67 20  |-Wood)..Any bug |
0000c9b0  72 65 70 6f 72 74 73 2c  20 69 64 65 61 73 20 6f  |reports, ideas o|
0000c9c0  72 20 64 6f 6e 61 74 69  6f 6e 73 20 67 72 61 74  |r donations grat|
0000c9d0  65 66 75 6c 6c 79 20 72  65 63 65 69 76 65 64 2e  |efully received.|
0000c9e0  0a                                                |.|
0000c9e1

© Dominic Ford 2021–2025.

Our privacy policy is here.
Last updated: 01 May 2025, 21:49 UTC
Website designed by .