This is the mail archive of the
automake@gnu.org
mailing list for the automake project.
Re: What is the correct way of handling generated docs?
- From: karl at freefriends dot org (Karl Berry)
- To: eliz at is dot elta dot co dot il
- Cc: bkorb at pacbell dot net, automake at gnu dot org, help-texinfo at gnu dot org
- Date: Sun, 30 Dec 2001 09:46:33 -0500
- Subject: Re: What is the correct way of handling generated docs?
What exactly are the reasons that you need to produce Texinfo from
some other source language, rather than maintaining them in Texinfo?
I don't know about doxygen, but javadoc has a well-developed mechanism
for maintaining the documentation for functions/classes/etc. in the
source file, and standard tools for extracting it. I didn't know there
was a way to turn that into Texinfo, but if there is, great, I think
it's worth supporting.
As for the original problem, maybe automake could have a variable
BUILT_DOCS which lists texinfo files which are created, analogous to
BUILT_SOURCES. Just an idea, not claiming it solves everything or is
easy to do ...