From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-return-35970-listarch-gdb=sources.redhat.com@sourceware.org>
Received: (qmail 17038 invoked by alias); 13 Oct 2009 18:16:41 -0000
Received: (qmail 17029 invoked by uid 22791); 13 Oct 2009 18:16:40 -0000
X-SWARE-Spam-Status: No, hits=-1.3 required=5.0 	tests=AWL,BAYES_00,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout3.012.net.il (HELO mtaout3.012.net.il) (84.95.2.7)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 13 Oct 2009 18:16:33 +0000
Received: from conversion-daemon.i_mtaout3.012.net.il by i_mtaout3.012.net.il (HyperSendmail v2004.12) id <0KRG00600T4GTF00@i_mtaout3.012.net.il> for gdb@sourceware.org; Tue, 13 Oct 2009 20:16:29 +0200 (IST)
Received: from HOME-C4E4A596F7 ([87.70.84.229]) by i_mtaout3.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KRG004VGTFH6HQ1@i_mtaout3.012.net.il>; Tue, 13 Oct 2009 20:16:29 +0200 (IST)
Date: Tue, 13 Oct 2009 18:16:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: Documentation generated from sources proposal
In-reply-to: <1255422217.4479.47.camel@thomas>
To: jeremy.bennett@embecosm.com
Cc: jan.kratochvil@redhat.com, gdb@sourceware.org
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <83ljjfi2dn.fsf@gnu.org>
References: <20091012161424.GA20603@host0.dyn.jankratochvil.net> <83tyy4igm2.fsf@gnu.org> <1255422217.4479.47.camel@thomas>
X-IsSubscribed: yes
Mailing-List: contact gdb-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb.sourceware.org>
List-Subscribe: <mailto:gdb-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb/>
List-Post: <mailto:gdb@sourceware.org>
List-Help: <mailto:gdb-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-owner@sourceware.org
X-SW-Source: 2009-10/txt/msg00243.txt.bz2

> From: Jeremy Bennett <jeremy.bennett@embecosm.com>
> Cc: Jan Kratochvil <jan.kratochvil@redhat.com>, gdb@sourceware.org
> Date: Tue, 13 Oct 2009 09:23:37 +0100
> 
> One suggestion: gtk-doc is not that general purpose. Doxygen (as
> recommended by the gtk-doc website) might prove a more flexible
> alternative.
> 
> The one caveat is that neither of these programs can generate Texinfo,
> so generating .info files will be hard (all the other output formats,
> including man pages can be generated directly, at least by Doxygen). In
> principle it could be done (gtk-doc->docbook->texinfo->info or
> doxygen->XML->texinfo->info), but who knows what the output might end up
> like!

No, the format generated from the comments must be Texinfo.

Can't we use whatever libiberty is using (gather-doc), and format the
comments as it does?  Why do we need to switch to such drastically
different tools?