| commit | 8d5e6d6927a52dc28f60214a15fb17149b7fd803 | [log] [tgz] |
|---|---|---|
| author | Joe Tsai <joetsai@digital-static.net> | Tue Aug 06 01:15:48 2019 -0700 |
| committer | Joe Tsai <joetsai@digital-static.net> | Wed Aug 07 17:33:08 2019 +0000 |
| tree | 35c0eb291a7cb4837e9d5cdae83f9b76e76f9747 | |
| parent | 70fdd5d140c5bd6b2a9609069ecf679ecf120b25 [diff] |
cmd/protoc-gen-go: improve generation of comments The following improvements were made: * All standalone comments above the "syntax" marker are preserved similar to Java and some other generators. * All standalone comments above the "package" marker are preserved to be consistent with our former behavior. * Leading comments are now generated for enums and extension fields. * Single-line trailing comments are now generated for enum values, message fields, and extension fields. * The leading comments for each field that is part of a oneof are now generated with the wrapper types rather than being shoved into the comment for the oneof itself in an unreadable way. * The deprecation marker is always generated as being above the declaration rather than sometimes being an inlined comment. * The deprecation marker is now properly generated for weak field setters. Updates golang/protobuf#666 Change-Id: I7fd832dd4f86d15bfff70d7c22c6ba4934c05fcf Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/189238 Reviewed-by: Damien Neil <dneil@google.com>
WARNING: This repository is in active development. There are no guarantees about API stability. Breaking changes will occur until a stable release is made and announced.
This repository is for the development of the next major Go implementation of protocol buffers. This library makes breaking API changes relative to the existing Go protobuf library. Of particular note, this API aims to make protobuf reflection a first-class feature of the API and implements the protobuf ecosystem in terms of reflection.
List of relevant design documents:
We appreciate community contributions. See CONTRIBUTING.md.
Issues regarding the new API can be filed at github.com/golang/protobuf. Please use a APIv2: prefix in the title to make it clear that the issue is regarding the new API work.