dart-lang / sdk

The Dart SDK, including the VM, dart2js, core libraries, and more.
https://dart.dev
BSD 3-Clause "New" or "Revised" License
9.94k stars 1.53k forks source link

"convert to line documentation comment" doesn't show for all dart doc comments #39317

Open ghost opened 4 years ago

ghost commented 4 years ago

@bernaferrari commented on Nov 7, 2019, 6:50 PM UTC:

I'm not sure if this is the correct place to report it, but there seems to be an issue with slash_for_doc_comments + convert to line documentation comment. Fail: image Ok: image

Fail:

/**
      Human-friendly HSL conversion utility class.
      final number must match the original"
   **/

Ok:

 /**
   * HSLuv values are ranging in [0;360], [0;100] and [0;100] and RGB in [0;1].
   * @param tuple An array containing the color's HSL values in HSLuv color space.
   * @return An array containing the resulting color's RGB coordinates.
   **/

It seems slash_for_doc_comments is tied to / / but the fix from intellij is tied to *.

This issue was moved by devoncarew from flutter/flutter-intellij#4063.

ghost commented 4 years ago

@devoncarew commented on Nov 9, 2019, 11:48 PM UTC:

I can repro this - it looks like the convert to line doc comment quick assist isn't enabled unless the doc comment is well formed - unless the comment starts with /**, ends with */, and the other lines start with *.

I assume this is a bug, as anything within /** ... */ is a dart doc comment.