From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 11720 invoked by alias); 21 Aug 2013 18:09:33 -0000 Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org Received: (qmail 11704 invoked by uid 89); 21 Aug 2013 18:09:33 -0000 X-Spam-SWARE-Status: No, score=-6.2 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,RP_MATCHES_RCVD,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.2 Received: from plane.gmane.org (HELO plane.gmane.org) (80.91.229.3) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Wed, 21 Aug 2013 18:09:32 +0000 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1VCCqW-0001ou-4y for gdb@sourceware.org; Wed, 21 Aug 2013 20:09:28 +0200 Received: from cm-84.208.248.210.getinternet.no ([84.208.248.210]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 21 Aug 2013 20:09:28 +0200 Received: from sb by cm-84.208.248.210.getinternet.no with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 21 Aug 2013 20:09:28 +0200 Mail-Followup-To: gdb@sourceware.org To: gdb@sourceware.org From: Steinar Bang Subject: Re: A new strategy for internals documentation Date: Wed, 21 Aug 2013 18:09:00 -0000 Message-ID: <87wqne9ar5.fsf@dod.no> References: <5201781A.3000607@earthlink.net> <83k3jyunt8.fsf@gnu.org> <5202A6D6.8090908@earthlink.net> Mime-Version: 1.0 Content-Type: text/plain Mail-Copies-To: never User-Agent: Gnus/5.130008 (Ma Gnus v0.8) Emacs/24.3 (gnu/linux) X-SW-Source: 2013-08/txt/msg00091.txt.bz2 >>>>> Stan Shebs : >>> *** Doxygen >>> As a second step, we should adopt Doxygen for the sources, and use it >>> to generate material for a new area of the website, which will be the >>> detailed documentation of GDB internals. >> AFAIK, Doxygen cannot generate an Info manual, only HTML. If so, this >> would be a serious downside that you don't mention. > Hmm, I'm perhaps prejudiced since I haven't looked at any info file in > probably a decade. Are many people using them still? Doxygen can generate output in Docbook XML. A quick google found me this tool that can convert Docbook to texinfo: http://docbook2x.sourceforge.net/ How well that works I have no idea. The Docbook output can be converted to a printable manual, and so can Doxygen's LaTeX output.