Home » Archimedes archive » Archimedes World » archimedes_world_volume_15_issue_2_scp.adf » !ARMEdit_ARMEdit » Docs/OSCLI
Docs/OSCLI
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 » Archimedes World » archimedes_world_volume_15_issue_2_scp.adf » !ARMEdit_ARMEdit |
| Filename: | Docs/OSCLI |
| Read OK: | ✔ |
| File size: | 234A bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
File : OSCLI
Date : 07-Dec-97
Author : � A.Thoukydides, 1995, 1996, 1997
Description : Description of the PC OSCLI command that is part of the ARMEdit
suite.
INTRODUCTION
The "OSCLI" command allows RISC OS *commands to be executed from the DOS
command line. To use this command it is necessary to load the ARMEdit module
before starting the PC front-end.
USAGE
The syntax is:
OSCLI [/?] [/I|/S|/T] [/R] [<Command>]
where
/? - Displays some help text.
/I - Redirects both input and output streams through DOS.
/S - Prevents redirection of output through DOS.
/T - Executes the command in a RISC OS TaskWindow.
/R - Disable processing of VDU codes in the output.
<Command> - The command to execute.
Note that to prevent DOS from changing the command it is a good idea to place
it in quotation marks. If no command is specified then shell mode is entered;
just press Return at the * prompt without entering any other characters on
the line to exit.
Due to the way in which this command operates, strange behaviour can
sometimes be produced. Some RISC OS commands can cause the computer to crash,
so be careful with it. In particular, except for the TaskWindow option, the
commands are executed within the environment of the PC front-end, so
applications (including BASIC) must not be started.
The "/T" switch attempts to start a RISC OS TaskWindow to execute the
command; this requires !ARMEdit to be running. This option has the advantage
that almost any command that can be used in an !Edit TaskWindow may be used,
including running other applications or starting the BASIC interpreter.
Another point to note is that commands that require action to be taken by a
WIMP task, such as Filer_Run will not take effect until the PC enters
multitasking mode.
REDIRECTION
Many *commands perform either input or output. By default the OSCLI command
redirects the output of the command being executed to a RISC OS file before
passing it to the DOS standard output. This allows, for example, piping to
the MORE filter. To prevent this behaviour it is possible to specify the "/S"
switch.
Some commands require interactive input and output, such as *Build or *Count.
Specifying the "/I" switch allows use of these commands by attaching both the
input and output of the command to the standard DOS streams. This requires
the command to be frequently suspended to allow input and output to be
processed, so it can appear slightly slower. It may also have problems with
some commands that work without the "/I" switch.
SHELL MODE
Using the OSCLI command without specifying a *command causes a shell mode to
be entered. This is similar to the command line that can be obtained from the
RISC OS desktop by pressing F12; a sequence of commands may be typed, ended
by pressing Return on a line by itself.
Unless the "/R" switch is used, a relatively simple command line history
function is provided. The following keys may be used:
Ctrl-A or Home Move the cursor to the start of the current line.
Ctrl-B or Left Move the cursor left one character.
Ctrl-D or Delete Delete the character to the right.
Ctrl-E or End Move the cursor to the end of the current line.
Ctrl-F or Right Move the cursor right one character.
Ctrl-H or Backspace Delete the character to the left.
Ctrl-K Delete all characters to the end of the line.
Ctrl-M or Return Execute the current command.
Ctrl-N or Down Move to the next entry in the history list.
Ctrl-P or Up Move to the previous entry in the history list.
Ctrl-T Transpose two characters.
Ctrl-U or Escape Clear the current line.
Ctrl-Left Move the cursor left one word.
Ctrl-Right Move the cursor right one word.
Insert Toggle insert or overwrite mode.
These are similar to the default assignments used by Oliver Betts' RISC OS
LineEditor module.
VDU CODES
The output from some commands include RISC OS VDU codes. When output from the
OSCLI command is directed to the DOS screen (as is normal) and the "/R"
switch is not used then some of these codes are processed:
VDU 6 Enable screen output. This cancels the effect of VDU 21.
VDU 7 Ring the terminal bell, i.e. produce a beep.
VDU 8 Backspace the cursor. This moves the cursor back one character
position.
VDU 9 Horizontal tab. This advances the cursor one character position.
VDU 10 Linefeed. This moves the cursor to the same position on the next
line.
VDU 11 Vertical tab. This moves the cursor to the same position on the
previous line.
VDU 12 Clear the current screen or text window if one defined.
VDU 13 Carriage return. This moves the cursor to the start of the
current line.
VDU 17 Set either the foreground or background the text colour. This
attempts to choose the closest DOS text screen colour to the one
specified. The default RISC OS palette is assumed.
VDU 20 Restore the default colours. This selects white text on a black
background.
VDU 21 Disable the screen display. All output is skipped until a VDU 6
code is reached.
VDU 22 Change the display mode. This clears the screen, clears any text
window and restores the default colours. An attempt is made to
use the closest DOS text mode to the requested RISC OS mode. This
also affects the mapping of text colours for VDU 17.
VDU 23 This encompasses a wide selection of possible operations. Only
some of these are supported:
VDU 23, 0 Control the text cursor appearance. This allows
the cursor to be switched off or changed into a
solid block.
VDU 23, 1 Control the appearance of the text cursor. This
allows the cursor to be switched off or changed
into a solid block.
VDU 23, 7 Scroll either the current text window or the
whole screen.
VDU 23, 16 Control the movement of the cursor after
printing. This allows the interpretation of
horizontal and vertical movements to be changed.
VDU 23, 17 Exchange the text foreground and background
colours.
VDU 26 Restore the default windows. This sets the text window to fill
the screen and places the cursor in the home position.
VDU 28 Define a text window. If the coordinates are in the wrong order
or lie outside the dimensions of the screen then this has no
effect.
VDU 30 Move the cursor to the home position. This is normally the
top-left corner of the current text window, but this may be
changed by VDU 23, 16.
VDU 31 Move the cursor to the specified coordinates. If the position
lies outside the current text window then this is ignored.
Note that some of these operations may not work quite as expected, normally
because the DOS screen does not exactly match the expected RISC OS mode, and
no graphics operations are supported. There are also some other VDU sequences
that have not been supported because they are rarely used.
THINGS TO DO
The following are changes that may be made to the OSCLI command sometime in
the future.
None at the moment!
VERSION HISTORY
0.00 (12-Nov-95) Original development version.
0.01 (14-Nov-95) Added version number and copyright message.
Output is passed through the standard output of the DOS
command.
0.02 (17-Nov-95) Uses correct HPC service identifier.
Changed to a .COM file to make it smaller.
Made redirection of output optional and added help text.
0.04 (16-Dec-95) Uses real HPC.
1.00 (12-Jan-96) First official release version.
1.01 (11-Mar-96) Version number updated to match the module.
1.02 (06-Aug-96) Added support for Acorn's software PC emulator.
Included redirection of input stream through DOS.
1.03 (21-Feb-97) Unique temporary filenames used.
Operation under Window now more reliable.
1.04 (07-Dec-97) Spaces no longer added to end of command.
Shell mode added with command line editing and history.
VDU codes in output processed before being displayed.
Commands may be executed in a RISC OS TaskWindow. 00000000 46 69 6c 65 20 20 20 20 20 20 20 20 3a 20 4f 53 |File : OS| 00000010 43 4c 49 0a 44 61 74 65 20 20 20 20 20 20 20 20 |CLI.Date | 00000020 3a 20 30 37 2d 44 65 63 2d 39 37 0a 41 75 74 68 |: 07-Dec-97.Auth| 00000030 6f 72 20 20 20 20 20 20 3a 20 a9 20 41 2e 54 68 |or : . A.Th| 00000040 6f 75 6b 79 64 69 64 65 73 2c 20 31 39 39 35 2c |oukydides, 1995,| 00000050 20 31 39 39 36 2c 20 31 39 39 37 0a 44 65 73 63 | 1996, 1997.Desc| 00000060 72 69 70 74 69 6f 6e 20 3a 20 44 65 73 63 72 69 |ription : Descri| 00000070 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 50 43 20 |ption of the PC | 00000080 4f 53 43 4c 49 20 63 6f 6d 6d 61 6e 64 20 74 68 |OSCLI command th| 00000090 61 74 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 |at is part of th| 000000a0 65 20 41 52 4d 45 64 69 74 0a 20 20 20 20 20 20 |e ARMEdit. | 000000b0 20 20 20 20 20 20 20 20 73 75 69 74 65 2e 0a 0a | suite...| 000000c0 0a 49 4e 54 52 4f 44 55 43 54 49 4f 4e 0a 0a 54 |.INTRODUCTION..T| 000000d0 68 65 20 22 4f 53 43 4c 49 22 20 63 6f 6d 6d 61 |he "OSCLI" comma| 000000e0 6e 64 20 61 6c 6c 6f 77 73 20 52 49 53 43 20 4f |nd allows RISC O| 000000f0 53 20 2a 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 62 |S *commands to b| 00000100 65 20 65 78 65 63 75 74 65 64 20 66 72 6f 6d 20 |e executed from | 00000110 74 68 65 20 44 4f 53 0a 63 6f 6d 6d 61 6e 64 20 |the DOS.command | 00000120 6c 69 6e 65 2e 20 54 6f 20 75 73 65 20 74 68 69 |line. To use thi| 00000130 73 20 63 6f 6d 6d 61 6e 64 20 69 74 20 69 73 20 |s command it is | 00000140 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6c 6f 61 |necessary to loa| 00000150 64 20 74 68 65 20 41 52 4d 45 64 69 74 20 6d 6f |d the ARMEdit mo| 00000160 64 75 6c 65 0a 62 65 66 6f 72 65 20 73 74 61 72 |dule.before star| 00000170 74 69 6e 67 20 74 68 65 20 50 43 20 66 72 6f 6e |ting the PC fron| 00000180 74 2d 65 6e 64 2e 0a 0a 0a 55 53 41 47 45 0a 0a |t-end....USAGE..| 00000190 54 68 65 20 73 79 6e 74 61 78 20 69 73 3a 0a 0a |The syntax is:..| 000001a0 20 20 20 20 4f 53 43 4c 49 20 5b 2f 3f 5d 20 5b | OSCLI [/?] [| 000001b0 2f 49 7c 2f 53 7c 2f 54 5d 20 5b 2f 52 5d 20 5b |/I|/S|/T] [/R] [| 000001c0 3c 43 6f 6d 6d 61 6e 64 3e 5d 0a 0a 77 68 65 72 |<Command>]..wher| 000001d0 65 0a 0a 20 20 20 20 2f 3f 20 20 20 20 20 20 20 |e.. /? | 000001e0 20 20 20 2d 20 44 69 73 70 6c 61 79 73 20 73 6f | - Displays so| 000001f0 6d 65 20 68 65 6c 70 20 74 65 78 74 2e 0a 20 20 |me help text.. | 00000200 20 20 2f 49 20 20 20 20 20 20 20 20 20 20 2d 20 | /I - | 00000210 52 65 64 69 72 65 63 74 73 20 62 6f 74 68 20 69 |Redirects both i| 00000220 6e 70 75 74 20 61 6e 64 20 6f 75 74 70 75 74 20 |nput and output | 00000230 73 74 72 65 61 6d 73 20 74 68 72 6f 75 67 68 20 |streams through | 00000240 44 4f 53 2e 0a 20 20 20 20 2f 53 20 20 20 20 20 |DOS.. /S | 00000250 20 20 20 20 20 2d 20 50 72 65 76 65 6e 74 73 20 | - Prevents | 00000260 72 65 64 69 72 65 63 74 69 6f 6e 20 6f 66 20 6f |redirection of o| 00000270 75 74 70 75 74 20 74 68 72 6f 75 67 68 20 44 4f |utput through DO| 00000280 53 2e 0a 20 20 20 20 2f 54 20 20 20 20 20 20 20 |S.. /T | 00000290 20 20 20 2d 20 45 78 65 63 75 74 65 73 20 74 68 | - Executes th| 000002a0 65 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 61 20 52 |e command in a R| 000002b0 49 53 43 20 4f 53 20 54 61 73 6b 57 69 6e 64 6f |ISC OS TaskWindo| 000002c0 77 2e 0a 20 20 20 20 2f 52 20 20 20 20 20 20 20 |w.. /R | 000002d0 20 20 20 2d 20 44 69 73 61 62 6c 65 20 70 72 6f | - Disable pro| 000002e0 63 65 73 73 69 6e 67 20 6f 66 20 56 44 55 20 63 |cessing of VDU c| 000002f0 6f 64 65 73 20 69 6e 20 74 68 65 20 6f 75 74 70 |odes in the outp| 00000300 75 74 2e 0a 20 20 20 20 3c 43 6f 6d 6d 61 6e 64 |ut.. <Command| 00000310 3e 20 20 20 2d 20 54 68 65 20 63 6f 6d 6d 61 6e |> - The comman| 00000320 64 20 74 6f 20 65 78 65 63 75 74 65 2e 0a 0a 4e |d to execute...N| 00000330 6f 74 65 20 74 68 61 74 20 74 6f 20 70 72 65 76 |ote that to prev| 00000340 65 6e 74 20 44 4f 53 20 66 72 6f 6d 20 63 68 61 |ent DOS from cha| 00000350 6e 67 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e |nging the comman| 00000360 64 20 69 74 20 69 73 20 61 20 67 6f 6f 64 20 69 |d it is a good i| 00000370 64 65 61 20 74 6f 20 70 6c 61 63 65 0a 69 74 20 |dea to place.it | 00000380 69 6e 20 71 75 6f 74 61 74 69 6f 6e 20 6d 61 72 |in quotation mar| 00000390 6b 73 2e 20 49 66 20 6e 6f 20 63 6f 6d 6d 61 6e |ks. If no comman| 000003a0 64 20 69 73 20 73 70 65 63 69 66 69 65 64 20 74 |d is specified t| 000003b0 68 65 6e 20 73 68 65 6c 6c 20 6d 6f 64 65 20 69 |hen shell mode i| 000003c0 73 20 65 6e 74 65 72 65 64 3b 0a 6a 75 73 74 20 |s entered;.just | 000003d0 70 72 65 73 73 20 52 65 74 75 72 6e 20 61 74 20 |press Return at | 000003e0 74 68 65 20 2a 20 70 72 6f 6d 70 74 20 77 69 74 |the * prompt wit| 000003f0 68 6f 75 74 20 65 6e 74 65 72 69 6e 67 20 61 6e |hout entering an| 00000400 79 20 6f 74 68 65 72 20 63 68 61 72 61 63 74 65 |y other characte| 00000410 72 73 20 6f 6e 0a 74 68 65 20 6c 69 6e 65 20 74 |rs on.the line t| 00000420 6f 20 65 78 69 74 2e 0a 0a 44 75 65 20 74 6f 20 |o exit...Due to | 00000430 74 68 65 20 77 61 79 20 69 6e 20 77 68 69 63 68 |the way in which| 00000440 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 6f 70 | this command op| 00000450 65 72 61 74 65 73 2c 20 73 74 72 61 6e 67 65 20 |erates, strange | 00000460 62 65 68 61 76 69 6f 75 72 20 63 61 6e 0a 73 6f |behaviour can.so| 00000470 6d 65 74 69 6d 65 73 20 62 65 20 70 72 6f 64 75 |metimes be produ| 00000480 63 65 64 2e 20 53 6f 6d 65 20 52 49 53 43 20 4f |ced. Some RISC O| 00000490 53 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 63 |S commands can c| 000004a0 61 75 73 65 20 74 68 65 20 63 6f 6d 70 75 74 65 |ause the compute| 000004b0 72 20 74 6f 20 63 72 61 73 68 2c 0a 73 6f 20 62 |r to crash,.so b| 000004c0 65 20 63 61 72 65 66 75 6c 20 77 69 74 68 20 69 |e careful with i| 000004d0 74 2e 20 49 6e 20 70 61 72 74 69 63 75 6c 61 72 |t. In particular| 000004e0 2c 20 65 78 63 65 70 74 20 66 6f 72 20 74 68 65 |, except for the| 000004f0 20 54 61 73 6b 57 69 6e 64 6f 77 20 6f 70 74 69 | TaskWindow opti| 00000500 6f 6e 2c 20 74 68 65 0a 63 6f 6d 6d 61 6e 64 73 |on, the.commands| 00000510 20 61 72 65 20 65 78 65 63 75 74 65 64 20 77 69 | are executed wi| 00000520 74 68 69 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e |thin the environ| 00000530 6d 65 6e 74 20 6f 66 20 74 68 65 20 50 43 20 66 |ment of the PC f| 00000540 72 6f 6e 74 2d 65 6e 64 2c 20 73 6f 0a 61 70 70 |ront-end, so.app| 00000550 6c 69 63 61 74 69 6f 6e 73 20 28 69 6e 63 6c 75 |lications (inclu| 00000560 64 69 6e 67 20 42 41 53 49 43 29 20 6d 75 73 74 |ding BASIC) must| 00000570 20 6e 6f 74 20 62 65 20 73 74 61 72 74 65 64 2e | not be started.| 00000580 0a 0a 54 68 65 20 22 2f 54 22 20 73 77 69 74 63 |..The "/T" switc| 00000590 68 20 61 74 74 65 6d 70 74 73 20 74 6f 20 73 74 |h attempts to st| 000005a0 61 72 74 20 61 20 52 49 53 43 20 4f 53 20 54 61 |art a RISC OS Ta| 000005b0 73 6b 57 69 6e 64 6f 77 20 74 6f 20 65 78 65 63 |skWindow to exec| 000005c0 75 74 65 20 74 68 65 0a 63 6f 6d 6d 61 6e 64 3b |ute the.command;| 000005d0 20 74 68 69 73 20 72 65 71 75 69 72 65 73 20 21 | this requires !| 000005e0 41 52 4d 45 64 69 74 20 74 6f 20 62 65 20 72 75 |ARMEdit to be ru| 000005f0 6e 6e 69 6e 67 2e 20 54 68 69 73 20 6f 70 74 69 |nning. This opti| 00000600 6f 6e 20 68 61 73 20 74 68 65 20 61 64 76 61 6e |on has the advan| 00000610 74 61 67 65 0a 74 68 61 74 20 61 6c 6d 6f 73 74 |tage.that almost| 00000620 20 61 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68 61 | any command tha| 00000630 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e |t can be used in| 00000640 20 61 6e 20 21 45 64 69 74 20 54 61 73 6b 57 69 | an !Edit TaskWi| 00000650 6e 64 6f 77 20 6d 61 79 20 62 65 20 75 73 65 64 |ndow may be used| 00000660 2c 0a 69 6e 63 6c 75 64 69 6e 67 20 72 75 6e 6e |,.including runn| 00000670 69 6e 67 20 6f 74 68 65 72 20 61 70 70 6c 69 63 |ing other applic| 00000680 61 74 69 6f 6e 73 20 6f 72 20 73 74 61 72 74 69 |ations or starti| 00000690 6e 67 20 74 68 65 20 42 41 53 49 43 20 69 6e 74 |ng the BASIC int| 000006a0 65 72 70 72 65 74 65 72 2e 0a 0a 41 6e 6f 74 68 |erpreter...Anoth| 000006b0 65 72 20 70 6f 69 6e 74 20 74 6f 20 6e 6f 74 65 |er point to note| 000006c0 20 69 73 20 74 68 61 74 20 63 6f 6d 6d 61 6e 64 | is that command| 000006d0 73 20 74 68 61 74 20 72 65 71 75 69 72 65 20 61 |s that require a| 000006e0 63 74 69 6f 6e 20 74 6f 20 62 65 20 74 61 6b 65 |ction to be take| 000006f0 6e 20 62 79 20 61 0a 57 49 4d 50 20 74 61 73 6b |n by a.WIMP task| 00000700 2c 20 73 75 63 68 20 61 73 20 46 69 6c 65 72 5f |, such as Filer_| 00000710 52 75 6e 20 77 69 6c 6c 20 6e 6f 74 20 74 61 6b |Run will not tak| 00000720 65 20 65 66 66 65 63 74 20 75 6e 74 69 6c 20 74 |e effect until t| 00000730 68 65 20 50 43 20 65 6e 74 65 72 73 0a 6d 75 6c |he PC enters.mul| 00000740 74 69 74 61 73 6b 69 6e 67 20 6d 6f 64 65 2e 0a |titasking mode..| 00000750 0a 0a 52 45 44 49 52 45 43 54 49 4f 4e 0a 0a 4d |..REDIRECTION..M| 00000760 61 6e 79 20 2a 63 6f 6d 6d 61 6e 64 73 20 70 65 |any *commands pe| 00000770 72 66 6f 72 6d 20 65 69 74 68 65 72 20 69 6e 70 |rform either inp| 00000780 75 74 20 6f 72 20 6f 75 74 70 75 74 2e 20 42 79 |ut or output. By| 00000790 20 64 65 66 61 75 6c 74 20 74 68 65 20 4f 53 43 | default the OSC| 000007a0 4c 49 20 63 6f 6d 6d 61 6e 64 0a 72 65 64 69 72 |LI command.redir| 000007b0 65 63 74 73 20 74 68 65 20 6f 75 74 70 75 74 20 |ects the output | 000007c0 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 62 |of the command b| 000007d0 65 69 6e 67 20 65 78 65 63 75 74 65 64 20 74 6f |eing executed to| 000007e0 20 61 20 52 49 53 43 20 4f 53 20 66 69 6c 65 20 | a RISC OS file | 000007f0 62 65 66 6f 72 65 0a 70 61 73 73 69 6e 67 20 69 |before.passing i| 00000800 74 20 74 6f 20 74 68 65 20 44 4f 53 20 73 74 61 |t to the DOS sta| 00000810 6e 64 61 72 64 20 6f 75 74 70 75 74 2e 20 54 68 |ndard output. Th| 00000820 69 73 20 61 6c 6c 6f 77 73 2c 20 66 6f 72 20 65 |is allows, for e| 00000830 78 61 6d 70 6c 65 2c 20 70 69 70 69 6e 67 20 74 |xample, piping t| 00000840 6f 0a 74 68 65 20 4d 4f 52 45 20 66 69 6c 74 65 |o.the MORE filte| 00000850 72 2e 20 54 6f 20 70 72 65 76 65 6e 74 20 74 68 |r. To prevent th| 00000860 69 73 20 62 65 68 61 76 69 6f 75 72 20 69 74 20 |is behaviour it | 00000870 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 |is possible to s| 00000880 70 65 63 69 66 79 20 74 68 65 20 22 2f 53 22 0a |pecify the "/S".| 00000890 73 77 69 74 63 68 2e 0a 0a 53 6f 6d 65 20 63 6f |switch...Some co| 000008a0 6d 6d 61 6e 64 73 20 72 65 71 75 69 72 65 20 69 |mmands require i| 000008b0 6e 74 65 72 61 63 74 69 76 65 20 69 6e 70 75 74 |nteractive input| 000008c0 20 61 6e 64 20 6f 75 74 70 75 74 2c 20 73 75 63 | and output, suc| 000008d0 68 20 61 73 20 2a 42 75 69 6c 64 20 6f 72 20 2a |h as *Build or *| 000008e0 43 6f 75 6e 74 2e 0a 53 70 65 63 69 66 79 69 6e |Count..Specifyin| 000008f0 67 20 74 68 65 20 22 2f 49 22 20 73 77 69 74 63 |g the "/I" switc| 00000900 68 20 61 6c 6c 6f 77 73 20 75 73 65 20 6f 66 20 |h allows use of | 00000910 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 62 |these commands b| 00000920 79 20 61 74 74 61 63 68 69 6e 67 20 62 6f 74 68 |y attaching both| 00000930 20 74 68 65 0a 69 6e 70 75 74 20 61 6e 64 20 6f | the.input and o| 00000940 75 74 70 75 74 20 6f 66 20 74 68 65 20 63 6f 6d |utput of the com| 00000950 6d 61 6e 64 20 74 6f 20 74 68 65 20 73 74 61 6e |mand to the stan| 00000960 64 61 72 64 20 44 4f 53 20 73 74 72 65 61 6d 73 |dard DOS streams| 00000970 2e 20 54 68 69 73 20 72 65 71 75 69 72 65 73 0a |. This requires.| 00000980 74 68 65 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 62 |the command to b| 00000990 65 20 66 72 65 71 75 65 6e 74 6c 79 20 73 75 73 |e frequently sus| 000009a0 70 65 6e 64 65 64 20 74 6f 20 61 6c 6c 6f 77 20 |pended to allow | 000009b0 69 6e 70 75 74 20 61 6e 64 20 6f 75 74 70 75 74 |input and output| 000009c0 20 74 6f 20 62 65 0a 70 72 6f 63 65 73 73 65 64 | to be.processed| 000009d0 2c 20 73 6f 20 69 74 20 63 61 6e 20 61 70 70 65 |, so it can appe| 000009e0 61 72 20 73 6c 69 67 68 74 6c 79 20 73 6c 6f 77 |ar slightly slow| 000009f0 65 72 2e 20 49 74 20 6d 61 79 20 61 6c 73 6f 20 |er. It may also | 00000a00 68 61 76 65 20 70 72 6f 62 6c 65 6d 73 20 77 69 |have problems wi| 00000a10 74 68 0a 73 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 |th.some commands| 00000a20 20 74 68 61 74 20 77 6f 72 6b 20 77 69 74 68 6f | that work witho| 00000a30 75 74 20 74 68 65 20 22 2f 49 22 20 73 77 69 74 |ut the "/I" swit| 00000a40 63 68 2e 0a 0a 0a 53 48 45 4c 4c 20 4d 4f 44 45 |ch....SHELL MODE| 00000a50 0a 0a 55 73 69 6e 67 20 74 68 65 20 4f 53 43 4c |..Using the OSCL| 00000a60 49 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 |I command withou| 00000a70 74 20 73 70 65 63 69 66 79 69 6e 67 20 61 20 2a |t specifying a *| 00000a80 63 6f 6d 6d 61 6e 64 20 63 61 75 73 65 73 20 61 |command causes a| 00000a90 20 73 68 65 6c 6c 20 6d 6f 64 65 20 74 6f 0a 62 | shell mode to.b| 00000aa0 65 20 65 6e 74 65 72 65 64 2e 20 54 68 69 73 20 |e entered. This | 00000ab0 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 74 68 |is similar to th| 00000ac0 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 74 |e command line t| 00000ad0 68 61 74 20 63 61 6e 20 62 65 20 6f 62 74 61 69 |hat can be obtai| 00000ae0 6e 65 64 20 66 72 6f 6d 20 74 68 65 0a 52 49 53 |ned from the.RIS| 00000af0 43 20 4f 53 20 64 65 73 6b 74 6f 70 20 62 79 20 |C OS desktop by | 00000b00 70 72 65 73 73 69 6e 67 20 46 31 32 3b 20 61 20 |pressing F12; a | 00000b10 73 65 71 75 65 6e 63 65 20 6f 66 20 63 6f 6d 6d |sequence of comm| 00000b20 61 6e 64 73 20 6d 61 79 20 62 65 20 74 79 70 65 |ands may be type| 00000b30 64 2c 20 65 6e 64 65 64 0a 62 79 20 70 72 65 73 |d, ended.by pres| 00000b40 73 69 6e 67 20 52 65 74 75 72 6e 20 6f 6e 20 61 |sing Return on a| 00000b50 20 6c 69 6e 65 20 62 79 20 69 74 73 65 6c 66 2e | line by itself.| 00000b60 0a 0a 55 6e 6c 65 73 73 20 74 68 65 20 22 2f 52 |..Unless the "/R| 00000b70 22 20 73 77 69 74 63 68 20 69 73 20 75 73 65 64 |" switch is used| 00000b80 2c 20 61 20 72 65 6c 61 74 69 76 65 6c 79 20 73 |, a relatively s| 00000b90 69 6d 70 6c 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 |imple command li| 00000ba0 6e 65 20 68 69 73 74 6f 72 79 0a 66 75 6e 63 74 |ne history.funct| 00000bb0 69 6f 6e 20 69 73 20 70 72 6f 76 69 64 65 64 2e |ion is provided.| 00000bc0 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6b | The following k| 00000bd0 65 79 73 20 6d 61 79 20 62 65 20 75 73 65 64 3a |eys may be used:| 00000be0 0a 0a 20 20 20 20 43 74 72 6c 2d 41 20 6f 72 20 |.. Ctrl-A or | 00000bf0 48 6f 6d 65 20 20 20 20 20 20 20 20 20 20 4d 6f |Home Mo| 00000c00 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f |ve the cursor to| 00000c10 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 | the start of th| 00000c20 65 20 63 75 72 72 65 6e 74 20 6c 69 6e 65 2e 0a |e current line..| 00000c30 20 20 20 20 0a 20 20 20 20 43 74 72 6c 2d 42 20 | . Ctrl-B | 00000c40 6f 72 20 4c 65 66 74 20 20 20 20 20 20 20 20 20 |or Left | 00000c50 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 | Move the cursor| 00000c60 20 6c 65 66 74 20 6f 6e 65 20 63 68 61 72 61 63 | left one charac| 00000c70 74 65 72 2e 0a 20 20 20 20 0a 20 20 20 20 43 74 |ter.. . Ct| 00000c80 72 6c 2d 44 20 6f 72 20 44 65 6c 65 74 65 20 20 |rl-D or Delete | 00000c90 20 20 20 20 20 20 44 65 6c 65 74 65 20 74 68 65 | Delete the| 00000ca0 20 63 68 61 72 61 63 74 65 72 20 74 6f 20 74 68 | character to th| 00000cb0 65 20 72 69 67 68 74 2e 0a 20 20 20 20 0a 20 20 |e right.. . | 00000cc0 20 20 43 74 72 6c 2d 45 20 6f 72 20 45 6e 64 20 | Ctrl-E or End | 00000cd0 20 20 20 20 20 20 20 20 20 20 4d 6f 76 65 20 74 | Move t| 00000ce0 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 |he cursor to the| 00000cf0 20 65 6e 64 20 6f 66 20 74 68 65 20 63 75 72 72 | end of the curr| 00000d00 65 6e 74 20 6c 69 6e 65 2e 0a 20 20 20 20 0a 20 |ent line.. . | 00000d10 20 20 20 43 74 72 6c 2d 46 20 6f 72 20 52 69 67 | Ctrl-F or Rig| 00000d20 68 74 20 20 20 20 20 20 20 20 20 4d 6f 76 65 20 |ht Move | 00000d30 74 68 65 20 63 75 72 73 6f 72 20 72 69 67 68 74 |the cursor right| 00000d40 20 6f 6e 65 20 63 68 61 72 61 63 74 65 72 2e 0a | one character..| 00000d50 20 20 20 20 0a 20 20 20 20 43 74 72 6c 2d 48 20 | . Ctrl-H | 00000d60 6f 72 20 42 61 63 6b 73 70 61 63 65 20 20 20 20 |or Backspace | 00000d70 20 44 65 6c 65 74 65 20 74 68 65 20 63 68 61 72 | Delete the char| 00000d80 61 63 74 65 72 20 74 6f 20 74 68 65 20 6c 65 66 |acter to the lef| 00000d90 74 2e 0a 20 20 20 20 0a 20 20 20 20 43 74 72 6c |t.. . Ctrl| 00000da0 2d 4b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |-K | 00000db0 20 20 20 20 44 65 6c 65 74 65 20 61 6c 6c 20 63 | Delete all c| 00000dc0 68 61 72 61 63 74 65 72 73 20 74 6f 20 74 68 65 |haracters to the| 00000dd0 20 65 6e 64 20 6f 66 20 74 68 65 20 6c 69 6e 65 | end of the line| 00000de0 2e 0a 20 20 20 20 0a 20 20 20 20 43 74 72 6c 2d |.. . Ctrl-| 00000df0 4d 20 6f 72 20 52 65 74 75 72 6e 20 20 20 20 20 |M or Return | 00000e00 20 20 20 45 78 65 63 75 74 65 20 74 68 65 20 63 | Execute the c| 00000e10 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 2e 0a |urrent command..| 00000e20 20 20 20 20 0a 20 20 20 20 43 74 72 6c 2d 4e 20 | . Ctrl-N | 00000e30 6f 72 20 44 6f 77 6e 20 20 20 20 20 20 20 20 20 |or Down | 00000e40 20 4d 6f 76 65 20 74 6f 20 74 68 65 20 6e 65 78 | Move to the nex| 00000e50 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 68 |t entry in the h| 00000e60 69 73 74 6f 72 79 20 6c 69 73 74 2e 0a 20 20 20 |istory list.. | 00000e70 20 0a 20 20 20 20 43 74 72 6c 2d 50 20 6f 72 20 | . Ctrl-P or | 00000e80 55 70 20 20 20 20 20 20 20 20 20 20 20 20 4d 6f |Up Mo| 00000e90 76 65 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f |ve to the previo| 00000ea0 75 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 |us entry in the | 00000eb0 68 69 73 74 6f 72 79 20 6c 69 73 74 2e 0a 20 20 |history list.. | 00000ec0 20 20 0a 20 20 20 20 43 74 72 6c 2d 54 20 20 20 | . Ctrl-T | 00000ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 | T| 00000ee0 72 61 6e 73 70 6f 73 65 20 74 77 6f 20 63 68 61 |ranspose two cha| 00000ef0 72 61 63 74 65 72 73 2e 0a 20 20 20 20 0a 20 20 |racters.. . | 00000f00 20 20 43 74 72 6c 2d 55 20 6f 72 20 45 73 63 61 | Ctrl-U or Esca| 00000f10 70 65 20 20 20 20 20 20 20 20 43 6c 65 61 72 20 |pe Clear | 00000f20 74 68 65 20 63 75 72 72 65 6e 74 20 6c 69 6e 65 |the current line| 00000f30 2e 0a 20 20 20 20 0a 20 20 20 20 43 74 72 6c 2d |.. . Ctrl-| 00000f40 4c 65 66 74 20 20 20 20 20 20 20 20 20 20 20 20 |Left | 00000f50 20 20 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 | Move the curs| 00000f60 6f 72 20 6c 65 66 74 20 6f 6e 65 20 77 6f 72 64 |or left one word| 00000f70 2e 0a 20 20 20 20 0a 20 20 20 20 43 74 72 6c 2d |.. . Ctrl-| 00000f80 52 69 67 68 74 20 20 20 20 20 20 20 20 20 20 20 |Right | 00000f90 20 20 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 | Move the curs| 00000fa0 6f 72 20 72 69 67 68 74 20 6f 6e 65 20 77 6f 72 |or right one wor| 00000fb0 64 2e 0a 20 20 20 20 0a 20 20 20 20 49 6e 73 65 |d.. . Inse| 00000fc0 72 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |rt | 00000fd0 20 20 20 20 54 6f 67 67 6c 65 20 69 6e 73 65 72 | Toggle inser| 00000fe0 74 20 6f 72 20 6f 76 65 72 77 72 69 74 65 20 6d |t or overwrite m| 00000ff0 6f 64 65 2e 0a 0a 54 68 65 73 65 20 61 72 65 20 |ode...These are | 00001000 73 69 6d 69 6c 61 72 20 74 6f 20 74 68 65 20 64 |similar to the d| 00001010 65 66 61 75 6c 74 20 61 73 73 69 67 6e 6d 65 6e |efault assignmen| 00001020 74 73 20 75 73 65 64 20 62 79 20 4f 6c 69 76 65 |ts used by Olive| 00001030 72 20 42 65 74 74 73 27 20 52 49 53 43 20 4f 53 |r Betts' RISC OS| 00001040 0a 4c 69 6e 65 45 64 69 74 6f 72 20 6d 6f 64 75 |.LineEditor modu| 00001050 6c 65 2e 0a 0a 0a 56 44 55 20 43 4f 44 45 53 0a |le....VDU CODES.| 00001060 0a 54 68 65 20 6f 75 74 70 75 74 20 66 72 6f 6d |.The output from| 00001070 20 73 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 20 69 | some commands i| 00001080 6e 63 6c 75 64 65 20 52 49 53 43 20 4f 53 20 56 |nclude RISC OS V| 00001090 44 55 20 63 6f 64 65 73 2e 20 57 68 65 6e 20 6f |DU codes. When o| 000010a0 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 0a 4f |utput from the.O| 000010b0 53 43 4c 49 20 63 6f 6d 6d 61 6e 64 20 69 73 20 |SCLI command is | 000010c0 64 69 72 65 63 74 65 64 20 74 6f 20 74 68 65 20 |directed to the | 000010d0 44 4f 53 20 73 63 72 65 65 6e 20 28 61 73 20 69 |DOS screen (as i| 000010e0 73 20 6e 6f 72 6d 61 6c 29 20 61 6e 64 20 74 68 |s normal) and th| 000010f0 65 20 22 2f 52 22 0a 73 77 69 74 63 68 20 69 73 |e "/R".switch is| 00001100 20 6e 6f 74 20 75 73 65 64 20 74 68 65 6e 20 73 | not used then s| 00001110 6f 6d 65 20 6f 66 20 74 68 65 73 65 20 63 6f 64 |ome of these cod| 00001120 65 73 20 61 72 65 20 70 72 6f 63 65 73 73 65 64 |es are processed| 00001130 3a 0a 0a 20 20 20 20 56 44 55 20 36 20 20 20 45 |:.. VDU 6 E| 00001140 6e 61 62 6c 65 20 73 63 72 65 65 6e 20 6f 75 74 |nable screen out| 00001150 70 75 74 2e 20 54 68 69 73 20 63 61 6e 63 65 6c |put. This cancel| 00001160 73 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 20 |s the effect of | 00001170 56 44 55 20 32 31 2e 0a 0a 20 20 20 20 56 44 55 |VDU 21... VDU| 00001180 20 37 20 20 20 52 69 6e 67 20 74 68 65 20 74 65 | 7 Ring the te| 00001190 72 6d 69 6e 61 6c 20 62 65 6c 6c 2c 20 69 2e 65 |rminal bell, i.e| 000011a0 2e 20 70 72 6f 64 75 63 65 20 61 20 62 65 65 70 |. produce a beep| 000011b0 2e 0a 0a 20 20 20 20 56 44 55 20 38 20 20 20 42 |... VDU 8 B| 000011c0 61 63 6b 73 70 61 63 65 20 74 68 65 20 63 75 72 |ackspace the cur| 000011d0 73 6f 72 2e 20 54 68 69 73 20 6d 6f 76 65 73 20 |sor. This moves | 000011e0 74 68 65 20 63 75 72 73 6f 72 20 62 61 63 6b 20 |the cursor back | 000011f0 6f 6e 65 20 63 68 61 72 61 63 74 65 72 0a 20 20 |one character. | 00001200 20 20 20 20 20 20 20 20 20 20 70 6f 73 69 74 69 | positi| 00001210 6f 6e 2e 0a 20 20 20 20 0a 20 20 20 20 56 44 55 |on.. . VDU| 00001220 20 39 20 20 20 48 6f 72 69 7a 6f 6e 74 61 6c 20 | 9 Horizontal | 00001230 74 61 62 2e 20 54 68 69 73 20 61 64 76 61 6e 63 |tab. This advanc| 00001240 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 6f 6e |es the cursor on| 00001250 65 20 63 68 61 72 61 63 74 65 72 20 70 6f 73 69 |e character posi| 00001260 74 69 6f 6e 2e 0a 20 20 20 20 0a 20 20 20 20 56 |tion.. . V| 00001270 44 55 20 31 30 20 20 4c 69 6e 65 66 65 65 64 2e |DU 10 Linefeed.| 00001280 20 54 68 69 73 20 6d 6f 76 65 73 20 74 68 65 20 | This moves the | 00001290 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 73 61 |cursor to the sa| 000012a0 6d 65 20 70 6f 73 69 74 69 6f 6e 20 6f 6e 20 74 |me position on t| 000012b0 68 65 20 6e 65 78 74 0a 20 20 20 20 20 20 20 20 |he next. | 000012c0 20 20 20 20 6c 69 6e 65 2e 0a 20 20 20 20 0a 20 | line.. . | 000012d0 20 20 20 56 44 55 20 31 31 20 20 56 65 72 74 69 | VDU 11 Verti| 000012e0 63 61 6c 20 74 61 62 2e 20 54 68 69 73 20 6d 6f |cal tab. This mo| 000012f0 76 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 74 |ves the cursor t| 00001300 6f 20 74 68 65 20 73 61 6d 65 20 70 6f 73 69 74 |o the same posit| 00001310 69 6f 6e 20 6f 6e 20 74 68 65 0a 20 20 20 20 20 |ion on the. | 00001320 20 20 20 20 20 20 20 70 72 65 76 69 6f 75 73 20 | previous | 00001330 6c 69 6e 65 2e 0a 0a 20 20 20 20 56 44 55 20 31 |line... VDU 1| 00001340 32 20 20 43 6c 65 61 72 20 74 68 65 20 63 75 72 |2 Clear the cur| 00001350 72 65 6e 74 20 73 63 72 65 65 6e 20 6f 72 20 74 |rent screen or t| 00001360 65 78 74 20 77 69 6e 64 6f 77 20 69 66 20 6f 6e |ext window if on| 00001370 65 20 64 65 66 69 6e 65 64 2e 0a 0a 20 20 20 20 |e defined... | 00001380 56 44 55 20 31 33 20 20 43 61 72 72 69 61 67 65 |VDU 13 Carriage| 00001390 20 72 65 74 75 72 6e 2e 20 54 68 69 73 20 6d 6f | return. This mo| 000013a0 76 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 74 |ves the cursor t| 000013b0 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 |o the start of t| 000013c0 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 63 |he. c| 000013d0 75 72 72 65 6e 74 20 6c 69 6e 65 2e 0a 0a 20 20 |urrent line... | 000013e0 20 20 56 44 55 20 31 37 20 20 53 65 74 20 65 69 | VDU 17 Set ei| 000013f0 74 68 65 72 20 74 68 65 20 66 6f 72 65 67 72 6f |ther the foregro| 00001400 75 6e 64 20 6f 72 20 62 61 63 6b 67 72 6f 75 6e |und or backgroun| 00001410 64 20 74 68 65 20 74 65 78 74 20 63 6f 6c 6f 75 |d the text colou| 00001420 72 2e 20 54 68 69 73 0a 20 20 20 20 20 20 20 20 |r. This. | 00001430 20 20 20 20 61 74 74 65 6d 70 74 73 20 74 6f 20 | attempts to | 00001440 63 68 6f 6f 73 65 20 74 68 65 20 63 6c 6f 73 65 |choose the close| 00001450 73 74 20 44 4f 53 20 74 65 78 74 20 73 63 72 65 |st DOS text scre| 00001460 65 6e 20 63 6f 6c 6f 75 72 20 74 6f 20 74 68 65 |en colour to the| 00001470 20 6f 6e 65 0a 20 20 20 20 20 20 20 20 20 20 20 | one. | 00001480 20 73 70 65 63 69 66 69 65 64 2e 20 54 68 65 20 | specified. The | 00001490 64 65 66 61 75 6c 74 20 52 49 53 43 20 4f 53 20 |default RISC OS | 000014a0 70 61 6c 65 74 74 65 20 69 73 20 61 73 73 75 6d |palette is assum| 000014b0 65 64 2e 0a 0a 20 20 20 20 56 44 55 20 32 30 20 |ed... VDU 20 | 000014c0 20 52 65 73 74 6f 72 65 20 74 68 65 20 64 65 66 | Restore the def| 000014d0 61 75 6c 74 20 63 6f 6c 6f 75 72 73 2e 20 54 68 |ault colours. Th| 000014e0 69 73 20 73 65 6c 65 63 74 73 20 77 68 69 74 65 |is selects white| 000014f0 20 74 65 78 74 20 6f 6e 20 61 20 62 6c 61 63 6b | text on a black| 00001500 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 61 63 |. bac| 00001510 6b 67 72 6f 75 6e 64 2e 0a 0a 20 20 20 20 56 44 |kground... VD| 00001520 55 20 32 31 20 20 44 69 73 61 62 6c 65 20 74 68 |U 21 Disable th| 00001530 65 20 73 63 72 65 65 6e 20 64 69 73 70 6c 61 79 |e screen display| 00001540 2e 20 41 6c 6c 20 6f 75 74 70 75 74 20 69 73 20 |. All output is | 00001550 73 6b 69 70 70 65 64 20 75 6e 74 69 6c 20 61 20 |skipped until a | 00001560 56 44 55 20 36 0a 20 20 20 20 20 20 20 20 20 20 |VDU 6. | 00001570 20 20 63 6f 64 65 20 69 73 20 72 65 61 63 68 65 | code is reache| 00001580 64 2e 0a 0a 20 20 20 20 56 44 55 20 32 32 20 20 |d... VDU 22 | 00001590 43 68 61 6e 67 65 20 74 68 65 20 64 69 73 70 6c |Change the displ| 000015a0 61 79 20 6d 6f 64 65 2e 20 54 68 69 73 20 63 6c |ay mode. This cl| 000015b0 65 61 72 73 20 74 68 65 20 73 63 72 65 65 6e 2c |ears the screen,| 000015c0 20 63 6c 65 61 72 73 20 61 6e 79 20 74 65 78 74 | clears any text| 000015d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 77 69 6e |. win| 000015e0 64 6f 77 20 61 6e 64 20 72 65 73 74 6f 72 65 73 |dow and restores| 000015f0 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c | the default col| 00001600 6f 75 72 73 2e 20 41 6e 20 61 74 74 65 6d 70 74 |ours. An attempt| 00001610 20 69 73 20 6d 61 64 65 20 74 6f 0a 20 20 20 20 | is made to. | 00001620 20 20 20 20 20 20 20 20 75 73 65 20 74 68 65 20 | use the | 00001630 63 6c 6f 73 65 73 74 20 44 4f 53 20 74 65 78 74 |closest DOS text| 00001640 20 6d 6f 64 65 20 74 6f 20 74 68 65 20 72 65 71 | mode to the req| 00001650 75 65 73 74 65 64 20 52 49 53 43 20 4f 53 20 6d |uested RISC OS m| 00001660 6f 64 65 2e 20 54 68 69 73 0a 20 20 20 20 20 20 |ode. This. | 00001670 20 20 20 20 20 20 61 6c 73 6f 20 61 66 66 65 63 | also affec| 00001680 74 73 20 74 68 65 20 6d 61 70 70 69 6e 67 20 6f |ts the mapping o| 00001690 66 20 74 65 78 74 20 63 6f 6c 6f 75 72 73 20 66 |f text colours f| 000016a0 6f 72 20 56 44 55 20 31 37 2e 0a 0a 20 20 20 20 |or VDU 17... | 000016b0 56 44 55 20 32 33 20 20 54 68 69 73 20 65 6e 63 |VDU 23 This enc| 000016c0 6f 6d 70 61 73 73 65 73 20 61 20 77 69 64 65 20 |ompasses a wide | 000016d0 73 65 6c 65 63 74 69 6f 6e 20 6f 66 20 70 6f 73 |selection of pos| 000016e0 73 69 62 6c 65 20 6f 70 65 72 61 74 69 6f 6e 73 |sible operations| 000016f0 2e 20 4f 6e 6c 79 0a 20 20 20 20 20 20 20 20 20 |. Only. | 00001700 20 20 20 73 6f 6d 65 20 6f 66 20 74 68 65 73 65 | some of these| 00001710 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 3a 0a | are supported:.| 00001720 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 | . | 00001730 20 20 20 20 20 20 20 20 20 20 20 20 20 56 44 55 | VDU| 00001740 20 32 33 2c 20 30 20 20 20 43 6f 6e 74 72 6f 6c | 23, 0 Control| 00001750 20 74 68 65 20 74 65 78 74 20 63 75 72 73 6f 72 | the text cursor| 00001760 20 61 70 70 65 61 72 61 6e 63 65 2e 20 54 68 69 | appearance. Thi| 00001770 73 20 61 6c 6c 6f 77 73 0a 20 20 20 20 20 20 20 |s allows. | 00001780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001790 20 20 20 20 20 74 68 65 20 63 75 72 73 6f 72 20 | the cursor | 000017a0 74 6f 20 62 65 20 73 77 69 74 63 68 65 64 20 6f |to be switched o| 000017b0 66 66 20 6f 72 20 63 68 61 6e 67 65 64 20 69 6e |ff or changed in| 000017c0 74 6f 20 61 0a 20 20 20 20 20 20 20 20 20 20 20 |to a. | 000017d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000017e0 20 73 6f 6c 69 64 20 62 6c 6f 63 6b 2e 0a 20 20 | solid block.. | 000017f0 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 | . | 00001800 20 20 20 20 20 20 20 20 20 20 20 56 44 55 20 32 | VDU 2| 00001810 33 2c 20 31 20 20 20 43 6f 6e 74 72 6f 6c 20 74 |3, 1 Control t| 00001820 68 65 20 61 70 70 65 61 72 61 6e 63 65 20 6f 66 |he appearance of| 00001830 20 74 68 65 20 74 65 78 74 20 63 75 72 73 6f 72 | the text cursor| 00001840 2e 20 54 68 69 73 0a 20 20 20 20 20 20 20 20 20 |. This. | 00001850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001860 20 20 20 61 6c 6c 6f 77 73 20 74 68 65 20 63 75 | allows the cu| 00001870 72 73 6f 72 20 74 6f 20 62 65 20 73 77 69 74 63 |rsor to be switc| 00001880 68 65 64 20 6f 66 66 20 6f 72 20 63 68 61 6e 67 |hed off or chang| 00001890 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |ed. | 000018a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 | i| 000018b0 6e 74 6f 20 61 20 73 6f 6c 69 64 20 62 6c 6f 63 |nto a solid bloc| 000018c0 6b 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |k.. | 000018d0 20 20 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 | . | 000018e0 20 20 20 20 56 44 55 20 32 33 2c 20 37 20 20 20 | VDU 23, 7 | 000018f0 53 63 72 6f 6c 6c 20 65 69 74 68 65 72 20 74 68 |Scroll either th| 00001900 65 20 63 75 72 72 65 6e 74 20 74 65 78 74 20 77 |e current text w| 00001910 69 6e 64 6f 77 20 6f 72 20 74 68 65 0a 20 20 20 |indow or the. | 00001920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001930 20 20 20 20 20 20 20 20 20 77 68 6f 6c 65 20 73 | whole s| 00001940 63 72 65 65 6e 2e 0a 20 20 20 20 20 20 20 20 20 |creen.. | 00001950 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 00001960 20 20 20 20 20 20 20 20 56 44 55 20 32 33 2c 20 | VDU 23, | 00001970 31 36 20 20 43 6f 6e 74 72 6f 6c 20 74 68 65 20 |16 Control the | 00001980 6d 6f 76 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 |movement of the | 00001990 63 75 72 73 6f 72 20 61 66 74 65 72 0a 20 20 20 |cursor after. | 000019a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000019b0 20 20 20 20 20 20 20 20 20 70 72 69 6e 74 69 6e | printin| 000019c0 67 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 74 |g. This allows t| 000019d0 68 65 20 69 6e 74 65 72 70 72 65 74 61 74 69 6f |he interpretatio| 000019e0 6e 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 20 |n of. | 000019f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001a00 20 68 6f 72 69 7a 6f 6e 74 61 6c 20 61 6e 64 20 | horizontal and | 00001a10 76 65 72 74 69 63 61 6c 20 6d 6f 76 65 6d 65 6e |vertical movemen| 00001a20 74 73 20 74 6f 20 62 65 20 63 68 61 6e 67 65 64 |ts to be changed| 00001a30 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |.. | 00001a40 20 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | . | 00001a50 20 20 20 56 44 55 20 32 33 2c 20 31 37 20 20 45 | VDU 23, 17 E| 00001a60 78 63 68 61 6e 67 65 20 74 68 65 20 74 65 78 74 |xchange the text| 00001a70 20 66 6f 72 65 67 72 6f 75 6e 64 20 61 6e 64 20 | foreground and | 00001a80 62 61 63 6b 67 72 6f 75 6e 64 0a 20 20 20 20 20 |background. | 00001a90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001aa0 20 20 20 20 20 20 20 63 6f 6c 6f 75 72 73 2e 0a | colours..| 00001ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001ac0 0a 20 20 20 20 56 44 55 20 32 36 20 20 52 65 73 |. VDU 26 Res| 00001ad0 74 6f 72 65 20 74 68 65 20 64 65 66 61 75 6c 74 |tore the default| 00001ae0 20 77 69 6e 64 6f 77 73 2e 20 54 68 69 73 20 73 | windows. This s| 00001af0 65 74 73 20 74 68 65 20 74 65 78 74 20 77 69 6e |ets the text win| 00001b00 64 6f 77 20 74 6f 20 66 69 6c 6c 0a 20 20 20 20 |dow to fill. | 00001b10 20 20 20 20 20 20 20 20 74 68 65 20 73 63 72 65 | the scre| 00001b20 65 6e 20 61 6e 64 20 70 6c 61 63 65 73 20 74 68 |en and places th| 00001b30 65 20 63 75 72 73 6f 72 20 69 6e 20 74 68 65 20 |e cursor in the | 00001b40 68 6f 6d 65 20 70 6f 73 69 74 69 6f 6e 2e 0a 0a |home position...| 00001b50 20 20 20 20 56 44 55 20 32 38 20 20 44 65 66 69 | VDU 28 Defi| 00001b60 6e 65 20 61 20 74 65 78 74 20 77 69 6e 64 6f 77 |ne a text window| 00001b70 2e 20 49 66 20 74 68 65 20 63 6f 6f 72 64 69 6e |. If the coordin| 00001b80 61 74 65 73 20 61 72 65 20 69 6e 20 74 68 65 20 |ates are in the | 00001b90 77 72 6f 6e 67 20 6f 72 64 65 72 0a 20 20 20 20 |wrong order. | 00001ba0 20 20 20 20 20 20 20 20 6f 72 20 6c 69 65 20 6f | or lie o| 00001bb0 75 74 73 69 64 65 20 74 68 65 20 64 69 6d 65 6e |utside the dimen| 00001bc0 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 73 63 72 |sions of the scr| 00001bd0 65 65 6e 20 74 68 65 6e 20 74 68 69 73 20 68 61 |een then this ha| 00001be0 73 20 6e 6f 0a 20 20 20 20 20 20 20 20 20 20 20 |s no. | 00001bf0 20 65 66 66 65 63 74 2e 0a 0a 20 20 20 20 56 44 | effect... VD| 00001c00 55 20 33 30 20 20 4d 6f 76 65 20 74 68 65 20 63 |U 30 Move the c| 00001c10 75 72 73 6f 72 20 74 6f 20 74 68 65 20 68 6f 6d |ursor to the hom| 00001c20 65 20 70 6f 73 69 74 69 6f 6e 2e 20 54 68 69 73 |e position. This| 00001c30 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 74 68 65 | is normally the| 00001c40 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 70 |. top| 00001c50 2d 6c 65 66 74 20 63 6f 72 6e 65 72 20 6f 66 20 |-left corner of | 00001c60 74 68 65 20 63 75 72 72 65 6e 74 20 74 65 78 74 |the current text| 00001c70 20 77 69 6e 64 6f 77 2c 20 62 75 74 20 74 68 69 | window, but thi| 00001c80 73 20 6d 61 79 20 62 65 0a 20 20 20 20 20 20 20 |s may be. | 00001c90 20 20 20 20 20 63 68 61 6e 67 65 64 20 62 79 20 | changed by | 00001ca0 56 44 55 20 32 33 2c 20 31 36 2e 0a 0a 20 20 20 |VDU 23, 16... | 00001cb0 20 56 44 55 20 33 31 20 20 4d 6f 76 65 20 74 68 | VDU 31 Move th| 00001cc0 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 |e cursor to the | 00001cd0 73 70 65 63 69 66 69 65 64 20 63 6f 6f 72 64 69 |specified coordi| 00001ce0 6e 61 74 65 73 2e 20 49 66 20 74 68 65 20 70 6f |nates. If the po| 00001cf0 73 69 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 |sition. | 00001d00 20 20 20 6c 69 65 73 20 6f 75 74 73 69 64 65 20 | lies outside | 00001d10 74 68 65 20 63 75 72 72 65 6e 74 20 74 65 78 74 |the current text| 00001d20 20 77 69 6e 64 6f 77 20 74 68 65 6e 20 74 68 69 | window then thi| 00001d30 73 20 69 73 20 69 67 6e 6f 72 65 64 2e 0a 0a 4e |s is ignored...N| 00001d40 6f 74 65 20 74 68 61 74 20 73 6f 6d 65 20 6f 66 |ote that some of| 00001d50 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 6f 6e | these operation| 00001d60 73 20 6d 61 79 20 6e 6f 74 20 77 6f 72 6b 20 71 |s may not work q| 00001d70 75 69 74 65 20 61 73 20 65 78 70 65 63 74 65 64 |uite as expected| 00001d80 2c 20 6e 6f 72 6d 61 6c 6c 79 0a 62 65 63 61 75 |, normally.becau| 00001d90 73 65 20 74 68 65 20 44 4f 53 20 73 63 72 65 65 |se the DOS scree| 00001da0 6e 20 64 6f 65 73 20 6e 6f 74 20 65 78 61 63 74 |n does not exact| 00001db0 6c 79 20 6d 61 74 63 68 20 74 68 65 20 65 78 70 |ly match the exp| 00001dc0 65 63 74 65 64 20 52 49 53 43 20 4f 53 20 6d 6f |ected RISC OS mo| 00001dd0 64 65 2c 20 61 6e 64 0a 6e 6f 20 67 72 61 70 68 |de, and.no graph| 00001de0 69 63 73 20 6f 70 65 72 61 74 69 6f 6e 73 20 61 |ics operations a| 00001df0 72 65 20 73 75 70 70 6f 72 74 65 64 2e 20 54 68 |re supported. Th| 00001e00 65 72 65 20 61 72 65 20 61 6c 73 6f 20 73 6f 6d |ere are also som| 00001e10 65 20 6f 74 68 65 72 20 56 44 55 20 73 65 71 75 |e other VDU sequ| 00001e20 65 6e 63 65 73 0a 74 68 61 74 20 68 61 76 65 20 |ences.that have | 00001e30 6e 6f 74 20 62 65 65 6e 20 73 75 70 70 6f 72 74 |not been support| 00001e40 65 64 20 62 65 63 61 75 73 65 20 74 68 65 79 20 |ed because they | 00001e50 61 72 65 20 72 61 72 65 6c 79 20 75 73 65 64 2e |are rarely used.| 00001e60 0a 0a 0a 54 48 49 4e 47 53 20 54 4f 20 44 4f 0a |...THINGS TO DO.| 00001e70 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 |.The following a| 00001e80 72 65 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 |re changes that | 00001e90 6d 61 79 20 62 65 20 6d 61 64 65 20 74 6f 20 74 |may be made to t| 00001ea0 68 65 20 4f 53 43 4c 49 20 63 6f 6d 6d 61 6e 64 |he OSCLI command| 00001eb0 20 73 6f 6d 65 74 69 6d 65 20 69 6e 0a 74 68 65 | sometime in.the| 00001ec0 20 66 75 74 75 72 65 2e 0a 0a 20 20 20 20 4e 6f | future... No| 00001ed0 6e 65 20 61 74 20 74 68 65 20 6d 6f 6d 65 6e 74 |ne at the moment| 00001ee0 21 0a 0a 0a 56 45 52 53 49 4f 4e 20 48 49 53 54 |!...VERSION HIST| 00001ef0 4f 52 59 0a 0a 30 2e 30 30 20 28 31 32 2d 4e 6f |ORY..0.00 (12-No| 00001f00 76 2d 39 35 29 20 20 20 20 4f 72 69 67 69 6e 61 |v-95) Origina| 00001f10 6c 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 76 65 |l development ve| 00001f20 72 73 69 6f 6e 2e 0a 0a 30 2e 30 31 20 28 31 34 |rsion...0.01 (14| 00001f30 2d 4e 6f 76 2d 39 35 29 20 20 20 20 41 64 64 65 |-Nov-95) Adde| 00001f40 64 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 |d version number| 00001f50 20 61 6e 64 20 63 6f 70 79 72 69 67 68 74 20 6d | and copyright m| 00001f60 65 73 73 61 67 65 2e 0a 20 20 20 20 20 20 20 20 |essage.. | 00001f70 20 20 20 20 20 20 20 20 20 20 20 20 4f 75 74 70 | Outp| 00001f80 75 74 20 69 73 20 70 61 73 73 65 64 20 74 68 72 |ut is passed thr| 00001f90 6f 75 67 68 20 74 68 65 20 73 74 61 6e 64 61 72 |ough the standar| 00001fa0 64 20 6f 75 74 70 75 74 20 6f 66 20 74 68 65 20 |d output of the | 00001fb0 44 4f 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 |DOS. | 00001fc0 20 20 20 20 20 20 20 20 63 6f 6d 6d 61 6e 64 2e | command.| 00001fd0 0a 0a 30 2e 30 32 20 28 31 37 2d 4e 6f 76 2d 39 |..0.02 (17-Nov-9| 00001fe0 35 29 20 20 20 20 55 73 65 73 20 63 6f 72 72 65 |5) Uses corre| 00001ff0 63 74 20 48 50 43 20 73 65 72 76 69 63 65 20 69 |ct HPC service i| 00002000 64 65 6e 74 69 66 69 65 72 2e 0a 20 20 20 20 20 |dentifier.. | 00002010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 43 | C| 00002020 68 61 6e 67 65 64 20 74 6f 20 61 20 2e 43 4f 4d |hanged to a .COM| 00002030 20 66 69 6c 65 20 74 6f 20 6d 61 6b 65 20 69 74 | file to make it| 00002040 20 73 6d 61 6c 6c 65 72 2e 0a 20 20 20 20 20 20 | smaller.. | 00002050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 | Ma| 00002060 64 65 20 72 65 64 69 72 65 63 74 69 6f 6e 20 6f |de redirection o| 00002070 66 20 6f 75 74 70 75 74 20 6f 70 74 69 6f 6e 61 |f output optiona| 00002080 6c 20 61 6e 64 20 61 64 64 65 64 20 68 65 6c 70 |l and added help| 00002090 20 74 65 78 74 2e 0a 0a 30 2e 30 34 20 28 31 36 | text...0.04 (16| 000020a0 2d 44 65 63 2d 39 35 29 20 20 20 20 55 73 65 73 |-Dec-95) Uses| 000020b0 20 72 65 61 6c 20 48 50 43 2e 0a 0a 31 2e 30 30 | real HPC...1.00| 000020c0 20 28 31 32 2d 4a 61 6e 2d 39 36 29 20 20 20 20 | (12-Jan-96) | 000020d0 46 69 72 73 74 20 6f 66 66 69 63 69 61 6c 20 72 |First official r| 000020e0 65 6c 65 61 73 65 20 76 65 72 73 69 6f 6e 2e 0a |elease version..| 000020f0 0a 31 2e 30 31 20 28 31 31 2d 4d 61 72 2d 39 36 |.1.01 (11-Mar-96| 00002100 29 20 20 20 20 56 65 72 73 69 6f 6e 20 6e 75 6d |) Version num| 00002110 62 65 72 20 75 70 64 61 74 65 64 20 74 6f 20 6d |ber updated to m| 00002120 61 74 63 68 20 74 68 65 20 6d 6f 64 75 6c 65 2e |atch the module.| 00002130 0a 0a 31 2e 30 32 20 28 30 36 2d 41 75 67 2d 39 |..1.02 (06-Aug-9| 00002140 36 29 20 20 20 20 41 64 64 65 64 20 73 75 70 70 |6) Added supp| 00002150 6f 72 74 20 66 6f 72 20 41 63 6f 72 6e 27 73 20 |ort for Acorn's | 00002160 73 6f 66 74 77 61 72 65 20 50 43 20 65 6d 75 6c |software PC emul| 00002170 61 74 6f 72 2e 0a 20 20 20 20 20 20 20 20 20 20 |ator.. | 00002180 20 20 20 20 20 20 20 20 20 20 49 6e 63 6c 75 64 | Includ| 00002190 65 64 20 72 65 64 69 72 65 63 74 69 6f 6e 20 6f |ed redirection o| 000021a0 66 20 69 6e 70 75 74 20 73 74 72 65 61 6d 20 74 |f input stream t| 000021b0 68 72 6f 75 67 68 20 44 4f 53 2e 0a 0a 31 2e 30 |hrough DOS...1.0| 000021c0 33 20 28 32 31 2d 46 65 62 2d 39 37 29 20 20 20 |3 (21-Feb-97) | 000021d0 20 55 6e 69 71 75 65 20 74 65 6d 70 6f 72 61 72 | Unique temporar| 000021e0 79 20 66 69 6c 65 6e 61 6d 65 73 20 75 73 65 64 |y filenames used| 000021f0 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |.. | 00002200 20 20 20 20 20 20 4f 70 65 72 61 74 69 6f 6e 20 | Operation | 00002210 75 6e 64 65 72 20 57 69 6e 64 6f 77 20 6e 6f 77 |under Window now| 00002220 20 6d 6f 72 65 20 72 65 6c 69 61 62 6c 65 2e 0a | more reliable..| 00002230 0a 31 2e 30 34 20 28 30 37 2d 44 65 63 2d 39 37 |.1.04 (07-Dec-97| 00002240 29 20 20 20 20 53 70 61 63 65 73 20 6e 6f 20 6c |) Spaces no l| 00002250 6f 6e 67 65 72 20 61 64 64 65 64 20 74 6f 20 65 |onger added to e| 00002260 6e 64 20 6f 66 20 63 6f 6d 6d 61 6e 64 2e 0a 20 |nd of command.. | 00002270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00002280 20 20 20 53 68 65 6c 6c 20 6d 6f 64 65 20 61 64 | Shell mode ad| 00002290 64 65 64 20 77 69 74 68 20 63 6f 6d 6d 61 6e 64 |ded with command| 000022a0 20 6c 69 6e 65 20 65 64 69 74 69 6e 67 20 61 6e | line editing an| 000022b0 64 20 68 69 73 74 6f 72 79 2e 0a 20 20 20 20 20 |d history.. | 000022c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 | V| 000022d0 44 55 20 63 6f 64 65 73 20 69 6e 20 6f 75 74 70 |DU codes in outp| 000022e0 75 74 20 70 72 6f 63 65 73 73 65 64 20 62 65 66 |ut processed bef| 000022f0 6f 72 65 20 62 65 69 6e 67 20 64 69 73 70 6c 61 |ore being displa| 00002300 79 65 64 2e 0a 20 20 20 20 20 20 20 20 20 20 20 |yed.. | 00002310 20 20 20 20 20 20 20 20 20 43 6f 6d 6d 61 6e 64 | Command| 00002320 73 20 6d 61 79 20 62 65 20 65 78 65 63 75 74 65 |s may be execute| 00002330 64 20 69 6e 20 61 20 52 49 53 43 20 4f 53 20 54 |d in a RISC OS T| 00002340 61 73 6b 57 69 6e 64 6f 77 2e |askWindow.| 0000234a
.