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

[Ihor Radchenko <yantar92@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 331 bytes --]

Max Nikulin <manikulin@gmail.com> 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.

Best,
Ihor


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-org-manual-Fix-example-block-with-unsupported-langua.patch --]
[-- Type: text/x-patch, Size: 940 bytes --]

From 1f5419fb4c249d6e53940ff16e27e16da55c5dbc Mon Sep 17 00:00:00 2001
Message-Id: <1f5419fb4c249d6e53940ff16e27e16da55c5dbc.1654826607.git.yantar92@gmail.com>
From: Ihor Radchenko <yantar92@gmail.com>
Date: Fri, 10 Jun 2022 10:02:51 +0800
Subject: [PATCH] org-manual: Fix example block with unsupported language name
 parameter

* doc/org-manual.org (Breaking Down Tasks into Subtasks): Remove
unsupported LANG parameter from #+begin_example LANG.
---
 doc/org-manual.org | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

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
-- 
2.35.1


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #3: 0001-Fix-example-blocks-with-unsupported-language-name-pa.patch --]
[-- Type: text/x-patch, Size: 4254 bytes --]

From 4a43d570b5424dadfda74996bddc4982aadafe37 Mon Sep 17 00:00:00 2001
Message-Id: <4a43d570b5424dadfda74996bddc4982aadafe37.1654826554.git.yantar92@gmail.com>
From: Ihor Radchenko <yantar92@gmail.com>
Date: Fri, 10 Jun 2022 10:01:10 +0800
Subject: [PATCH] Fix example blocks with unsupported language name parameter

* org-contrib/babel/languages/ob-doc-shell.org (Requirements and Setup):
* org-hacks.org (Reschedule agenda items to today with a single command):
* org-tutorials/org-jekyll.org (Creating an org File to be Published with Jekyll):
(Showing Blog Posts on the Front Page):
(Creating Archive Pages):
(Inserting Image):
(Using Text Markup in Front Matte): Remove LANG in #+begin_example LANG.
---
 org-contrib/babel/languages/ob-doc-shell.org |  2 +-
 org-hacks.org                                |  2 +-
 org-tutorials/org-jekyll.org                 | 16 ++++++++--------
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/org-contrib/babel/languages/ob-doc-shell.org b/org-contrib/babel/languages/ob-doc-shell.org
index 730f63d7..e7d728b3 100644
--- a/org-contrib/babel/languages/ob-doc-shell.org
+++ b/org-contrib/babel/languages/ob-doc-shell.org
@@ -179,7 +179,7 @@ * Requirements and Setup
 2. The Org Babel language facility must be set to load shell
    functionality[fn:5]:
 
-    #+begin_example emacs-lisp
+    #+begin_example
     ;; active Babel languages
     (org-babel-do-load-languages
     'org-babel-load-languages
diff --git a/org-hacks.org b/org-hacks.org
index 968e511d..d446de9b 100644
--- a/org-hacks.org
+++ b/org-hacks.org
@@ -2196,7 +2196,7 @@ *** Reschedule agenda items to today with a single command
 #+index: Agenda!Reschedule
 This was suggested by Carsten in reply to David Abrahams:
 
-#+begin_example emacs-lisp
+#+begin_example
 (defun org-agenda-reschedule-to-today ()
   (interactive)
   (flet ((org-read-date (&rest rest) (current-time)))
diff --git a/org-tutorials/org-jekyll.org b/org-tutorials/org-jekyll.org
index 4da2d5ad..a0c57991 100644
--- 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
@@ -254,7 +254,7 @@ ** Showing Blog Posts on the Front Page
 Most blogs show the latest posts on their front page. The example
 below shows the title and an excerpt for the five latest posts:
 
-#+BEGIN_EXAMPLE html
+#+BEGIN_EXAMPLE
 <ul class="posts">
 {% for post in site.posts limit: 5 %}
   <div class="post_info">
@@ -274,7 +274,7 @@ ** Creating Archive Pages
 available. You can create a simple list of all blog posts using the
 following markup:
 
-#+begin_example html
+#+begin_example
 <ul>
   {% for post in site.posts %}
   <li>
@@ -295,7 +295,7 @@ * Inserting Image
 You will probably want to insert some images into your blog posts. I
 use the following method:
 
-#+BEGIN_EXAMPLE html
+#+BEGIN_EXAMPLE
 <img src ="/images/skiddaw.jpg"
 alt="John and Ella on Skiddaw" align="left" width="300" height="250"
 title="John and Ella on Skiddaw" class="img"</img>
@@ -304,7 +304,7 @@ * Inserting Image
 Note that the class attribute refers to the class used to style the
 image tag in your css. My css contains:
 
-#+BEGIN_EXAMPLE css
+#+BEGIN_EXAMPLE
 img {
     margin: 15px;
     border: 1px solid blue;
@@ -323,7 +323,7 @@ * Inserting Image
 
 In your =.org= file use the following html to embed the picture:
 
-#+BEGIN_EXAMPLE html
+#+BEGIN_EXAMPLE
 <div class="photofloatr">
   <p><img src="myphoto.jpg" width="300"
     height="150" alt="My Mug Shot"></p>
@@ -333,7 +333,7 @@ * Inserting Image
 
 Now you need to add some information to your style sheet:
 
-#+BEGIN_EXAMPLE css
+#+BEGIN_EXAMPLE
 div.photofloatr {
     float: right;
     border: thin silver solid;
@@ -362,7 +362,7 @@ * Using Text Markup in Front Matte
 I use this to format my page excerpts, which I include in my org files
 Front Matter markup. So in my sites index.html I have:
 
-#+begin_example html
+#+begin_example
 <li>
   <a href="{{ post.url }}">{{ post.title }}</a>
   <span>({{ post.date | date:"%Y-%m-%d" }})</span>
-- 
2.35.1