g+
g+ Communities
Argonne National Laboratory

Experimental Physics and
Industrial Control System

1994  1995  1996  1997  1998  1999  2000  2001  2002  2003  2004  2005  2006  2007  2008  2009  2010  2011  <20122013  2014  Index 1994  1995  1996  1997  1998  1999  2000  2001  2002  2003  2004  2005  2006  2007  2008  2009  2010  2011  <20122013  2014 
<== Date ==> <== Thread ==>

Subject: Re: Doxygen and EPICS build system
From: Ralph Lange <Ralph.Lange@gmx.de>
To: Benjamin Franksen <benjamin.franksen@helmholtz-berlin.de>
Cc: tech-talk@aps.anl.gov
Date: 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


References:
Doxygen and EPICS build system Ralph Lange
Re: Doxygen and EPICS build system Benjamin Franksen

Navigate by Date:
Prev: Re: Doxygen and EPICS build system Benjamin Franksen
Next: Re: Compilation error EPICS for RTEMS Bruno Seiva Martins
Index: 1994  1995  1996  1997  1998  1999  2000  2001  2002  2003  2004  2005  2006  2007  2008  2009  2010  2011  <20122013  2014 
Navigate by Thread:
Prev: Re: Doxygen and EPICS build system Benjamin Franksen
Next: CAC problem between RTEMS and vxWorks Wesley Moore
Index: 1994  1995  1996  1997  1998  1999  2000  2001  2002  2003  2004  2005  2006  2007  2008  2009  2010  2011  <20122013  2014 
ANJ, 18 Nov 2013 Valid HTML 4.01! · Home · News · About · Base · Modules · Extensions · Distributions · Download ·
· EPICSv4 · IRMIS · Talk · Bugs · Documents · Links · Licensing ·