emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Ordered list items and the point
@ 2022-04-29 12:13 c.buhtz
  2022-04-29 14:07 ` Ihor Radchenko
  0 siblings, 1 reply; 2+ messages in thread
From: c.buhtz @ 2022-04-29 12:13 UTC (permalink / raw)
  To: Emacs orgmode

This is about https://orgmode.org/worg/dev/org-syntax.html#Plain_Lists

Comparing the syntax description and the real world behaviour of my 
Emacs 27 with org from yesterday it seems to me that the syntax 
description is not correct.

I cite "Plain Lists" section:
"If first item in a plain list has a COUNTER in its BULLET, the plain 
list will be an “ordered plain-list”."

This is not true in many ways because in the section "Items" a COUNTER 
is described as
"Either a number or a single letter (a-z)."

An ordered list item need to have a point after its digit. Correct is 
"1. item"; incorrect is "1 item". As an alternative to the "." an ")" is 
allowed also.

A letter is not a COUNTER no matter if there is an "." or ")" after it. 
An org-buffer and org-html-export-as-html does not recognize this as a 
list item.

Do I miss something? Are there any other characters that need to 
considered?


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

* Re: Ordered list items and the point
  2022-04-29 12:13 Ordered list items and the point c.buhtz
@ 2022-04-29 14:07 ` Ihor Radchenko
  0 siblings, 0 replies; 2+ messages in thread
From: Ihor Radchenko @ 2022-04-29 14:07 UTC (permalink / raw)
  To: c.buhtz; +Cc: Emacs orgmode, Timothy

c.buhtz@posteo.jp writes:

> This is about https://orgmode.org/worg/dev/org-syntax.html#Plain_Lists
>
> Comparing the syntax description and the real world behaviour of my 
> Emacs 27 with org from yesterday it seems to me that the syntax 
> description is not correct.
>
> I cite "Plain Lists" section:
> "If first item in a plain list has a COUNTER in its BULLET, the plain 
> list will be an “ordered plain-list”."

> This is not true in many ways because in the section "Items" a COUNTER 
> is described as
> "Either a number or a single letter (a-z)."

To be on the same page, I will also quote what is BULLET:

>> One of the two forms below, followed by either a whitespace character
>> or line ending.
>> - An asterisk, hyphen, or plus sign character (i.e., *, -, or +).
>> - Either the pattern COUNTER. or COUNTER).
>>   + COUNTER :: Either a number or a single letter (a-z).

> An ordered list item need to have a point after its digit. Correct is 
> "1. item"; incorrect is "1 item". As an alternative to the "." an ")" is 
> allowed also.
>
> A letter is not a COUNTER no matter if there is an "." or ")" after it. 
> An org-buffer and org-html-export-as-html does not recognize this as a 
> list item.

> Do I miss something? Are there any other characters that need to 
> considered?

The latter ("1 item") is not an item because it does not have BULLET
even though it contains COUNTER.

Again, if you can think about better way to explain ordered plain lists,
feel free to propose a patch. The fact that you were confused already
shows that the current description is not ideal.

I am also CCing Timothy as he may be interested.

Best,
Ihor


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

end of thread, other threads:[~2022-04-29 14:07 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-04-29 12:13 Ordered list items and the point c.buhtz
2022-04-29 14:07 ` Ihor Radchenko

Code repositories for project(s) associated with this 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).