Hello All,

The Husky project documentation is far from ideal. Essentially we have only
3 reference manuals on fidoconfig, hpt and htick but there is no user
manual, not to mention a tutorial. The reference manuals list all keywords
in alphabet order while a user manual should explain how the programs can
be used. But even the existing manuals have flaws. It would be wonderful if
you could help with improving the documentation.

Here is what has to be done with the existing manuals.

1. There is 'A working sample config' in the fidoconfig manual. It is for
husky 1.4 and it is not valid for husky 1.9. So the first and most
important task is to replace it with a sample config working in husky 1.9.

2. A fidoconfig structure has to be described in general (in the fidoconfig manual).

3. 'Highly Portable Tosser keywords' and 'HTick (Husky Ticker) keywords'
lists in the fidoconfig manual should be updated to the current status.

4. Hpt manual needs 'HPT 1.9 Command Line OPTIONS and SWITCHES' section on
the analogy of such a section in the htick manual.

5. Only hpt and htick have manuals. Maybe it is worth to add one more
manual where all other utilities that usually accompany hpt and htick are
described.

The manuals can be downloaded here:
http://husky.cvs.sf.net/viewvc/husky/fidoconf/doc/fidoconfig.texi
http://husky.cvs.sf.net/viewvc/husky/hpt/doc/hpt.texi
http://husky.cvs.sf.net/viewvc/husky/htick/doc/htick.texi

All the manuals are in texinfo format and can be edited in any text editor.
GNU Texinfo manual can be found here:
https://www.gnu.org/software/texinfo/manual/texinfo/

The following commands convert manuals from texinfo to html:
makeinfo --html --no-split fidoconfig.texi
makeinfo --html --no-split hpt.texi
makeinfo --html --no-split htick.texi

Michael

... node (at) f1042 (dot) ru
--- GoldED+/LNX 1.1.5-b20100314