From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5746 invoked by alias); 13 Oct 2009 19:13:47 -0000 Received: (qmail 5735 invoked by uid 22791); 13 Oct 2009 19:13:47 -0000 X-SWARE-Spam-Status: No, hits=-2.5 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 13 Oct 2009 19:13:13 +0000 Received: from int-mx05.intmail.prod.int.phx2.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.18]) by mx1.redhat.com (8.13.8/8.13.8) with ESMTP id n9DJDAWX013848; Tue, 13 Oct 2009 15:13:10 -0400 Received: from host0.dyn.jankratochvil.net (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by int-mx05.intmail.prod.int.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id n9DJD5Z5011952 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 13 Oct 2009 15:13:09 -0400 Received: from host0.dyn.jankratochvil.net (localhost [127.0.0.1]) by host0.dyn.jankratochvil.net (8.14.3/8.14.3) with ESMTP id n9DJD4NM026477; Tue, 13 Oct 2009 21:13:04 +0200 Received: (from jkratoch@localhost) by host0.dyn.jankratochvil.net (8.14.3/8.14.3/Submit) id n9DJD1aR026471; Tue, 13 Oct 2009 21:13:01 +0200 Date: Tue, 13 Oct 2009 19:13:00 -0000 From: Jan Kratochvil To: Eli Zaretskii Cc: jeremy.bennett@embecosm.com, gdb@sourceware.org Subject: Re: Documentation generated from sources proposal Message-ID: <20091013191301.GA24733@host0.dyn.jankratochvil.net> References: <20091012161424.GA20603@host0.dyn.jankratochvil.net> <83tyy4igm2.fsf@gnu.org> <1255422217.4479.47.camel@thomas> <83ljjfi2dn.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <83ljjfi2dn.fsf@gnu.org> User-Agent: Mutt/1.5.20 (2009-08-17) X-IsSubscribed: yes 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 X-SW-Source: 2009-10/txt/msg00247.txt.bz2 On Tue, 13 Oct 2009 20:18:28 +0200, Eli Zaretskii wrote: > No, the format generated from the comments must be Texinfo. Are there some specific technical or FSF reasons? The reference manuals are normally delivered as HTML. http://library.gnome.org/devel/gtk/stable/ http://java.sun.com/javase/6/docs/api/ > 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? I freely admit a side track of my proposal was to be able to start writing the doc in a different format than texinfo. Still a .c-placed doc even in the texinfo format I find a useful improvement. Regards, Jan