search

felipeprov / protoc-gen-docbook

Automatically exported from code.google.com/p/protoc-gen-docbook
0 stars 0 forks source link

With linux builds, comments in .proto are not translated to description fields in the output #2

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago 
What steps will reproduce the problem?
1. Installed protobuf 2.5.0 from source:
$ tar xvf protobuf-2.5.0.tar.bz2 
$ cd protobuf-2.5.0/
$ ./configure --prefix=/usr
$ make -j 4
$ sudo make install

2. Checked out 0.3.0 tag (same results with current trunk):
svn checkout http://protoc-gen-docbook.googlecode.com/svn/tags/release/0.3.0 
protoc-gen-docbook-0.3.0

3. Patched linux makefile linux/src/subdir.mk to update 
"external/includes/protobuf-2.5.0rc1" to "external/includes/protobuf-2.5.0/" to 
match the checked out path

4. Built ...:
$ cd protoc-gen-docbook-0.3.0/linux/
$ make clean; make

5. Attempted to generate the example-addressbook included:
$ cd ../deploy/example-addressbook/
$ protoc -I/usr/include --proto_path=. addressbook.proto 
--plugin=../../linux/protoc-gen-docbook --docbook_out=.
$ fop -xml docbook_out.xml -xsl 
/usr/share/xml/docbook/stylesheet/docbook-xsl/fo/docbook.xsl -pdf 
docbook_out.pdf -param page.orientation landscape -param paper.type USletter

6. Checked in both the xml and pdf output, no comments from the .proto file 
made it into the description column ... see attached files.

The base OS is Ubuntu 10.04.4.

I've attached the modified subdir.mk and the output xml & pdf files. Please let 
me know if I can run any experiments (verbose mode etc ...). The tool looks 
very helpful, I'd love to get it running ...

Thanks for your work!
--Matt Hughes

Original issue reported on code.google.com by matthew....@gmail.com on 3 Apr 2013 at 3:15

Attachments:

GoogleCodeExporter commented 9 years ago 
Whoops - my bad - I managed to end up with two protoc installs, one in /usr/ 
and one in /usr/local, path was pointing to protobuf 2.4.1 rather than 2.5.0 - 
everything seems fine if I run against 2.5.0 ... sorry!

Original comment by matthew....@gmail.com on 3 Apr 2013 at 5:43

GoogleCodeExporter commented 9 years ago 
No problem.

Thanks for trying it out on Linux. I am likely going to re-do the make files in 
the near future. They are a bit sloppy right now, and is auto-generated through 
Eclipse CDT.

... Alan

Original comment by alancn...@gmail.com on 6 Apr 2013 at 2:31