Merge pull request #426 from jacobtolar/mark-fields-deprecated

Note deprecated fields in HTML and Markdown outputs

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.3.2...master)
 
+* Note deprecated fields in HTML, Markdown, and Docbook outputs [#426](https://github.com/pseudomuto/protoc-gen-doc/pull/426)
+
 ## [v1.3.2](https://github.com/pseudomuto/protoc-gen-doc/compare/v1.3.1...v1.3.2) - May 7, 2020
 
 ### Changed

examples/doc/example.docbook

@@ -62,6 +62,13 @@
               <entry><para>Has payment been received?</para></entry>
             </row>
 
+            <row>
+              <entry>color_preference</entry>
+              <entry><link linkend="string">string</link></entry>
+              <entry></entry>
+              <entry><emphasis>Deprecated.</emphasis><para>Color preference of the customer.</para></entry>
+            </row>
+
           </tbody>
         </tgroup>
       </table>

examples/doc/example.html

@@ -315,10 +315,38 @@ <h3 id="com.example.Booking">Booking</h3>
                   <td><p>Has payment been received? </p></td>
                 </tr>
 
+                <tr>
+                  <td>color_preference</td>
+                  <td><a href="#string">string</a></td>
+                  <td></td>
+                  <td><p><strong>Deprecated.</strong> Color preference of the customer. </p></td>
+                </tr>
+
             </tbody>
           </table>
 
 
+
+
+            <h4>Fields with deprecated option</h4>
+            <table>
+              <thead>
+                <tr>
+                  <td>Name</td>
+                  <td>Option</td>
+                </tr>
+              </thead>
+              <tbody>
+
+                <tr>
+                  <td>color_preference</td>
+                  <td><p>true</p></td>
+                </tr>
+
+              </tbody>
+            </table>
+
+
 
 
 

examples/doc/example.json

@@ -69,6 +69,19 @@
               "fullType": "bool",
               "ismap": false,
               "defaultValue": ""
+            },
+            {
+              "name": "color_preference",
+              "description": "Color preference of the customer.",
+              "label": "",
+              "type": "string",
+              "longType": "string",
+              "fullType": "string",
+              "ismap": false,
+              "defaultValue": "",
+              "options": {
+                "deprecated": true
+              }
             }
           ]
         },

examples/doc/example.md

