___     ___   ___     ___   ___________
            |   |   |   | |   |   |   | |           |
            |   |   |   | |   |___|   | |    _______|
            |   |   |   | |           | |   |
            |   |___|   | |    ___    | |   |_______
            |           | |   |   |   | |           |
            |___________| |___|   |___| |___________|

                        -=[ UHC TOOLS ]=-

 This is a collection of programs and scripts for Amiga computers and their
 offsprings to simplify daily usage and make the Amiga more independent.

 How to install:
 ---------------
 - Run the included Installer, this package includes the minimum required
   files to get an installation going, the rest of the package will be
   downloaded over the internet.

 The following programs and scripts are currently included in the package.

 Programs:
 ---------
 aget            - A small and performant HTTP/HTTPS/Gemini download tool.
 AskMore         - Asks a question and saves the answer in local env.
 BreakForEach    - Used by ForEachLine.
 EndForEach      - Used by ForEachLine.
 FlushDevice     - Flushes cached writes to a device.
 ForEachLine     - Loop over each line of a file in a script.
 ModifyPath      - String manipulator that can get parts of a given path.
 NoClick         - Minimal noclick-program that disables the clicking noise
                   on all floppydrives in a system.
 Reboot          - Reboots the computer.
 SetResult       - Sets $RC and optionally $Result2 (IoErr) to given values.
 sntp            - NTP/SNTP time sync utility.
 SetFromCmd      - Set env from output of command. The command result is
                   returned to $RC, which regular "Set + backticks" won't do.
 StackSize       - Prints the stack size in a format usable in scripts.
 SynergyClient   - Control mouse and keyboard from another computer.
 TCPBlock        - Connects to a host socket and only reads data when you
                   press enter, causing the other side to block
 TCPEcho         - Echoes data to a host socket and displays the response if
                   present.
 TCPRec          - Like TCPEcho but in reverse.
 TCPSend         - Send data to a host socket.
 time            - Very small time measurement utility.
 TypeLine        - Types out a specific line-number from a textfile.
 UHCSearch       - Master program used by the search scripts.
 UTF8Echo        - Converts a ISO-8859-1 string to UTF-8 and echoes it to
                   STDOUT.


 Scripts:
 --------
 bootablerad     - Prepares RAD: with an empty floppyimage with a bootblock.
 checkifsys      - Checks if a Volume/Device is SYS: or not.
 detectos        - A script that tries to figure out if it's running under
                   AmigaOS3, AmigaOS4, MorphOS or AROS.
 dirs            - Displays directory stack.
 drawertoadf     - Makes a floppy of all files in a drawer (directory).
 extracttag      - Can extract text from tags in markup-language files.
 formatpath      - Similiar to ModifyPath but uses LFORMAT-like syntax.
 head            - Reads the first few lines of a text-file.
 help            - Help-system, same as uhchelp.
 installdeps     - Downloads and installs 68020 versions of programs a few
                   scripts rely on.
 popd            - Retrieves the newest directory from the stack.
 posttoslack     - Post a message to a Slack messageboard.
 pushd           - Pushes current dir to the directory stack.
 tail            - Reads the last few lines of a text-file.
 uhccheck        - Checks if a new version of UHCTools is available.
 uhcextract      - Masterscript for extract-scripts.
 uhcget          - Masterscript for get-scripts.
 uhchelp         - Help-system, same as help.
 uhchtmlreadme   - Masterscript for extracting readmes from HTML-files.
 uhcmirrorget    - Masterscript for downloading files using a mirror list.
 uhcmirrorsearch - Master script for searching using UHCSearch and mirror
                   list.
 uhcrecent       - Masterscript for displaying recent files.
 uhcresultpath   - Masterscript used by get/readme/extract scripts.
 uhcstatus       - Shows all UHC-related ENV-variables.
 uhctextreadme   - Masterscript for text readmes.
 uhctoggle       - Toggles UHC-related ENV-variables that have two states.
 uhcupdate       - Updates UHC Tools to the latest version.
 unpack          - Can unpack various archives by checking the file extension
                   of the archive and launch the apropriate unpacking-tool.


 Search-scripts:
 ---------------
 Aminet:
   aminetextract     - Downloads and extracts a file from Aminet.
   aminetget         - Downloads a file from Aminet.
   aminetreadme      - Downloads and views a readme from Aminet.
   aminetrecent      - Displays recent Aminet-files.
   aminetsearch      - Searches Aminet for files.

 AROS Archives:
   arosextract       - Downloads and extracts a file from AROS Archives.
   arosget           - Downloads a file from AROS Archives.
   arosreadme        - Downloads and views a readme from AROS Archives.
   arosrecent        - Displays recent AROS Archives files.
   arossearch        - Searches AROS Archives for files.

 MorphOS Storage:
   mosstorageextract - Downloads and extracts a file from MorphOS Storage.
   mosstorageget     - Downloads a file from MorphOS Storage.
   mosstoragereadme  - Downloads and views a readme from MorphOS Storage.
   mosstoragerecent  - Displays recent MorphOS Storage files.
   mosstoragesearch  - Searches MorphOS Storage for files.

 OS4 Depot:
   depotextract      - Downloads and extracts a file from OS4 Depot.
   depotget          - Downloads a file from OS4 Depot
   depotreadme       - Downloads and views a readme from OS4 Depot.
   depotrecent       - Displays recent OS4 Depot files.
   depotsearch       - Searches OS4 Depot for files.

 WHDLoad:
   whdextract        - Downloads and extracts a file from www.whdload.de
   whdget            - Downloads a file from www.whdload.de
   whdreadme         - Downloads and views a readme from www.whdload.de.
   whdrecent         - Displays recent www.whdload.de files.
   whdsearch         - Searches www.whdload.de for files.

 WHDownload:
   whdownextract     - Downloads and extracts a file from WHDownload.
   whdownget         - Downloads a file from WHDownload.
   whdownsearch      - Search WHDownload for files.

 amigascne.org:
   scneextract       - Downloads and extracts a file from amigascne.org.
   scneget           - Downloads a file from amigascne.org.
   scnesearch        - Search amigascne.org for demo files.

 Modland:
   modlandget        - Downloads a file from Modland.
   modlandsearch     - Search Modland for modules.

 Fred Fish Disc collection:
   fishextract       - Downloads and extracts a file from the Fred Fish Disk
                       collection.
   fishget           - Downloads a file from the Fred Fish Disk collection.
   fishreadme        - Downloads and views a readme from the Fred Fish Disk
                       collection.
   fishsearch        - Searches the Fred Fish Disk collection for files.

 asciiarena:
   asciiarenaextract - Downloads and extracts a file from asciiarena.
   asciiarenaget     - Downloads a file from asciiarena.
   asciiarenasearch  - Searches asciiarena for files.
   asciiarenareview  - Downloads and views a file from asciiarena.

 modules.pl:
   modulesextract    - Downloads and extracts a file from modules.pl.
   modulesget        - Downloads a file from modules.pl.
   modulessearch     - Searches modules.pl for files.

 Mirror list:
 ------------
 http://uhc.megaburken.net/
 gemini://uhc.megaburken.net/
 http://uhc.driar.se/
 gemini://uhc.driar.se/
 http://uhc.a1k.org/

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Aug 24  2021 UHCTools/
-rwxr-xr-x  1000/1000      774    1746  44.3% -lh5- 07b8 Aug 24  2021 UHCTools/Installation
-rw-r--r--  1000/1000      253     686  36.9% -lh5- ad27 Jun  6  2018 UHCTools/Installation.info
-rw-r--r--  1000/1000     2594    8014  32.4% -lh5- 1375 Sep 17 21:42 UHCTools/ReadMe
-rw-r--r--  1000/1000      215     464  46.3% -lh5- 6650 Oct  7  2017 UHCTools/ReadMe.info
-rwxr-xr-x  1000/1000    12387   25688  48.2% -lh5- ab9d Sep 17 17:03 UHCTools/aget.aros-i386
-rwxr-xr-x  1000/1000    11090   24904  44.5% -lh5- 7815 Sep 17 17:03 UHCTools/aget.mos
-rwxr-xr-x  1000/1000     9481   16368  57.9% -lh5- 0555 Sep 17 17:03 UHCTools/aget.os3
-rwxr-xr-x  1000/1000    11142   23932  46.6% -lh5- 2579 Sep 17 17:03 UHCTools/aget.os4
-rw-r--r--  1000/1000      266     628  42.4% -lh5- 058a Oct  7  2017 UHCTools.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        10 files   48202  102430  47.1%            Sep 18 03:33