Home » Archimedes archive » Acorn User » AU 1995-04.adf » !Internet_StarterPak » !SLIPdial/Resources/UK/Help/message

!SLIPdial/Resources/UK/Help/message

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 1995-04.adf » !Internet_StarterPak
Filename: !SLIPdial/Resources/UK/Help/message
Read OK:
File size: 041F bytes
Load address: 0000
Exec address: 0000
File contents
message [/id=<n>] [/add] [/title=<title>] [/capture[=<string>]] [/end=<string>]
        [/max=<n>] [/wait] <line1> [<line2> ... ]
 opens a window with a textual message for the user. Each line should be
   enclosed in quotes.
 /id=<n>  identifies which message window the command applies to. At
          present there is only one window, and this qualifier is ignored.
          The ability to specify multiple windows will be added in
          later versions.
 /wait    qualifier pauses script until user clicks on OK icon or closes
          message window.
 /capture[=<string>] will capture serial input to the message window, 
          optionally starting from <string>. (See Notes at end)
 /end=<string> causes message capture to end when <string> is found.
 /max=<n> defines a maximum number of lines to capture.
 /add     causes text to be added to an existing message. If no text
          is given, the command simply forces an update (redraw) of the
          message window.

message [/id=<id>] /close
 explicitly closes any message window.
