Asciidoctor :: Discussion

Block comments are not intuitive for programmers

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

4 messages Options

rockyallen

Block comments are not intuitive for programmers

This does not work as I expected, the B is still shown:

= Title

== Section 1
|====
|Col 1
|A
////
|B
////
|C
|====

It seems to be because //// is implemented as a type of block, not a programming style comment marker. Is there a reason for this? It seems more natural to me that //// should be able to exclude arbitrary chunks of content.

mojavelinux

Re: Block comments are not intuitive for programmers

Administrator

Actually, I would describe this as a bug. Those lines should be filtered out. AsciiDoc Python happens to have the same bug, but I agree with you that it is not the behavior I expect.

Block-level comments fall somewhere between a preprocessor directive and a delimited block (very similar to document-level attribute entries). They are consumed by the line reader. This is important because we don't want to impact lines inside of a verbatim context such as a listing or literal block. However, within a table, I'd say that they should be filtered out.

Could you file an issue?

Thanks!

-Dan

On Mon, Jan 25, 2016 at 1:44 AM, rockyallen [via Asciidoctor :: Discussion] <[hidden email]> wrote:

This does not work as I expected, the B is still shown:

= Title

== Section 1
|====
|Col 1
|A
////
|B
////
|C
|====

It seems to be because //// is implemented as a type of block, not a programming style comment marker. Is there a reason for this? It seems more natural to me that //// should be able to exclude arbitrary chunks of content.

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Block-comments-are-not-intuitive-for-programmers-tp4228.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen

rockyallen

Re: Block comments are not intuitive for programmers

In reply to this post by rockyallen

See https://github.com/asciidoctor/asciidoctor/issues/1681

mojavelinux

Re: Block comments are not intuitive for programmers

Administrator

Thanks rocky!

-Dan

On Tue, Jan 26, 2016 at 12:03 PM, rockyallen [via Asciidoctor :: Discussion] <[hidden email]> wrote:

See https://github.com/asciidoctor/asciidoctor/issues/1681

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Block-comments-are-not-intuitive-for-programmers-tp4228p4235.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen