[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: problems with TEXINFOS
From: |
Dan McMahill |
Subject: |
Re: problems with TEXINFOS |
Date: |
Sun, 26 Mar 2006 21:11:48 -0500 |
User-agent: |
Thunderbird 1.5 (Windows/20051201) |
Alexandre Duret-Lutz wrote:
"DM" == Dan McMahill <address@hidden> writes:
DM> Whats happening is that there are some dependencies for the docs
DM> which get created at build time which makes the .info files be out of date.
DM> Would it be reasonable then to wrap up the rules which generate some of
DM> these files into a maintainer-mode only section?
If you show us your setup someone might be able to suggest changes
that do not involve the infamous maintainer-mode.
The bit that I think causes the most problem is this:
.PHONY : extracted-docs
extracted-docs :
@address@hidden $(srcdir)/extract-docs $(srcdir)
@@address@hidden "Skipping documentation extraction
since you are not in maintainer-mode"
The extract-docs script extracts a .texi file from all of the .{c,h,y,l}
files in the program. We finally reached a point where it seemed much
easier to put the documentation with the sources (largely in a .y file)
and let that documentation serve both as comments for the sources and
text for a manual.
The extracted .texi file(s) is/are included with @include file.texi in
the main myprog.texi file.
The rest of the rules (that seem to lead to the problem I'm having) are:
info_TEXINFOS= myprog
myprog_TEXINFOS= @MAINTAINER_MODE_TRUE@ extracted.texi
extracted.texi : extracted-docs
-Dan