Skip to content

protoc-gen-go: add doc comment to String method to explain its output isn't stable #1332

Open
@meling

Description

@meling

Is your feature request related to a problem? Please describe.

I wrote code as part of an Example style test that used the generated String() method, forgetting about issue #1121. While it shouldn't have taken me long to figure out this, it did! (I was focused on trying to understand the code that caused instability, and didn't read the doc comment on the Format() method, until much too late.)

Describe the solution you'd like

It would help if a doc comment had surfaced this from the generated messages' String() methods.

// String returns the message as a string.
// This method is only intended for human consumption and ignores errors.
// Do not depend on the output being stable. It may change over time across
// different versions of the program.

I guess the doc comment could be written more briefly if the number of comment lines is a concern.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions