Home » Archimedes archive » Archimedes World » archimedes_world_volume_15_issue_2_scp.adf » !ARMEdit_ARMEdit » Docs/Talk

Docs/Talk

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/Talk
Read OK:
File size: 1A0E bytes
Load address: 0000
Exec address: 0000
File contents
File        : Talk
Date        : 07-Dec-97
Author      : � A.Thoukydides, 1996, 1997
Description : ARMEdit messages supported by the !ARMEdit front-end.


INTRODUCTION

The !ARMEdit front-end supports several messages used by PC software. The
messages are arranged in pairs: code running on the PC card sends a message,
and the front-end sends an acknowledgement (with the same reason code). No
messages are sent from the front-end unrequested.

Messages from other sources are ignored. To test these messages from RISC OS
software it is necessary to use an ID of 0 (the same as for PC clients).

All of the messages use the ID 256.


MSG_ARMEDIT_FIND

    Check whether the front-end is running.
    
    Data sent:

        Offset  Size    Description
    
        0       4       Reason code = &00000000.
    
    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000000.

    The PC software sends this message to ID 256 to find the handle of the
    front-end software. A timeout should be used to detect whether the
    message has been delivered.
    
    All future messages should use the message handle.


MSG_ARMEDIT_START

    Start an external edit.
    
    Data sent:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000001.
        4       4       Byte offset of initial cursor position.
        8       20      Null terminated DOS leaf name of file to edit.
        28      256     Null terminated name of RISC OS file to edit.
    
    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000001.
        4       4       Handle for this edit.

    This message is used to start an external edit. The leaf name is used for
    display purposes - only the RISC OS name is used to access the file
    (which must exist when the message is sent).
    
    No status is returned by this message. Use MSG_ARMEDIT_POLL to check the
    state of the edit.
    
    A unique handle is returned for this file. This handle should be used
    when polling the status of the edit.


MSG_ARMEDIT_POLL

    Poll the status of the external edit.
    
    Data sent:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000002.
        4       4       Handle of edit to poll.
        8       4       Flags:
                            bit 0   Set to retrieve data.
                            bit 1   Set to end external edit.
                            bit 2   Set to mark file as safely saved.
    
    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000002.
        4       4       Flags:
                            bit 0   Set if file modified since last poll.
                            bit 1   Set if external edit aborted.

    This message is used to check or update the status of an external edit.
    The input flags allow the file to be retrieved from the editor, or to
    abandon the edit. It is also possible to mark the edit as safely saved
    after it has been saved by the editor.
    
    If a request has been made to retrieve a file then the returned flags
    should be checked until the modified flag is set.
    
    If the returned flags indicate that the edit has been aborted then no
    more messages should be sent for this edit.


MSG_ARMEDIT_SAVEAS

    Display a Save As window for a specified file.
    
    Data sent:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000003.
        4       256     Null terminated name of RISC OS file to save.
        260     256     Null terminated suggested name of file to save.
    
    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000003.

    Allow a file to be saved under a user specifiable name. This is intended
    for use by the PUTFILE command when no destination is specified. The
    file is deleted when it has either been saved, or when the user has
    cancelled the operation. No method for determining the success or
    failure of the operation is provided.
    

MSG_ARMEDIT_OSCLI_START

    Start executing a specified *command using a TaskWindow.
    
    Data sent:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000004.
        4       256     The null terminated command to execute.
        260     256     Name of the task to create.

    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000004.
        4       4       Handle for this command.

    This message is used to start a *command executing in a TaskWindow.
    
    A unique handle is returned for this command. This handle should be used
    when polling or ending execution of the command.


MSG_ARMEDIT_OSCLI_POLL

    Continue execution of a *command. 
    
    Data sent:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000005.
        4       4       Handle of command to poll.
        8       4       Number of bytes to input.
        12      1000    Up to 1000 bytes of input.

    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000005.
        4       4       Status:
                            0   Command has finished.
                            1   Active.
        8       4       Number of bytes to output.
        12      1000    Up to 1000 bytes of output.

    This message is used to send input or to receive any output from a
    *command running in a TaskWindow. Both input and output is buffered as
    required.
    

MSG_ARMEDIT_OSCLI_END

    Terminate execution of a *command.
    
    Data sent:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000006.
        4       4       Handle of command to terminate.

    Data returned:
    
        Offset  Size    Description
        
        0       4       Reason code = &00000006.

    Kill the TaskWindow associated with the specified command. Any pending
    input or output is discarded.


THINGS TO DO

The following are changes that may be made to the HPC services sometime in
the future.

    None at the moment!


VERSION HISTORY

0.00 (10-Sep-96)    Original development version.

0.01 (05-Feb-97)    Cursor position in external edits can be specified.
                    Added Save As window support.

1.03 (21-Feb-97)    First official release version.

