|go ahead... be a heretic|
Need advise on documentation support tools in Perlby admiraln (Acolyte)
|on Feb 06, 2003 at 19:14 UTC||Need Help??|
admiraln has asked for the
wisdom of the Perl Monks concerning the following question:
I have a fair sized application to provide documentation and help files for.
The apps has a feature that makes every label on any form have "hover title" info and help text when you click on it. Given that I have 15 pages with 1 to 5 tabs and 4 to 40 labels I have a large task of keeping track of each of the pieces of help text.
My intent is to produce several target files from the one source file eg. Reference manuel and input file to the help system. I tried out POD on its own and I am running into problem with the number of levels of =head is limited to 4. The alternative is to use the =over =item =back features. I found was typing a lot of repeated text to structure the document and it was taking a long time to do.
I started to think about using text::autoformat to help produce pod text from an indented file. I have no experience with this module and I don't know it is even possible.
Now I am not sure what to do. While typing this question I wondered if there are any data dictionary programs that could keep the tree structure organized and allow anyone to do the input. I could write the programs to do the output.
Has anyone delt with this before.