[protobuf] Re: documentation within proto files

2009-11-02 Thread Evan Jones
On Nov 2, 2009, at 12:14 , Kenton Varda wrote: There's no convention for this currently. It would be pretty nice to have the parser parse some form of doc comments. Then the language backends could output them appropriately: javadoc for Java, docstrings for Python, etc. Not that I'm

[protobuf] Re: documentation within proto files

2009-11-02 Thread Kenton Varda
We all agree it would be nice, but no one has volunteered to do it. :) There's also the question of where, exactly, you put the comments given that each field expands to several methods. Does each method get a copy of the same comments? Or do they all refer to a common copy? On Mon, Nov 2,