Jacob S. Gordon writes on Wed 28 Jan 2026 19:09:

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

In real cases, my items are exercises. Each comment is a summary of what
the exercise is about.  The bodies are not titles, but start like 'Let
$f(x)$ be a function ...'.  So your solution would not work for me.

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

Yes, "just", but so much more convenient :-)

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

I like when anything useful is documented.  Possibly in some miscellaneous
section, possibly along with all the reasons not to use it.

-- 
EOST (École et Observatoire des Sciences de la Terre) 
ITE (Institut Terre & Environnement) | [email protected]
5 rue René Descartes                 | Phone: +33 (0)3 68 85 50 44 
F-67084 Strasbourg Cedex, France     | bureau 110, ancien bât.

Reply via email to