@@ -54,6 +54,7 @@ Vehicles are some cool shit. But drive carefully!
 | status | [BookingStatus](#com.example.BookingStatus) |  | Status of the booking. |
 | confirmation_sent | [bool](#bool) |  | Has booking confirmation been sent? |
 | payment_received | [bool](#bool) |  | Has payment been received? |
+| color_preference | [string](#string) |  | **Deprecated.** Color preference of the customer. |
 
 
 

examples/doc/example.txt

@@ -26,6 +26,8 @@ Vehicles are some cool shit. But drive carefully!
 
 |payment_received | <<bool,bool>> | |Has payment been received?
 
+|color_preference | <<string,string>> | |Color preference of the customer.
+
 |===========================================
 
 

examples/proto/Booking.proto

@@ -41,6 +41,8 @@ message Booking {
 
   /** Has payment been received? */
   bool payment_received = 5;
+
+  string color_preference = 6 [deprecated=true]; // Color preference of the customer.
 }
 
 // An empty message for testing

fixtures/Booking.proto

@@ -76,6 +76,8 @@ message Booking {
   /** Has payment been received? */
   optional bool payment_received = 5 [default = false, (com.pseudomuto.protokit.v1.extend_field) = true];
 
+  optional string color_preference = 6 [deprecated=true]; // Color preference of the customer.
+
   // Nested extentions are also a thing.
 
   extend BookingStatus {

resources.go

@@ -11,9 +11,9 @@ import (
 )
 
 var embeddedResources = map[string]string{
-	"docbook.tmpl": "H4sIAAAAAAAA/+xZ70/zNhD+3r/Cyr7t1Zu8E0OaJrdIKytoAoQo23c3ubbWHDuznUIV9X+fHIf8/tHRUtjGF0R8T+7su3uec1t88RwytAGpqOBj5wf3m4OA+yKgfDV2fn+cff3JuZiMMJGa+gwmI4SwpprB5F4KLXzB0KXw4xC4JpoKjj1rHSGUJJLwFSB3Rhmo3c68qsA3KGPOHSWJe0dC2O1K75q3IyIJci9B+ZJG5q3URcnvLShFVpnrwjmiwdhJEncWM2YdO9ZlOeKN4KuWqH1xjY0ukXtN1IwCC1S+jjVZMEBLSUIYO4SxPGAeEvuMKMVJ2IheGJB1W9uQcbGSIo6QL5gaOz+WnCOEzWIEvjE+0UCvx873jncw4pt7Pgw6q0P0GkhQXkEIS/FUXUEIA9dyO0lPiz370A553EbQj7ghC2D9kFIlW4HYq+0Re42DYL0QQe29Un9XumHw4KWG79s3ZpT/icwf4EVHm5SYjs66yD5iz8Am/f7MGyZbQ3FbGWBb/xKWJGb6D8JiE9XgJtnazyhJ6nYvBSQJ8KAjaCP3Jq0pvFqPavaxZxmR09pLCVhQuOwhJ+2vzxq4kbnjE/cOlIYAFREGOHx+Cg5/DJbnOTmU6b8QNYC4i8MFyHcWg5YuG8zROwlC099UcE0op3xV81wY/rno2LL8r1QHe5WLTtlUNAqPw9NdXY6ldGmSh+Tt7BTydqAumbP9C+TE5vvoUnIYLU9Fqg4aZQ9dY736ISNvb/Mp5CuDDbDuOY0pXwoZEtbLls9J/jnJPyf5f2qSV3i/j/hkPTIHuaH+676CePsZ3jK/b0Gvxcf4juHNBcueFQ1P+gf4Kwal0bB0PYCKBFewB/TN9Skr5QnEKctPTUmy1YaMWKpn1rmWQELKV7sdUun/fXTu3YPNfGMTdrlzF9b8ym18xNtPzVDSpdZvV+c+YUTae3vatVXuD994uu87Q5xusZ8PAY5rbxKqUaWs0m4khRbdtH65mAhtEtgNmH750mf+jWxIn/1+q9ddemHXrkRv+O96vV/f95kf4sW2xV5r7YZMNUWqGI9p81UlqqsELzMz/V2hxPDSc9/mjbiZ4gyiplG0lzdTqr2AtmZ7Qa/2O8h0viYyGg683u8kpq6dwIZw1WWrJlpVyWq5OZXUaYS9/HejvwMAAP//LC5x+GkaAAA=",
-	"html.tmpl": "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",
-	"markdown.tmpl": "H4sIAAAAAAAA/+RWTU/bTBC++1fMG7+HIuRwR0kOhQKqACGCekFV2SSTxJKz63rXUZF3/3u1H/au7RhSCfVSDtgzY8/H8zw7cQwPBRNsyTK4ZMtyh1QQkTIaTQhQssPpSLB8NJuckVkUxTE8kUWGwNZwwahAKnhUVQWhG4TxVZohVyqqqv/XaYY/9OtwPoXxPdmhUgk8V5W7//4pbu5PIoCqSiBdw/gOOScb5KCU8brMtVspAJvmltFNmOqqzLIwHdKVS5EA0hUkjaXLfKHlrlvD+D6swC+BlKeM9qo0AVdKg5ZkuMcMfMyU9CAqlWATO6b8HIt9uuzBWLv9lH86Ye1N4Hm+JBkp4BvJSoSn1xx119w4k712JkI7T6KjBeIl13TmhDfJgWTphk5HRbrZitFsQmBb4Ho6io06n1iun5uc5VakzftRVY0vkS+LNNeiViroxouqVdjD4FVvMnpFHMyqcb8h/CrFbKVzSjC3IA04IOGWLDADCcGbICMJif4De4W26f5Ahhjq/I5v6ScF2chW1wtJtfaJfdp0YR6vKsoWBbQnsXNc4pqUmTDcKgXOPAczdxhyejANWmXUV49IKPlIepV7ZD4Tri/35W6BxRBCfZQakIbRCs7hIcRagFlbrzWS0pRuuhHb3t+BzoYm/yX26O3qtZgks0DBbmV9gHwl6NB7HBwBuBluEOz3IAzA6IOAZmk7BA5pK4BhYHeGkBxcvP+uPl96An0ZVKjnpEVBR53+1+Y4gb4hzjsUW7aqNfqIP0vkombnEXnOKMfaHmSnS0TX7Noy/K3QDQyvXddSd/s6d7CELQnOPxcFkl1KN0oBN/cN5C6rnayf1voP5LWBtxK/d/B6HPP6Y8LR685nHEP/E0CTNc71B2XNxj0TyEHCxekpSPhK9gQkPLyKrTlg10yHYu26edBclovXIdLs9eDZ8v98PBCiadOTF6rRfPxaDEdwNoO2yzGtR2jOX56HMT1QaNvJQs91K9fFfEuKvHl620qmp6/tBujfAQAA//+3qHlyoQsAAA==",
+	"docbook.tmpl": "H4sIAAAAAAAA/+xZ3W/bNhB/z19BaC/bikodugDDQLvA7LnF0GZB3O2dls42MYrUSMqNoel/Hyiq+v5a7bhZkJcguvvxjryP39ESfnMfMnQAqajgM+cH95WDgPsioHw3c/74uHr5k/NmfoWJ1NRnML9CCGuqGcxvpdDCFwwthR+HwDXRVHDsWe0VQkkiCd8BcleUgUpTs1SBb1BGXRhKEveGhJCmlbVmdUQkQe4SlC9pZFZlJip2P4BSZJebLo0jGsycJHFXMWPWsGNNVj2+F3zX4XXIr9HRLXLfEbWiwAJVyLEmGwZoK0kIM4cwVjgsXGKfEaU4CVveSwWyZhsbMiZ2UsQR8gVTM+fHinGEsBFG4BvlJxro/cz53vFORrxyr8dBr5sQvQcSVCUIYSk+1SUIYeBaHufZabFnH7ohH48RDCPekw2wYUglk51A7DX2iL3WQbDeiKCxrlLftWoYPXil4If2jRnlfyHzB3hZ0SYkpqLzKrKP2DOw+bA9s8JEa8xvVuXfUh7APXJ/z+KmkBNAJMEnGgLnnwC2JGYabQlT8F2aYgijPVFUzZcFysVeIU0S4EGadraW7amltfgnYbE5jsHNc9nPKEmaei8D5GanJdXkK4PXE11PK/ZsqxV84WWdXXJD1ULBBr/ea+CGP8/PCDegNASo9DBCDteXIIfHQR9FTE6lkF+IGkHcxOEG5FdmmY4qG43RV2Katr2F4JpQTvmuYblU/Hc2s2kZp7MnxDrYq92gqqqyUHgcXu5OdC6my4I8Rm+vL0FvJ/KSOdv/gE5svM9OJae15aWaqqeN8oe+sV7/9VKUt/l585LBAVj/nMaUb4UMCRvsludJ/jzJnyf5k5rktb6fQj55jaxBHqj/Ze82Hn6Gd8zvD6D34nG8vHhwwrJnReOT/g7+jkFpNE5dd6AiwRVMgD44P+WpvAA55fFpMEkubdGIbfVcu9YSSEj5Lk2Ryv4faufBPdjItzZhxb27sOov3MZjvP00FBVe6nxtu/YJI9Le27Oqrff++I2n/74z1tMd+usxwHn17YZqZSnPtBtJoUV/W3++mAhtAtgPWLx4MaT+jRzIkP72qPd9fGFlb8Wg+28Grb+7HVLfxZtjh75R2i2aapNUOR6z4qtTVF8KPs/M7INFpcMrz0ObN+RmkjOKWkTRJGsmVZOANmeToG+nHWSx3hMZjTveTzuJyWsvsEVcTdpqkFadsjpuThV2usJe8UHq3wAAAP//9p3zJMIaAAA=",
+	"html.tmpl": "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",
+	"markdown.tmpl": "H4sIAAAAAAAA/+RWzW7jNhC+6ymmUg9rL+TcF7YPjZtdFLtpsA56WRQNbY1tATKpipSRQOS7F/yRSFlW4gLpqT5Ymhlpfr75ZsQEHiom2JYVsGLb+ohUEJEzGs0JUHLERSxYGS/nN2QZRUkCj2RTILAd3DIqkAoeNU1F6B5hdpcXyJWKmubnXV7gX/p1+LSA2T05olIp/Ggad//nh6S7n0QATZNCvoPZN+Sc7JGDUkbrPLdqpQCsm6+M7kNXd3VRhO6QZs5FCkgzSDtJh/mV1sfzGEb3bgGeBVKeMzqI0hlcKA1aWuAJC/A2E9KDqFSKne2a8GusTvl2AGOr9lX+2wpbbQo/1ltSkAr+IEWN8PhSos6aG2V60spUaOUkupognnJdZo548xJIke/pIq7y/UHEyzmBQ4W7RZwYdj6yUj83vyktSbv3o6aZrZBvq7zUpFYqyMaTqhfYw+BZbzx6Rlz0qnH/QvhdjkWmfUowtyANOCDhK9lgARKCN0FGElL9A3uFvuh+IEMMtX/Xb+krBdnRVscLm2rliX3aZGEeNyl/yGmGzzD73eTDIc6wrHBLBGaxzHBH6kLAjhQcJ0pNp6vOOptOW440DWWbCvqQWEBW1oMhiVLgxE9gAAxNzpWp1FKsvXpow9mJpB8XD/EvhOvLfX3cYDUG9RDuDu1x2IOBvgR9D3kr6/1IcprT/bnFpuek/xg6a5r/lNoZPrb7NU2XwSi43fcOcyBBm97qwRWAm+JGwX4LwgCMIQhotr9D4BK3AhhGlnAIycUN/v/l59OAoE+jDPU96bXgjJ3+s3UdQV8h5zcUB5a1HP2Of9fIRdud78hLRjm28mh3zhtxLp7LMvzo6ATG97dL6XyNO3WwzW0TnH4tKiTHnO6VAm7uO8idV1vZ0K3VX/BrDa85fmvwBj3m7anEtdfNZ5LA8CyhmzUr9cm07cY9E8hBwu3HjyDhN3IiIOHhRRzMgH1m2pRo1ZcH3ct68zLWNHu9OFv+z9sDIpo0ffNCNppTtMUwhpsl9FWu07qEbv7KMrTpgkLZVhZqPvd83a4PpCq7pw89Z7r6Vu6A/icAAP//o9X/quoLAAA=",
 	"scalars.json": "H4sIAAAAAAAA/9yXzW4aMRDH7zzFiFMqBZDSlEa9JZGQOOQEOUWp5GVnvW6NTewxzaqq1HfoG/ZJqt0F1gYvpChVk9zQfHg9v/nPWNx1AL53AAC6C6NJT4sFdj9BN9Uukdg9rV1KE9rSvDbMFot45MzG7XxzciY1o+H52vGFLVk8ZZEvgpyNvaBcq6jLuKRYO0aVowPw47SlxiB1X4lBYFNhYN4q8P1ZrMCwjn9dn1DeNTb13Vq0sGRGsERiT6LilAOqmU6F4n0YK8wyMROoCDJtNh5QyBmJJYJy8wSNhd8/f4HIoNDOQCZQpiAsSPEVZQGkIWdl7DppyaRDewrOItjqYiCUJWRpPwI8uHkDXKgI7iDWh+1Fe6iFIuRo4rC9FB/1leDKzUEbGInH8tcJs2DwwQmD6btDPWi0/sJ6MDw/0IPm5k0PpFY82oT4SPvhu10YWDLCC9huxsBP3+3IXvLuGPlHOLgWMbqoGt0zy/EAgaM06Y4RZQuZmERcXCPu/4jkKET2qN05EVxhCkJRPWt9mOZoEebaIGxGWhZ1Cu6OM+VMgUHuJDNQXcG+7fVoj9qPz855eN7G+VWvwEw8YhqR8aX8xgoLWflqJAWh7cNNgK4G5FbvdLZ6OYAZBJ0RKuAGGaGp484+n128vM35zEqtWEakumKJgud0CGb54B6G+WH4epft/mF/uh7f9tL7Cy29wa2UaC2f8q/Lj2vK9K08eqZfZWlHpiKFbnuCCrecfoFT4/BaMmsHIyZt/XN/twOSTa+hdsDcWQJWd36mFTGh4HY66l2sXq+01NjHXiIILifX4zEQPlJMF+GHGmKhnbdczKc2CZuft3wiZGbJDJwS5ZVj3Ooz4aQqbf98VMrfAXbDig0fpgpgJhFkmCnA4oNDNSvXafvUtNG5KggnLYTu7svjYoR2s55OaR+dqsO9i6vxtEbUue/8CQAA//8z+wC/ohEAAA==",
 }
 

resources/docbook.tmpl

@@ -31,7 +31,7 @@
               <entry>{{.Name}}</entry>
               <entry><link linkend="{{.FullType}}">{{.LongType}}</link></entry>
               <entry>{{.Label}}</entry>
-              <entry>{{para .Description}}{{if .DefaultValue}}<para>Default: {{.DefaultValue}}</para>{{end}}</entry>
+              <entry>{{if (index .Options "deprecated"|default false)}}<emphasis>Deprecated.</emphasis>{{end}}{{para .Description}}{{if .DefaultValue}}<para>Default: {{.DefaultValue}}</para>{{end}}</entry>
             </row>
             {{end}}
           </tbody>

resources/html.tmpl

@@ -226,7 +226,7 @@
                   <td>{{.Name}}</td>
                   <td><a href="#{{.FullType}}">{{.LongType}}</a></td>
                   <td>{{.Label}}</td>
-                  <td><p>{{.Description}} {{if .DefaultValue}}Default: {{.DefaultValue}}{{end}}</p></td>
+                  <td><p>{{if (index .Options "deprecated"|default false)}}<strong>Deprecated.</strong> {{end}}{{.Description}} {{if .DefaultValue}}Default: {{.DefaultValue}}{{end}}</p></td>
                 </tr>
               {{end}}
             </tbody>

resources/markdown.tmpl

@@ -41,7 +41,7 @@
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 {{range .Fields -}}
-  | {{.Name}} | [{{.LongType}}](#{{.FullType}}) | {{.Label}} | {{nobr .Description}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
+  | {{.Name}} | [{{.LongType}}](#{{.FullType}}) | {{.Label}} | {{if (index .Options "deprecated"|default false)}}**Deprecated.** {{end}}{{nobr .Description}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
 {{end}}
 {{end}}