Skip to content

Cannot :nodoc: def_clone macro #15356

@Blacksmoke16

Description

@Blacksmoke16

Bug Report

Somewhat related to #14039, the def_clone macro has a comment directly on the method generated by the macro. This makes it so you cannot customize the API docs for the generated method. My use case being wanting to throw a :nodoc: on it.

Easiest solution would be to remove the default comment, but could maybe do something with https://crystal-lang.org/reference/1.15/syntax_and_semantics/macros/index.html#merging-expansion-and-call-comments to only use it if there is not a doc comment on the macro call.

Metadata

Metadata

Assignees

No one assigned

    Labels

    good first issueThis is an issue suited for newcomers to become aquianted with working on the codebase.kind:bugA bug in the code. Does not apply to documentation, specs, etc.topic:tools:docs-generator

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions