X-Authentication-Warning:	delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient:	geda-user AT delorie DOT com
X-Mailer:	exmh version 2.7.2 01/07/2005 (debian 1:2.7.2-18) with nmh-1.3
X-Exmh-Isig-CompType:	repl
X-Exmh-Isig-Folder:	inbox
To:	geda-user AT delorie DOT com
Subject:	Re: [geda-user] libgeda documentation
In-reply-to:	<50A6A5AE.506@sbcglobal.net>
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>
Comments:	In-reply-to "Girvin R. Herr" <girvin DOT herr AT sbcglobal DOT net>
	message dated "Fri, 16 Nov 2012 12:44:30 -0800."
Mime-Version:	1.0
Message-Id:	<20121116221659.DDD8181345FC@turkos.aspodata.se>
Date:	Fri, 16 Nov 2012 23:16:59 +0100 (CET)
From:	karl AT aspodata DOT se (Karl Hammar)
X-Virus-Scanned:	ClamAV using ClamSMTP
Reply-To:	geda-user AT delorie DOT com
Errors-To:	nobody AT delorie DOT com
X-Mailing-List:	geda-user AT delorie DOT com
X-Unsubscribes-To:	listserv AT delorie DOT com

Girvin R. Herr:
> Karl Hammar wrote:
> > Girvin Herr:
> >> Karl Hammar wrote:
...
> > You probably missed the "build" step I mentioned above.
> > To build, look for instructions in the README file (in geda top dir),
> > under (if you downloaded the .tar.gz file)
> >   
> I looked at the README regarding the source archive build, which is what 
> I am using, not the git build, and I did not find anything there 
> regarding doxygen.  No mention of any --enable-doxygen.  I checked the 
> INSTALL document and it is the standard FSF install document supplied 
> with Gnu autotools.  Nothing there.

Yes, that seems to be a documentation bug.

> > But I see now that --enable-doxygen is not documented there,
> > you have to run ./configure with the --enable-doxygen option.
> > Please rerun the configure, and then run "make doxygen"
> <snip>
> I did a full build and not seeing the referenced documents, a partial 
> build using "./configure --enable-doxygen ; make doxygen".  No change.  
> I still am not getting the libgeda documentation, just those two html 
> files that are no use to solve my thirst for information.  When I 
> entered "make doxygen", I get:
> 
>     507:$make doxygen
>     make: *** No rule to make target `doxygen'.  Stop.
> 
> However, in the Makefile.am, I see the doxygen target.  So, it seems the 
> hooks are there.  I tried to run "make doxygen" in the doc directory, 
> but it failed.

 I tried with:

 cd /Net/http
 wget -x http://geda.seul.org/devel/v1.7/1.7.2/geda-gaf-1.7.2.tar.gz
 cd ~/tmp/
 tar zxf /Net/http/geda.seul.org/devel/v1.7/1.7.2/geda-gaf-1.7.2.tar.gz 
 geda-gaf-1.7.2/
 ./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.):

$ grep -A7 ^doxygen: Makefile
doxygen:
        @for subdir in gattrib/docs gschem/docs gnetlist/docs \
          libgeda/docs gsymcheck/docs utils/docs ; do \
          (cd $$subdir; $(MAKE) doxygen) || exit 1; \
        done
#       @echo 'configure was not run with the --enable-doxygen switch.'
#       @echo 'The documentation cannot be built from the sources.'

$ grep -A9 ^doxygen: libgeda/docs/Makefile
doxygen: libgeda.dox
        @echo 'Creating doxygen documentation for libgeda...'
        -cd images && $(MAKE) images
        -cd ..
        $(DOXYGEN) libgeda.dox
        -cd latex && $(MAKE)
        -cd ..
#       @echo 'configure was not run with the --enable-doxygen switch.'
#       @echo 'The documentation cannot be built from the sources.'

$

> BTW: "--enable-doxygen" is documented in the "./configure --help" output.

Yes, though it seems the configure doesn't check for every programs
needed.

Regards,
/Karl Hammar

-----------------------------------------------------------------------
Aspö Data
Lilla Aspö 148
S-742 94 Östhammar
Sweden
+46 173 140 57

- Raw text -