Page 1 of 1

CSS editing: Avoid asterisk prefix in block comment lines

Posted: Tue Jun 09, 2020 1:18 pm
by michaelmh
Hi,
most of the time I find it useful that OxygenXML automatically indents and prefixes block comments in CSS files, so that they appear like this with minimum effort:

Code: Select all

/* 
 * Text
 * next line, just after typing ENTER
 */
Now I am trying to add documentation to CSS files and want to use MarkDown inside block comments. But I find it hard to create content like this:

Code: Select all

/* 
# Heading text

New paragraph
 */
If I press ENTER at the end of a text line inside a block comment, I always get the new line prefixed with SPACE + ASTERISK + SPACE.
Is there possibly a (hidden) configuration to turn that feature off?
Thanks,
- Michael

PS: In https://sass-lang.com/documentation/syntax/comments I read the recommendation to use /// as prefix for documentation comments, but that would make it hard to copy and paste MarkDown content between files.

Re: CSS editing: Avoid asterisk prefix in block comment lines

Posted: Wed Jun 10, 2020 3:58 pm
by adrian
Hello,

Thank you for the feedback.
Unfortunately this behavior within CSS comments is hard-coded and cannot be turned off.
I've logged an improvement request on our issue tracking tool to make this behavior optional. For future reference it is issue EXM-45799. We will notify this thread when it is implemented.

Regards,
Adrian