> On June 27, 2015, 6:59 p.m., Adam B wrote:
> > src/java/generated/org/apache/mesos/MesosNativeLibrary.java.in, lines 27-36
> > <https://reviews.apache.org/r/35961/diff/1/?file=993816#file993816line27>
> >
> > Did you verify that the curly-braces are properly handled here? I read
> > on http://stackoverflow.com/a/13512524/4056606 that the `{@code` tag will
> > interpret the first closing brace as its own ending brace. In fact, @code
> > may only be necessary for wrapping Generic `<something>` declarations. You
> > could additionally/instead use the old-style `<code>` tag to print
> > everything in code-font. I would hope this would be easier, but parsing
> > code within docs within code must be difficult. Don't even try to put `/*`
> > block comments inside your code example, or the compiler will get confused
> > too.
>
> Connor Doyle wrote:
> Yes, it does seem to work. Here is the output as rendered by my
> up-to-date Google Chrome browser on OS X:
>
> [](http://s15.postimg.org/p44aqh2e2/Screen_Shot_2015_06_29_at_07_47_24.jpg)
>
> However, I personally find the `<code></code>` markup more readable than
> the dangling closing curling brace. I will update this to use the plain HTML
> tag style.
The `<code></code>` variant causes the build to fail with Java 8. The javadoc
parser chokes on the `>` symbol for some reason. I will verify that the
`{@code ... }` style still works with Java < 8.
- Connor
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/35961/#review89629
-----------------------------------------------------------
On June 27, 2015, 1:18 a.m., Connor Doyle wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/35961/
> -----------------------------------------------------------
>
> (Updated June 27, 2015, 1:18 a.m.)
>
>
> Review request for mesos, Adam B and Ben Whitehead.
>
>
> Bugs: MESOS-1552
> https://issues.apache.org/jira/browse/MESOS-1552
>
>
> Repository: mesos-incubating
>
>
> Description
> -------
>
> Updates the Java POM to include the generated Java protobuf classes.
>
>
> Diffs
> -----
>
> src/java/generated/org/apache/mesos/MesosNativeLibrary.java.in c54d903
> src/java/mesos.pom.in 138da55
> src/java/src/org/apache/mesos/MesosExecutorDriver.java 1b5ed60
>
> Diff: https://reviews.apache.org/r/35961/diff/
>
>
> Testing
> -------
>
> - configure
> - make
> - Manual verification of generated Javadoc HTML
>
>
> Thanks,
>
> Connor Doyle
>
>