>> The use of inline comments instead of block comments within lists is >> documented in http://www.methods.co.nz/asciidoc/userguide.html#X64. >> >> Since line comments can be exposed by the showcomments attribute and >> both types are passed through to the docbook backend, arbitrary >> deletion isn't appropriate. > > Hmmm, I have a few 'comments' about that :)
Then according to you I should ignore them :-D > > - I still think that the behaviour is very disturbing, even when > documented > > - I wonder why comments need to go to the backend, because I do not > expect comments to be processed and translated to a back-end comment > > (In fact, I was expecting comments to not appear in the final output, > they may contain confidential or private information !) Then don't put them in. Comments (<remarks> in docbook speak) are envisioned by the docbook creators to be used for editorial purposes such as input from reviewers, etc. The decision on them appearing in the final output, eg PDF is determined by the docbook toolchain, usually by options. It is not an Asciidoc decision. > > - I could not find any information about inline comments in the AsciiDoc > document or what effect it has, could you elaborate ? >From User Guide 18.3.2 "Comment lines have been implemented as both block and inline macros so a comment line can appear as a stand-alone block or within block elements that support inline macro expansion". Cheers Lex -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.
