From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Georg Brandl Newsgroups: gmane.emacs.devel Subject: Re: Using Git to manage your Emacs changes Date: Sun, 25 Apr 2010 18:47:07 +0200 Message-ID: References: <87aaswaf2t.fsf@lifelogs.com> <4A1FFF2C-5794-4D58-B26B-07CD7FC0BB74@gmail.com> <83d3xs4jw5.fsf@gnu.org> <87hbn2a7fk.fsf@mail.jurta.org> <877hnwj2ft.fsf@notengoamigos.org> <87vdbghcgy.fsf@notengoamigos.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1272214221 22626 80.91.229.12 (25 Apr 2010 16:50:21 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 25 Apr 2010 16:50:21 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Apr 25 18:50:20 2010 connect(): No such file or directory Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1O652B-0001Yp-NC for ged-emacs-devel@m.gmane.org; Sun, 25 Apr 2010 18:50:20 +0200 Original-Received: from localhost ([127.0.0.1]:37255 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1O652B-0006xt-6b for ged-emacs-devel@m.gmane.org; Sun, 25 Apr 2010 12:50:19 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1O6526-0006xi-Ea for emacs-devel@gnu.org; Sun, 25 Apr 2010 12:50:14 -0400 Original-Received: from [140.186.70.92] (port=38383 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1O6525-0006xR-5E for emacs-devel@gnu.org; Sun, 25 Apr 2010 12:50:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1O651z-00042r-Dd for emacs-devel@gnu.org; Sun, 25 Apr 2010 12:50:12 -0400 Original-Received: from lo.gmane.org ([80.91.229.12]:50737) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O651z-00042a-0e for emacs-devel@gnu.org; Sun, 25 Apr 2010 12:50:07 -0400 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1O651v-0001TA-Ky for emacs-devel@gnu.org; Sun, 25 Apr 2010 18:50:03 +0200 Original-Received: from dslb-084-057-022-031.pools.arcor-ip.net ([84.57.22.31]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 25 Apr 2010 18:50:03 +0200 Original-Received: from g.brandl by dslb-084-057-022-031.pools.arcor-ip.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 25 Apr 2010 18:50:03 +0200 X-Injected-Via-Gmane: http://gmane.org/ connect(): No such file or directory Original-Lines: 48 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: dslb-084-057-022-031.pools.arcor-ip.net User-Agent: Mozilla/5.0 (X11; U; Linux i686; de; rv:1.8.1.23) Gecko/20090913 Thunderbird/2.0.0.23 Mnenhy/0.7.5.0 In-Reply-To: <87vdbghcgy.fsf@notengoamigos.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:124197 Archived-At: Am 24.04.2010 21:33, schrieb Jason Earl: >> Does it really matter that much? I am certain that their are other >> parts of the GNU system (like, perhaps, TeX), where the hackers in >> question don't follow GNU policies. In fact, Bazaar doesn't >> completely follow GNU policies (no texinfo documentation, and no >> real plans to generate it either). >> >> While TeX is part of the GNU system, it is not part of the GNU >> project. I hope that bazaar will adpot texinfo manuals soon, I think >> someone was working on that. > > Bazaar has this marked as a bug (wishlist), but they are essentially > waiting for someone to come up with a way to make texinfo documentation > from their existing rst documentation. In fact, it could easily be > argued that they are moving farther away from texinfo as they have moved > from simply requiring docutils to requiring the more complicated sphinx > documentation build system. As the Sphinx maintainer and at the same time avid Emacs user, I feel I have to chime in here. I wouldn't say that using Sphinx is moving farther away from texinfo. As far as I know, there is no docutils writer for texinfo right now. Most of the work of supporting Texinfo as a Sphinx output format would be required for docutils as well, i.e. the conversion from a node tree to Texinfo markup. Additional overhead is only necessary for Sphinx' custom nodes, and for determining how to interpret cross-references and how to map the multi-file structure of a Sphinx project to the output. This is simply stuff that isn't supported by "plain" docutils but has to be supported by Texinfo, so the mapping shouldn't be hard. > On the bright side, if someone could modify Sphinx to generate texinfo > then I would get my Python documentation back in texinfo format as well. I'm absolutely not opposed to supporting Texinfo. Anyone who wants to take this on will have my support, but as with many feature requests, I do not have the time to do it myself. Georg -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out.