Skip to content

Support @macro on documentation comments #1444

Closed

Description

@gabrc52

For example, MaterialApp.color, should show

The primary color to use for the application in the operating system
interface.

For example, on Android this is the color used for the application in the
application switcher.

instead of

{@macro flutter.widgets.widgetsApp.color}

See https://github.com/dart-lang/dartdoc#macros

Activity

  1. DanTup commented on Feb 3, 2019

    @DanTup
    Member

    It's not currently possible to resolve these from the editor, though the {@macro text should at least be stripped out (see #1420). If you're still seeing the macro text in the latest version, let me know and I'll take another look.

    Long-term we need to find a better way to handle this, but there sadly isn't a quick fix.

  2. added this to the Backlog milestone on Feb 3, 2019
  3. added
    is enhancementAn enhancement or improvement that should be listed in release notes but is not a bug fix.
    in editorRelates to code editing or language features
    on Feb 3, 2019
  4. modified the milestones: Backlog, v2.26.0 on Apr 3, 2019
  5. DanTup commented on Apr 8, 2019

    @DanTup
    Member

    This has been resolved in vNext when using a new enough version of the SDKs. It's really an SDK fix, however it currently only enables with SuggestionSets, which are on by default in v2.26.

    Screenshot 2019-04-08 at 10 40 15 am (2)

    Screenshot 2019-04-08 at 10 41 01 am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    in editorRelates to code editing or language featuresis enhancementAn enhancement or improvement that should be listed in release notes but is not a bug fix.

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions