Re: [O] [RFC] Moving "manual.org" into core

[Nicolas Goaziou]

Hello,

Kaushal Modi <address@hidden> writes:

> I'd prefer "begin_src org". When these manuals are converted to HTML, we
> can use syntax highlighting to format comments, etc in Org snippets. I
> think it's good to retain the meta data that that is not an arbitrary block
> of text, but Org data. Can you please revert to "begin_src org"?

"manual.org" is not meant to be exported to HTML through "ox-html", but
using Texinfo itself. AFAIK, Texinfo does not highlight specially Org
syntax, so using "begin_src org" is not very important for export.

Moreover, the advantage of using "begin_example" instead is:
1. we can use fixed-width for one-liners,
2. Org fontification for source blocks can be sometimes misleading,
   as you sometimes cannot what is an example and what is not.

Regards,

-- 
Nicolas Goaziou                                                0x80A93738