Opened 12 years ago

Closed 12 years ago

#501 closed enhancement (fixed)

doxygen should only read header files that will be installed

Reported by: Peter Owned by: Peter
Priority: major Milestone: yat 0.6
Component: build Version: trunk
Keywords: Cc:

Description (last modified by Peter)

documentation_test fails because I have a stray header file. That would not happen if solved this ticket.

Change History (3)

comment:1 Changed 12 years ago by Jari Häkkinen

Milestone: yat 0.x+yat 0.6

comment:2 Changed 12 years ago by Peter

Description: modified (diff)
Status: newassigned

fixed spelling

comment:3 Changed 12 years ago by Peter

Resolution: fixed
Status: assignedclosed

(In [1905]) Revised make dependencies for generating doxygen docs (fixes #438 and #501).

In doxygen.config removed variables INPUT and FILE_PATTERN to avoid us from editing these values. The variables ignored in the new setup.

doc/Makefile includes a 'doxygen.mk' located in each of the directories with header files. This is similar to how Maefiles include files from '.deps/' to get dependencies for source and header files. The inclusion relies on an undocumented feature in Automake, but it should likely not be a problem with future versions of Automake as it has been frequently been mentioned as a solution on the automake mailing list.

These 'doxygen.mk' are generated during 'make all' in each of these directories; they are also updated during 'make {doc|html|dvi|ps|pdf}' in topdir and topdir/yat. This latter is to avoid situations in which doc/Makefile is corrupted because of missing include.

This implies that obscure things like make clean && cd doc && make doc will fail noisily.

One could let doc/Makefile go into yat/subdirs and create the doxygen.mk files but I don't like that kind of setup.

Another thought might be to have doxygen.mk removed during 'make distclean' rather than 'make clean'. Thoughts are welcome.

Note: See TracTickets for help on using tickets.