After downloading the s() archive, it should be unpacked. The name of
the archive is of the form tt(stealth-_CurVers_.tar.gz), where tt(_CurVers_)
is a version number. Below, tt(_CurVers_) should be altered into the version
of the archive that is actually used.

Required, non-standard software, for compiling s() is summarized in the file
tt(required), which is included in the source file distribution. Currently,
its contents are:

    verbinclude(../../../required)

    itemization(
    it() S() compilation is controlled by bf(icmake)(1). The program
maintenance utility bf(icmake)(1) can be obtained at
lurl(https://fbb-git.gitlab.io/icmake/), and it is also available in several
Linux distributions (e.g., Debian, Ubuntu);

    it() Determine a directory where the files in s()'s archive ashould be
stored. E.g., if the files in the archive should be stored under tt(/tmp)
(and assuming the archive itself is stored in tt(/tmp) as well) then do:
        verb(
    cd /tmp
    tar xzf stealth-_CurVers_.tar.gz
        )
    This creates a subdirectory tt(stealth) containing s()'s sources;

    it() Change-dir to that directory:
        verb(
    chdir stealth
        )

    it() Check the contents of the files tt(INSTALL.im) and tt(icmconf), and
verify that all tt(#defines) match your computer's file system and
software. 

    When compiling s(), the
url(bobcat)(https://fbb-git.gitlab.io/bobcat/) header files must be
available. When s() is run it is dynamically linked against the bobcat
library. bf(Bobcat) can be downloaded from 
lurl(https://gitlab.com/fbb-git/bobcat/) (and follow its installation
instructions). Alternatively, bobcat may be available in your distribution,
(e.g.,  Debian or Ubuntu). Make sure to install both the run-time
(bf(bobcat_...))  and the development (bf(bobcat-dev_...)) versions.

    it() Execute the command
        verb(
    ./build program strip
        )
    This command by default creates the
program bf(./tmp/bin/binary).

    it() To install s() and its documentation, several commands are available:
        verb(
   ./build install program [path] - installs the program as `path'
                                (by default as `/usr/bin/stealth')
   ./build install man [base]   - install the man pages below `base'
                                (by default below `/usr/share/man/man1')
   ./build install manual [base]- install the manual below `base'
                                (by default below 
                                    `/usr/share/doc/stealth-doc/manual')
   ./build install std [base]   - install standard docs below `base'
                                (by default below `/usr/share/doc/stealth')
   ./build install extra [base] - install extra docs below `base'
                                (by default below 
                                    `/usr/share/doc/stealth-doc')
        )
    )
