X-Original-To: pgsql-www-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id AB6DF9DC847; Mon, 16 Jan 2006 19:40:24 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 67384-10; Mon, 16 Jan 2006 19:40:23 -0400 (AST) Received: from hub.org (hub.org [200.46.204.220]) by postgresql.org (Postfix) with ESMTP id 2D1289DC87A; Mon, 16 Jan 2006 19:40:19 -0400 (AST) Received: from localhost (unknown [200.46.204.144]) by hub.org (Postfix) with ESMTP id 59ACF62C849; Mon, 16 Jan 2006 19:40:23 -0400 (AST) Received: from hub.org ([200.46.204.220]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 72602-03; Mon, 16 Jan 2006 19:40:19 -0400 (AST) Received: from ganymede.hub.org (blk-222-82-85.eastlink.ca [24.222.82.85]) by hub.org (Postfix) with ESMTP id 71D3D62C847; Mon, 16 Jan 2006 19:40:19 -0400 (AST) Received: by ganymede.hub.org (Postfix, from userid 1000) id 1542445591; Mon, 16 Jan 2006 19:40:21 -0400 (AST) Received: from localhost (localhost [127.0.0.1]) by ganymede.hub.org (Postfix) with ESMTP id 12A90453C3; Mon, 16 Jan 2006 19:40:21 -0400 (AST) Date: Mon, 16 Jan 2006 19:40:20 -0400 (AST) From: "Marc G. Fournier" X-X-Sender: scrappy@ganymede.hub.org To: Bruce Momjian cc: Joachim Wieland , pgsql-hackers@postgresql.org, jgardner@jonathangardner.net, PostgreSQL www Subject: Re: [HACKERS] source documentation tool doxygen In-Reply-To: <200601162332.k0GNW7D28523@candle.pha.pa.us> Message-ID: <20060116193856.I28752@ganymede.hub.org> References: <200601162332.k0GNW7D28523@candle.pha.pa.us> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Virus-Scanned: by amavisd-new at hub.org X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.955 required=5 tests=[AWL=0.476, DNS_FROM_RFC_ABUSE=0.479] X-Spam-Score: 0.955 X-Spam-Level: X-Archive-Number: 200601/179 X-Sequence-Number: 9367 the only question I have ... is there any way of improving that right index? Love the 'detail pages', but somehow making the right index more 'tree like' might make navigation a bit easier ... On Mon, 16 Jan 2006, Bruce Momjian wrote: > > Wow, looks great. Is that URL stable? Can we link to it from the > PostgreSQL developers page? > > http://www.postgresql.org/developer/coding > > --------------------------------------------------------------------------- > > Joachim Wieland wrote: >> I've created a browsable source tree "documentation", it's done with the >> doxygen tool. >> >> http://www.mcknight.de/pgsql-doxygen/cvshead/html/ >> >> There was a discussion about this some time ago, Jonathan Gardner proposed >> it here: >> >> http://archives.postgresql.org/pgsql-hackers/2004-03/msg00748.php >> >> quite a few people found it useful but it somehow got stuck. The reason was >> apparently that you'd have to tweak your comments in order to profit from >> it as much as possible. >> >> However I still think it's a nice-to-have among the online documentation >> and it gives people quite new to the code the possibility to easily check >> what is where defined and how... What do you think? >> >> doxygen can also produce a pdf but I haven't succeeded in doing that so far, >> pdflatex keeps bailing out. Has anybody else succeeded building this yet? >> >> >> >> Joachim >> >> -- >> Joachim Wieland joe@mcknight.de >> C/ Usandizaga 12 1?B ICQ: 37225940 >> 20002 Donostia / San Sebastian (Spain) GPG key available >> >> ---------------------------(end of broadcast)--------------------------- >> TIP 3: Have you checked our extensive FAQ? >> >> http://www.postgresql.org/docs/faq >> > > -- > Bruce Momjian | http://candle.pha.pa.us > pgman@candle.pha.pa.us | (610) 359-1001 > + If your life is a hard drive, | 13 Roberts Road > + Christ can be your backup. | Newtown Square, Pennsylvania 19073 > > ---------------------------(end of broadcast)--------------------------- > TIP 5: don't forget to increase your free space map settings > ---- Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: scrappy@hub.org Yahoo!: yscrappy ICQ: 7615664