From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Steinar Bang Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Sat, 06 Dec 2014 16:46:24 +0100 Organization: Probably a good idea Message-ID: <87tx18vl0v.fsf@dod.no> 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 1417880820 5129 80.91.229.3 (6 Dec 2014 15:47:00 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 15:47:00 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 16:46:53 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 1XxHZM-0006Ha-H3 for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 16:46:52 +0100 Original-Received: from localhost ([::1]:54799 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxHZM-0000cZ-6Z for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 10:46:52 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37021) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxHZD-0000au-Nc for emacs-devel@gnu.org; Sat, 06 Dec 2014 10:46:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxHZ7-0003Tj-Is for emacs-devel@gnu.org; Sat, 06 Dec 2014 10:46:43 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:42471) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxHZ7-0003Tf-C7 for emacs-devel@gnu.org; Sat, 06 Dec 2014 10:46:37 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1XxHZ6-0006AH-31 for emacs-devel@gnu.org; Sat, 06 Dec 2014 16:46:36 +0100 Original-Received: from cm-84.208.248.210.getinternet.no ([84.208.248.210]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 06 Dec 2014 16:46:36 +0100 Original-Received: from sb by cm-84.208.248.210.getinternet.no with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 06 Dec 2014 16:46:36 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: emacs-devel@gnu.org Original-Lines: 35 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: cm-84.208.248.210.getinternet.no Mail-Copies-To: never User-Agent: Gnus/5.130008 (Ma Gnus v0.8) Emacs/24.4 (gnu/linux) Cancel-Lock: sha1:urIH78d4C1TkU9/jSCdL2g7zAdA= 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:179184 Archived-At: >>>>> Richard Stallman : > I once looked at the documentation for Org mode, and gave up. It presented > doing things I didn't find useful. I did not see, at the beginning, how > to use it as markup for manuals. Perhaps it says that later, but I did not > get that far. The documentation for Org doesn't AFAIK explicitly say how to markup a document for manuals. But conceptually it is fairly simple: think outline-mode on steroids (ie. with added primitives for emphasis, hyperlinks, cross reference and other thing. It has quite extensive facilities for editing code examples, because it can use emacs' mode for the language of the example and also render exported code example with emacs' formatting/colouring of that language) And any sub-tree of of an Org document can be exported in a variety of formats. > * It is a program. What we need is a format. Well... in addition to being an emacs major mode, Org _is_ a format, supported by at least 4 other programs I can think of offhand (2 vim modes, and mobile-org for Android and iOS). > * The program runs only in Emacs. Even if that was true, why should that be a handicap for writing documentation for emacs...? On a side note: As another poster on this thread mentioned, org-mode has made people use emacs, that otherwise wouldn't have used emacs (they use emacs to be able to use org-mode as their notebook, timetracker, organizer etc.).