Re: [O] [RFC] Official Org manual in Org! (Was: Dog food, anyone?)

[Marcin Borkowski]

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 – rather than em dashes or hyphens –
| 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 <address@hidden> 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 <address@hidden>
> Date: Sun, Dec 17, 2017 at 5:35 AM
> Subject: [O] [RFC] Dog food, anyone?
> To: Org Mode List <address@hidden>
>
>
> 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