From mboxrd@z Thu Jan 1 00:00:00 1970 From: Marcin Borkowski Subject: Re: [RFC] Official Org manual in Org! (Was: Dog food, anyone?) Date: Thu, 21 Dec 2017 09:00:00 +0100 Message-ID: <87wp1go6in.fsf@mbork.pl> References: <87efntod73.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34104) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eRvmZ-000664-Kf for emacs-orgmode@gnu.org; Thu, 21 Dec 2017 03:00:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eRvmW-0005xg-Bb for emacs-orgmode@gnu.org; Thu, 21 Dec 2017 03:00:47 -0500 Received: from mail.mojserwer.eu ([195.110.48.8]:55202) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eRvmW-0005dI-0i for emacs-orgmode@gnu.org; Thu, 21 Dec 2017 03:00:44 -0500 In-reply-to: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Kaushal Modi Cc: emacs-org list Hi all, my 2 cents. 1. Now that we know that it is possible to construct a texi document from org automatically, whould it be feasible to get back to the topic of converting the Emacs manual(s) to org? Would it make sense? 2. Re: the style guide: why not ditch em-dashes altogether? Quoting Robert Brighurst: ,---- | The em dash is the nineteenth-century standard, still prescribed by | many editorial style books, but the em dash is too long for use with | the best text faces. Like the oversized space between sentences, it | belongs to the padded and corseted aesthetic of Victorian | typography. Use spaced en dashes =E2=80=93 rather than em dashes or hyphe= ns =E2=80=93 | to set off phrases. `---- In case you think this is not something of utmost importance: I quoted Bringhurst after the article http://www.denizcemonduygu.com/2009/09/where-to-use-en-and-em-dashes-lupton= -vs-bringhurst/, where this gem can be found: ,---- | The en dash between your birth and death dates on your headstone will | be representing your whole life. All your joys and sorrows, adventures | and disappointments, tucked in something slightly longer than a hyphen | and shorter than an em dash. So go on ignoring them. The dashes will | have the last word. `---- Best, Marcin On 2017-12-17, at 19:58, Kaushal Modi wrote: > Hi Nicholas, > > Thanks for taking up this humongous project. It was a dream of many like = me > to eventually read and maintain the Org manual in Org :) > > To be honest, I discarded this email by instinct by just reading the title > "Dog food, anyone?", as I assumed that email to be from my neighborhood > community, with someone giving away their extra dog food (literally).. and > I don't own dogs.. so off the email went.. to my "read bin".. :) > > It wasn't until few minutes back that I realized what this email was and > that it was actually on the Org list.. so changing the title for more > visibility. > > This arduous task shouldn't go unrecognized. > > ---------- Forwarded message --------- > From: Nicolas Goaziou > Date: Sun, Dec 17, 2017 at 5:35 AM > Subject: [O] [RFC] Dog food, anyone? > To: Org Mode List > > > Hello, > > The task started by Thomas S. Dye a couple years ago is now complete. > The "manual.org" file in "contrib/" directory is an up-to-date, > sometimes enhanced, version of the Org manual. Org can now eat its own > dog food. > > During the process, I had to re-organize some parts of the manual (e.g., > "Working with source code" section, the concept index...) and improve > the "texinfo" export back-end, which was not up to the task when Thomas > started it. > > Ultimately, this file is going to serve as the source for a new > "org.texi". IOW, it could go into "doc/" and "make info" should export > "manual.org" to "org.texi". First, however, it would be nice to review > it, either as an Org file, or within the Info viewer, with > > (require 'ox-texinfo) > > and > > `C-c C-e i o' from "manual.org". > > Note that Info output is expected to be sometimes different from the > current manual. This is not a 1:1 conversion. > > Feedback welcome! > > > Regards, > > -- > Nicolas Goaziou 0x80A93738 -- Marcin Borkowski