Re: [PATCH] #+begin_example lang used in manual and worg (was: [DISCUSSION] Refactoring fontification system)

[Max Nikulin <manikulin@gmail.com>]

On 10/06/2022 09:06, Ihor Radchenko wrote:
> Max Nikulin writes:
> 
>> Side note: I can not say that #+begin_example with language is widely
>> used, but one case may be found in org-manual.org and a dozen in worg.
> 
> Which should probably be fixed. LANG parameter is ignored on export
> anyway. See the attached patches for WORG and emacs-manual.

Thank you for your intent to fix it.

> diff --git a/doc/org-manual.org b/doc/org-manual.org
> index 32a45f884..51aa4d77e 100644
> --- a/doc/org-manual.org
> +++ b/doc/org-manual.org
> @@ -4488,7 +4488,7 @@ ** Breaking Down Tasks into Subtasks
>  include the word =recursive= into the value of the =COOKIE_DATA=
>  property.
>  
> -#+begin_example org
> +#+begin_example
>  ,* Parent capturing statistics [2/20]
>    :PROPERTIES:
>    :COOKIE_DATA: todo recursive

It is consistent with other examples in the manual. Only one snippet is 
wrapped into "#+begin_src org" and it is a recent addition caused a long 
discussion on Shakespeare's poetry. I am curious why #+begin_src is used 
for elisp examples, but not for org markup.

For worg pages #+begin_example to #+begin_src substitution may be a 
better option than dropping language.

> --- a/org-tutorials/org-jekyll.org
> +++ b/org-tutorials/org-jekyll.org
> @@ -172,7 +172,7 @@ * Creating an org File to be Published with Jekyll
>  
>  Below is a short extract from one of my org files showing my setup:
>  
> -#+BEGIN_EXAMPLE org
> +#+BEGIN_EXAMPLE
>  #+STARTUP: showall indent
>  #+STARTUP: hidestars
>  #+BEGIN_EXPORT html

It is not the scope of this patch but looks like missed commas to escape 
leading "#".