[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: Kaushal Modi
Subject: [O] [RFC] Official Org manual in Org! (Was: Dog food, anyone?)
Date: Sun, 17 Dec 2017 18:58:39 +0000

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>


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)


   `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!


Nicolas Goaziou                                                0x80A93738


Kaushal Modi

reply via email to

[Prev in Thread] Current Thread [Next in Thread]