1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
# Changelog
All noteworthy changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (as of Feb 2018)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
## [Unreleased](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.5.0...master)
_**CHANGELOG is now available with each release rather than in this file**_
### Changed
* Escape special characters in markdown anchors [#460](https://github.com/pseudomuto/protoc-gen-doc/pull/460)
* Bump go to 1.17, protoc to 3.18.1, and leverage go:embed [#461](https://github.com/pseudomuto/protoc-gen-doc/pull/461)
## [v1.5.0](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.4.1...v1.5.0)
* Add `source_relative` flag [#450](https://github.com/pseudomuto/protoc-gen-doc/pull/450)
## [v1.4.1](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.3.2...v1.4.1)
* Add support for OneOf in templates [#436](https://github.com/pseudomuto/protoc-gen-doc/pull/436)
* Note deprecated fields in HTML, Markdown, and Docbook outputs [#426](https://github.com/pseudomuto/protoc-gen-doc/pull/426)
* Tidy up modules
## [v1.3.2](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.3.1...v1.3.2) - May 7, 2020
### Changed
* Stripped unnecessary whitespace from markdown templates [#410](https://github.com/pseudomuto/protoc-gen-doc/pull/410)
* Renamed `lyft_validate` extension to `envoyproxy_validate`
[#392](https://github.com/pseudomuto/protoc-gen-doc/pull/392)
* Fixed `envoyproxy_validate` rules with slice values such as `in` and `not_in`
[#392](https://github.com/pseudomuto/protoc-gen-doc/pull/392)
## [v1.3.1](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.3.0...v1.3.1) - March 3, 2020
### Changed
* Switched from dep to go modules
## [v1.3.0](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.2.0...v1.3.0) - April 15, 2019
### Added
* Support for options and extended options in files, services, methods, enums, enum values, messages and fields [#376](https://github.com/pseudomuto/protoc-gen-doc/pull/376)
### Changed
### Fixed
## [v1.2.0](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.1.0...v1.2.0) - March 13, 2019
### Added
* Added [Sprig](https://github.com/Masterminds/sprig) functions to renderer contexts
* Added `IsMap` to `MessageField` objects indicating whether or not the field is a map field
* Added `RequestStreaming` and `ResponseStreaming` to `ServiceMethod` objects indicating whether the request and/or response are streaming. Updated the templates to add "stream" indicators to method requests and responses.
* Support for recursively adding nested enums and messages.
### Changed
* Bumped protobuf to 3.6.1 in docker container
### Fixed
* CI issue related to Regexp comparison on Golang master
* Markdown template was incorrectly links response types to request types
* Markdown template anchor tags were self-closing (invalid).
## [v1.1.0](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.0.0...v1.1.0) - March 13, 2018
### Added
* Switch to using [protokit] to handle parsing and running the plugin
* Default values are not included in the built-in templates
* Added the ability to ignore certain files by adding `:pattern[,pattern]` to `--doc_opt`
* Added `-help` and `-version` flags to the binary (e.g. `./protoc-gen-doc -help`)
### Changed
* Dev tooling, now using dep and retool
* CI setup to use go 1.10 (and master) and protoc 3.5.1
* Docker image updated to use protoc 3.5.1 as well
## Fixed
* Several issues with the documentation
* `NrBr` filter was a little too aggressive
### Removed
* The entire `parser` package (in favor of [protokit])
[protokit]: https://github.com/pseudomuto/protokit
# v1.0.0 - September 26, 2017
This is the tenth official release. (However, it's the first 1.x release!!)
**New things**
* Support for both proto2 and proto3!
* Application is now dockerized, no need to install it (unless you want to of course)
* Ported to Go and precompiled for Linux, OSX, and Windows
* Added test coverage to ensure functionality and prevent regressions
* Ignore comments starting with `@exclude`
* Added (and backfilled) CHANGELOG.md
* Added CONTRIBUTING.md
**Bug fixes**
* Message enums no longer included in file enums (#288)
* Added top-level `files` key for JSON output and _camelCased_ all fields (#289)
* Fixed issue with TOC in Markdown not nesting correctly (#293)
* No need to worry about expiring apt keys (#295)
* Extra slashes in comment prefix no longer show up in output (#298)
* Added field details for templates (#300)
* Markdown headers include new line so they render correctly (#303)
**Breaking changes**
* File-level comments are now attached to the syntax directive
* JSON fields are now _camelCased_
* Mustache templates replaced with golang templates
* Dropped direct support for PDF generation (still possible with FOP)
* `doc_out` flag removed in favor of `doc_opt`
# v0.9 - February 26, 2017
This is the ninth official release.
**changes**
* Improve installation instructions for macOS (thanks @guozheng)
* Improve installation instructions for Debian/Ubuntu (thanks @mhaberler)
* Add asciidoc.mustache example template (thanks @ArcEye)
* Don't do HTML escaping in Markdown template (thanks @sunfmin)
* Add support for JSON output
# v0.8 - February 26, 2016
This is the eight official release.
**changes**
* Add support for documenting files (#9)
* Add support for default values (#11)
* Add no-exclude flag to ignore @exclude directives (#13)
* Add support for RPC services (#14) (thanks to @murph0 !)
# v0.7 - January 7, 2016
This is the seventh official release.
**changes**
* Added support for extensions (thanks @masterzen !)
* Added Custom Templates wiki page
* Added additional distro packages for Debian 8, Ubuntu 15.04 + 15.10 and Fedora 22 + 23
# v0.6 - April 8, 2015
This is the sixth official release.
No functional changes were made, but Linux distribution package repositories are now provided for Ubuntu, Arch, Fedora
and openSUSE through the Open Build Service, and an RPM for CentOS 7 here below.
# v0.5 - December 19, 2014
This is the fifth official release.
**changes**
* Support exclusion also of enum values (accidental omission in 0.4).
# v0.4 - December 19, 2014
This is the fourth official release.
**changes**
* Updated to a newer version of qt-mustache.
* Updated Windows zip to libprotobuf/libprotoc 2.6.1.
* Added support for excluding messages/enums/fields.
# v0.3 - August 19, 2014
This is the third official release.
**changes**
* Updated to a newer version of qt-mustache which is more spec compliant.
* Added missing documentation for enums to Markdown output.
# v0.2 - August 14, 2014
This is the second official release.
* No functional changes were made, but the build system was improved.
# v0.1 - August 6, 2014
* Initial release
|
