Ihor Radchenko <yanta...@posteo.net> writes:

> ...

Apologies for a late reply.  I have been sick. :(

> Also, keep in mind that syntax highlighting is experimental and that the
> texinfo manual explicitly says
>
>      Warning: Source highlighting is experimental; feedback is
>      welcomed. The syntax of HIGHLIGHT_SYNTAX is very likely to change
>      in future release.

That setting is for HTML exports only.
Currently, Org does not do that.
So, we are good.

> On the other hand, simply allowing to specify @example appears to be
> safe (I may be wrong), even if we happen to use language name that is
> not supported by the highlighter.

Yes, this is all we need:

  1. Look up BACKEND in `org-latex-src-block-backend'
  2. Look up LANG in `org-latex-BACKEND-langs'
  3. Suffix `@example' with the looked up LANG translation.

> Maybe we can move cautiously and simply refrain from overengineering the
> area until the dust settles on texinfo side. Maybe not, if they are
> serious about the feature specs.

We can safely say that:

  - Texinfo @example syntax will not change.
  - Syntax highlighting programs will not remove languages.

HIGHLIGHT_SYNTAX may change, but that is out of scope of Org.

TL;DR All stars are perfectly aligned, and we can do the right thing.

Rudy
-- 
"Genius is 1% inspiration and 99% perspiration."
--- Thomas Alva Edison, 1932

Rudolf Adamkovič <rud...@adamkovic.org> [he/him]
http://adamkovic.org

Reply via email to