CSS editing: Avoid asterisk prefix in block comment lines

<oXygen/> general issues.
michaelmh
Posts: 14
Joined: Tue Jan 19, 2016 5:55 pm

CSS editing: Avoid asterisk prefix in block comment lines

Post by michaelmh » Tue Jun 09, 2020 1:18 pm

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.

adrian
Posts: 2666
Joined: Tue May 17, 2005 4:01 pm

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

Post by adrian » Wed Jun 10, 2020 3:58 pm

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
Adrian Buza
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

Post Reply