> if you are interested in my perspective - scrap the HTML documentation > and fix the manpage. The reference manual - i.e. the manpage - is > really important: when you use some software regularly, you use the > reference manual all your life. Catering to the experienced user
> is most important because whoever is serious about using the software > will become experienced sooner rather than later. So the reference > manual (manpage) must be concise, precise, and correct. ... > This is not rocket science and nothing new - just do it... +10 Software that inherently defies concise description is suspect on its face. In all likelihood it was built by accumulation way beyond the bounds of any organizing principles that the author(s) may have had at the outset. Doug
