Nicolas Goaziou writes: > Hello, > > Christian Wittern writes: > >> Hmm. In my book, the concept of comments implies that they should be >> able to appear on any line in the text, without altering the meaning >> of the context it appears in. So to me, it would seem necessary to >> treat comments as special, different from other elements. > > I don't think comments make much sense anywhere in Org (e.g., in an > example block or in a source block). Also Org has no inline comment > syntax (and I don't think it needs one: it is no programming language). > So comments do not really fit in paragraphs. > When Org-mode is used as a document preparation language inline comments are very useful. The use case being notes on the surrounding material which are not to be published. Both HTML and LaTeX support comments and at least in LaTeX they are extensively used (in my experience) and can be very helpful. > > Last, but not least, it is also easier to parse it that way. > Stripping lines starting with "^ *#[^+]" is a trivial pre-processing step, and would support the traditional Org-mode comments which (as I recall) could previously appear mid paragraph without causing problems. > > Now, if you want to improve comments anyway, you can always provide > patches. There's some non-trivial work involved, though. > The attached patch worked on some small example files for me.