emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Spurious comma after C-c '
@ 2020-07-06 10:00 Colin Baxter
  2020-07-06 10:49 ` Nicolas Goaziou
  0 siblings, 1 reply; 5+ messages in thread
From: Colin Baxter @ 2020-07-06 10:00 UTC (permalink / raw)
  To: emacs-orgmode


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



^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Spurious comma after C-c '
  2020-07-06 10:00 Spurious comma after C-c ' Colin Baxter
@ 2020-07-06 10:49 ` Nicolas Goaziou
  2020-07-06 11:53   ` Colin Baxter
  0 siblings, 1 reply; 5+ messages in thread
From: Nicolas Goaziou @ 2020-07-06 10:49 UTC (permalink / raw)
  To: Colin Baxter; +Cc: emacs-orgmode

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


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Spurious comma after C-c '
  2020-07-06 10:49 ` Nicolas Goaziou
@ 2020-07-06 11:53   ` Colin Baxter
  2020-07-06 13:59     ` Nicolas Goaziou
  0 siblings, 1 reply; 5+ messages in thread
From: Colin Baxter @ 2020-07-06 11:53 UTC (permalink / raw)
  To: emacs-orgmode

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



^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Spurious comma after C-c '
  2020-07-06 11:53   ` Colin Baxter
@ 2020-07-06 13:59     ` Nicolas Goaziou
  2020-07-06 14:24       ` Colin Baxter
  0 siblings, 1 reply; 5+ messages in thread
From: Nicolas Goaziou @ 2020-07-06 13:59 UTC (permalink / raw)
  To: Colin Baxter; +Cc: emacs-orgmode

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?


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Spurious comma after C-c '
  2020-07-06 13:59     ` Nicolas Goaziou
@ 2020-07-06 14:24       ` Colin Baxter
  0 siblings, 0 replies; 5+ messages in thread
From: Colin Baxter @ 2020-07-06 14:24 UTC (permalink / raw)
  To: emacs-orgmode

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



^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2020-07-06 14:24 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-07-06 10:00 Spurious comma after C-c ' Colin Baxter
2020-07-06 10:49 ` Nicolas Goaziou
2020-07-06 11:53   ` Colin Baxter
2020-07-06 13:59     ` Nicolas Goaziou
2020-07-06 14:24       ` Colin Baxter

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).