From mboxrd@z Thu Jan  1 00:00:00 1970
From: =?utf-8?B?xaB0xJtww6FuIE7Em21lYw==?= <stepnem@gmail.com>
Subject: Org syntax inside verbatim/literal blocks
Date: Fri, 09 Aug 2019 21:02:41 +0200
Message-ID: <87tvaqduwe.fsf_-_@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:56530)
 by lists.gnu.org with esmtp (Exim 4.86_2)
 (envelope-from <stepnem@gmail.com>) id 1hwAA1-0002HF-Jd
 for emacs-orgmode@gnu.org; Fri, 09 Aug 2019 15:02:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <stepnem@gmail.com>) id 1hwAA0-0001md-MU
 for emacs-orgmode@gnu.org; Fri, 09 Aug 2019 15:02:45 -0400
Received: from mail-wm1-x334.google.com ([2a00:1450:4864:20::334]:55774)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <stepnem@gmail.com>) id 1hwAA0-0001kE-Go
 for emacs-orgmode@gnu.org; Fri, 09 Aug 2019 15:02:44 -0400
Received: by mail-wm1-x334.google.com with SMTP id f72so6653268wmf.5
 for <emacs-orgmode@gnu.org>; Fri, 09 Aug 2019 12:02:43 -0700 (PDT)
Received: from localhost ([185.112.167.114])
 by smtp.gmail.com with ESMTPSA id t10sm2983387wru.96.2019.08.09.12.02.41
 for <emacs-orgmode@gnu.org>
 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);
 Fri, 09 Aug 2019 12:02:41 -0700 (PDT)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
 <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: emacs-orgmode@gnu.org


I notice that even inside example blocks, some strings are still parsed
as Org syntax, e.g. the asterisk becomes a bogus heading:

#+begin_example
*  _____
 \|   @ \
  |_____/
   /\ /\
#+end_example

When I enclose the text in a region and use
`org-insert-structure-template' to surround it with begin and end lines,
a comma is prepended to the asterisk automatically (doc string of
`org-escape-code-in-region' uses the word "append", which is usually
used in the sense of "add to the end", though).

But all I could find in the manual regarding "verbatim", "escaping" etc.
are sections 12.2 and 16.3, neither of which mentions comma.

I'd prefer if there were some kind of a _real_ verbatim block without
need for escaping anything, but failing that, could this matter be
clarified in the documentation?

  Thanks,

  =C5=A0t=C4=9Bp=C3=A1n