Serial Tube Host 0.27
                        =====================
                         Draft Documentation


TubeHost will run on RISC OS or Windows. TubeHost.exe is a precompiled
Windows binary.

Defaults to 19,200 baud. BBC Client divides the serial clock by 16, so set
the speed to the Host speed divided by 4, ie 4800, with for instance *FX7,6
and *FX8,6.

The default configuration can be overridden by local choices.

RISC OS:
  A file 'Choices' in the same directory as TubeHost
  A file 'Choices:JGHarston.TubeHost.Choices'
Windows:
  A file 'TubeHost.ini' in the same directory as TubeHost
  A file pointed to by the Registry key:
      User\Software\J.G.Harston\TubeHost\Settings

The configuration file is a text file containing any of the following:
    baud:<speed>
    debug:<value>
    RST:<value>
    INF:<value>

for instance:
    baud:19200
    debug:-2
    RST:0
    INF:1

A BBC satisfactorily works with the Host at 19,200 baud. Although the BBC
can go up to 76,800, the maximum speed possible is 38,400 as Windows jumps
from 38,400 to 115,200.

Transmission errors start to occur with the speed at 38,400.

The debug value is a binary bitmap:
  b0 - OSBPUT, OSBGET
  b1 - RDLINE, OSWORD, OSBYTE
  b2 - File I/O

If RST is nonzero, when TubeHost starts up it sends a Client Reset command
to the client.

If INF is zero then .inf files are not created on non-RISC OS platforms.
The INF setting can be selectively turned on or off by prefixing pathnames
with :INF: or :NOINF:. The INF setting can be permanently set (until the
host is next run) by prefixing a *DIR pathname with :INF: or :NOINF:.


You are free to imlment Serial Tube Host on other platforms, and are free to
use this TubeHost code as its basis.


Update history
--------------
v0.23  - Bugfix in host OSCLI, *HELP, *GO.
v0.24  - Running executable files, OSCLI does not echo to Client.
v0.25  - *LOAD, *SAVE implemented, *RUN fixed.
v0.26  - Host personality specifiable by client.
v0.26a - gbpb8 (directory scanning) and gbpb6 (read current directory name)
         implemented on Windows.
v0.26b - FileInfo on "$" (or a path that resolves to "$", eg "^") correctly
         returns type=2.
v0.27  - *Delete also deletes any .inf file, INF configurable and selectable.
v0.27a - Null string is a Bad filename, eg LOAD "".

Bugs
----
Client: *RUN, */, *command from HostFS runs the program but fails to return.
Host:   *DELETE (notfound) doesn't return an error.
        Quoted filenames with spaces aren't scanned correctly, eg *LOAD "A B"
        fails is scanned as *LOAD "A giving a Bad string error.