I was looking at the docs too. I installed fedoras tcllib and there's a doctools lib, but no standalone tool to convert things. Should there be? Or where does this live?
Also, how are folks converting the templates to man and html pages? I can't see any Makefile rules, in the Tcl thread package for example. Are people just converting by hand and putting the result in CVS? I dunno about the below -- docs live in /usr/shar/doc/naviserver-x.x... I'd like to make things more standard, not less. I see the docs in two parts, the man pages, which are a technical reference, and the HOWTO stuff. Seems to me like the technical ref should be kept uptodate with the code, and the HOWTO stuff on the wiki, where people can, hopefully, update it. Pointing people in the right direction is a good idea though. How about a default start page for the installed server which focusses more on what to do next, rather than advertising? Could point to the installed html version of the docs with a file:/// reference, and the online wiki for HOWTO stuff, talk about the reference config file, and the the stats module can be enabled for introspection stuff. The current index.adp in contrib doesn't mention any docs at all... Or how t osign up to the mailing list, or how to report a bug, or how to find modules to install... On 9/4/06, Vlad Seryakov <[EMAIL PROTECTED]> wrote:
Maybe instead of solving documentation issue technically using conversion tools we can just include html pages with all we have docs into distributon, like Apache does, once installed we will copy manuals under pages so every new install will have access to docs even without writing any script. Those docs can have working examples, simple ones or complex does not matter but they will perform testing and educational tasks at the same time. I went through AOlserver site, wiki and our wiki and pieces of docs, it is spread and having this simply as html docs in one place may be easier. Just a thought inspired by thread on AOLserver mailing list:-)) -- Vlad Seryakov 571 262-8608 office [EMAIL PROTECTED] http://www.crystalballinc.com/vlad/ ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ naviserver-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/naviserver-devel
