Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199801_2.adf » PenDnHTML » !Install/!Help
!Install/!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 » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199801_2.adf » PenDnHTML |
| Filename: | !Install/!Help |
| Read OK: | ✔ |
| File size: | 100A bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
!Install
========
!Install is a general installation utility. It is script-driven and,
therefore, relatively versatile.
If you double-click the !Install icon, the "Script" file (located inside
the !Install application folder) will be executed. The !Install icon never
appears on the icon bar since once the script has been completed the
utility's useful life is over.
!Install can be used to install any software. It has three requirements:
(i) The script file
(ii) Sprites to be used in the GetPath dialogue (see below)
("Sprites", "Sprites22", etc. located in the !Install folder).
(iii) The files to be installed
(could be anywhere but in a "Files" folder within the !Install
folder is suggested).
The Script file
---------------
This is a text file containing comments (preceded by the '|' character) and
commands. Commands consist of a keyword and one or more parameters, each
separated by one or more spaces. The commands are as follows:
Set <var> <value>
Set the variable, var, to the given string value. Variables set in this way
can be used later in the script, enclosing the variable name in <> characters,
for example: Set installdir Install$Dir.Files
can be used later, as in: Copy <installdir>.somefile .....
Note that there are two "special" variables which have predefined purposes:
title: The value of this variable is used as the title to all installation
dialogue windows.
path: This variable is always set by the GetPath command (see below).
Report <text>
Inform the user of something. The text will be displayed in a window which
will contain an 'OK' button only. Execution of the script will be paused
until the user clicks 'OK' and then will continue. The text may include
variables enclosed in <> characters. If the text contains spaces than the
whole string should be enclosed in quotes. The maximum is 256 characters.
Warning <text>
The same as Report, except that the window will have both an 'OK' button and
a 'Cancel' button. Execution of the script will continue if the user clicks
'OK' but will be aborted on 'Cancel'.
Ensure <filename> <text>
Ensure will check for the existence of a file. The filename should be a full
path or an OS environmental variable yielding a path (e.g. "<Install$Dir>").
If the file does not exist, the text will be displayed and execution of the
script will be aborted.
GetPath <name> <default destination> <sprite>
This opens a window inviting the user to choose an installation path, which
will be returned in the special variable, path.
name: A name for the save to follow (less than 12 chars), usually the leaf
name of the file which is to be saved into the user's chosen folder.
default destination: a suggested path for saving the file.
sprite: The name of a sprite to appear in the dialogue window. The named
sprite should be contained within in the !Install "Sprites" and
"Sprites22" files.
The returned path will be that chosen by the user, either by typed entry or
as the result of an icon drag, without the leaf name, i.e. it can be used more
than once in the script by attaching a succession of file leaf names. For
example, if the user's path is: ADFS::MyDisc.$.MyFolder.Filename
then the returned path will be: ADFS::MyDisc.$.MyFolder
Copy <source> <destination>
Similar to an OS Copy command, except (i) source and destination may include
variables, (ii) overwriting of any existing file, the name of which matches the
destination, will always be forced without warning the user, and (iii) the copy
is always recursive, so copying a directory or application will always copy the
contents. Normally the source will be some file contained in the "Files" folder
within the !Install application.
OS <command>
Execute an OS command. If it contains spaces, enclose it in quotes.
Postscript
----------
A working copy of !Install will not require this !Help file. It is suggested that
it be deleted from any distribution medium in order to save storage space.
00000000 0a 21 49 6e 73 74 61 6c 6c 0a 3d 3d 3d 3d 3d 3d |.!Install.======|
00000010 3d 3d 0a 0a 21 49 6e 73 74 61 6c 6c 20 69 73 20 |==..!Install is |
00000020 61 20 67 65 6e 65 72 61 6c 20 69 6e 73 74 61 6c |a general instal|
00000030 6c 61 74 69 6f 6e 20 75 74 69 6c 69 74 79 2e 20 |lation utility. |
00000040 49 74 20 69 73 20 73 63 72 69 70 74 2d 64 72 69 |It is script-dri|
00000050 76 65 6e 20 61 6e 64 2c 0a 74 68 65 72 65 66 6f |ven and,.therefo|
00000060 72 65 2c 20 72 65 6c 61 74 69 76 65 6c 79 20 76 |re, relatively v|
00000070 65 72 73 61 74 69 6c 65 2e 0a 0a 49 66 20 79 6f |ersatile...If yo|
00000080 75 20 64 6f 75 62 6c 65 2d 63 6c 69 63 6b 20 74 |u double-click t|
00000090 68 65 20 21 49 6e 73 74 61 6c 6c 20 69 63 6f 6e |he !Install icon|
000000a0 2c 20 74 68 65 20 22 53 63 72 69 70 74 22 20 66 |, the "Script" f|
000000b0 69 6c 65 20 28 6c 6f 63 61 74 65 64 20 69 6e 73 |ile (located ins|
000000c0 69 64 65 0a 74 68 65 20 21 49 6e 73 74 61 6c 6c |ide.the !Install|
000000d0 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 66 6f 6c | application fol|
000000e0 64 65 72 29 20 77 69 6c 6c 20 62 65 20 65 78 65 |der) will be exe|
000000f0 63 75 74 65 64 2e 20 54 68 65 20 21 49 6e 73 74 |cuted. The !Inst|
00000100 61 6c 6c 20 69 63 6f 6e 20 6e 65 76 65 72 0a 61 |all icon never.a|
00000110 70 70 65 61 72 73 20 6f 6e 20 74 68 65 20 69 63 |ppears on the ic|
00000120 6f 6e 20 62 61 72 20 73 69 6e 63 65 20 6f 6e 63 |on bar since onc|
00000130 65 20 74 68 65 20 73 63 72 69 70 74 20 68 61 73 |e the script has|
00000140 20 62 65 65 6e 20 63 6f 6d 70 6c 65 74 65 64 20 | been completed |
00000150 74 68 65 0a 75 74 69 6c 69 74 79 27 73 20 75 73 |the.utility's us|
00000160 65 66 75 6c 20 6c 69 66 65 20 69 73 20 6f 76 65 |eful life is ove|
00000170 72 2e 0a 0a 21 49 6e 73 74 61 6c 6c 20 63 61 6e |r...!Install can|
00000180 20 62 65 20 75 73 65 64 20 74 6f 20 69 6e 73 74 | be used to inst|
00000190 61 6c 6c 20 61 6e 79 20 73 6f 66 74 77 61 72 65 |all any software|
000001a0 2e 20 49 74 20 68 61 73 20 74 68 72 65 65 20 72 |. It has three r|
000001b0 65 71 75 69 72 65 6d 65 6e 74 73 3a 0a 0a 28 69 |equirements:..(i|
000001c0 29 20 20 20 54 68 65 20 73 63 72 69 70 74 20 66 |) The script f|
000001d0 69 6c 65 0a 0a 28 69 69 29 20 20 53 70 72 69 74 |ile..(ii) Sprit|
000001e0 65 73 20 74 6f 20 62 65 20 75 73 65 64 20 69 6e |es to be used in|
000001f0 20 74 68 65 20 47 65 74 50 61 74 68 20 64 69 61 | the GetPath dia|
00000200 6c 6f 67 75 65 20 28 73 65 65 20 62 65 6c 6f 77 |logue (see below|
00000210 29 0a 20 20 20 20 20 20 28 22 53 70 72 69 74 65 |). ("Sprite|
00000220 73 22 2c 20 22 53 70 72 69 74 65 73 32 32 22 2c |s", "Sprites22",|
00000230 20 65 74 63 2e 20 6c 6f 63 61 74 65 64 20 69 6e | etc. located in|
00000240 20 74 68 65 20 21 49 6e 73 74 61 6c 6c 20 66 6f | the !Install fo|
00000250 6c 64 65 72 29 2e 0a 0a 28 69 69 69 29 20 54 68 |lder)...(iii) Th|
00000260 65 20 66 69 6c 65 73 20 74 6f 20 62 65 20 69 6e |e files to be in|
00000270 73 74 61 6c 6c 65 64 0a 20 20 20 20 20 20 28 63 |stalled. (c|
00000280 6f 75 6c 64 20 62 65 20 61 6e 79 77 68 65 72 65 |ould be anywhere|
00000290 20 62 75 74 20 69 6e 20 61 20 22 46 69 6c 65 73 | but in a "Files|
000002a0 22 20 66 6f 6c 64 65 72 20 77 69 74 68 69 6e 20 |" folder within |
000002b0 74 68 65 20 21 49 6e 73 74 61 6c 6c 0a 20 20 20 |the !Install. |
000002c0 20 20 20 66 6f 6c 64 65 72 20 69 73 20 73 75 67 | folder is sug|
000002d0 67 65 73 74 65 64 29 2e 0a 0a 0a 54 68 65 20 53 |gested)....The S|
000002e0 63 72 69 70 74 20 66 69 6c 65 0a 2d 2d 2d 2d 2d |cript file.-----|
000002f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 |----------..This|
00000300 20 69 73 20 61 20 74 65 78 74 20 66 69 6c 65 20 | is a text file |
00000310 63 6f 6e 74 61 69 6e 69 6e 67 20 63 6f 6d 6d 65 |containing comme|
00000320 6e 74 73 20 28 70 72 65 63 65 64 65 64 20 62 79 |nts (preceded by|
00000330 20 74 68 65 20 27 7c 27 20 63 68 61 72 61 63 74 | the '|' charact|
00000340 65 72 29 20 61 6e 64 0a 63 6f 6d 6d 61 6e 64 73 |er) and.commands|
00000350 2e 20 43 6f 6d 6d 61 6e 64 73 20 63 6f 6e 73 69 |. Commands consi|
00000360 73 74 20 6f 66 20 61 20 6b 65 79 77 6f 72 64 20 |st of a keyword |
00000370 61 6e 64 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 |and one or more |
00000380 70 61 72 61 6d 65 74 65 72 73 2c 20 65 61 63 68 |parameters, each|
00000390 0a 73 65 70 61 72 61 74 65 64 20 62 79 20 6f 6e |.separated by on|
000003a0 65 20 6f 72 20 6d 6f 72 65 20 73 70 61 63 65 73 |e or more spaces|
000003b0 2e 20 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20 61 |. The commands a|
000003c0 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a |re as follows:..|
000003d0 53 65 74 20 3c 76 61 72 3e 20 3c 76 61 6c 75 65 |Set <var> <value|
000003e0 3e 0a 0a 20 20 53 65 74 20 74 68 65 20 76 61 72 |>.. Set the var|
000003f0 69 61 62 6c 65 2c 20 76 61 72 2c 20 74 6f 20 74 |iable, var, to t|
00000400 68 65 20 67 69 76 65 6e 20 73 74 72 69 6e 67 20 |he given string |
00000410 76 61 6c 75 65 2e 20 56 61 72 69 61 62 6c 65 73 |value. Variables|
00000420 20 73 65 74 20 69 6e 20 74 68 69 73 20 77 61 79 | set in this way|
00000430 0a 20 20 63 61 6e 20 62 65 20 75 73 65 64 20 6c |. can be used l|
00000440 61 74 65 72 20 69 6e 20 74 68 65 20 73 63 72 69 |ater in the scri|
00000450 70 74 2c 20 65 6e 63 6c 6f 73 69 6e 67 20 74 68 |pt, enclosing th|
00000460 65 20 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 20 |e variable name |
00000470 69 6e 20 3c 3e 20 63 68 61 72 61 63 74 65 72 73 |in <> characters|
00000480 2c 0a 20 20 66 6f 72 20 65 78 61 6d 70 6c 65 3a |,. for example:|
00000490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 | S|
000004a0 65 74 20 69 6e 73 74 61 6c 6c 64 69 72 20 49 6e |et installdir In|
000004b0 73 74 61 6c 6c 24 44 69 72 2e 46 69 6c 65 73 0a |stall$Dir.Files.|
000004c0 20 20 63 61 6e 20 62 65 20 75 73 65 64 20 6c 61 | can be used la|
000004d0 74 65 72 2c 20 61 73 20 69 6e 3a 20 20 43 6f 70 |ter, as in: Cop|
000004e0 79 20 3c 69 6e 73 74 61 6c 6c 64 69 72 3e 2e 73 |y <installdir>.s|
000004f0 6f 6d 65 66 69 6c 65 20 2e 2e 2e 2e 2e 0a 0a 20 |omefile ....... |
00000500 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 72 65 | Note that there|
00000510 20 61 72 65 20 74 77 6f 20 22 73 70 65 63 69 61 | are two "specia|
00000520 6c 22 20 76 61 72 69 61 62 6c 65 73 20 77 68 69 |l" variables whi|
00000530 63 68 20 68 61 76 65 20 70 72 65 64 65 66 69 6e |ch have predefin|
00000540 65 64 20 70 75 72 70 6f 73 65 73 3a 0a 0a 20 20 |ed purposes:.. |
00000550 74 69 74 6c 65 3a 20 54 68 65 20 76 61 6c 75 65 |title: The value|
00000560 20 6f 66 20 74 68 69 73 20 76 61 72 69 61 62 6c | of this variabl|
00000570 65 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 |e is used as the|
00000580 20 74 69 74 6c 65 20 74 6f 20 61 6c 6c 20 69 6e | title to all in|
00000590 73 74 61 6c 6c 61 74 69 6f 6e 0a 20 20 20 20 20 |stallation. |
000005a0 20 20 20 20 64 69 61 6c 6f 67 75 65 20 77 69 6e | dialogue win|
000005b0 64 6f 77 73 2e 0a 20 20 70 61 74 68 3a 20 20 54 |dows.. path: T|
000005c0 68 69 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 |his variable is |
000005d0 61 6c 77 61 79 73 20 73 65 74 20 62 79 20 74 68 |always set by th|
000005e0 65 20 47 65 74 50 61 74 68 20 63 6f 6d 6d 61 6e |e GetPath comman|
000005f0 64 20 28 73 65 65 20 62 65 6c 6f 77 29 2e 0a 0a |d (see below)...|
00000600 52 65 70 6f 72 74 20 3c 74 65 78 74 3e 0a 0a 20 |Report <text>.. |
00000610 20 49 6e 66 6f 72 6d 20 74 68 65 20 75 73 65 72 | Inform the user|
00000620 20 6f 66 20 73 6f 6d 65 74 68 69 6e 67 2e 20 54 | of something. T|
00000630 68 65 20 74 65 78 74 20 77 69 6c 6c 20 62 65 20 |he text will be |
00000640 64 69 73 70 6c 61 79 65 64 20 69 6e 20 61 20 77 |displayed in a w|
00000650 69 6e 64 6f 77 20 77 68 69 63 68 0a 20 20 77 69 |indow which. wi|
00000660 6c 6c 20 63 6f 6e 74 61 69 6e 20 61 6e 20 27 4f |ll contain an 'O|
00000670 4b 27 20 62 75 74 74 6f 6e 20 6f 6e 6c 79 2e 20 |K' button only. |
00000680 45 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 |Execution of the|
00000690 20 73 63 72 69 70 74 20 77 69 6c 6c 20 62 65 20 | script will be |
000006a0 70 61 75 73 65 64 0a 20 20 75 6e 74 69 6c 20 74 |paused. until t|
000006b0 68 65 20 75 73 65 72 20 63 6c 69 63 6b 73 20 27 |he user clicks '|
000006c0 4f 4b 27 20 61 6e 64 20 74 68 65 6e 20 77 69 6c |OK' and then wil|
000006d0 6c 20 63 6f 6e 74 69 6e 75 65 2e 20 54 68 65 20 |l continue. The |
000006e0 74 65 78 74 20 6d 61 79 20 69 6e 63 6c 75 64 65 |text may include|
000006f0 0a 20 20 76 61 72 69 61 62 6c 65 73 20 65 6e 63 |. variables enc|
00000700 6c 6f 73 65 64 20 69 6e 20 3c 3e 20 63 68 61 72 |losed in <> char|
00000710 61 63 74 65 72 73 2e 20 49 66 20 74 68 65 20 74 |acters. If the t|
00000720 65 78 74 20 63 6f 6e 74 61 69 6e 73 20 73 70 61 |ext contains spa|
00000730 63 65 73 20 74 68 61 6e 20 74 68 65 0a 20 20 77 |ces than the. w|
00000740 68 6f 6c 65 20 73 74 72 69 6e 67 20 73 68 6f 75 |hole string shou|
00000750 6c 64 20 62 65 20 65 6e 63 6c 6f 73 65 64 20 69 |ld be enclosed i|
00000760 6e 20 71 75 6f 74 65 73 2e 20 54 68 65 20 6d 61 |n quotes. The ma|
00000770 78 69 6d 75 6d 20 69 73 20 32 35 36 20 63 68 61 |ximum is 256 cha|
00000780 72 61 63 74 65 72 73 2e 0a 0a 57 61 72 6e 69 6e |racters...Warnin|
00000790 67 20 3c 74 65 78 74 3e 0a 0a 20 20 54 68 65 20 |g <text>.. The |
000007a0 73 61 6d 65 20 61 73 20 52 65 70 6f 72 74 2c 20 |same as Report, |
000007b0 65 78 63 65 70 74 20 74 68 61 74 20 74 68 65 20 |except that the |
000007c0 77 69 6e 64 6f 77 20 77 69 6c 6c 20 68 61 76 65 |window will have|
000007d0 20 62 6f 74 68 20 61 6e 20 27 4f 4b 27 20 62 75 | both an 'OK' bu|
000007e0 74 74 6f 6e 20 61 6e 64 0a 20 20 61 20 27 43 61 |tton and. a 'Ca|
000007f0 6e 63 65 6c 27 20 62 75 74 74 6f 6e 2e 20 45 78 |ncel' button. Ex|
00000800 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 |ecution of the s|
00000810 63 72 69 70 74 20 77 69 6c 6c 20 63 6f 6e 74 69 |cript will conti|
00000820 6e 75 65 20 69 66 20 74 68 65 20 75 73 65 72 20 |nue if the user |
00000830 63 6c 69 63 6b 73 0a 20 20 27 4f 4b 27 20 62 75 |clicks. 'OK' bu|
00000840 74 20 77 69 6c 6c 20 62 65 20 61 62 6f 72 74 65 |t will be aborte|
00000850 64 20 6f 6e 20 27 43 61 6e 63 65 6c 27 2e 0a 0a |d on 'Cancel'...|
00000860 45 6e 73 75 72 65 20 3c 66 69 6c 65 6e 61 6d 65 |Ensure <filename|
00000870 3e 20 3c 74 65 78 74 3e 0a 0a 20 20 45 6e 73 75 |> <text>.. Ensu|
00000880 72 65 20 77 69 6c 6c 20 63 68 65 63 6b 20 66 6f |re will check fo|
00000890 72 20 74 68 65 20 65 78 69 73 74 65 6e 63 65 20 |r the existence |
000008a0 6f 66 20 61 20 66 69 6c 65 2e 20 54 68 65 20 66 |of a file. The f|
000008b0 69 6c 65 6e 61 6d 65 20 73 68 6f 75 6c 64 20 62 |ilename should b|
000008c0 65 20 61 20 66 75 6c 6c 0a 20 20 70 61 74 68 20 |e a full. path |
000008d0 6f 72 20 61 6e 20 4f 53 20 65 6e 76 69 72 6f 6e |or an OS environ|
000008e0 6d 65 6e 74 61 6c 20 76 61 72 69 61 62 6c 65 20 |mental variable |
000008f0 79 69 65 6c 64 69 6e 67 20 61 20 70 61 74 68 20 |yielding a path |
00000900 28 65 2e 67 2e 20 22 3c 49 6e 73 74 61 6c 6c 24 |(e.g. "<Install$|
00000910 44 69 72 3e 22 29 2e 0a 20 20 49 66 20 74 68 65 |Dir>").. If the|
00000920 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65 | file does not e|
00000930 78 69 73 74 2c 20 74 68 65 20 74 65 78 74 20 77 |xist, the text w|
00000940 69 6c 6c 20 62 65 20 64 69 73 70 6c 61 79 65 64 |ill be displayed|
00000950 20 61 6e 64 20 65 78 65 63 75 74 69 6f 6e 20 6f | and execution o|
00000960 66 20 74 68 65 0a 20 20 73 63 72 69 70 74 20 77 |f the. script w|
00000970 69 6c 6c 20 62 65 20 61 62 6f 72 74 65 64 2e 0a |ill be aborted..|
00000980 0a 47 65 74 50 61 74 68 20 3c 6e 61 6d 65 3e 20 |.GetPath <name> |
00000990 3c 64 65 66 61 75 6c 74 20 64 65 73 74 69 6e 61 |<default destina|
000009a0 74 69 6f 6e 3e 20 3c 73 70 72 69 74 65 3e 0a 0a |tion> <sprite>..|
000009b0 20 20 54 68 69 73 20 6f 70 65 6e 73 20 61 20 77 | This opens a w|
000009c0 69 6e 64 6f 77 20 69 6e 76 69 74 69 6e 67 20 74 |indow inviting t|
000009d0 68 65 20 75 73 65 72 20 74 6f 20 63 68 6f 6f 73 |he user to choos|
000009e0 65 20 61 6e 20 69 6e 73 74 61 6c 6c 61 74 69 6f |e an installatio|
000009f0 6e 20 70 61 74 68 2c 20 77 68 69 63 68 0a 20 20 |n path, which. |
00000a00 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 |will be returned|
00000a10 20 69 6e 20 74 68 65 20 73 70 65 63 69 61 6c 20 | in the special |
00000a20 76 61 72 69 61 62 6c 65 2c 20 70 61 74 68 2e 0a |variable, path..|
00000a30 0a 20 20 6e 61 6d 65 3a 20 20 20 41 20 6e 61 6d |. name: A nam|
00000a40 65 20 66 6f 72 20 74 68 65 20 73 61 76 65 20 74 |e for the save t|
00000a50 6f 20 66 6f 6c 6c 6f 77 20 28 6c 65 73 73 20 74 |o follow (less t|
00000a60 68 61 6e 20 31 32 20 63 68 61 72 73 29 2c 20 75 |han 12 chars), u|
00000a70 73 75 61 6c 6c 79 20 74 68 65 20 6c 65 61 66 0a |sually the leaf.|
00000a80 20 20 20 20 20 20 20 20 20 20 6e 61 6d 65 20 6f | name o|
00000a90 66 20 74 68 65 20 66 69 6c 65 20 77 68 69 63 68 |f the file which|
00000aa0 20 69 73 20 74 6f 20 62 65 20 73 61 76 65 64 20 | is to be saved |
00000ab0 69 6e 74 6f 20 74 68 65 20 75 73 65 72 27 73 20 |into the user's |
00000ac0 63 68 6f 73 65 6e 20 66 6f 6c 64 65 72 2e 0a 20 |chosen folder.. |
00000ad0 20 64 65 66 61 75 6c 74 20 64 65 73 74 69 6e 61 | default destina|
00000ae0 74 69 6f 6e 3a 20 61 20 73 75 67 67 65 73 74 65 |tion: a suggeste|
00000af0 64 20 70 61 74 68 20 66 6f 72 20 73 61 76 69 6e |d path for savin|
00000b00 67 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 73 70 |g the file.. sp|
00000b10 72 69 74 65 3a 20 54 68 65 20 6e 61 6d 65 20 6f |rite: The name o|
00000b20 66 20 61 20 73 70 72 69 74 65 20 74 6f 20 61 70 |f a sprite to ap|
00000b30 70 65 61 72 20 69 6e 20 74 68 65 20 64 69 61 6c |pear in the dial|
00000b40 6f 67 75 65 20 77 69 6e 64 6f 77 2e 20 54 68 65 |ogue window. The|
00000b50 20 6e 61 6d 65 64 0a 20 20 20 20 20 20 20 20 20 | named. |
00000b60 20 73 70 72 69 74 65 20 73 68 6f 75 6c 64 20 62 | sprite should b|
00000b70 65 20 63 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 |e contained with|
00000b80 69 6e 20 69 6e 20 74 68 65 20 21 49 6e 73 74 61 |in in the !Insta|
00000b90 6c 6c 20 22 53 70 72 69 74 65 73 22 20 61 6e 64 |ll "Sprites" and|
00000ba0 0a 20 20 20 20 20 20 20 20 20 20 22 53 70 72 69 |. "Spri|
00000bb0 74 65 73 32 32 22 20 66 69 6c 65 73 2e 0a 0a 20 |tes22" files... |
00000bc0 20 54 68 65 20 72 65 74 75 72 6e 65 64 20 70 61 | The returned pa|
00000bd0 74 68 20 77 69 6c 6c 20 62 65 20 74 68 61 74 20 |th will be that |
00000be0 63 68 6f 73 65 6e 20 62 79 20 74 68 65 20 75 73 |chosen by the us|
00000bf0 65 72 2c 20 65 69 74 68 65 72 20 62 79 20 74 79 |er, either by ty|
00000c00 70 65 64 20 65 6e 74 72 79 20 6f 72 0a 20 20 61 |ped entry or. a|
00000c10 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 |s the result of |
00000c20 61 6e 20 69 63 6f 6e 20 64 72 61 67 2c 20 77 69 |an icon drag, wi|
00000c30 74 68 6f 75 74 20 74 68 65 20 6c 65 61 66 20 6e |thout the leaf n|
00000c40 61 6d 65 2c 20 69 2e 65 2e 20 69 74 20 63 61 6e |ame, i.e. it can|
00000c50 20 62 65 20 75 73 65 64 20 6d 6f 72 65 0a 20 20 | be used more. |
00000c60 74 68 61 6e 20 6f 6e 63 65 20 69 6e 20 74 68 65 |than once in the|
00000c70 20 73 63 72 69 70 74 20 62 79 20 61 74 74 61 63 | script by attac|
00000c80 68 69 6e 67 20 61 20 73 75 63 63 65 73 73 69 6f |hing a successio|
00000c90 6e 20 6f 66 20 66 69 6c 65 20 6c 65 61 66 20 6e |n of file leaf n|
00000ca0 61 6d 65 73 2e 20 46 6f 72 0a 20 20 65 78 61 6d |ames. For. exam|
00000cb0 70 6c 65 2c 20 69 66 20 74 68 65 20 75 73 65 72 |ple, if the user|
00000cc0 27 73 20 70 61 74 68 20 69 73 3a 20 41 44 46 53 |'s path is: ADFS|
00000cd0 3a 3a 4d 79 44 69 73 63 2e 24 2e 4d 79 46 6f 6c |::MyDisc.$.MyFol|
00000ce0 64 65 72 2e 46 69 6c 65 6e 61 6d 65 0a 20 20 74 |der.Filename. t|
00000cf0 68 65 6e 20 74 68 65 20 72 65 74 75 72 6e 65 64 |hen the returned|
00000d00 20 70 61 74 68 20 77 69 6c 6c 20 62 65 3a 20 41 | path will be: A|
00000d10 44 46 53 3a 3a 4d 79 44 69 73 63 2e 24 2e 4d 79 |DFS::MyDisc.$.My|
00000d20 46 6f 6c 64 65 72 0a 0a 43 6f 70 79 20 3c 73 6f |Folder..Copy <so|
00000d30 75 72 63 65 3e 20 3c 64 65 73 74 69 6e 61 74 69 |urce> <destinati|
00000d40 6f 6e 3e 0a 0a 20 20 53 69 6d 69 6c 61 72 20 74 |on>.. Similar t|
00000d50 6f 20 61 6e 20 4f 53 20 43 6f 70 79 20 63 6f 6d |o an OS Copy com|
00000d60 6d 61 6e 64 2c 20 65 78 63 65 70 74 20 28 69 29 |mand, except (i)|
00000d70 20 73 6f 75 72 63 65 20 61 6e 64 20 64 65 73 74 | source and dest|
00000d80 69 6e 61 74 69 6f 6e 20 6d 61 79 20 69 6e 63 6c |ination may incl|
00000d90 75 64 65 0a 20 20 76 61 72 69 61 62 6c 65 73 2c |ude. variables,|
00000da0 20 28 69 69 29 20 6f 76 65 72 77 72 69 74 69 6e | (ii) overwritin|
00000db0 67 20 6f 66 20 61 6e 79 20 65 78 69 73 74 69 6e |g of any existin|
00000dc0 67 20 66 69 6c 65 2c 20 74 68 65 20 6e 61 6d 65 |g file, the name|
00000dd0 20 6f 66 20 77 68 69 63 68 20 6d 61 74 63 68 65 | of which matche|
00000de0 73 20 74 68 65 0a 20 20 64 65 73 74 69 6e 61 74 |s the. destinat|
00000df0 69 6f 6e 2c 20 77 69 6c 6c 20 61 6c 77 61 79 73 |ion, will always|
00000e00 20 62 65 20 66 6f 72 63 65 64 20 77 69 74 68 6f | be forced witho|
00000e10 75 74 20 77 61 72 6e 69 6e 67 20 74 68 65 20 75 |ut warning the u|
00000e20 73 65 72 2c 20 61 6e 64 20 28 69 69 69 29 20 74 |ser, and (iii) t|
00000e30 68 65 20 63 6f 70 79 0a 20 20 69 73 20 61 6c 77 |he copy. is alw|
00000e40 61 79 73 20 72 65 63 75 72 73 69 76 65 2c 20 73 |ays recursive, s|
00000e50 6f 20 63 6f 70 79 69 6e 67 20 61 20 64 69 72 65 |o copying a dire|
00000e60 63 74 6f 72 79 20 6f 72 20 61 70 70 6c 69 63 61 |ctory or applica|
00000e70 74 69 6f 6e 20 77 69 6c 6c 20 61 6c 77 61 79 73 |tion will always|
00000e80 20 63 6f 70 79 20 74 68 65 0a 20 20 63 6f 6e 74 | copy the. cont|
00000e90 65 6e 74 73 2e 20 4e 6f 72 6d 61 6c 6c 79 20 74 |ents. Normally t|
00000ea0 68 65 20 73 6f 75 72 63 65 20 77 69 6c 6c 20 62 |he source will b|
00000eb0 65 20 73 6f 6d 65 20 66 69 6c 65 20 63 6f 6e 74 |e some file cont|
00000ec0 61 69 6e 65 64 20 69 6e 20 74 68 65 20 22 46 69 |ained in the "Fi|
00000ed0 6c 65 73 22 20 66 6f 6c 64 65 72 0a 20 20 77 69 |les" folder. wi|
00000ee0 74 68 69 6e 20 74 68 65 20 21 49 6e 73 74 61 6c |thin the !Instal|
00000ef0 6c 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a 0a |l application...|
00000f00 4f 53 20 3c 63 6f 6d 6d 61 6e 64 3e 0a 0a 20 20 |OS <command>.. |
00000f10 45 78 65 63 75 74 65 20 61 6e 20 4f 53 20 63 6f |Execute an OS co|
00000f20 6d 6d 61 6e 64 2e 20 49 66 20 69 74 20 63 6f 6e |mmand. If it con|
00000f30 74 61 69 6e 73 20 73 70 61 63 65 73 2c 20 65 6e |tains spaces, en|
00000f40 63 6c 6f 73 65 20 69 74 20 69 6e 20 71 75 6f 74 |close it in quot|
00000f50 65 73 2e 0a 0a 0a 50 6f 73 74 73 63 72 69 70 74 |es....Postscript|
00000f60 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 77 |.----------..A w|
00000f70 6f 72 6b 69 6e 67 20 63 6f 70 79 20 6f 66 20 21 |orking copy of !|
00000f80 49 6e 73 74 61 6c 6c 20 77 69 6c 6c 20 6e 6f 74 |Install will not|
00000f90 20 72 65 71 75 69 72 65 20 74 68 69 73 20 21 48 | require this !H|
00000fa0 65 6c 70 20 66 69 6c 65 2e 20 49 74 20 69 73 20 |elp file. It is |
00000fb0 73 75 67 67 65 73 74 65 64 20 74 68 61 74 0a 69 |suggested that.i|
00000fc0 74 20 62 65 20 64 65 6c 65 74 65 64 20 66 72 6f |t be deleted fro|
00000fd0 6d 20 61 6e 79 20 64 69 73 74 72 69 62 75 74 69 |m any distributi|
00000fe0 6f 6e 20 6d 65 64 69 75 6d 20 69 6e 20 6f 72 64 |on medium in ord|
00000ff0 65 72 20 74 6f 20 73 61 76 65 20 73 74 6f 72 61 |er to save stora|
00001000 67 65 20 73 70 61 63 65 2e 0a |ge space..|
0000100a 
.