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: <50A82A9E.8040107@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> <20121116221659 DOT DDD8181345FC AT turkos DOT aspodata DOT se> <50A6EC60 DOT 9080503 AT sbcglobal DOT net> <20121117152957 DOT 894028130EDB AT turkos DOT aspodata DOT se> <50A82A9E DOT 8040107 AT sbcglobal DOT net>
Comments: In-reply-to "Girvin R. Herr" <girvin DOT herr AT sbcglobal DOT net>
   message dated "Sat, 17 Nov 2012 16:23:58 -0800."
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Message-Id: <20121118111439.E590A8134612@turkos.aspodata.se>
Date: Sun, 18 Nov 2012 12:14:39 +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 Herr:
> Karl Hammar wrote:
> > Can you tell me what source archive you downloaded so I can test for 
> > myself, or perhaps can you try the git version since I had better luck 
> > with it.
> I don't use git.  I prefer stable releases to minimize problems.  My 
> version is "geda-gaf-1.6.2.20110115".  Yes, it is old, but it works for

I have trying that version [1], and no, the top Makefile doesn't
have any doxygen target, you have to go to the libgeda/docs
(and similar) subdirectory.
 The only modules that have a doxygen makefile target are:

$ find . -name Makefile | xargs grep ^doxygen:
./gschem/docs/Makefile:doxygen: gschem.dox
./gattrib/docs/Makefile:doxygen: gattrib.dox
./libgeda/docs/Makefile:doxygen: libgeda.dox

///

To build the api doc, do as follows:

install graphviz (http://graphviz.org/) so that you have the dot
command available.

 cd libgeda/docs/images
 make images

ignore the messages: /bin/sh: inkscape: command not found

 cd ..
 make doxygen

then point your webbrowser to html/index.html, or do
xpdf latex/refman.pdf

> me and I have had no compelling reason to update.  Yet.
...

Ohh, but you can still use the git version -- just for the docs.
Give it a try with:

git clone http://git.geda-project.org/geda-gaf/
cd geda-gaf
./autogen
./configure --enable-doxygen
make
make doxygen

Good luck.
/Karl Hammar

[1] http://geda.seul.org/release/v1.6/1.6.2/geda-gaf-1.6.2.tar.gz

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