Contents

6.  Document History Protocol (DHST)                          Start Me Up!

 The Document History Protocol (DHST) serves to it, a global list of
the last used documents similar to the Recall menu in Texel. 
Start-Me-Up makes use of this by enabling files to be retrieved from
just one place.
To it a shorter departure the structure in C-Notation:

#define DHST_ADD 0xdadd
#define DHST_ACK 0xdade

typedef struct
{
   char *appname,
        *apppath,
        *docname,
        *docpath;
} DHSTINFO;


 Every time, if the user opens a file, it searches the application
after the Cookie 'DHST'. 
The AES-ID of the DHST Servers, informs other programs where they
should send DHST messages using the DHST_ADD message. 
The application then sends the information down to the global
DHSTINFO-structure and adds the corresponding information depending
upon:

 appname:     name of the application
              (e.g. "Texel")

 apppath:     Absolute path of the application
              (e.g. "c:\program\texel.app")

 docname:     Name of the document
              (e.g. "balmer.txl")

 docpath:     Absolute path of the document
              (e.g. "d:\Data\balmer.txl")

Then sends the DHST-Server following message:
 
 msg[0]    DHST_ADD

 msg[1]    ap_id

 msg[2]    0

 msg[3]    and

 msg[4]    Pointer on DHSTINFO-structure

 msg[5]    0

 msg[6]    0

 msg[7]    0


When an answer is received, the application sends the following
message :


 msg[0]    DHST_ACK

 msg[1]    ap_id

 msg[2]    0

 msg[3]    and

 msg[4]    Pointer on DHSTINFO-structure (how with DHST_ADD passed)

 msg[5]    0

 msg[6]    0

 msg[7]    0=error(s), else: OK