@DATABASE "Default"
@NODE "MAIN" "DNet clients with GUI"
@NEXT "Overview"
@TOC "MAIN"
Graphical clients for DNet
==========================

    @{"Overview" LINK "Overview"}
    @{"Requirements" LINK "Requirements"}
    @{"Installation" LINK "Installation"}
    @{"Commandline Options" LINK "CommandlineOptions"}
    @{"Copyright" LINK "Copyright"}


© Tommi Johtela 1994


@ENDNODE

@NODE "Overview" "Overview"
@NEXT "Requirements"
@PREV "MAIN"
@TOC "MAIN"
What are they?
==============

This archive contains three classic @{"DNet" LINK "Requirements"} client programs with revised outlook
and GadTools based GUI. Also new command line options have been added. All
windows and requesters are font sensitive, of course.

@{"GGet" LINK "GGet"}    is basically old getfiles downloader with the exception that it
        opens a window showing the name and size of the file being
        transferred. Also the mandatory progress indicator bar is drawn.

@{"GPut" LINK "GPut"}    looks similar to @{"GGet" LINK "GGet"} but is used to upload files (e.g. is a putfiles
        clone).

@{"DLoad" LINK "DLoad"}   is a XLoad-stylish remote load monitor. Replaces old LoadAv.


@ENDNODE

@NODE "Requirements" "Requirements"
@NEXT "Installation"
@PREV "Overview"
@TOC "MAIN"
Requirements
============

Obviously you need a DNet installed before you can use these programs. At
least version 37 of Kickstart is also required. Clients should run with all
versions of DNet, but I have tested them only with old 2.20 version which I
prefer to use (untill someone writes a STABLE version of DNet not using the
massive ixemul.library or anything else unnecessary). The programs are
compiled with DICE and GUIs created with GadToolsBox, so no extra libraries
or utilities are needed.
  Clients can be run from CLI only. When run from Workbench programs simply
exit doing nothing. If you want to start clients from icon, write a shell-
script and use IconX or ARexx.


@ENDNODE

@NODE "Installation" "Installation"
@NEXT "CommandlineOptions"
@PREV "Requirements"
@TOC "MAIN"
Installation
============

Just copy the programs where the other DNet clients are.


@ENDNODE

@NODE "CommandlineOptions" "Commandline Options"
@NEXT "GGet"
@PREV "Requirements"
@TOC "MAIN"
Commandline Options
===================

There are several keywords in the commandline which are recognized.
Common switches applying to all programs include:

N=NET           Specifies the network ID (doesn't work in fact, but is
                included for compatibility reasons).
PS=PUBSCREEN    Specifies the name of public screen on which the client opens.


Follow the appropriate links for the client specific keywords.

    @{"GGet" LINK "GGet"}
    @{"GPut" LINK "GPut"}
    @{"DLoad" LINK "DLoad"}


@ENDNODE

@NODE "GGet" "GGet"
@NEXT "GPut"
@PREV "CommandlineOptions"
@TOC "MAIN"
GGet
----
F=FILES Specifies the remote files/directories to be downloaded. This keyword
        is optional (means you don't have to write it since all the words in
        the commandline not belonging to another option are assumed to be
        file/directory names).
D=DIR   Specifies the local directory to hold the downloaded files.
L=LEFT  The x-coordinate of the upper left corner of the window.
T=TOP   The y-coordinate of the upper left corner of the window.
B=BUF   Specifies the size of the input buffer in bytes (default 4096).
C=CONT  When this keyword is present GGet downloads only the files/directories
        or even the parts of files which doesn't already exist in the local
        directory . Useful when transfer is continued after error or
        interruption.

Examples:
    GGet FILES foo.c foo.h DIR ram: BUF 1024
    GGet foodir T=0 L=300 CONT PS=MyScreen


@ENDNODE

@NODE "GPut" "GPut"
@NEXT "DLoad"
@PREV "GGet"
@TOC "MAIN"
GPut
----
F=FILES Specifies the local files/directories to be uploaded. This keyword
        is optional (see above).
D=DIR   Specifies the remote directory to hold the files.
L=LEFT  The x-coordinate of the upper left corner of the window.
T=TOP   The y-coordinate of the upper left corner of the window.
B=BUF   Specifies the size of the ouput buffer in bytes (default 1024).

Examples:
    GPut FILES ram:foo.c ram:foo.h DIR /tmp/mydir BUF=1024
    GPut T 0 L 300 S:


@ENDNODE

@NODE "DLoad" "DLoad"
@NEXT "Copyright"
@PREV "GPut"
@TOC "MAIN"
DLoad
-----
G=GEOMETRY  Specifies the size and location of the DLoad window. The format
            is "top/left/width/height". Default is 484/0/80/44.
P=PENS      Specifies the pen numbers used to render the window. The format
            is "backgroundpen/foregroundpen/textpen/gridpen". Default is
            0/3/1/2.
PR=PERIOD   Specifies the frequency in seconds in which the graph is updated.
            Default is 60 seconds.
ML=MAXLOAD  Specifies the scale of the load window. E.g. the amount of load
            (from 1 to 100) in the top edge of the window. Default is 20.
GS=GRIDSTEP Specifies the scale of the horizontal grid in the load window
            (same units as above). If smaller or equal to MAXLOAD no grid
            is drawn at all. Default is 5.

Examples:
    DLoad GEOMETRY 0/16/80/80 PERIOD=40 MAXLOAD=10 GRIDSTEP=2
    DLoad G=480/0/160/80 P=1/3/2/0 PR 10 PS MyScreen


@ENDNODE

@NODE "Copyright" "Copyright"
@PREV "DLoad"
@TOC "MAIN"
Copyright
=========

These programs are, like DNet, freely distributable. You may do whatever you
want with them. And as usually, I take no responsibility for any damages
caused directly or indirectly by them.
  The source is not included because it is not exactly a model example of how
to write nice little DNet clients. Rather a mixture of Matt's old code and a
sourcecode produced by GadToolsBox spiced with my own modifications. So don't
ask me for it ;-). If you want to contact me, drop a mail at the following
address:

    Tommi Johtela
    tjohtela@polaris.utu.fi
@ENDNODE