Re: [O] [RFC] Dog food, anyone?

[Thomas S. Dye]

Aloha Nicolas,

Nicolas Goaziou writes:
>
> 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".

I've spent a few hours with manual.org now and I like it very much.  The
info file it produces looks clean to me and it compiled without a hitch
using Org mode from the master branch.

One change that might be made globally is the use of em-dash (---) to
set off text, versus en-dash (--) between numerals, e.g. "the range of
run times is 1--5 seconds".  I've spotted several places where the
en-dash is used to set off text.  See this web site for the convention
on dashes:

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Conventions.html

I appreciate your work on the chapter "Working with source code". I
think it is a big improvement over the original. The reorganization
seems effective to me, especially the integration of "Specific header
arguments" with the structural overview you provide in the first several
sections of the chapter.  Thanks!

Attached, please find a patch with some copy editing to the introductory
section of the "Working with source code" chapter.  The patch also
includes a correction for a typo elsewhere in the manual.

Like others on the list, I'm pleased by the prospect of being able to
contribute to the Org manual by editing an Org document.  It is so much
easier for me than trying to work on org.texi!

Let me know if you have questions.

All the best,
Tom

manual-introduction.patch
Description: Edits to the introductory section of "Working with source code"

--
Thomas S. Dye
http://www.tsdye.com