On 2026-01-28 17:21, [email protected] wrote:
> For the following Org file:
>
> #+OPTIONS: H:0 toc:nil
> * Item 1
> ** Item 1a
> * @@comment: comment for Item 2@@
>
> Item 2
> * Item 3
> wrong: on the generated pdf file, there is no number before 'Item 2'
> while the numbers 2 and 3 are superimposed before 'Item 3'.
> it seems tied to the presence of the enumerate list in 'Item 1'
> *and* the absence of blank line after the '\end{enumerate}'
> (inserting one there saves the day.
I see the same. Removing the blank line before ‘Item 2’ fixes it, and
the problem also depends on the sub-lists before, i.e., these both
export fine:
#+OPTIONS: H:0 toc:nil
* Item 1
* @@comment: comment for Item 2@@
Item 2
* Item 3
--
#+OPTIONS: H:0 toc:nil
* Item 1
** Item 1a
* Item 2
* @@comment: comment for Item 3@@
Item 3
* Item 4
> does the above Org file violate some Org rule?
AFAICT, no. Though, is it your intent to have an empty headline with
‘Item 2’ as the body? If it’s meant as the headline then this also
avoids the problem:
* Item 2 @@comment: comment for Item 2@@
> I thus learned that (if I understand correctly what I read) there
> should not be a blank line after an \item, though it often does not
> create any problem.
> If not, then I was hoping there might be somme room for improvement
> in the export process, like suppressing the blank line before 'Item
> 2'?
+1
> I realize that '@@comment' does not appear in the manual; this feels
> wrong to me. Was it removed? It is still here, though:
> https://orgmode.org/quickstart.html
This is just the inline equivalent of a ‘comment’ export block:
#+BEGIN_EXPORT comment […] #+END_EXPORT
IMO it’s a bit of a hack since it relies on the fact that there’s no
‘comment’ export backend (which is true until you load
‘ox-only-comments’ ;P), so I’m not sure this part should be
documented.
The inline syntax is documented throughout the individual exporters
(e.g. ASCII, HTML, LaTeX), but not at a general level. I think
generalizing some of text in the ‘Quoting ASCII text’ section would be
useful earlier.
Best,
--
Jacob S. Gordon
[email protected]
Please don’t send me HTML emails or MS Office/Apple iWork documents.
https://useplaintext.email/#etiquette
https://www.fsf.org/campaigns/opendocument
