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 3BB099DC84E for ; Mon, 16 Jan 2006 17:51:33 -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 47911-01 for ; Mon, 16 Jan 2006 17:51:32 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from smtp-send.myrealbox.com (smtp-send.myrealbox.com [151.155.5.143]) by postgresql.org (Postfix) with ESMTP id EC0D79DC854 for ; Mon, 16 Jan 2006 17:51:25 -0400 (AST) Received: from [172.16.1.181] grzm [61.197.227.146] by smtp-send.myrealbox.com with NetMail SMTP Agent $Revision: 1.6 $ on Linux; Mon, 16 Jan 2006 14:51:23 -0700 In-Reply-To: <10961.1137437498@sss.pgh.pa.us> References: <43CB85A8.9080001@tada.se> <38611.68.143.134.146.1137419873.squirrel@www.dunslane.net> <1137436300.9145.78.camel@localhost.localdomain> <10961.1137437498@sss.pgh.pa.us> Mime-Version: 1.0 (Apple Message framework v746.2) Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed Message-Id: Cc: Neil Conway , Andrew Dunstan , thomas@tada.se, pgsql-hackers@postgresql.org, jgardner@jonathangardner.net Content-Transfer-Encoding: 7bit From: Michael Glaesemann Subject: Re: source documentation tool doxygen Date: Tue, 17 Jan 2006 06:51:15 +0900 To: Tom Lane X-Mailer: Apple Mail (2.746.2) X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.417 required=5 tests=[AWL=0.417] X-Spam-Score: 0.417 X-Spam-Level: X-Archive-Number: 200601/492 X-Sequence-Number: 78596 On Jan 17, 2006, at 3:51 , Tom Lane wrote: > A quick look through the doxygen manual doesn't make it sound too > invasive, but I am worried about how well it will coexist with > pgindent. > It seems both tools think they can dictate the meaning of the > characters > immediately after /* of a comment block. I haven't looked at it yet, but might there not be a way to have a preprocessing step where the current comment format is converted to something doxygen-friendly? pg_indent2doxygen or something? Then the current comment style could be maintained and doxygen could get what it likes. Michael Glaesemann grzm myrealbox com