From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 28649 invoked by alias); 12 Oct 2009 16:14:36 -0000 Received: (qmail 28639 invoked by uid 22791); 12 Oct 2009 16:14:35 -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; Mon, 12 Oct 2009 16:14:32 +0000 Received: from int-mx08.intmail.prod.int.phx2.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by mx1.redhat.com (8.13.8/8.13.8) with ESMTP id n9CGEVI8027878 for ; Mon, 12 Oct 2009 12:14:31 -0400 Received: from host0.dyn.jankratochvil.net (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by int-mx08.intmail.prod.int.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id n9CGEQs7019972 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 12 Oct 2009 12:14:30 -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 n9CGEPuP020734 for ; Mon, 12 Oct 2009 18:14:25 +0200 Received: (from jkratoch@localhost) by host0.dyn.jankratochvil.net (8.14.3/8.14.3/Submit) id n9CGEOBH020733 for gdb@sourceware.org; Mon, 12 Oct 2009 18:14:24 +0200 Date: Mon, 12 Oct 2009 16:14:00 -0000 From: Jan Kratochvil To: gdb@sourceware.org Subject: Documentation generated from sources proposal Message-ID: <20091012161424.GA20603@host0.dyn.jankratochvil.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline 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/msg00208.txt.bz2 Hi, currently there is gdb/doc/gdbint.texinfo referencing gdb/ sources functions and duplicating various comments in the gdb/*.c sources. At the same time the gdb/doc/gdbint.texinfo content is obsolete and one usually misses it when dealing with the sources. May the GDB project start using some tool to format documentation from the sources? One could move the appropriate parts of gdb/doc/gdbint.texinfo into gdb/*.c along the patches being submitted, keeping in gdb/doc/gdbint.texinfo only the abstract parts in the future. This proposal was already discussed in the past. Vote from me for gtk-doc, its plus is that it is a part of GNU project GTK. Thanks, Jan