Home » Archimedes archive » Archimedes World » AW-1992-08.adf » AWaug92 » !AWaug92/Goodies/CLI/!Help

!AWaug92/Goodies/CLI/!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 » Archimedes World » AW-1992-08.adf » AWaug92
Filename: !AWaug92/Goodies/CLI/!Help
Read OK:
File size: 0A77 bytes
Load address: 0000
Exec address: 0000
Duplicates

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

File contents
                           !WimpCLI   by Mark Mahieu
                              version 1.01  (28-05-92)

  !WimpCLI is a multitasking alternative to the current method of accessing the command line from the desktop.  Rather than suspending the desktop and scrolling the screen up a line just to enter a command, !WimpCLI provides a window for entering *commands.  

  !WimpCLI also includes a screen saver utility with a user definable time limit (use the icon bar menu to change it).  After this period of time has elapsed, the screen will be blanked to prevent monitor burn-in.  A feature of this particular screen saver is that it shows a moving display - which stops people from switching the computer off in the assumption that it is not being used - while avoiding burn-in at the same time.  Three displays are included, a fireworks display, a water fountain and 'walker'.

  On the icon bar menu is an option called 'F12 replace'.  When this is ticked, !WimpCLI will intercept F12 keypresses and bring up its *command window instead of the usual F12 method of operation.  This window contains two writable icons, one for the command and one for its suffix.  There is also a Help icon for gaining help on a command.  To execute the command, press Return.  You can execute a command on files simply by dragging them into the window.

  If you call up the main menu from the *command window you will find that it contains several commonly used *commands.  Choosing any of the entries from the main menu will enter it in the first writable icon in the *command window.  Submenu entries are entered in the suffix icon.  The menu structure itself is user-definable and is found in the file '!WimpCLI.menus'.  Here is an example layout:          

{settype,basic,sprite,text,obey,data,module,BBC font,palette,template}
{access,lwr~}
{adfs}
{ram}
{stamp}
{compact^}
{volume,64~}
{speaker,on,off}
{audio^,on,off}
{time}
{basic}
{modules}


Each line follows a simple format.  They are surrounded by { and } to mark the beginning and end of the data.  Each item is separated from the last by a comma.  The first item appears on the main menu and any items after it appear on its submenu.  If a main menu item is followed by a ^ then there will be a break in the menu after that item.  This is useful for separating different types of commands.  If a submenu item is followed by a ~ then it is writeable.

