Experimental Physics and
Industrial Control System

Ralph Lange <[email protected]> · Thu, 20 Sep 2012 11:44:25 +0200

Thanks, Andrew and Benjamin!

I ended up deciding to make the generated doc part of the sources.
Which is bad, I know, but IMHO not as bad as forcing people to have root
access and install a fat toolchain (Doxygen/LaTeX), just because they
want to look at the manual.

The regular build just installs the existing stuff, while the new make
target "doxy" creates a new version of the documentation from the source
files.

To do that I added in .../Makefile:

INSTALL_DOCS += $(INSTALL_HTML)/MCoreUtils
DOCS += MCoreUtils.pdf

[...]

$(INSTALL_DOC)/%: ../documentation/%
    $(ECHO) "Installing doc $@"
    @$(INSTALL) -d -m $(INSTALL_PERMISSIONS) $< $(INSTALL_DOC)

$(INSTALL_HTML)/%: ../documentation/%
    $(ECHO) "Installing html tree $@"
    @$(MKDIR) -p $(INSTALL_HTML)
    @$(CP) -rT $< $@
    @find $@ -type f -exec chmod $(INSTALL_PERMISSIONS) {} \;

doxy:
    @$(RMDIR) O.Common/doxy
    @$(RMDIR) documentation
    @$(MKDIR) -p documentation/MCoreUtils
    @doxygen
    @make -C O.Common/doxy/latex
    @$(CP) O.Common/doxy/latex/refman.pdf documentation/MCoreUtils.pdf
    @$(CP) -rT O.Common/doxy/html documentation/MCoreUtils

Thanks again,
~Ralph

Experimental Physics and Industrial Control System

Experimental Physics and
Industrial Control System