On Sat, 17 Dec 2005 03:30, Eric Blossom wrote:
> On Sat, Dec 17, 2005 at 12:53:01AM +1030, Berndt Josef Wulf wrote:
> > I don't understand what the fuss is all about. It takes 11m1s to build
> > all the binaries and documentation of all GNU Radio 2.6 modules supported
> > by the NetBSD packages sytem from scratch on my laptop. The time it takes
> > to generate the gnuradio-core documentation is 1m21s which is merely 10%
> > of the total time taken to rebuild GNU Radio.
> >
> > What are these people running? Sinclair Pocket PCs?  :-)
> >
> > NetBSD uses a later version of doxygen namely doxygen-1.4.5. It supports
> > many new features, has seen many bugfixes and hence creates a different
> > set of doc files. Perhaps its faster too... ;-)
>
> Some version's of doxygen in wide circulation are *really* slow.
> Also, do you have dot installed?  If so, additional time is spent
> generating graphs.  On my opteron, it takes over 7 minutes to generate the
> docs with doxygen 1.4.1 and dot 2.2.
>
> > How about a --enable-build-docs configure switch to enable users to make
> > that decision at the configuration stage?
>
> A patch to configure.ac would be welcome!
>
> Eric

How about the attached patch? It will generate the doxygen documentation only 
with --enable-doxygen=yes. Default is no doxygen docs.

cheerio Berndt
--- config/gr_doxygen.m4.orig	2005-12-17 11:43:43.000000000 +1030
+++ config/gr_doxygen.m4	2005-12-17 11:58:49.000000000 +1030
@@ -25,19 +25,21 @@
   AC_ARG_ENABLE(html-docs, [  --enable-html-docs      enable HTML generation with doxygen (yes)], [], [ enable_html_docs=yes])              
   AC_ARG_ENABLE(latex-docs, [  --enable-latex-docs     enable LaTeX doc generation with doxygen (no)], [], [ enable_latex_docs=no])
 
-  if test "x$enable_doxygen" = xno; then
-        enable_doc=no
-  else 
+  if test "x$enable_doxygen" = xyes; then
         AC_PATH_PROG(DOXYGEN, doxygen, , $PATH)
         if test x$DOXYGEN = x; then
                 if test "x$enable_doxygen" = xyes; then
                         AC_MSG_ERROR([could not find doxygen])
                 fi
                 enable_doc=no
+		generate_docs=
         else
                 enable_doc=yes
+		generate_docs=docs
                 AC_PATH_PROG(DOT, dot, , $PATH)
         fi
+  else 
+        enable_doc=no
   fi
 
   AM_CONDITIONAL(DOC, test x$enable_doc = xyes)
@@ -53,4 +55,5 @@
   AC_SUBST(enable_dot)
   AC_SUBST(enable_html_docs)
   AC_SUBST(enable_latex_docs)
+  AC_SUBST(generate_docs)
 ])
--- doc/Makefile.am.orig	2005-12-17 14:27:00.000000000 +1030
+++ doc/Makefile.am	2005-12-17 11:58:22.000000000 +1030
@@ -28,7 +28,7 @@
 
 EXTRA_DIST = 
 
-all-local: prep
+all-local: prep @generate_docs@
 doc: docs            # alias
 
 docs: prep html/index.html

Attachment: pgp9hYY0Hrm6d.pgp
Description: PGP signature

_______________________________________________
Discuss-gnuradio mailing list
Discuss-gnuradio@gnu.org
http://lists.gnu.org/mailman/listinfo/discuss-gnuradio

Reply via email to