00000000  6d 65 73 73 61 67 65 20  5b 2f 69 64 3d 3c 6e 3e  |message [/id=<n>|
00000010  5d 20 5b 2f 61 64 64 5d  20 5b 2f 74 69 74 6c 65  |] [/add] [/title|
00000020  3d 3c 74 69 74 6c 65 3e  5d 20 5b 2f 63 61 70 74  |=<title>] [/capt|
00000030  75 72 65 5b 3d 3c 73 74  72 69 6e 67 3e 5d 5d 20  |ure[=<string>]] |
00000040  5b 2f 65 6e 64 3d 3c 73  74 72 69 6e 67 3e 5d 0a  |[/end=<string>].|
00000050  20 20 20 20 20 20 20 20  5b 2f 6d 61 78 3d 3c 6e  |        [/max=<n|
00000060  3e 5d 20 5b 2f 77 61 69  74 5d 20 3c 6c 69 6e 65  |>] [/wait] <line|
00000070  31 3e 20 5b 3c 6c 69 6e  65 32 3e 20 2e 2e 2e 20  |1> [<line2> ... |
00000080  5d 0a 20 6f 70 65 6e 73  20 61 20 77 69 6e 64 6f  |]. opens a windo|
00000090  77 20 77 69 74 68 20 61  20 74 65 78 74 75 61 6c  |w with a textual|
000000a0  20 6d 65 73 73 61 67 65  20 66 6f 72 20 74 68 65  | message for the|
000000b0  20 75 73 65 72 2e 20 45  61 63 68 20 6c 69 6e 65  | user. Each line|
000000c0  20 73 68 6f 75 6c 64 20  62 65 0a 20 20 20 65 6e  | should be.   en|
000000d0  63 6c 6f 73 65 64 20 69  6e 20 71 75 6f 74 65 73  |closed in quotes|
000000e0  2e 0a 20 2f 69 64 3d 3c  6e 3e 20 20 69 64 65 6e  |.. /id=<n>  iden|
000000f0  74 69 66 69 65 73 20 77  68 69 63 68 20 6d 65 73  |tifies which mes|
00000100  73 61 67 65 20 77 69 6e  64 6f 77 20 74 68 65 20  |sage window the |
00000110  63 6f 6d 6d 61 6e 64 20  61 70 70 6c 69 65 73 20  |command applies |
00000120  74 6f 2e 20 41 74 0a 20  20 20 20 20 20 20 20 20  |to. At.         |
00000130  20 70 72 65 73 65 6e 74  20 74 68 65 72 65 20 69  | present there i|
00000140  73 20 6f 6e 6c 79 20 6f  6e 65 20 77 69 6e 64 6f  |s only one windo|
00000150  77 2c 20 61 6e 64 20 74  68 69 73 20 71 75 61 6c  |w, and this qual|
00000160  69 66 69 65 72 20 69 73  20 69 67 6e 6f 72 65 64  |ifier is ignored|
00000170  2e 0a 20 20 20 20 20 20  20 20 20 20 54 68 65 20  |..          The |
00000180  61 62 69 6c 69 74 79 20  74 6f 20 73 70 65 63 69  |ability to speci|
00000190  66 79 20 6d 75 6c 74 69  70 6c 65 20 77 69 6e 64  |fy multiple wind|
000001a0  6f 77 73 20 77 69 6c 6c  20 62 65 20 61 64 64 65  |ows will be adde|
000001b0  64 20 69 6e 0a 20 20 20  20 20 20 20 20 20 20 6c  |d in.          l|
000001c0  61 74 65 72 20 76 65 72  73 69 6f 6e 73 2e 0a 20  |ater versions.. |
000001d0  2f 77 61 69 74 20 20 20  20 71 75 61 6c 69 66 69  |/wait    qualifi|
000001e0  65 72 20 70 61 75 73 65  73 20 73 63 72 69 70 74  |er pauses script|
000001f0  20 75 6e 74 69 6c 20 75  73 65 72 20 63 6c 69 63  | until user clic|
00000200  6b 73 20 6f 6e 20 4f 4b  20 69 63 6f 6e 20 6f 72  |ks on OK icon or|
00000210  20 63 6c 6f 73 65 73 0a  20 20 20 20 20 20 20 20  | closes.        |
00000220  20 20 6d 65 73 73 61 67  65 20 77 69 6e 64 6f 77  |  message window|
00000230  2e 0a 20 2f 63 61 70 74  75 72 65 5b 3d 3c 73 74  |.. /capture[=<st|
00000240  72 69 6e 67 3e 5d 20 77  69 6c 6c 20 63 61 70 74  |ring>] will capt|
00000250  75 72 65 20 73 65 72 69  61 6c 20 69 6e 70 75 74  |ure serial input|
00000260  20 74 6f 20 74 68 65 20  6d 65 73 73 61 67 65 20  | to the message |
00000270  77 69 6e 64 6f 77 2c 20  0a 20 20 20 20 20 20 20  |window, .       |
00000280  20 20 20 6f 70 74 69 6f  6e 61 6c 6c 79 20 73 74  |   optionally st|
00000290  61 72 74 69 6e 67 20 66  72 6f 6d 20 3c 73 74 72  |arting from <str|
000002a0  69 6e 67 3e 2e 20 28 53  65 65 20 4e 6f 74 65 73  |ing>. (See Notes|
000002b0  20 61 74 20 65 6e 64 29  0a 20 2f 65 6e 64 3d 3c  | at end). /end=<|
000002c0  73 74 72 69 6e 67 3e 20  63 61 75 73 65 73 20 6d  |string> causes m|
000002d0  65 73 73 61 67 65 20 63  61 70 74 75 72 65 20 74  |essage capture t|
000002e0  6f 20 65 6e 64 20 77 68  65 6e 20 3c 73 74 72 69  |o end when <stri|
000002f0  6e 67 3e 20 69 73 20 66  6f 75 6e 64 2e 0a 20 2f  |ng> is found.. /|
00000300  6d 61 78 3d 3c 6e 3e 20  64 65 66 69 6e 65 73 20  |max=<n> defines |
00000310  61 20 6d 61 78 69 6d 75  6d 20 6e 75 6d 62 65 72  |a maximum number|
00000320  20 6f 66 20 6c 69 6e 65  73 20 74 6f 20 63 61 70  | of lines to cap|
00000330  74 75 72 65 2e 0a 20 2f  61 64 64 20 20 20 20 20  |ture.. /add     |
00000340  63 61 75 73 65 73 20 74  65 78 74 20 74 6f 20 62  |causes text to b|
00000350  65 20 61 64 64 65 64 20  74 6f 20 61 6e 20 65 78  |e added to an ex|
00000360  69 73 74 69 6e 67 20 6d  65 73 73 61 67 65 2e 20  |isting message. |
00000370  49 66 20 6e 6f 20 74 65  78 74 0a 20 20 20 20 20  |If no text.     |
00000380  20 20 20 20 20 69 73 20  67 69 76 65 6e 2c 20 74  |     is given, t|
00000390  68 65 20 63 6f 6d 6d 61  6e 64 20 73 69 6d 70 6c  |he command simpl|
000003a0  79 20 66 6f 72 63 65 73  20 61 6e 20 75 70 64 61  |y forces an upda|
000003b0  74 65 20 28 72 65 64 72  61 77 29 20 6f 66 20 74  |te (redraw) of t|
000003c0  68 65 0a 20 20 20 20 20  20 20 20 20 20 6d 65 73  |he.          mes|
000003d0  73 61 67 65 20 77 69 6e  64 6f 77 2e 0a 0a 6d 65  |sage window...me|
000003e0  73 73 61 67 65 20 5b 2f  69 64 3d 3c 69 64 3e 5d  |ssage [/id=<id>]|
000003f0  20 2f 63 6c 6f 73 65 0a  20 65 78 70 6c 69 63 69  | /close. explici|
00000400  74 6c 79 20 63 6c 6f 73  65 73 20 61 6e 79 20 6d  |tly closes any m|
00000410  65 73 73 61 67 65 20 77  69 6e 64 6f 77 2e 0a     |essage window..|
0000041f