Add public doc for accessing C++ enums in Java.

Add public doc for accessing C++ enums in Java.

BUG=570878
Committed: https://crrev.com/c0b135ff0d80305eea8ff3b9a2e746808c2664a5
Cr-Commit-Position: refs/heads/master@{#432885}

[estevenson, 2016-11-16 22:51:10]

estevenson@chromium.org changed reviewers:
+ agrieve@chromium.org

[estevenson, 2016-11-16 22:51:10]

ptal Andrew!

https://codereview.chromium.org/2507863003/diff/1/docs/android_accessing_cpp_...
File docs/android_accessing_cpp_enums_in_java.md (right):

https://codereview.chromium.org/2507863003/diff/1/docs/android_accessing_cpp_...
docs/android_accessing_cpp_enums_in_java.md:20: ```cpp
I indented these blocks so that list continuation would work. Using
md_browser.py shows these blocks as formatted incorrectly while a few online md
browsers I tried format the blocks correctly. 

Any ideas on the correct way to do this? If not I can change after submitting if
it's wrong.

[agrieve, 2016-11-17 15:16:14]

reads great! lgtm (/w nit)

https://codereview.chromium.org/2507863003/diff/1/docs/android_accessing_cpp_...
File docs/android_accessing_cpp_enums_in_java.md (right):

https://codereview.chromium.org/2507863003/diff/1/docs/android_accessing_cpp_...
docs/android_accessing_cpp_enums_in_java.md:7: The traditional method involved
extracting the enum values to a separate `_list.h` file so that we could then
use gcc -E to generate a Java file (yes, we use the C preprocessor to codegen
Java). The new method involves a Python script which analyzes the C++ enum and
spits out the corresponding Java class. The enum needs to be annotated in a
particular way. By default, the generated class name will be the same as the
name of the enum. If all the names of the enum values are prefixed with the
MACRO\_CASED\_ name of the enum those prefixes will be stripped from the Java
version.
let's not mention the previous way :P.

Also - please wrap lines to 80 characters

[estevenson, 2016-11-17 15:52:58]

https://codereview.chromium.org/2507863003/diff/1/docs/android_accessing_cpp_...
File docs/android_accessing_cpp_enums_in_java.md (right):

https://codereview.chromium.org/2507863003/diff/1/docs/android_accessing_cpp_...
docs/android_accessing_cpp_enums_in_java.md:7: The traditional method involved
extracting the enum values to a separate `_list.h` file so that we could then
use gcc -E to generate a Java file (yes, we use the C preprocessor to codegen
Java). The new method involves a Python script which analyzes the C++ enum and
spits out the corresponding Java class. The enum needs to be annotated in a
particular way. By default, the generated class name will be the same as the
name of the enum. If all the names of the enum values are prefixed with the
MACRO\_CASED\_ name of the enum those prefixes will be stripped from the Java
version.
On 2016/11/17 15:16:14, agrieve wrote:
> let's not mention the previous way :P.
> 
> Also - please wrap lines to 80 characters

Done.

[estevenson, 2016-11-17 15:53:07]

The CQ bit was checked by estevenson@chromium.org

[estevenson, 2016-11-17 15:53:07]

The patchset sent to the CQ was uploaded after l-g-t-m from agrieve@chromium.org
Link to the patchset: https://codereview.chromium.org/2507863003/#ps20001
(title: "Line wrap @ 80 chars")

[commit-bot: I haz the power, 2016-11-17 15:53:45]

CQ is trying da patch. Follow status at
 
https://chromium-cq-status.appspot.com/v2/patch-status/codereview.chromium.or...

[commit-bot: I haz the power, 2016-11-17 16:04:15]

Committed patchset #2 (id:20001)

[commit-bot: I haz the power, 2016-11-17 16:08:20]

Description was changed from

==========
Add public doc for accessing C++ enums in Java.

BUG=570878
==========

to

==========
Add public doc for accessing C++ enums in Java.

BUG=570878

Committed: https://crrev.com/c0b135ff0d80305eea8ff3b9a2e746808c2664a5
Cr-Commit-Position: refs/heads/master@{#432885}
==========

[commit-bot: I haz the power, 2016-11-17 16:08:21]

Patchset 2 (id:??) landed as
https://crrev.com/c0b135ff0d80305eea8ff3b9a2e746808c2664a5
Cr-Commit-Position: refs/heads/master@{#432885}