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
Content-Type: text/plain; charset="utf-8"
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
Precedence: bulk

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