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

[Kaushal Modi]

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

--

Kaushal Modi