automake
[Top][All Lists]
Advanced

[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











reply via email to

[Prev in Thread] Current Thread [Next in Thread]