X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sbcglobal.net; s=s1024; t=1353116776; bh=K93IboME+olWa93+ySYGWs8KkLsVHsg8P67DoYD3Mns=; h=X-Yahoo-Newman-Id:X-Yahoo-Newman-Property:X-YMail-OSG:X-Yahoo-SMTP:Received:Message-ID:Date:From:User-Agent:MIME-Version:To:Subject:References:In-Reply-To:Content-Type:Content-Transfer-Encoding; b=EqL4q8E/M+cTOpVDbRB+PU9FKvIQfsLG0eWp2G+fGnCxB3WtX8TGKvMGwFhH/YWXN5V0YWjfn7q1OjOad/JjFMbdsoHX2bdLiUHlDQ5FlMeuPh6swgBNJhaUgodG4+0UjGet8DrEHOQISZLB/t25ouuyLhpwUijidfQueb9jqwg=
X-Yahoo-Newman-Id: 428711 DOT 32128 DOT bm AT smtp111 DOT sbc DOT mail DOT bf1 DOT yahoo DOT com
X-Yahoo-Newman-Property: ymail-3
X-YMail-OSG: _W2FrFgVM1nLOVBgXld3uUJmXSsBhIP7t26y0pLzrFqiljk
 JAE8QdaambisIsgF7nC5wmrj_wZX6iiPAA1IGv_g3s5vBnYNHBORBrKqGPwR
 OWvJ.m_nslFN5XD83N6QLiBY6zN6Qvg9MEBGi_jfFU.22dMPIgox2dI2gUbN
 j1F4796rLualPGxAUaUqBxxEXdbeE2cb44yPyo71.UO4cipowSubg1WLMUF.
 5xFzUyCxW8P47WbULFAFmEW.u2PGMPshOBmZmz3HYiS9a9C0FYMjqH8jBNOv
 SKFb1fJLhtvNI0uL3DkPF66zfC36pyYfIk5Gd0.O6nFecwCkc9grBmOTvR2d
 sELZOHHvpTMm8mqdhXFsuMfuXff4nEtl3MDsgPXPqbzbaQBefvvsjaFIwYzk
 qvIXL4r4mRGvH4vS364eQ1jpsRKxwvtRMBvIv05tZzWy5fvBV4vkR3zKpDRH
 91HDnRsB8TqJLw9g31L5prvuYz0hr.EUQvp8GzDA2NseBM5LYqeFtpOw5Q10
 ZS1ypCYjnRNtqyaa2wKJZlkD7ay0yaOoRgAGAhFTgyFtJPDKxk2l2jdizYZ5
 RTkuJOpEez1Px2v7h
X-Yahoo-SMTP: f_DTt3mswBBgAkQlHvfWr7fedPivEj8lM_i1QPTGLa1z0f7XFiw-
Message-ID: <50A6EC60.9080503@sbcglobal.net>
Date: Fri, 16 Nov 2012 17:46:08 -0800
From: "Girvin R. Herr" <girvin DOT herr AT sbcglobal DOT net>
User-Agent: Thunderbird 2.0.0.24 (X11/20100228)
MIME-Version: 1.0
To: geda-user AT delorie DOT com
Subject: Re: [geda-user] libgeda documentation
References: <20121113195022 DOT 2B2CF813A49B AT turkos DOT aspodata DOT se> <50A2E0FC DOT 5050108 AT sbcglobal DOT net> <20121114090659 DOT BF2CF813A49D AT turkos DOT aspodata DOT se> <50A3FD26 DOT 5000305 AT sbcglobal DOT net> <20121115195816 DOT 29A428117B46 AT turkos DOT aspodata DOT se> <50A6A5AE DOT 506 AT sbcglobal DOT net> <20121116221659 DOT DDD8181345FC AT turkos DOT aspodata DOT se>
In-Reply-To: <20121116221659.DDD8181345FC@turkos.aspodata.se>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Reply-To: geda-user AT delorie DOT com



Karl Hammar wrote:
<snip>
>   ./configure --enable-doxygen --disable-update-xdg-database
>  make
> ...
>  make doxygen
> ... millons of lines passing by ...
>
> Two errors (the first one fixed by installing inkscape):
>  ! LaTeX Error: File `o_attrib_overview' not found.
>  sh: dot: command not found
>
> So that worked (sort of...).
>
>  cd libgeda/docs/
>  make doxygen
>
> same.
>
> What do you get if you run (in top dir.):
>   
That's when I get the

    make: *** No rule to make target `doxygen'.  Stop.

I got the same results as you did when I tried the "make doxygen" target 
in the libgeda/docs" directory.  Lots of errors and the missing "dot" 
program at least.

I just searched for the doxygen Makefile target and only found it in the 
"libgeda/docs" Makefile.  There was nothing in the "libgeda" Makefile, 
and it was defined, but not a target in the main Makefile.  That is 
probably why I got the "No Rule" message.  There seems to be a 
disconnect between the main Makefile and the libgeda/docs Makefile.  
Could that be from a "silent" test failure by configure?  I also noticed 
the other html documentation (docs/wiki) is already in html format.  The 
docs/wiki Makefile.am lists all the wiki files as data, so it is copied 
by make during the build process - no need for doxygen at build time.

<snip>
> Yes, though it seems the configure doesn't check for every programs
> needed.
>   
I would agree to that.  Since I do not have the inkscape program, that 
may be another hangup to generating these documents.  Another 
possibility is that configure is checking for the programs, but not 
reporting the errors, just continuing quietly without doing the API 
document build.
IMHO: It would seem to be a good idea that if the user specifies 
"--enable-doxygen" to configure (implying documents are required) _and_ 
the files needed to build those doxygen files are not found by 
configure, that would be grounds for a fatal configure error with a 
resulting error message!  At least display a warning message at the end 
of configure that documentation is not to be built.  I have seen that 
done also.
I see in my "configure.log" file that the search for inkscape had 
failed, but doxygen was okay. 
I also see in "configure.ac", that doxygen is implicitly checked:

    AX_OPTION_DOXYGEN

, but no other, like "dot".  Although configure seems to check for 
inkscape, it is not implicit in the "configure.ac" file.  So something 
else is going on in the background for implied dependencies.

Thanks.
Girvin Herr