Other features are also user-definable.  Options such as the time before the screen saver is invoked, which screen saver to use, whether or not to intercept F12 key-presses or not etc. are all on the icon bar menu, which also allows you to save your choices as the default.
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000010  20 20 20 20 20 20 20 20  20 20 20 21 57 69 6d 70  |           !Wimp|
00000020  43 4c 49 20 20 20 62 79  20 4d 61 72 6b 20 4d 61  |CLI   by Mark Ma|
00000030  68 69 65 75 0a 20 20 20  20 20 20 20 20 20 20 20  |hieu.           |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000050  20 20 20 76 65 72 73 69  6f 6e 20 31 2e 30 31 20  |   version 1.01 |
00000060  20 28 32 38 2d 30 35 2d  39 32 29 0a 0a 20 20 21  | (28-05-92)..  !|
00000070  57 69 6d 70 43 4c 49 20  69 73 20 61 20 6d 75 6c  |WimpCLI is a mul|
00000080  74 69 74 61 73 6b 69 6e  67 20 61 6c 74 65 72 6e  |titasking altern|
00000090  61 74 69 76 65 20 74 6f  20 74 68 65 20 63 75 72  |ative to the cur|
000000a0  72 65 6e 74 20 6d 65 74  68 6f 64 20 6f 66 20 61  |rent method of a|
000000b0  63 63 65 73 73 69 6e 67  20 74 68 65 20 63 6f 6d  |ccessing the com|
000000c0  6d 61 6e 64 20 6c 69 6e  65 20 66 72 6f 6d 20 74  |mand line from t|
000000d0  68 65 20 64 65 73 6b 74  6f 70 2e 20 20 52 61 74  |he desktop.  Rat|
000000e0  68 65 72 20 74 68 61 6e  20 73 75 73 70 65 6e 64  |her than suspend|
000000f0  69 6e 67 20 74 68 65 20  64 65 73 6b 74 6f 70 20  |ing the desktop |
00000100  61 6e 64 20 73 63 72 6f  6c 6c 69 6e 67 20 74 68  |and scrolling th|
00000110  65 20 73 63 72 65 65 6e  20 75 70 20 61 20 6c 69  |e screen up a li|
00000120  6e 65 20 6a 75 73 74 20  74 6f 20 65 6e 74 65 72  |ne just to enter|
00000130  20 61 20 63 6f 6d 6d 61  6e 64 2c 20 21 57 69 6d  | a command, !Wim|
00000140  70 43 4c 49 20 70 72 6f  76 69 64 65 73 20 61 20  |pCLI provides a |
00000150  77 69 6e 64 6f 77 20 66  6f 72 20 65 6e 74 65 72  |window for enter|
00000160  69 6e 67 20 2a 63 6f 6d  6d 61 6e 64 73 2e 20 20  |ing *commands.  |
00000170  0a 0a 20 20 21 57 69 6d  70 43 4c 49 20 61 6c 73  |..  !WimpCLI als|
00000180  6f 20 69 6e 63 6c 75 64  65 73 20 61 20 73 63 72  |o includes a scr|
00000190  65 65 6e 20 73 61 76 65  72 20 75 74 69 6c 69 74  |een saver utilit|
000001a0  79 20 77 69 74 68 20 61  20 75 73 65 72 20 64 65  |y with a user de|
000001b0  66 69 6e 61 62 6c 65 20  74 69 6d 65 20 6c 69 6d  |finable time lim|
000001c0  69 74 20 28 75 73 65 20  74 68 65 20 69 63 6f 6e  |it (use the icon|
000001d0  20 62 61 72 20 6d 65 6e  75 20 74 6f 20 63 68 61  | bar menu to cha|
000001e0  6e 67 65 20 69 74 29 2e  20 20 41 66 74 65 72 20  |nge it).  After |
000001f0  74 68 69 73 20 70 65 72  69 6f 64 20 6f 66 20 74  |this period of t|
00000200  69 6d 65 20 68 61 73 20  65 6c 61 70 73 65 64 2c  |ime has elapsed,|
00000210  20 74 68 65 20 73 63 72  65 65 6e 20 77 69 6c 6c  | the screen will|
00000220  20 62 65 20 62 6c 61 6e  6b 65 64 20 74 6f 20 70  | be blanked to p|
00000230  72 65 76 65 6e 74 20 6d  6f 6e 69 74 6f 72 20 62  |revent monitor b|
00000240  75 72 6e 2d 69 6e 2e 20  20 41 20 66 65 61 74 75  |urn-in.  A featu|
00000250  72 65 20 6f 66 20 74 68  69 73 20 70 61 72 74 69  |re of this parti|
00000260  63 75 6c 61 72 20 73 63  72 65 65 6e 20 73 61 76  |cular screen sav|
00000270  65 72 20 69 73 20 74 68  61 74 20 69 74 20 73 68  |er is that it sh|
00000280  6f 77 73 20 61 20 6d 6f  76 69 6e 67 20 64 69 73  |ows a moving dis|
00000290  70 6c 61 79 20 2d 20 77  68 69 63 68 20 73 74 6f  |play - which sto|
000002a0  70 73 20 70 65 6f 70 6c  65 20 66 72 6f 6d 20 73  |ps people from s|
000002b0  77 69 74 63 68 69 6e 67  20 74 68 65 20 63 6f 6d  |witching the com|
000002c0  70 75 74 65 72 20 6f 66  66 20 69 6e 20 74 68 65  |puter off in the|
000002d0  20 61 73 73 75 6d 70 74  69 6f 6e 20 74 68 61 74  | assumption that|
000002e0  20 69 74 20 69 73 20 6e  6f 74 20 62 65 69 6e 67  | it is not being|
000002f0  20 75 73 65 64 20 2d 20  77 68 69 6c 65 20 61 76  | used - while av|
00000300  6f 69 64 69 6e 67 20 62  75 72 6e 2d 69 6e 20 61  |oiding burn-in a|
00000310  74 20 74 68 65 20 73 61  6d 65 20 74 69 6d 65 2e  |t the same time.|
00000320  20 20 54 68 72 65 65 20  64 69 73 70 6c 61 79 73  |  Three displays|
00000330  20 61 72 65 20 69 6e 63  6c 75 64 65 64 2c 20 61  | are included, a|
00000340  20 66 69 72 65 77 6f 72  6b 73 20 64 69 73 70 6c  | fireworks displ|
00000350  61 79 2c 20 61 20 77 61  74 65 72 20 66 6f 75 6e  |ay, a water foun|
00000360  74 61 69 6e 20 61 6e 64  20 27 77 61 6c 6b 65 72  |tain and 'walker|
00000370  27 2e 0a 0a 20 20 4f 6e  20 74 68 65 20 69 63 6f  |'...  On the ico|
00000380  6e 20 62 61 72 20 6d 65  6e 75 20 69 73 20 61 6e  |n bar menu is an|
00000390  20 6f 70 74 69 6f 6e 20  63 61 6c 6c 65 64 20 27  | option called '|
000003a0  46 31 32 20 72 65 70 6c  61 63 65 27 2e 20 20 57  |F12 replace'.  W|
000003b0  68 65 6e 20 74 68 69 73  20 69 73 20 74 69 63 6b  |hen this is tick|
000003c0  65 64 2c 20 21 57 69 6d  70 43 4c 49 20 77 69 6c  |ed, !WimpCLI wil|
000003d0  6c 20 69 6e 74 65 72 63  65 70 74 20 46 31 32 20  |l intercept F12 |
000003e0  6b 65 79 70 72 65 73 73  65 73 20 61 6e 64 20 62  |keypresses and b|
000003f0  72 69 6e 67 20 75 70 20  69 74 73 20 2a 63 6f 6d  |ring up its *com|
00000400  6d 61 6e 64 20 77 69 6e  64 6f 77 20 69 6e 73 74  |mand window inst|
00000410  65 61 64 20 6f 66 20 74  68 65 20 75 73 75 61 6c  |ead of the usual|
00000420  20 46 31 32 20 6d 65 74  68 6f 64 20 6f 66 20 6f  | F12 method of o|
00000430  70 65 72 61 74 69 6f 6e  2e 20 20 54 68 69 73 20  |peration.  This |
00000440  77 69 6e 64 6f 77 20 63  6f 6e 74 61 69 6e 73 20  |window contains |
00000450  74 77 6f 20 77 72 69 74  61 62 6c 65 20 69 63 6f  |two writable ico|
00000460  6e 73 2c 20 6f 6e 65 20  66 6f 72 20 74 68 65 20  |ns, one for the |
00000470  63 6f 6d 6d 61 6e 64 20  61 6e 64 20 6f 6e 65 20  |command and one |
00000480  66 6f 72 20 69 74 73 20  73 75 66 66 69 78 2e 20  |for its suffix. |
00000490  20 54 68 65 72 65 20 69  73 20 61 6c 73 6f 20 61  | There is also a|
000004a0  20 48 65 6c 70 20 69 63  6f 6e 20 66 6f 72 20 67  | Help icon for g|
000004b0  61 69 6e 69 6e 67 20 68  65 6c 70 20 6f 6e 20 61  |aining help on a|
000004c0  20 63 6f 6d 6d 61 6e 64  2e 20 20 54 6f 20 65 78  | command.  To ex|
000004d0  65 63 75 74 65 20 74 68  65 20 63 6f 6d 6d 61 6e  |ecute the comman|
000004e0  64 2c 20 70 72 65 73 73  20 52 65 74 75 72 6e 2e  |d, press Return.|
000004f0  20 20 59 6f 75 20 63 61  6e 20 65 78 65 63 75 74  |  You can execut|
00000500  65 20 61 20 63 6f 6d 6d  61 6e 64 20 6f 6e 20 66  |e a command on f|
00000510  69 6c 65 73 20 73 69 6d  70 6c 79 20 62 79 20 64  |iles simply by d|
00000520  72 61 67 67 69 6e 67 20  74 68 65 6d 20 69 6e 74  |ragging them int|
00000530  6f 20 74 68 65 20 77 69  6e 64 6f 77 2e 0a 0a 20  |o the window... |
00000540  20 49 66 20 79 6f 75 20  63 61 6c 6c 20 75 70 20  | If you call up |
00000550  74 68 65 20 6d 61 69 6e  20 6d 65 6e 75 20 66 72  |the main menu fr|
00000560  6f 6d 20 74 68 65 20 2a  63 6f 6d 6d 61 6e 64 20  |om the *command |
00000570  77 69 6e 64 6f 77 20 79  6f 75 20 77 69 6c 6c 20  |window you will |
00000580  66 69 6e 64 20 74 68 61  74 20 69 74 20 63 6f 6e  |find that it con|
00000590  74 61 69 6e 73 20 73 65  76 65 72 61 6c 20 63 6f  |tains several co|
000005a0  6d 6d 6f 6e 6c 79 20 75  73 65 64 20 2a 63 6f 6d  |mmonly used *com|
000005b0  6d 61 6e 64 73 2e 20 20  43 68 6f 6f 73 69 6e 67  |mands.  Choosing|
000005c0  20 61 6e 79 20 6f 66 20  74 68 65 20 65 6e 74 72  | any of the entr|
000005d0  69 65 73 20 66 72 6f 6d  20 74 68 65 20 6d 61 69  |ies from the mai|
000005e0  6e 20 6d 65 6e 75 20 77  69 6c 6c 20 65 6e 74 65  |n menu will ente|
000005f0  72 20 69 74 20 69 6e 20  74 68 65 20 66 69 72 73  |r it in the firs|
00000600  74 20 77 72 69 74 61 62  6c 65 20 69 63 6f 6e 20  |t writable icon |
00000610  69 6e 20 74 68 65 20 2a  63 6f 6d 6d 61 6e 64 20  |in the *command |
00000620  77 69 6e 64 6f 77 2e 20  20 53 75 62 6d 65 6e 75  |window.  Submenu|
00000630  20 65 6e 74 72 69 65 73  20 61 72 65 20 65 6e 74  | entries are ent|
00000640  65 72 65 64 20 69 6e 20  74 68 65 20 73 75 66 66  |ered in the suff|
00000650  69 78 20 69 63 6f 6e 2e  20 20 54 68 65 20 6d 65  |ix icon.  The me|
00000660  6e 75 20 73 74 72 75 63  74 75 72 65 20 69 74 73  |nu structure its|
00000670  65 6c 66 20 69 73 20 75  73 65 72 2d 64 65 66 69  |elf is user-defi|
00000680  6e 61 62 6c 65 20 61 6e  64 20 69 73 20 66 6f 75  |nable and is fou|
00000690  6e 64 20 69 6e 20 74 68  65 20 66 69 6c 65 20 27  |nd in the file '|
000006a0  21 57 69 6d 70 43 4c 49  2e 6d 65 6e 75 73 27 2e  |!WimpCLI.menus'.|
000006b0  20 20 48 65 72 65 20 69  73 20 61 6e 20 65 78 61  |  Here is an exa|
000006c0  6d 70 6c 65 20 6c 61 79  6f 75 74 3a 20 20 20 20  |mple layout:    |
000006d0  20 20 20 20 20 20 0a 0a  7b 73 65 74 74 79 70 65  |      ..{settype|
000006e0  2c 62 61 73 69 63 2c 73  70 72 69 74 65 2c 74 65  |,basic,sprite,te|
000006f0  78 74 2c 6f 62 65 79 2c  64 61 74 61 2c 6d 6f 64  |xt,obey,data,mod|
00000700  75 6c 65 2c 42 42 43 20  66 6f 6e 74 2c 70 61 6c  |ule,BBC font,pal|
00000710  65 74 74 65 2c 74 65 6d  70 6c 61 74 65 7d 0a 7b  |ette,template}.{|
00000720  61 63 63 65 73 73 2c 6c  77 72 7e 7d 0a 7b 61 64  |access,lwr~}.{ad|
00000730  66 73 7d 0a 7b 72 61 6d  7d 0a 7b 73 74 61 6d 70  |fs}.{ram}.{stamp|
00000740  7d 0a 7b 63 6f 6d 70 61  63 74 5e 7d 0a 7b 76 6f  |}.{compact^}.{vo|
00000750  6c 75 6d 65 2c 36 34 7e  7d 0a 7b 73 70 65 61 6b  |lume,64~}.{speak|
00000760  65 72 2c 6f 6e 2c 6f 66  66 7d 0a 7b 61 75 64 69  |er,on,off}.{audi|
00000770  6f 5e 2c 6f 6e 2c 6f 66  66 7d 0a 7b 74 69 6d 65  |o^,on,off}.{time|
00000780  7d 0a 7b 62 61 73 69 63  7d 0a 7b 6d 6f 64 75 6c  |}.{basic}.{modul|
00000790  65 73 7d 0a 0a 0a 45 61  63 68 20 6c 69 6e 65 20  |es}...Each line |
000007a0  66 6f 6c 6c 6f 77 73 20  61 20 73 69 6d 70 6c 65  |follows a simple|
000007b0  20 66 6f 72 6d 61 74 2e  20 20 54 68 65 79 20 61  | format.  They a|
000007c0  72 65 20 73 75 72 72 6f  75 6e 64 65 64 20 62 79  |re surrounded by|
000007d0  20 7b 20 61 6e 64 20 7d  20 74 6f 20 6d 61 72 6b  | { and } to mark|
000007e0  20 74 68 65 20 62 65 67  69 6e 6e 69 6e 67 20 61  | the beginning a|
000007f0  6e 64 20 65 6e 64 20 6f  66 20 74 68 65 20 64 61  |nd end of the da|
00000800  74 61 2e 20 20 45 61 63  68 20 69 74 65 6d 20 69  |ta.  Each item i|
00000810  73 20 73 65 70 61 72 61  74 65 64 20 66 72 6f 6d  |s separated from|
00000820  20 74 68 65 20 6c 61 73  74 20 62 79 20 61 20 63  | the last by a c|
00000830  6f 6d 6d 61 2e 20 20 54  68 65 20 66 69 72 73 74  |omma.  The first|
00000840  20 69 74 65 6d 20 61 70  70 65 61 72 73 20 6f 6e  | item appears on|
00000850  20 74 68 65 20 6d 61 69  6e 20 6d 65 6e 75 20 61  | the main menu a|
00000860  6e 64 20 61 6e 79 20 69  74 65 6d 73 20 61 66 74  |nd any items aft|
00000870  65 72 20 69 74 20 61 70  70 65 61 72 20 6f 6e 20  |er it appear on |
00000880  69 74 73 20 73 75 62 6d  65 6e 75 2e 20 20 49 66  |its submenu.  If|
00000890  20 61 20 6d 61 69 6e 20  6d 65 6e 75 20 69 74 65  | a main menu ite|
000008a0  6d 20 69 73 20 66 6f 6c  6c 6f 77 65 64 20 62 79  |m is followed by|
000008b0  20 61 20 5e 20 74 68 65  6e 20 74 68 65 72 65 20  | a ^ then there |
000008c0  77 69 6c 6c 20 62 65 20  61 20 62 72 65 61 6b 20  |will be a break |
000008d0  69 6e 20 74 68 65 20 6d  65 6e 75 20 61 66 74 65  |in the menu afte|
000008e0  72 20 74 68 61 74 20 69  74 65 6d 2e 20 20 54 68  |r that item.  Th|
000008f0  69 73 20 69 73 20 75 73  65 66 75 6c 20 66 6f 72  |is is useful for|
00000900  20 73 65 70 61 72 61 74  69 6e 67 20 64 69 66 66  | separating diff|
00000910  65 72 65 6e 74 20 74 79  70 65 73 20 6f 66 20 63  |erent types of c|
00000920  6f 6d 6d 61 6e 64 73 2e  20 20 49 66 20 61 20 73  |ommands.  If a s|
00000930  75 62 6d 65 6e 75 20 69  74 65 6d 20 69 73 20 66  |ubmenu item is f|
00000940  6f 6c 6c 6f 77 65 64 20  62 79 20 61 20 7e 20 74  |ollowed by a ~ t|
00000950  68 65 6e 20 69 74 20 69  73 20 77 72 69 74 65 61  |hen it is writea|
00000960  62 6c 65 2e 0a 0a 4f 74  68 65 72 20 66 65 61 74  |ble...Other feat|
00000970  75 72 65 73 20 61 72 65  20 61 6c 73 6f 20 75 73  |ures are also us|
00000980  65 72 2d 64 65 66 69 6e  61 62 6c 65 2e 20 20 4f  |er-definable.  O|
00000990  70 74 69 6f 6e 73 20 73  75 63 68 20 61 73 20 74  |ptions such as t|
000009a0  68 65 20 74 69 6d 65 20  62 65 66 6f 72 65 20 74  |he time before t|
000009b0  68 65 20 73 63 72 65 65  6e 20 73 61 76 65 72 20  |he screen saver |
000009c0  69 73 20 69 6e 76 6f 6b  65 64 2c 20 77 68 69 63  |is invoked, whic|
000009d0  68 20 73 63 72 65 65 6e  20 73 61 76 65 72 20 74  |h screen saver t|
000009e0  6f 20 75 73 65 2c 20 77  68 65 74 68 65 72 20 6f  |o use, whether o|
000009f0  72 20 6e 6f 74 20 74 6f  20 69 6e 74 65 72 63 65  |r not to interce|
00000a00  70 74 20 46 31 32 20 6b  65 79 2d 70 72 65 73 73  |pt F12 key-press|
00000a10  65 73 20 6f 72 20 6e 6f  74 20 65 74 63 2e 20 61  |es or not etc. a|
00000a20  72 65 20 61 6c 6c 20 6f  6e 20 74 68 65 20 69 63  |re all on the ic|
00000a30  6f 6e 20 62 61 72 20 6d  65 6e 75 2c 20 77 68 69  |on bar menu, whi|
00000a40  63 68 20 61 6c 73 6f 20  61 6c 6c 6f 77 73 20 79  |ch also allows y|
00000a50  6f 75 20 74 6f 20 73 61  76 65 20 79 6f 75 72 20  |ou to save your |
00000a60  63 68 6f 69 63 65 73 20  61 73 20 74 68 65 20 64  |choices as the d|
00000a70  65 66 61 75 6c 74 2e                              |efault.|
00000a77