Allow documenting SassDoc comments.

[jgerigmeyer]

This is related to #428 -- and really stems from CDocParser, used by scss-comment-parser, (see issued filed there: FWeinb/CDocParser#16) -- but relates to a SassDoc use-case, so I wanted to document it here as well.

Within a SassDoc comment, I would like to document how to make a SassDoc comment. For example:

/// Here is how to add a comment:
/// /// I am a comment.

Right now, CDocParser strips to to just:

Here is how to add a comment:
I am a comment.

Instead of the desired:

Here is how to add a comment:
/// I am a comment.

Is there a good way to do this? Could there be an option to mark a section of text as "escaped", so it won't be parsed as a comment? Or enforce only one comment per line?

[jgerigmeyer]

I think I've found a way to address this in CDocParser without breaking other use-cases: FWeinb/CDocParser#17

[steffenpedersen]

Hi @jgerigmeyer, is this still an issue? I can see, that you made some changes in CDocParser 😃

[jgerigmeyer]

@steffenpedersen Well, sort of and also not really. :)

It's been fixed in CDocParser v0.15.0, but SassDoc (through scss-comment-parser) is still using the older v0.13.0, where this is not fixed. I don't fully understand why (I've been using SassDoc with CDocParser v0.15.0 for nearly a year without issue), but see @pascalduez's comment: FWeinb/CDocParser#16 (comment)

[pascalduez]

Because 0.14 enables a new feature that we would prefer to get documented and unit tested. Otherwise it might get lost in limbo :) Will try to find some time to get this done.