Spurious comma after C-c '

Spurious comma after C-c '

[Colin Baxter]

1. Use `emacs -q' and open a new org file.
2. Enter
         #+begin_example

         #+end_example
3. Place cursor in the empty line of the example block and hit C-c '
4. Enter #+STARTUP in the edit buffer and hit C-c ' to exit
5. A spurious comma appears at the beginning of #+STARTUP
6. The comma appears to form only when + is entered after #, so #STARTUP
   produces no comma. The STARTUP entry is unimportant and #+ alone also
   gives a comma.
7. I'm using Org mode version 9.3.7 (release_9.3.7-669-g3327fb)

Best wishes,

Colin.

Colin Baxter
URL: http://www.Colin-Baxter.com

Re: Spurious comma after C-c '

[Nicolas Goaziou]

Hello,

Colin Baxter <m43cap@yandex.com> writes:

> 1. Use `emacs -q' and open a new org file. 2. Enter
>
>          #+begin_example
>
>          #+end_example
>
> 3. Place cursor in the empty line of the example block and hit C-c '
> 4. Enter #+STARTUP in the edit buffer and hit C-c ' to exit
> 5. A spurious comma appears at the beginning of #+STARTUP
> 6. The comma appears to form only when + is entered after #, so #STARTUP
>    produces no comma. The STARTUP entry is unimportant and #+ alone also
>    gives a comma.
> 7. I'm using Org mode version 9.3.7 (release_9.3.7-669-g3327fb)

This is an escape character. See (info "(org) Literal Examples").

Regards,
-- 
Nicolas Goaziou

Re: Spurious comma after C-c '

[Colin Baxter]

>>>>> Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

    > Hello, Colin Baxter <m43cap@yandex.com> writes:

    >> 1. Use `emacs -q' and open a new org file. 2. Enter
    >> 
    >> #+begin_example
    >> 
    >> #+end_example
    >> 
    >> 3. Place cursor in the empty line of the example block and hit
    >> C-c ' 4. Enter #+STARTUP in the edit buffer and hit C-c ' to exit
    >> 5. A spurious comma appears at the beginning of #+STARTUP 6. The
    >> comma appears to form only when + is entered after #, so #STARTUP
    >> produces no comma. The STARTUP entry is unimportant and #+ alone
    >> also gives a comma.  7. I'm using Org mode version 9.3.7
    >> (release_9.3.7-669-g3327fb)

    > This is an escape character. See (info "(org) Literal Examples").

Well, yes. But should it really be in an "example" source block? If this
is then exported and the author hasn't caught and deleted it, then it is 
likely to cause confusion in the mind of the final reader - who may
know nothing about org-mode.

Best wishes,

 
Colin Baxter
URL: http://www.Colin-Baxter.com
---------------------------------------------------------------------
GnuPG fingerprint: 68A8 799C 0230 16E7 BF68  2A27 BBFA 2492 91F5 41C8
---------------------------------------------------------------------
The sole cause of all human misery is the inability of people to sit
quietly in their rooms.  Blaise Pascal, 1670
---------------------------------------------------------------------
Since mathematicians have invaded the theory of relativity, I do not
understand it myself. A. Einstein

Re: Spurious comma after C-c '

[Nicolas Goaziou]

Colin Baxter <m43cap@yandex.com> writes:

> Well, yes. But should it really be in an "example" source block? 

Are you asking if this comma character is needed? This particular comma
is due to Org being over-cautious, and may be ignored. But you should
simply ignore it.

> If this is then exported and the author hasn't caught and deleted it,
> then it is likely to cause confusion in the mind of the final reader -
> who may know nothing about org-mode.

When exported, Org mode removes automatically the escape-comma. The
author has nothing to do in this situation. Or do you have something
else in mind?

Re: Spurious comma after C-c '

[Colin Baxter]

>>>>> Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

    > When exported, Org mode removes automatically the
    > escape-comma. The author has nothing to do in this situation.

I now understand. I assumed the comma would export and did not check -
mea culpa.

 
Colin Baxter
URL: http://www.Colin-Baxter.com