Re: is tcl a reasonable alternative to unix shell scripts?

John Perry wrote:
Unix-style man pages suck horridly (you have to already know something
in order to look for it). Gnu info pages are not much better. But it
really does tcl/tk a terrible injustice to call its documentation
"manpages": they're written in html (http://www.tcl.tk ->
Documentation), so you can browse them effectively. They're pretty
well crosslinked, too.

Actually, the Tcl/Tk documentation is written in nroff/troff and there's
a Tcl script that converts them into HTML. Much other documentation
(e.g. for tcllib) is written using a tcllib package called doctools. In
fact, the only major documentation written directly in HTML is the
tutorial, and that's still something of a work-in-progress.

But if there's anything that you think is inadequately documented,
please let us know! We can help! We're just usually too close to the
trees to see the wood, if you know what I mean, so the perspectives (and
questions) of a newcomer are very valuable for making things better.

Donal.
.

Relevant Pages

  • Single Source Documentation Woes
    ... provide the ability to single-source user manual documentation, ... | (WAP, HTML, etc.) | ... Application Name has the following command line options: ... To make life truly entertaining, ...
    (comp.programming)
  • Re: Angband documentation project
    ... Given that my plans involve making the help external HTML files (with ... Using a wiki isn't that great for this, ... the documentation is currently distributed as, ... helpfiles are probably GPL, though that's not really that appropriate ...
    (rec.games.roguelike.angband)
  • Re: XmlTextWriter Encodes HTML Entities?
    ... Most of us and most documentation including W3C documentation define & ... drop the verbiage "HTML" when describing character entities. ... XML but not part of HTML, while ö is part of HTML but not of XML; ... use of the language. ...
    (microsoft.public.dotnet.xml)
  • urllib2.urlopen(url) pulling something other than HTML
    ... shortcoming of Python, a mistype on my part or just an inherent ... htmllib.HTMLParser so it can parse the html for links. ... I can't find any documentation to explain ... def get_page: ...
    (comp.lang.python)
  • Re: A critique of cgi.escape
    ... that the documentation doesn't say that input has to be HTML, ... output must be used as HTML. ... Also, because Python has a ... conservative policy on backwards incompatible changes, ...
    (comp.lang.python)