The Dockapp
===========

- left click on the dockapp in the lower left corner (white area),
  to toggle the visibility of the main application window.
- right click anywhere to hide the main application window if its visible
- middle click on the dockapp on the red PLUS-sign, to paste and append the
  current X-Selection to the download queue.

You can also DragNDrop a ftp:// or http:// URL onto the PLUS-sign,
for instance using Netscape (the current Location, or any Link)
XDND dropping not implemented YET!!!! Motif (Netscape) dropping works well

Via the ShortCut option in ~/.wmdropzone.conf you can make the dockapp
grab a key-press-combination and open up the URL List Window without
having to reach for the mouse ;)
See doc/configuration.txt for more.

The circle in the lower right of the dockapp indicates the current status.
Red means, that nothing has been downloaded yet. Green means, means that
at least one download was successfully finished. Blinking yellow tells you, 
that a download has been finished. After a few intervals the blinking stops,
turning to solid green. The color never changes back to red after being either
yellow or green.


The Main Application Window
===========================

The current download queue is displayed as a list.

You can select items using the <Up> and <Down> cursor keys or 'k' and 'j'. 
To jump to the top or bottom of the list use <Home> and <End> respectively.
The Number-Keys can be used to jump to the specified index (the first
entry has index 1); you can only quick-jump within the first 10 items.
You may change the order of the items in the list by holding down
a SHIFT-Key when pressing any of the above mentioned motion keys.
(i.e. type SHIFT-2 to make the selected item be the second in the list).

For adding items to the list the same rules apply as for the dockapp.
There are three ways to add an item to the list:
  - middle mouse button to paste the current X-Selection(ed) URL
  - DragNDrop from Netscape (or any Motif client). XDND is untested!
  - pressing CTRL-a and entering the URL manually
  - pressing CTRL-p to append the current X-Selection to the list

To remove an item after selecting it hit the 'Delete' or 'BackSpace' key.

Each item has the URL in the right-most column of the line, and three
images left of it.
The left-most image represents the current status which can be one of
  - on hold          (red ball)
  - loading          (green ball)
  - download done    ('broken' green ball :)

The 2nd image tells you about the Group the item belongs to. Possible values
are
  - Seperate Item      (solid blue ball)
  - Queue Item         (vertical red dots)

The right-most image specifies the current Mode of the item
  - Mirror             (gray wall with lines on each side)
  - Download           (gray wall with line on the right only)

You can toggle each of these values by clicking on the icons.
Be careful with the status! Clicking on the green ball abandons the download!


You may right-click the URL-String of an item to get a menu popped up.

There you get an overview if the item's properties. Additionally you
may toggle the 'mode' property of the item (see below) or request
access to further options regarding the item (for a list see below)

When downloading, a separate process is forked off which only
opens a pipe to the wget command, that handles the actual retrieval.
For each download, this procedure is followed, with every queue-download
counting as a separate one. This is necessary for each queue-download
to still have it's own properties (like Target Directory or Bandwidth limit)
But for logging, the queue is one download so that all queue-downloads
log into the same window and each separate download still has it's own
associated logwindow.

As soon as a forked off download process terminates, an entry is written to
the logfile (see configuration.txt, Option 'Logfile'). The logfile format
is: [<date>] "URL" -> "Target Directory"
Where <date> is the current localtime at the point when the download is
finished.


Item Properties
===============

Each item can have its own properties defining
  - mode             - (mirror mode, simple mode)
  - group            - (download as a member of the queue, download separately)
  - directory prefix - (where the stuff gets stored to)
  - bandwidth limit  - one can set a limit for the bandwidth usage produced
                       when downloading that item; this feature is
               particularly useful when prioritizing several
               simultaneous downloads