1.04 (07-Dec-97)    Added support for executing a command in a TaskWindow.
00000000  46 69 6c 65 20 20 20 20  20 20 20 20 3a 20 54 61  |File        : Ta|
00000010  6c 6b 0a 44 61 74 65 20  20 20 20 20 20 20 20 3a  |lk.Date        :|
00000020  20 30 37 2d 44 65 63 2d  39 37 0a 41 75 74 68 6f  | 07-Dec-97.Autho|
00000030  72 20 20 20 20 20 20 3a  20 a9 20 41 2e 54 68 6f  |r      : . A.Tho|
00000040  75 6b 79 64 69 64 65 73  2c 20 31 39 39 36 2c 20  |ukydides, 1996, |
00000050  31 39 39 37 0a 44 65 73  63 72 69 70 74 69 6f 6e  |1997.Description|
00000060  20 3a 20 41 52 4d 45 64  69 74 20 6d 65 73 73 61  | : ARMEdit messa|
00000070  67 65 73 20 73 75 70 70  6f 72 74 65 64 20 62 79  |ges supported by|
00000080  20 74 68 65 20 21 41 52  4d 45 64 69 74 20 66 72  | the !ARMEdit fr|
00000090  6f 6e 74 2d 65 6e 64 2e  0a 0a 0a 49 4e 54 52 4f  |ont-end....INTRO|
000000a0  44 55 43 54 49 4f 4e 0a  0a 54 68 65 20 21 41 52  |DUCTION..The !AR|
000000b0  4d 45 64 69 74 20 66 72  6f 6e 74 2d 65 6e 64 20  |MEdit front-end |
000000c0  73 75 70 70 6f 72 74 73  20 73 65 76 65 72 61 6c  |supports several|
000000d0  20 6d 65 73 73 61 67 65  73 20 75 73 65 64 20 62  | messages used b|
000000e0  79 20 50 43 20 73 6f 66  74 77 61 72 65 2e 20 54  |y PC software. T|
000000f0  68 65 0a 6d 65 73 73 61  67 65 73 20 61 72 65 20  |he.messages are |
00000100  61 72 72 61 6e 67 65 64  20 69 6e 20 70 61 69 72  |arranged in pair|
00000110  73 3a 20 63 6f 64 65 20  72 75 6e 6e 69 6e 67 20  |s: code running |
00000120  6f 6e 20 74 68 65 20 50  43 20 63 61 72 64 20 73  |on the PC card s|
00000130  65 6e 64 73 20 61 20 6d  65 73 73 61 67 65 2c 0a  |ends a message,.|
00000140  61 6e 64 20 74 68 65 20  66 72 6f 6e 74 2d 65 6e  |and the front-en|
00000150  64 20 73 65 6e 64 73 20  61 6e 20 61 63 6b 6e 6f  |d sends an ackno|
00000160  77 6c 65 64 67 65 6d 65  6e 74 20 28 77 69 74 68  |wledgement (with|
00000170  20 74 68 65 20 73 61 6d  65 20 72 65 61 73 6f 6e  | the same reason|
00000180  20 63 6f 64 65 29 2e 20  4e 6f 0a 6d 65 73 73 61  | code). No.messa|
00000190  67 65 73 20 61 72 65 20  73 65 6e 74 20 66 72 6f  |ges are sent fro|
000001a0  6d 20 74 68 65 20 66 72  6f 6e 74 2d 65 6e 64 20  |m the front-end |
000001b0  75 6e 72 65 71 75 65 73  74 65 64 2e 0a 0a 4d 65  |unrequested...Me|
000001c0  73 73 61 67 65 73 20 66  72 6f 6d 20 6f 74 68 65  |ssages from othe|
000001d0  72 20 73 6f 75 72 63 65  73 20 61 72 65 20 69 67  |r sources are ig|
000001e0  6e 6f 72 65 64 2e 20 54  6f 20 74 65 73 74 20 74  |nored. To test t|
000001f0  68 65 73 65 20 6d 65 73  73 61 67 65 73 20 66 72  |hese messages fr|
00000200  6f 6d 20 52 49 53 43 20  4f 53 0a 73 6f 66 74 77  |om RISC OS.softw|
00000210  61 72 65 20 69 74 20 69  73 20 6e 65 63 65 73 73  |are it is necess|
00000220  61 72 79 20 74 6f 20 75  73 65 20 61 6e 20 49 44  |ary to use an ID|
00000230  20 6f 66 20 30 20 28 74  68 65 20 73 61 6d 65 20  | of 0 (the same |
00000240  61 73 20 66 6f 72 20 50  43 20 63 6c 69 65 6e 74  |as for PC client|
00000250  73 29 2e 0a 0a 41 6c 6c  20 6f 66 20 74 68 65 20  |s)...All of the |
00000260  6d 65 73 73 61 67 65 73  20 75 73 65 20 74 68 65  |messages use the|
00000270  20 49 44 20 32 35 36 2e  0a 0a 0a 4d 53 47 5f 41  | ID 256....MSG_A|
00000280  52 4d 45 44 49 54 5f 46  49 4e 44 0a 0a 20 20 20  |RMEDIT_FIND..   |
00000290  20 43 68 65 63 6b 20 77  68 65 74 68 65 72 20 74  | Check whether t|
000002a0  68 65 20 66 72 6f 6e 74  2d 65 6e 64 20 69 73 20  |he front-end is |
000002b0  72 75 6e 6e 69 6e 67 2e  0a 20 20 20 20 0a 20 20  |running..    .  |
000002c0  20 20 44 61 74 61 20 73  65 6e 74 3a 0a 0a 20 20  |  Data sent:..  |
000002d0  20 20 20 20 20 20 4f 66  66 73 65 74 20 20 53 69  |      Offset  Si|
000002e0  7a 65 20 20 20 20 44 65  73 63 72 69 70 74 69 6f  |ze    Descriptio|
000002f0  6e 0a 20 20 20 20 0a 20  20 20 20 20 20 20 20 30  |n.    .        0|
00000300  20 20 20 20 20 20 20 34  20 20 20 20 20 20 20 52  |       4       R|
00000310  65 61 73 6f 6e 20 63 6f  64 65 20 3d 20 26 30 30  |eason code = &00|
00000320  30 30 30 30 30 30 2e 0a  20 20 20 20 0a 20 20 20  |000000..    .   |
00000330  20 44 61 74 61 20 72 65  74 75 72 6e 65 64 3a 0a  | Data returned:.|
00000340  20 20 20 20 0a 20 20 20  20 20 20 20 20 4f 66 66  |    .        Off|
00000350  73 65 74 20 20 53 69 7a  65 20 20 20 20 44 65 73  |set  Size    Des|
00000360  63 72 69 70 74 69 6f 6e  0a 20 20 20 20 20 20 20  |cription.       |
00000370  20 0a 20 20 20 20 20 20  20 20 30 20 20 20 20 20  | .        0     |
00000380  20 20 34 20 20 20 20 20  20 20 52 65 61 73 6f 6e  |  4       Reason|
00000390  20 63 6f 64 65 20 3d 20  26 30 30 30 30 30 30 30  | code = &0000000|
000003a0  30 2e 0a 0a 20 20 20 20  54 68 65 20 50 43 20 73  |0...    The PC s|
000003b0  6f 66 74 77 61 72 65 20  73 65 6e 64 73 20 74 68  |oftware sends th|
000003c0  69 73 20 6d 65 73 73 61  67 65 20 74 6f 20 49 44  |is message to ID|
000003d0  20 32 35 36 20 74 6f 20  66 69 6e 64 20 74 68 65  | 256 to find the|
000003e0  20 68 61 6e 64 6c 65 20  6f 66 20 74 68 65 0a 20  | handle of the. |
000003f0  20 20 20 66 72 6f 6e 74  2d 65 6e 64 20 73 6f 66  |   front-end sof|
00000400  74 77 61 72 65 2e 20 41  20 74 69 6d 65 6f 75 74  |tware. A timeout|
00000410  20 73 68 6f 75 6c 64 20  62 65 20 75 73 65 64 20  | should be used |
00000420  74 6f 20 64 65 74 65 63  74 20 77 68 65 74 68 65  |to detect whethe|
00000430  72 20 74 68 65 0a 20 20  20 20 6d 65 73 73 61 67  |r the.    messag|
00000440  65 20 68 61 73 20 62 65  65 6e 20 64 65 6c 69 76  |e has been deliv|
00000450  65 72 65 64 2e 0a 20 20  20 20 0a 20 20 20 20 41  |ered..    .    A|
00000460  6c 6c 20 66 75 74 75 72  65 20 6d 65 73 73 61 67  |ll future messag|
00000470  65 73 20 73 68 6f 75 6c  64 20 75 73 65 20 74 68  |es should use th|
00000480  65 20 6d 65 73 73 61 67  65 20 68 61 6e 64 6c 65  |e message handle|
00000490  2e 0a 0a 0a 4d 53 47 5f  41 52 4d 45 44 49 54 5f  |....MSG_ARMEDIT_|
000004a0  53 54 41 52 54 0a 0a 20  20 20 20 53 74 61 72 74  |START..    Start|
000004b0  20 61 6e 20 65 78 74 65  72 6e 61 6c 20 65 64 69  | an external edi|
000004c0  74 2e 0a 20 20 20 20 0a  20 20 20 20 44 61 74 61  |t..    .    Data|
000004d0  20 73 65 6e 74 3a 0a 20  20 20 20 0a 20 20 20 20  | sent:.    .    |
000004e0  20 20 20 20 4f 66 66 73  65 74 20 20 53 69 7a 65  |    Offset  Size|
000004f0  20 20 20 20 44 65 73 63  72 69 70 74 69 6f 6e 0a  |    Description.|
00000500  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00000510  20 30 20 20 20 20 20 20  20 34 20 20 20 20 20 20  | 0       4      |
00000520  20 52 65 61 73 6f 6e 20  63 6f 64 65 20 3d 20 26  | Reason code = &|
00000530  30 30 30 30 30 30 30 31  2e 0a 20 20 20 20 20 20  |00000001..      |
00000540  20 20 34 20 20 20 20 20  20 20 34 20 20 20 20 20  |  4       4     |
00000550  20 20 42 79 74 65 20 6f  66 66 73 65 74 20 6f 66  |  Byte offset of|
00000560  20 69 6e 69 74 69 61 6c  20 63 75 72 73 6f 72 20  | initial cursor |
00000570  70 6f 73 69 74 69 6f 6e  2e 0a 20 20 20 20 20 20  |position..      |
00000580  20 20 38 20 20 20 20 20  20 20 32 30 20 20 20 20  |  8       20    |
00000590  20 20 4e 75 6c 6c 20 74  65 72 6d 69 6e 61 74 65  |  Null terminate|
000005a0  64 20 44 4f 53 20 6c 65  61 66 20 6e 61 6d 65 20  |d DOS leaf name |
000005b0  6f 66 20 66 69 6c 65 20  74 6f 20 65 64 69 74 2e  |of file to edit.|
000005c0  0a 20 20 20 20 20 20 20  20 32 38 20 20 20 20 20  |.        28     |
000005d0  20 32 35 36 20 20 20 20  20 4e 75 6c 6c 20 74 65  | 256     Null te|
000005e0  72 6d 69 6e 61 74 65 64  20 6e 61 6d 65 20 6f 66  |rminated name of|
000005f0  20 52 49 53 43 20 4f 53  20 66 69 6c 65 20 74 6f  | RISC OS file to|
00000600  20 65 64 69 74 2e 0a 20  20 20 20 0a 20 20 20 20  | edit..    .    |
00000610  44 61 74 61 20 72 65 74  75 72 6e 65 64 3a 0a 20  |Data returned:. |
00000620  20 20 20 0a 20 20 20 20  20 20 20 20 4f 66 66 73  |   .        Offs|
00000630  65 74 20 20 53 69 7a 65  20 20 20 20 44 65 73 63  |et  Size    Desc|
00000640  72 69 70 74 69 6f 6e 0a  20 20 20 20 20 20 20 20  |ription.        |
00000650  0a 20 20 20 20 20 20 20  20 30 20 20 20 20 20 20  |.        0      |
00000660  20 34 20 20 20 20 20 20  20 52 65 61 73 6f 6e 20  | 4       Reason |
00000670  63 6f 64 65 20 3d 20 26  30 30 30 30 30 30 30 31  |code = &00000001|
00000680  2e 0a 20 20 20 20 20 20  20 20 34 20 20 20 20 20  |..        4     |
00000690  20 20 34 20 20 20 20 20  20 20 48 61 6e 64 6c 65  |  4       Handle|
000006a0  20 66 6f 72 20 74 68 69  73 20 65 64 69 74 2e 0a  | for this edit..|
000006b0  0a 20 20 20 20 54 68 69  73 20 6d 65 73 73 61 67  |.    This messag|
000006c0  65 20 69 73 20 75 73 65  64 20 74 6f 20 73 74 61  |e is used to sta|
000006d0  72 74 20 61 6e 20 65 78  74 65 72 6e 61 6c 20 65  |rt an external e|
000006e0  64 69 74 2e 20 54 68 65  20 6c 65 61 66 20 6e 61  |dit. The leaf na|
000006f0  6d 65 20 69 73 20 75 73  65 64 20 66 6f 72 0a 20  |me is used for. |
00000700  20 20 20 64 69 73 70 6c  61 79 20 70 75 72 70 6f  |   display purpo|
00000710  73 65 73 20 2d 20 6f 6e  6c 79 20 74 68 65 20 52  |ses - only the R|
00000720  49 53 43 20 4f 53 20 6e  61 6d 65 20 69 73 20 75  |ISC OS name is u|
00000730  73 65 64 20 74 6f 20 61  63 63 65 73 73 20 74 68  |sed to access th|
00000740  65 20 66 69 6c 65 0a 20  20 20 20 28 77 68 69 63  |e file.    (whic|
00000750  68 20 6d 75 73 74 20 65  78 69 73 74 20 77 68 65  |h must exist whe|
00000760  6e 20 74 68 65 20 6d 65  73 73 61 67 65 20 69 73  |n the message is|
00000770  20 73 65 6e 74 29 2e 0a  20 20 20 20 0a 20 20 20  | sent)..    .   |
00000780  20 4e 6f 20 73 74 61 74  75 73 20 69 73 20 72 65  | No status is re|
00000790  74 75 72 6e 65 64 20 62  79 20 74 68 69 73 20 6d  |turned by this m|
000007a0  65 73 73 61 67 65 2e 20  55 73 65 20 4d 53 47 5f  |essage. Use MSG_|
000007b0  41 52 4d 45 44 49 54 5f  50 4f 4c 4c 20 74 6f 20  |ARMEDIT_POLL to |
000007c0  63 68 65 63 6b 20 74 68  65 0a 20 20 20 20 73 74  |check the.    st|
000007d0  61 74 65 20 6f 66 20 74  68 65 20 65 64 69 74 2e  |ate of the edit.|
000007e0  0a 20 20 20 20 0a 20 20  20 20 41 20 75 6e 69 71  |.    .    A uniq|
000007f0  75 65 20 68 61 6e 64 6c  65 20 69 73 20 72 65 74  |ue handle is ret|
00000800  75 72 6e 65 64 20 66 6f  72 20 74 68 69 73 20 66  |urned for this f|
00000810  69 6c 65 2e 20 54 68 69  73 20 68 61 6e 64 6c 65  |ile. This handle|
00000820  20 73 68 6f 75 6c 64 20  62 65 20 75 73 65 64 0a  | should be used.|
00000830  20 20 20 20 77 68 65 6e  20 70 6f 6c 6c 69 6e 67  |    when polling|
00000840  20 74 68 65 20 73 74 61  74 75 73 20 6f 66 20 74  | the status of t|
00000850  68 65 20 65 64 69 74 2e  0a 0a 0a 4d 53 47 5f 41  |he edit....MSG_A|
00000860  52 4d 45 44 49 54 5f 50  4f 4c 4c 0a 0a 20 20 20  |RMEDIT_POLL..   |
00000870  20 50 6f 6c 6c 20 74 68  65 20 73 74 61 74 75 73  | Poll the status|
00000880  20 6f 66 20 74 68 65 20  65 78 74 65 72 6e 61 6c  | of the external|
00000890  20 65 64 69 74 2e 0a 20  20 20 20 0a 20 20 20 20  | edit..    .    |
000008a0  44 61 74 61 20 73 65 6e  74 3a 0a 20 20 20 20 0a  |Data sent:.    .|
000008b0  20 20 20 20 20 20 20 20  4f 66 66 73 65 74 20 20  |        Offset  |
000008c0  53 69 7a 65 20 20 20 20  44 65 73 63 72 69 70 74  |Size    Descript|
000008d0  69 6f 6e 0a 20 20 20 20  20 20 20 20 0a 20 20 20  |ion.        .   |
000008e0  20 20 20 20 20 30 20 20  20 20 20 20 20 34 20 20  |     0       4  |
000008f0  20 20 20 20 20 52 65 61  73 6f 6e 20 63 6f 64 65  |     Reason code|
00000900  20 3d 20 26 30 30 30 30  30 30 30 32 2e 0a 20 20  | = &00000002..  |
00000910  20 20 20 20 20 20 34 20  20 20 20 20 20 20 34 20  |      4       4 |
00000920  20 20 20 20 20 20 48 61  6e 64 6c 65 20 6f 66 20  |      Handle of |
00000930  65 64 69 74 20 74 6f 20  70 6f 6c 6c 2e 0a 20 20  |edit to poll..  |
00000940  20 20 20 20 20 20 38 20  20 20 20 20 20 20 34 20  |      8       4 |
00000950  20 20 20 20 20 20 46 6c  61 67 73 3a 0a 20 20 20  |      Flags:.   |
00000960  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000970  20 20 20 20 20 20 20 20  20 62 69 74 20 30 20 20  |         bit 0  |
00000980  20 53 65 74 20 74 6f 20  72 65 74 72 69 65 76 65  | Set to retrieve|
00000990  20 64 61 74 61 2e 0a 20  20 20 20 20 20 20 20 20  | data..         |
000009a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000009b0  20 20 20 62 69 74 20 31  20 20 20 53 65 74 20 74  |   bit 1   Set t|
000009c0  6f 20 65 6e 64 20 65 78  74 65 72 6e 61 6c 20 65  |o end external e|
000009d0  64 69 74 2e 0a 20 20 20  20 20 20 20 20 20 20 20  |dit..           |
000009e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000009f0  20 62 69 74 20 32 20 20  20 53 65 74 20 74 6f 20  | bit 2   Set to |
00000a00  6d 61 72 6b 20 66 69 6c  65 20 61 73 20 73 61 66  |mark file as saf|
00000a10  65 6c 79 20 73 61 76 65  64 2e 0a 20 20 20 20 0a  |ely saved..    .|
00000a20  20 20 20 20 44 61 74 61  20 72 65 74 75 72 6e 65  |    Data returne|
00000a30  64 3a 0a 20 20 20 20 0a  20 20 20 20 20 20 20 20  |d:.    .        |
00000a40  4f 66 66 73 65 74 20 20  53 69 7a 65 20 20 20 20  |Offset  Size    |
00000a50  44 65 73 63 72 69 70 74  69 6f 6e 0a 20 20 20 20  |Description.    |
00000a60  20 20 20 20 0a 20 20 20  20 20 20 20 20 30 20 20  |    .        0  |
00000a70  20 20 20 20 20 34 20 20  20 20 20 20 20 52 65 61  |     4       Rea|
00000a80  73 6f 6e 20 63 6f 64 65  20 3d 20 26 30 30 30 30  |son code = &0000|
00000a90  30 30 30 32 2e 0a 20 20  20 20 20 20 20 20 34 20  |0002..        4 |
00000aa0  20 20 20 20 20 20 34 20  20 20 20 20 20 20 46 6c  |      4       Fl|
00000ab0  61 67 73 3a 0a 20 20 20  20 20 20 20 20 20 20 20  |ags:.           |
00000ac0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000ad0  20 62 69 74 20 30 20 20  20 53 65 74 20 69 66 20  | bit 0   Set if |
00000ae0  66 69 6c 65 20 6d 6f 64  69 66 69 65 64 20 73 69  |file modified si|
00000af0  6e 63 65 20 6c 61 73 74  20 70 6f 6c 6c 2e 0a 20  |nce last poll.. |
00000b00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000b10  20 20 20 20 20 20 20 20  20 20 20 62 69 74 20 31  |           bit 1|
00000b20  20 20 20 53 65 74 20 69  66 20 65 78 74 65 72 6e  |   Set if extern|
00000b30  61 6c 20 65 64 69 74 20  61 62 6f 72 74 65 64 2e  |al edit aborted.|
00000b40  0a 0a 20 20 20 20 54 68  69 73 20 6d 65 73 73 61  |..    This messa|
00000b50  67 65 20 69 73 20 75 73  65 64 20 74 6f 20 63 68  |ge is used to ch|
00000b60  65 63 6b 20 6f 72 20 75  70 64 61 74 65 20 74 68  |eck or update th|
00000b70  65 20 73 74 61 74 75 73  20 6f 66 20 61 6e 20 65  |e status of an e|
00000b80  78 74 65 72 6e 61 6c 20  65 64 69 74 2e 0a 20 20  |xternal edit..  |
00000b90  20 20 54 68 65 20 69 6e  70 75 74 20 66 6c 61 67  |  The input flag|
00000ba0  73 20 61 6c 6c 6f 77 20  74 68 65 20 66 69 6c 65  |s allow the file|
00000bb0  20 74 6f 20 62 65 20 72  65 74 72 69 65 76 65 64  | to be retrieved|
00000bc0  20 66 72 6f 6d 20 74 68  65 20 65 64 69 74 6f 72  | from the editor|
00000bd0  2c 20 6f 72 20 74 6f 0a  20 20 20 20 61 62 61 6e  |, or to.    aban|
00000be0  64 6f 6e 20 74 68 65 20  65 64 69 74 2e 20 49 74  |don the edit. It|
00000bf0  20 69 73 20 61 6c 73 6f  20 70 6f 73 73 69 62 6c  | is also possibl|
00000c00  65 20 74 6f 20 6d 61 72  6b 20 74 68 65 20 65 64  |e to mark the ed|
00000c10  69 74 20 61 73 20 73 61  66 65 6c 79 20 73 61 76  |it as safely sav|
00000c20  65 64 0a 20 20 20 20 61  66 74 65 72 20 69 74 20  |ed.    after it |
00000c30  68 61 73 20 62 65 65 6e  20 73 61 76 65 64 20 62  |has been saved b|
00000c40  79 20 74 68 65 20 65 64  69 74 6f 72 2e 0a 20 20  |y the editor..  |
00000c50  20 20 0a 20 20 20 20 49  66 20 61 20 72 65 71 75  |  .    If a requ|
00000c60  65 73 74 20 68 61 73 20  62 65 65 6e 20 6d 61 64  |est has been mad|
00000c70  65 20 74 6f 20 72 65 74  72 69 65 76 65 20 61 20  |e to retrieve a |
00000c80  66 69 6c 65 20 74 68 65  6e 20 74 68 65 20 72 65  |file then the re|
00000c90  74 75 72 6e 65 64 20 66  6c 61 67 73 0a 20 20 20  |turned flags.   |
00000ca0  20 73 68 6f 75 6c 64 20  62 65 20 63 68 65 63 6b  | should be check|
00000cb0  65 64 20 75 6e 74 69 6c  20 74 68 65 20 6d 6f 64  |ed until the mod|
00000cc0  69 66 69 65 64 20 66 6c  61 67 20 69 73 20 73 65  |ified flag is se|
00000cd0  74 2e 0a 20 20 20 20 0a  20 20 20 20 49 66 20 74  |t..    .    If t|
00000ce0  68 65 20 72 65 74 75 72  6e 65 64 20 66 6c 61 67  |he returned flag|
00000cf0  73 20 69 6e 64 69 63 61  74 65 20 74 68 61 74 20  |s indicate that |
00000d00  74 68 65 20 65 64 69 74  20 68 61 73 20 62 65 65  |the edit has bee|
00000d10  6e 20 61 62 6f 72 74 65  64 20 74 68 65 6e 20 6e  |n aborted then n|
00000d20  6f 0a 20 20 20 20 6d 6f  72 65 20 6d 65 73 73 61  |o.    more messa|
00000d30  67 65 73 20 73 68 6f 75  6c 64 20 62 65 20 73 65  |ges should be se|
00000d40  6e 74 20 66 6f 72 20 74  68 69 73 20 65 64 69 74  |nt for this edit|
00000d50  2e 0a 0a 0a 4d 53 47 5f  41 52 4d 45 44 49 54 5f  |....MSG_ARMEDIT_|
00000d60  53 41 56 45 41 53 0a 0a  20 20 20 20 44 69 73 70  |SAVEAS..    Disp|
00000d70  6c 61 79 20 61 20 53 61  76 65 20 41 73 20 77 69  |lay a Save As wi|
00000d80  6e 64 6f 77 20 66 6f 72  20 61 20 73 70 65 63 69  |ndow for a speci|
00000d90  66 69 65 64 20 66 69 6c  65 2e 0a 20 20 20 20 0a  |fied file..    .|
00000da0  20 20 20 20 44 61 74 61  20 73 65 6e 74 3a 0a 20  |    Data sent:. |
00000db0  20 20 20 0a 20 20 20 20  20 20 20 20 4f 66 66 73  |   .        Offs|
00000dc0  65 74 20 20 53 69 7a 65  20 20 20 20 44 65 73 63  |et  Size    Desc|
00000dd0  72 69 70 74 69 6f 6e 0a  20 20 20 20 20 20 20 20  |ription.        |
00000de0  0a 20 20 20 20 20 20 20  20 30 20 20 20 20 20 20  |.        0      |
00000df0  20 34 20 20 20 20 20 20  20 52 65 61 73 6f 6e 20  | 4       Reason |
00000e00  63 6f 64 65 20 3d 20 26  30 30 30 30 30 30 30 33  |code = &00000003|
00000e10  2e 0a 20 20 20 20 20 20  20 20 34 20 20 20 20 20  |..        4     |
00000e20  20 20 32 35 36 20 20 20  20 20 4e 75 6c 6c 20 74  |  256     Null t|
00000e30  65 72 6d 69 6e 61 74 65  64 20 6e 61 6d 65 20 6f  |erminated name o|
00000e40  66 20 52 49 53 43 20 4f  53 20 66 69 6c 65 20 74  |f RISC OS file t|
00000e50  6f 20 73 61 76 65 2e 0a  20 20 20 20 20 20 20 20  |o save..        |
00000e60  32 36 30 20 20 20 20 20  32 35 36 20 20 20 20 20  |260     256     |
00000e70  4e 75 6c 6c 20 74 65 72  6d 69 6e 61 74 65 64 20  |Null terminated |
00000e80  73 75 67 67 65 73 74 65  64 20 6e 61 6d 65 20 6f  |suggested name o|
00000e90  66 20 66 69 6c 65 20 74  6f 20 73 61 76 65 2e 0a  |f file to save..|
00000ea0  20 20 20 20 0a 20 20 20  20 44 61 74 61 20 72 65  |    .    Data re|
00000eb0  74 75 72 6e 65 64 3a 0a  20 20 20 20 0a 20 20 20  |turned:.    .   |
00000ec0  20 20 20 20 20 4f 66 66  73 65 74 20 20 53 69 7a  |     Offset  Siz|
00000ed0  65 20 20 20 20 44 65 73  63 72 69 70 74 69 6f 6e  |e    Description|
00000ee0  0a 20 20 20 20 20 20 20  20 0a 20 20 20 20 20 20  |.        .      |
00000ef0  20 20 30 20 20 20 20 20  20 20 34 20 20 20 20 20  |  0       4     |
00000f00  20 20 52 65 61 73 6f 6e  20 63 6f 64 65 20 3d 20  |  Reason code = |
00000f10  26 30 30 30 30 30 30 30  33 2e 0a 0a 20 20 20 20  |&00000003...    |
00000f20  41 6c 6c 6f 77 20 61 20  66 69 6c 65 20 74 6f 20  |Allow a file to |
00000f30  62 65 20 73 61 76 65 64  20 75 6e 64 65 72 20 61  |be saved under a|
00000f40  20 75 73 65 72 20 73 70  65 63 69 66 69 61 62 6c  | user specifiabl|
00000f50  65 20 6e 61 6d 65 2e 20  54 68 69 73 20 69 73 20  |e name. This is |
00000f60  69 6e 74 65 6e 64 65 64  0a 20 20 20 20 66 6f 72  |intended.    for|
00000f70  20 75 73 65 20 62 79 20  74 68 65 20 50 55 54 46  | use by the PUTF|
00000f80  49 4c 45 20 63 6f 6d 6d  61 6e 64 20 77 68 65 6e  |ILE command when|
00000f90  20 6e 6f 20 64 65 73 74  69 6e 61 74 69 6f 6e 20  | no destination |
00000fa0  69 73 20 73 70 65 63 69  66 69 65 64 2e 20 54 68  |is specified. Th|
00000fb0  65 0a 20 20 20 20 66 69  6c 65 20 69 73 20 64 65  |e.    file is de|
00000fc0  6c 65 74 65 64 20 77 68  65 6e 20 69 74 20 68 61  |leted when it ha|
00000fd0  73 20 65 69 74 68 65 72  20 62 65 65 6e 20 73 61  |s either been sa|
00000fe0  76 65 64 2c 20 6f 72 20  77 68 65 6e 20 74 68 65  |ved, or when the|
00000ff0  20 75 73 65 72 20 68 61  73 0a 20 20 20 20 63 61  | user has.    ca|
00001000  6e 63 65 6c 6c 65 64 20  74 68 65 20 6f 70 65 72  |ncelled the oper|
00001010  61 74 69 6f 6e 2e 20 4e  6f 20 6d 65 74 68 6f 64  |ation. No method|
00001020  20 66 6f 72 20 64 65 74  65 72 6d 69 6e 69 6e 67  | for determining|
00001030  20 74 68 65 20 73 75 63  63 65 73 73 20 6f 72 0a  | the success or.|
00001040  20 20 20 20 66 61 69 6c  75 72 65 20 6f 66 20 74  |    failure of t|
00001050  68 65 20 6f 70 65 72 61  74 69 6f 6e 20 69 73 20  |he operation is |
00001060  70 72 6f 76 69 64 65 64  2e 0a 20 20 20 20 0a 0a  |provided..    ..|
00001070  4d 53 47 5f 41 52 4d 45  44 49 54 5f 4f 53 43 4c  |MSG_ARMEDIT_OSCL|
00001080  49 5f 53 54 41 52 54 0a  0a 20 20 20 20 53 74 61  |I_START..    Sta|
00001090  72 74 20 65 78 65 63 75  74 69 6e 67 20 61 20 73  |rt executing a s|
000010a0  70 65 63 69 66 69 65 64  20 2a 63 6f 6d 6d 61 6e  |pecified *comman|
000010b0  64 20 75 73 69 6e 67 20  61 20 54 61 73 6b 57 69  |d using a TaskWi|
000010c0  6e 64 6f 77 2e 0a 20 20  20 20 0a 20 20 20 20 44  |ndow..    .    D|
000010d0  61 74 61 20 73 65 6e 74  3a 0a 20 20 20 20 0a 20  |ata sent:.    . |
000010e0  20 20 20 20 20 20 20 4f  66 66 73 65 74 20 20 53  |       Offset  S|
000010f0  69 7a 65 20 20 20 20 44  65 73 63 72 69 70 74 69  |ize    Descripti|
00001100  6f 6e 0a 20 20 20 20 20  20 20 20 0a 20 20 20 20  |on.        .    |
00001110  20 20 20 20 30 20 20 20  20 20 20 20 34 20 20 20  |    0       4   |
00001120  20 20 20 20 52 65 61 73  6f 6e 20 63 6f 64 65 20  |    Reason code |
00001130  3d 20 26 30 30 30 30 30  30 30 34 2e 0a 20 20 20  |= &00000004..   |
00001140  20 20 20 20 20 34 20 20  20 20 20 20 20 32 35 36  |     4       256|
00001150  20 20 20 20 20 54 68 65  20 6e 75 6c 6c 20 74 65  |     The null te|
00001160  72 6d 69 6e 61 74 65 64  20 63 6f 6d 6d 61 6e 64  |rminated command|
00001170  20 74 6f 20 65 78 65 63  75 74 65 2e 0a 20 20 20  | to execute..   |
00001180  20 20 20 20 20 32 36 30  20 20 20 20 20 32 35 36  |     260     256|
00001190  20 20 20 20 20 4e 61 6d  65 20 6f 66 20 74 68 65  |     Name of the|
000011a0  20 74 61 73 6b 20 74 6f  20 63 72 65 61 74 65 2e  | task to create.|
000011b0  0a 0a 20 20 20 20 44 61  74 61 20 72 65 74 75 72  |..    Data retur|
000011c0  6e 65 64 3a 0a 20 20 20  20 0a 20 20 20 20 20 20  |ned:.    .      |
000011d0  20 20 4f 66 66 73 65 74  20 20 53 69 7a 65 20 20  |  Offset  Size  |
000011e0  20 20 44 65 73 63 72 69  70 74 69 6f 6e 0a 20 20  |  Description.  |
000011f0  20 20 20 20 20 20 0a 20  20 20 20 20 20 20 20 30  |      .        0|
00001200  20 20 20 20 20 20 20 34  20 20 20 20 20 20 20 52  |       4       R|
00001210  65 61 73 6f 6e 20 63 6f  64 65 20 3d 20 26 30 30  |eason code = &00|
00001220  30 30 30 30 30 34 2e 0a  20 20 20 20 20 20 20 20  |000004..        |
00001230  34 20 20 20 20 20 20 20  34 20 20 20 20 20 20 20  |4       4       |
00001240  48 61 6e 64 6c 65 20 66  6f 72 20 74 68 69 73 20  |Handle for this |
00001250  63 6f 6d 6d 61 6e 64 2e  0a 0a 20 20 20 20 54 68  |command...    Th|
00001260  69 73 20 6d 65 73 73 61  67 65 20 69 73 20 75 73  |is message is us|
00001270  65 64 20 74 6f 20 73 74  61 72 74 20 61 20 2a 63  |ed to start a *c|
00001280  6f 6d 6d 61 6e 64 20 65  78 65 63 75 74 69 6e 67  |ommand executing|
00001290  20 69 6e 20 61 20 54 61  73 6b 57 69 6e 64 6f 77  | in a TaskWindow|
000012a0  2e 0a 20 20 20 20 0a 20  20 20 20 41 20 75 6e 69  |..    .    A uni|
000012b0  71 75 65 20 68 61 6e 64  6c 65 20 69 73 20 72 65  |que handle is re|
000012c0  74 75 72 6e 65 64 20 66  6f 72 20 74 68 69 73 20  |turned for this |
000012d0  63 6f 6d 6d 61 6e 64 2e  20 54 68 69 73 20 68 61  |command. This ha|
000012e0  6e 64 6c 65 20 73 68 6f  75 6c 64 20 62 65 20 75  |ndle should be u|
000012f0  73 65 64 0a 20 20 20 20  77 68 65 6e 20 70 6f 6c  |sed.    when pol|
00001300  6c 69 6e 67 20 6f 72 20  65 6e 64 69 6e 67 20 65  |ling or ending e|
00001310  78 65 63 75 74 69 6f 6e  20 6f 66 20 74 68 65 20  |xecution of the |
00001320  63 6f 6d 6d 61 6e 64 2e  0a 0a 0a 4d 53 47 5f 41  |command....MSG_A|
00001330  52 4d 45 44 49 54 5f 4f  53 43 4c 49 5f 50 4f 4c  |RMEDIT_OSCLI_POL|
00001340  4c 0a 0a 20 20 20 20 43  6f 6e 74 69 6e 75 65 20  |L..    Continue |
00001350  65 78 65 63 75 74 69 6f  6e 20 6f 66 20 61 20 2a  |execution of a *|
00001360  63 6f 6d 6d 61 6e 64 2e  20 0a 20 20 20 20 0a 20  |command. .    . |
00001370  20 20 20 44 61 74 61 20  73 65 6e 74 3a 0a 20 20  |   Data sent:.  |
00001380  20 20 0a 20 20 20 20 20  20 20 20 4f 66 66 73 65  |  .        Offse|
00001390  74 20 20 53 69 7a 65 20  20 20 20 44 65 73 63 72  |t  Size    Descr|
000013a0  69 70 74 69 6f 6e 0a 20  20 20 20 20 20 20 20 0a  |iption.        .|
000013b0  20 20 20 20 20 20 20 20  30 20 20 20 20 20 20 20  |        0       |
000013c0  34 20 20 20 20 20 20 20  52 65 61 73 6f 6e 20 63  |4       Reason c|
000013d0  6f 64 65 20 3d 20 26 30  30 30 30 30 30 30 35 2e  |ode = &00000005.|
000013e0  0a 20 20 20 20 20 20 20  20 34 20 20 20 20 20 20  |.        4      |
000013f0  20 34 20 20 20 20 20 20  20 48 61 6e 64 6c 65 20  | 4       Handle |
00001400  6f 66 20 63 6f 6d 6d 61  6e 64 20 74 6f 20 70 6f  |of command to po|
00001410  6c 6c 2e 0a 20 20 20 20  20 20 20 20 38 20 20 20  |ll..        8   |
00001420  20 20 20 20 34 20 20 20  20 20 20 20 4e 75 6d 62  |    4       Numb|
00001430  65 72 20 6f 66 20 62 79  74 65 73 20 74 6f 20 69  |er of bytes to i|
00001440  6e 70 75 74 2e 0a 20 20  20 20 20 20 20 20 31 32  |nput..        12|
00001450  20 20 20 20 20 20 31 30  30 30 20 20 20 20 55 70  |      1000    Up|
00001460  20 74 6f 20 31 30 30 30  20 62 79 74 65 73 20 6f  | to 1000 bytes o|
00001470  66 20 69 6e 70 75 74 2e  0a 0a 20 20 20 20 44 61  |f input...    Da|
00001480  74 61 20 72 65 74 75 72  6e 65 64 3a 0a 20 20 20  |ta returned:.   |
00001490  20 0a 20 20 20 20 20 20  20 20 4f 66 66 73 65 74  | .        Offset|
000014a0  20 20 53 69 7a 65 20 20  20 20 44 65 73 63 72 69  |  Size    Descri|
000014b0  70 74 69 6f 6e 0a 20 20  20 20 20 20 20 20 0a 20  |ption.        . |
000014c0  20 20 20 20 20 20 20 30  20 20 20 20 20 20 20 34  |       0       4|
000014d0  20 20 20 20 20 20 20 52  65 61 73 6f 6e 20 63 6f  |       Reason co|
000014e0  64 65 20 3d 20 26 30 30  30 30 30 30 30 35 2e 0a  |de = &00000005..|
000014f0  20 20 20 20 20 20 20 20  34 20 20 20 20 20 20 20  |        4       |
00001500  34 20 20 20 20 20 20 20  53 74 61 74 75 73 3a 0a  |4       Status:.|
00001510  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001520  20 20 20 20 20 20 20 20  20 20 20 20 30 20 20 20  |            0   |
00001530  43 6f 6d 6d 61 6e 64 20  68 61 73 20 66 69 6e 69  |Command has fini|
00001540  73 68 65 64 2e 0a 20 20  20 20 20 20 20 20 20 20  |shed..          |
00001550  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001560  20 20 31 20 20 20 41 63  74 69 76 65 2e 0a 20 20  |  1   Active..  |
00001570  20 20 20 20 20 20 38 20  20 20 20 20 20 20 34 20  |      8       4 |
00001580  20 20 20 20 20 20 4e 75  6d 62 65 72 20 6f 66 20  |      Number of |
00001590  62 79 74 65 73 20 74 6f  20 6f 75 74 70 75 74 2e  |bytes to output.|
000015a0  0a 20 20 20 20 20 20 20  20 31 32 20 20 20 20 20  |.        12     |
000015b0  20 31 30 30 30 20 20 20  20 55 70 20 74 6f 20 31  | 1000    Up to 1|
000015c0  30 30 30 20 62 79 74 65  73 20 6f 66 20 6f 75 74  |000 bytes of out|
000015d0  70 75 74 2e 0a 0a 20 20  20 20 54 68 69 73 20 6d  |put...    This m|
000015e0  65 73 73 61 67 65 20 69  73 20 75 73 65 64 20 74  |essage is used t|
000015f0  6f 20 73 65 6e 64 20 69  6e 70 75 74 20 6f 72 20  |o send input or |
00001600  74 6f 20 72 65 63 65 69  76 65 20 61 6e 79 20 6f  |to receive any o|
00001610  75 74 70 75 74 20 66 72  6f 6d 20 61 0a 20 20 20  |utput from a.   |
00001620  20 2a 63 6f 6d 6d 61 6e  64 20 72 75 6e 6e 69 6e  | *command runnin|
00001630  67 20 69 6e 20 61 20 54  61 73 6b 57 69 6e 64 6f  |g in a TaskWindo|
00001640  77 2e 20 42 6f 74 68 20  69 6e 70 75 74 20 61 6e  |w. Both input an|
00001650  64 20 6f 75 74 70 75 74  20 69 73 20 62 75 66 66  |d output is buff|
00001660  65 72 65 64 20 61 73 0a  20 20 20 20 72 65 71 75  |ered as.    requ|
00001670  69 72 65 64 2e 0a 20 20  20 20 0a 0a 4d 53 47 5f  |ired..    ..MSG_|
00001680  41 52 4d 45 44 49 54 5f  4f 53 43 4c 49 5f 45 4e  |ARMEDIT_OSCLI_EN|
00001690  44 0a 0a 20 20 20 20 54  65 72 6d 69 6e 61 74 65  |D..    Terminate|
000016a0  20 65 78 65 63 75 74 69  6f 6e 20 6f 66 20 61 20  | execution of a |
000016b0  2a 63 6f 6d 6d 61 6e 64  2e 0a 20 20 20 20 0a 20  |*command..    . |
000016c0  20 20 20 44 61 74 61 20  73 65 6e 74 3a 0a 20 20  |   Data sent:.  |
000016d0  20 20 0a 20 20 20 20 20  20 20 20 4f 66 66 73 65  |  .        Offse|
000016e0  74 20 20 53 69 7a 65 20  20 20 20 44 65 73 63 72  |t  Size    Descr|
000016f0  69 70 74 69 6f 6e 0a 20  20 20 20 20 20 20 20 0a  |iption.        .|
00001700  20 20 20 20 20 20 20 20  30 20 20 20 20 20 20 20  |        0       |
00001710  34 20 20 20 20 20 20 20  52 65 61 73 6f 6e 20 63  |4       Reason c|
00001720  6f 64 65 20 3d 20 26 30  30 30 30 30 30 30 36 2e  |ode = &00000006.|
00001730  0a 20 20 20 20 20 20 20  20 34 20 20 20 20 20 20  |.        4      |
00001740  20 34 20 20 20 20 20 20  20 48 61 6e 64 6c 65 20  | 4       Handle |
00001750  6f 66 20 63 6f 6d 6d 61  6e 64 20 74 6f 20 74 65  |of command to te|
00001760  72 6d 69 6e 61 74 65 2e  0a 0a 20 20 20 20 44 61  |rminate...    Da|
00001770  74 61 20 72 65 74 75 72  6e 65 64 3a 0a 20 20 20  |ta returned:.   |
00001780  20 0a 20 20 20 20 20 20  20 20 4f 66 66 73 65 74  | .        Offset|
00001790  20 20 53 69 7a 65 20 20  20 20 44 65 73 63 72 69  |  Size    Descri|
000017a0  70 74 69 6f 6e 0a 20 20  20 20 20 20 20 20 0a 20  |ption.        . |
000017b0  20 20 20 20 20 20 20 30  20 20 20 20 20 20 20 34  |       0       4|
000017c0  20 20 20 20 20 20 20 52  65 61 73 6f 6e 20 63 6f  |       Reason co|
000017d0  64 65 20 3d 20 26 30 30  30 30 30 30 30 36 2e 0a  |de = &00000006..|
000017e0  0a 20 20 20 20 4b 69 6c  6c 20 74 68 65 20 54 61  |.    Kill the Ta|
000017f0  73 6b 57 69 6e 64 6f 77  20 61 73 73 6f 63 69 61  |skWindow associa|
00001800  74 65 64 20 77 69 74 68  20 74 68 65 20 73 70 65  |ted with the spe|
00001810  63 69 66 69 65 64 20 63  6f 6d 6d 61 6e 64 2e 20  |cified command. |
00001820  41 6e 79 20 70 65 6e 64  69 6e 67 0a 20 20 20 20  |Any pending.    |
00001830  69 6e 70 75 74 20 6f 72  20 6f 75 74 70 75 74 20  |input or output |
00001840  69 73 20 64 69 73 63 61  72 64 65 64 2e 0a 0a 0a  |is discarded....|
00001850  54 48 49 4e 47 53 20 54  4f 20 44 4f 0a 0a 54 68  |THINGS TO DO..Th|
00001860  65 20 66 6f 6c 6c 6f 77  69 6e 67 20 61 72 65 20  |e following are |
00001870  63 68 61 6e 67 65 73 20  74 68 61 74 20 6d 61 79  |changes that may|
00001880  20 62 65 20 6d 61 64 65  20 74 6f 20 74 68 65 20  | be made to the |
00001890  48 50 43 20 73 65 72 76  69 63 65 73 20 73 6f 6d  |HPC services som|
000018a0  65 74 69 6d 65 20 69 6e  0a 74 68 65 20 66 75 74  |etime in.the fut|
000018b0  75 72 65 2e 0a 0a 20 20  20 20 4e 6f 6e 65 20 61  |ure...    None a|
000018c0  74 20 74 68 65 20 6d 6f  6d 65 6e 74 21 0a 0a 0a  |t the moment!...|
000018d0  56 45 52 53 49 4f 4e 20  48 49 53 54 4f 52 59 0a  |VERSION HISTORY.|
000018e0  0a 30 2e 30 30 20 28 31  30 2d 53 65 70 2d 39 36  |.0.00 (10-Sep-96|
000018f0  29 20 20 20 20 4f 72 69  67 69 6e 61 6c 20 64 65  |)    Original de|
00001900  76 65 6c 6f 70 6d 65 6e  74 20 76 65 72 73 69 6f  |velopment versio|
00001910  6e 2e 0a 0a 30 2e 30 31  20 28 30 35 2d 46 65 62  |n...0.01 (05-Feb|
00001920  2d 39 37 29 20 20 20 20  43 75 72 73 6f 72 20 70  |-97)    Cursor p|
00001930  6f 73 69 74 69 6f 6e 20  69 6e 20 65 78 74 65 72  |osition in exter|
00001940  6e 61 6c 20 65 64 69 74  73 20 63 61 6e 20 62 65  |nal edits can be|
00001950  20 73 70 65 63 69 66 69  65 64 2e 0a 20 20 20 20  | specified..    |
00001960  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001970  41 64 64 65 64 20 53 61  76 65 20 41 73 20 77 69  |Added Save As wi|
00001980  6e 64 6f 77 20 73 75 70  70 6f 72 74 2e 0a 0a 31  |ndow support...1|
00001990  2e 30 33 20 28 32 31 2d  46 65 62 2d 39 37 29 20  |.03 (21-Feb-97) |
000019a0  20 20 20 46 69 72 73 74  20 6f 66 66 69 63 69 61  |   First officia|
000019b0  6c 20 72 65 6c 65 61 73  65 20 76 65 72 73 69 6f  |l release versio|
000019c0  6e 2e 0a 0a 31 2e 30 34  20 28 30 37 2d 44 65 63  |n...1.04 (07-Dec|
000019d0  2d 39 37 29 20 20 20 20  41 64 64 65 64 20 73 75  |-97)    Added su|
000019e0  70 70 6f 72 74 20 66 6f  72 20 65 78 65 63 75 74  |pport for execut|
000019f0  69 6e 67 20 61 20 63 6f  6d 6d 61 6e 64 20 69 6e  |ing a command in|
00001a00  20 61 20 54 61 73 6b 57  69 6e 64 6f 77 2e        | a TaskWindow.|
00001a0e