README.txt		    www.fege.net		      2026-07-16
		 _____    _____     ____    _____
		|  ___|\ |  ___|\  / ___\  |  ___|\ U
		| |\__\| | |\__\| | /\__\\ | |\__\| N
		|  _|\   |  _|\   | |/_ \  |  _|\   I
		| |\_\   | |\_\   | |_/ |\ | |\_\   X
		|_||     |_____|\  \____/| |_____|\ * N E T
		 \_\      \____\|   \___\/  \____\|

Welcome to the QAM terminal weather widget!
________________________________________________________________________
Weather information for the terminal, hence old morse request 'QAM'.

TABLE OF CONTENTS:
  1. Contents
  2. Description & system requirements
  3. How to start
  4. Documentation
  5. Copyright & Contact

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

1.: CONTENTS: WHAT IS PROVIDED WITH THIS PACKAGE?

    beyond this README.txt

    1. qam.sh weather program as a shell script for POSIX shell sh(1).

    2. DOCUMENTATION:  User manuals of the program as PDF or
		       ROFF source code:
       - qam.1       - mdoc manual page of qam.sh.
       - qam.pdf     - PDF version of the manual page of qam.sh.

    3. LICENSE agreement (gpl-2.0.txt) and a Makefile to install the
       collection on the target system or remove it from there.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

2.: DESCRIPTION and SYSTEM REQUIREMENTS:

    The provided program of this package is a shell scripts ready to run
    immediately on POSIX compatible systems.
    If desired, this suite can be installed on the system permanently by
    running the Makefile as root with make(1) as described below.  The
    same is true for uninstalling the collection.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

3.: HOW TO START:

    1. Accept the license agreement "gpl-2.0.txt" (or delete this
       package fully otherwise).

    2. Familiarise yourself with the programs and concepts by studying
       the manuals.

    3. Make sure the program is flagged as executable by running

	$ chmod a+x *.sh

       If desired, install the collection on the target system by
       running the Makefile as root with make(1) as follows:

	# make install clean

       Uninstalling could be achieved by running the Makefile as root
       again:

	# make uninstall


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

4.: DOCUMENTATION:

    For reference documentation of the program refer to the manual.
    This manual is provided in two forms:  As
      - PDF file and
      - ROFF-style manual page.  It can be viewed within the terminal
	with man(1) in the following manner:

	$ man ./qam.1

    The program includes also a builtin help about how to operate it.
    This short help can be printed out by running for example

	$ ./qam.sh -h

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

5.: COPYRIGHT & CONTACT:

    Copyright (C) 2023-26, Marc Fege.
    Internet:	https://www.fege.net/software
    E-Mail:	13mdf@fege.net

    Please refer to "gpl-2.0.txt" for details.

________________________________________________________________________

Have much fun with this software package!

Sincerely,
your Marc Fege
alias 13MDF / DN9MF.
