[email protected] writes: > Christian Moe writes on Thu 29 Jan 2026 15:45: > > > > I realize that '@@comment' does not appear in the manual; > > > It's also in the FAQ: > > https://orgmode.org/worg/org-faq.html#inline-comments > > > Fair enough. And thanks. I thus learned about the even better > @@c: a_comment@@ syntax. I don't spontaneously go to the FAQ to find > documentation and don't see a problem in duplicating information in the FAQ > and in the manual anyway, and, since I cannot appreciate Jacob's earlier > mention that perhaps this shouldn't be documented, I would advocate > inserting something like > > Inline comments are also possible @@comment: like this@@ or even @@c: > like that@@. > > in the '13.6 Comment Lines' section of the manual, after > > Likewise, regions surrounded by ‘#+BEGIN_COMMENT’ ... ‘#+END_COMMENT’ > are not exported. > > The title "Comment Lines" would then perhaps better be just "Comments" > ('Lines' already did not feel optimal to me with respect to the ‘COMMENT’ > keyword at the beginning of an entry).
The topic about inline comments has been raised several times. Maybe we should document this in the manual. Using non-existing export snippet is kind of a hack though. Maybe we need a dedicated syntax for inline comments? -- Ihor Radchenko // yantar92, Org mode maintainer, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
