X-Original-To: pgsql-hackers-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 827189DC83E for ; Mon, 16 Jan 2006 09:38:42 -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 55066-01 for ; Mon, 16 Jan 2006 09:38:45 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from trolak.mydnsbox2.com (ns1.mydnsbox2.com [207.44.142.118]) by postgresql.org (Postfix) with ESMTP id 187899DC810 for ; Mon, 16 Jan 2006 09:38:39 -0400 (AST) Received: from dunslane.net (localhost.localdomain [127.0.0.1]) (authenticated (0 bits)) by trolak.mydnsbox2.com (8.11.6/8.11.6) with ESMTP id k0GDvrN07311; Mon, 16 Jan 2006 07:57:53 -0600 Received: from 68.143.134.146 (SquirrelMail authenticated user andrew@dunslane.net) by www.dunslane.net with HTTP; Mon, 16 Jan 2006 07:57:53 -0600 (CST) Message-ID: <38611.68.143.134.146.1137419873.squirrel@www.dunslane.net> Date: Mon, 16 Jan 2006 07:57:53 -0600 (CST) Subject: Re: source documentation tool doxygen From: "Andrew Dunstan" To: In-Reply-To: <43CB85A8.9080001@tada.se> References: <43CB85A8.9080001@tada.se> X-Priority: 3 Importance: Normal X-MSMail-Priority: Normal Cc: , X-Mailer: SquirrelMail (version 1.2.5) MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.083 required=5 tests=[AWL=0.083] X-Spam-Score: 0.083 X-Spam-Level: X-Archive-Number: 200601/456 X-Sequence-Number: 78560 Thomas Hallgren said: > I wish I've had this when I started working with PostgreSQL. This looks > really good. Very useful indeed, even without the comments. What kind > of changes are needed in order to get the comments in? > I too have done this. But retrofitting Doxygen style comments to the PostgreSQL source code would be a big undertaking. Maintaining it, which would be another task for reviewers/committers, would also be a pain unless there were some automated checking tool. cheers andrew