[Top][All Lists]

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

Re: Using Org as the source format to generate org.texi

From: Joshua Branson
Subject: Re: Using Org as the source format to generate org.texi
Date: Sat, 14 Apr 2018 15:15:42 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux)

This is sooo cool!  Awesome!

P.S. Is it appropriate for me to congratulate people for their hard
effort on this list? Or should I keep my nerdy joy to myself?

Bastien <address@hidden> writes:

> Hi all,
> thanks to Thomas' initiative and Nicolas' efforts, we now have Org's
> documentation available as an .org file:
> https://code.orgmode.org/bzg/org-mode/raw/master/contrib/manual.org
> We plan to use manual.org (or org.org) as the source file for Org's
> documentation: editing Org file is easier than to edit .texi files,
> and Org's current Texinfo exporter does a very good job at producing
> an org.texi file that is equivalent to the one we have right now.
> One drawback is that we will have to backport manual changes made in
> Emacs' repo to org.texi into Org's manual.org file, but such changes
> are rare enough that we think we can handle this.
> In the long term, it would be nice to have more cli exporters for Org,
> although pandoc already does a good job at converting an .org file to
> a .texi file.
> In any case, editing such a big manual directly in Org is great and
> maybe this proof of concept will inspire other Elisp contributors to
> write their documentation directly in Org.
> Glenn suggested we'd share this with the list and I think it's a good
> idea -- in case you foresee problems that we may not have adressed.
> Thanks!

reply via email to

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