From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Achim Gratz Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Sat, 06 Dec 2014 13:35:18 +0100 Organization: Linux Private Site Message-ID: <87oarh9cs9.fsf@Gertrud.fritz.box> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87wq66ufyt.fsf@wanadoo.es> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417869369 1533 80.91.229.3 (6 Dec 2014 12:36:09 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 12:36:09 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 13:36:02 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XxEag-00023A-Er for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 13:36:02 +0100 Original-Received: from localhost ([::1]:54227 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxEag-0007uK-1O for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 07:36:02 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60396) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxEaJ-0007uC-IV for emacs-devel@gnu.org; Sat, 06 Dec 2014 07:35:45 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxEaD-0006OJ-WD for emacs-devel@gnu.org; Sat, 06 Dec 2014 07:35:39 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:36407) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxEaD-0006O0-F8 for emacs-devel@gnu.org; Sat, 06 Dec 2014 07:35:33 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1XxEaB-0001p4-5u for emacs-devel@gnu.org; Sat, 06 Dec 2014 13:35:31 +0100 Original-Received: from p54b7e982.dip0.t-ipconnect.de ([84.183.233.130]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 06 Dec 2014 13:35:31 +0100 Original-Received: from Stromeko by p54b7e982.dip0.t-ipconnect.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 06 Dec 2014 13:35:31 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 54 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: p54b7e982.dip0.t-ipconnect.de User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) Cancel-Lock: sha1:GLSlnXvl8C16B4IgqyVQor4Nfvs= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179168 Archived-At: Richard Stallman writes: > I could consider Org mode as a way of formatting manuals if I saw > documentation presenting Org mode _as_ a way to format manuals. Org mode can be used to format whole manuals, but it has many other uses and its user base is very diverse in how they apply Org to their documents and workflows. Documentation for specific workflows or uses is usally initiated by Org users and , but none have been forthcoming for formatting of manuals so far (it's been discussed briefly on the Org mailing list a few times, though). If you'd like me to, I could ask on the Org mailing list if anybody would want to have a go at it. > However, it would still have two big drawbacks as a candidate for GNU > documentation. > > * It is a program. What we need is a format. Org has been a format for a while, just one that wasn't formally defined. However, that is being worked on by Nicolas Goaziou and the next major release is intended to make the switch to a formally defined format and a reference implementation in eLisp. The draft version of that specification is here: http://orgmode.org/worg/dev/org-syntax.html Feedback specifically directed at that definition should go to the Org mailing list. > * The program runs only in Emacs. There are a small number of programs and web applications that support or use the Org format (or approximations thereof) for various things. With the format soon having a more formal definition this situation should improve further one would hope. > Texinfo is a format and you can use any editor to write that format. That is true for Org as well. You might lose some of the amenities that Emacs delivers for easier navigation and editing shortcuts, but it is quite possible to edit Org outside Emacs or even generate it programmatically. > I don't want to take a step back on either of these points. You wouldn't need to, unless I misunderstood what you are after. Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ SD adaptations for KORG EX-800 and Poly-800MkII V0.9: http://Synth.Stromeko.net/Downloads.html#KorgSDada