From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Joshua Branson Newsgroups: gmane.emacs.devel Subject: Re: Using Org as the source format to generate org.texi Date: Sat, 14 Apr 2018 15:15:42 -0400 Message-ID: References: <878tb5axms.fsf@bzg.fr> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1523733194 31108 195.159.176.226 (14 Apr 2018 19:13:14 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 14 Apr 2018 19:13:14 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Apr 14 21:13:10 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f7Qbm-0007yW-Eu for ged-emacs-devel@m.gmane.org; Sat, 14 Apr 2018 21:13:10 +0200 Original-Received: from localhost ([::1]:58041 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f7Qdt-0003j5-5r for ged-emacs-devel@m.gmane.org; Sat, 14 Apr 2018 15:15:21 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37818) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f7QdG-0003iN-CT for emacs-devel@gnu.org; Sat, 14 Apr 2018 15:14:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f7QdD-0000gv-51 for emacs-devel@gnu.org; Sat, 14 Apr 2018 15:14:42 -0400 Original-Received: from out3-smtp.messagingengine.com ([66.111.4.27]:54787) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1f7QdC-0000gd-Tz for emacs-devel@gnu.org; Sat, 14 Apr 2018 15:14:39 -0400 Original-Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id 3328E20E06 for ; Sat, 14 Apr 2018 15:14:38 -0400 (EDT) Original-Received: from mailfrontend2 ([10.202.2.163]) by compute6.internal (MEProxy); Sat, 14 Apr 2018 15:14:38 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= content-type:date:from:in-reply-to:message-id:mime-version :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; bh=qq9iNLZn9zTfUoPh83IGiA9JQW8Fd71ha1BVa3MnZe8=; b=KGxw3i/Q RjXceRb4FaASNkPpd8DErqMIwIkWViNX8lBpDPvfrY4fO6xtZ8J/ELoAAK3h6Wjg tI+3iyNuNaY2B/meqtGnUmGMI+rdWTJG0sXhNSBx3zxasyU6P+ikh+1kfPV6gxgA 5Sw8nNCIo/jUvaYsClG2SnLgQw/FI5sItNkvb1L8ZTERP9AyhEy4p3bMkfEZQE40 ji4SPQtRkjuaQgzGMdyDZWtQGWKvcGLnTNoTTcLGRFf82UhpK4cDz/jcVHYCEhyP 0n+5KkRz2nWTiqQ4n9cWHjuQYwzh0Hx0EtDCVJSKuarG29HrJAiimXJ0LvVPuZkc pUMBFcbpmucXFQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-sender :x-me-sender:x-sasl-enc; s=fm2; bh=qq9iNLZn9zTfUoPh83IGiA9JQW8Fd 71ha1BVa3MnZe8=; b=aOsfQJ03JbaYB+lvT16nIq1yBPZDbDBiLYTuCtc5/7Lle O1fo2ecThEyT+eUdMB887L8TZ11o7Oe8e3EOt6+HmOuVXLqfNboa8wojKabHggk/ PzyQyXAf3CHgGuRe/fPgjFft253R5V943rhN43ZtYeLtPEo7IDQbs3P7Afg0sIPK xml3ljWAJg//nJUuWckthu742y6O7DExtYherVsWoOxSR649NU7Cnuxnd4KByTR3 FM3wsZuhp0mfFJbrbAWEFrAmTBb01TzJfGpBPMHjxLSheZVJMo+X3/utgJKk3kge E8pA4uyeAvLFnAOohSBEUzsOyIVtUqjsV2YfdYdyg== X-ME-Sender: Original-Received: from parabola (unknown [72.12.201.221]) by mail.messagingengine.com (Postfix) with ESMTPA id C701410252 for ; Sat, 14 Apr 2018 15:14:37 -0400 (EDT) In-Reply-To: <878tb5axms.fsf@bzg.fr> (Bastien's message of "Tue, 06 Mar 2018 19:04:43 +0100") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 66.111.4.27 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:224609 Archived-At: This is sooo cool! Awesome! P.S. Is it appropriate for me to congratulate people for their hard effort on this list? Or should I keep my nerdy joy to myself? Bastien writes: > Hi all, > > thanks to Thomas' initiative and Nicolas' efforts, we now have Org's > documentation available as an .org file: > > https://code.orgmode.org/bzg/org-mode/raw/master/contrib/manual.org > > We plan to use manual.org (or org.org) as the source file for Org's > documentation: editing Org file is easier than to edit .texi files, > and Org's current Texinfo exporter does a very good job at producing > an org.texi file that is equivalent to the one we have right now. > > One drawback is that we will have to backport manual changes made in > Emacs' repo to org.texi into Org's manual.org file, but such changes > are rare enough that we think we can handle this. > > In the long term, it would be nice to have more cli exporters for Org, > although pandoc already does a good job at converting an .org file to > a .texi file. > > In any case, editing such a big manual directly in Org is great and > maybe this proof of concept will inspire other Elisp contributors to > write their documentation directly in Org. > > Glenn suggested we'd share this with the list and I think it's a good > idea -- in case you foresee problems that we may not have adressed. > > Thanks!