Эх сурвалжийг харах

converted javanano README to markdown. Corrected Makefile

jesse 10 жил өмнө
parent
commit
0481bf32c4
2 өөрчлөгдсөн 44 нэмэгдсэн , 25 устгасан
  1. 3 3
      Makefile.am
  2. 41 22
      javanano/README.md

+ 3 - 3
Makefile.am

@@ -152,7 +152,7 @@ java_EXTRA_DIST=                                                             \
   java/src/test/java/com/google/protobuf/test_check_utf8_size.proto          \
   java/src/test/java/com/google/protobuf/test_check_utf8_size.proto          \
   java/src/test/java/com/google/protobuf/test_custom_options.proto           \
   java/src/test/java/com/google/protobuf/test_custom_options.proto           \
   java/pom.xml                                                               \
   java/pom.xml                                                               \
-  java/README.txt
+  java/README.md
 
 
 javanano_EXTRA_DIST=                                                                      \
 javanano_EXTRA_DIST=                                                                      \
   javanano/src/main/java/com/google/protobuf/nano/CodedOutputByteBufferNano.java          \
   javanano/src/main/java/com/google/protobuf/nano/CodedOutputByteBufferNano.java          \
@@ -190,7 +190,7 @@ javanano_EXTRA_DIST=
   javanano/src/test/java/com/google/protobuf/nano/unittest_multiple_nano.proto            \
   javanano/src/test/java/com/google/protobuf/nano/unittest_multiple_nano.proto            \
   javanano/src/test/java/com/google/protobuf/nano/unittest_enum_class_multiple_nano.proto \
   javanano/src/test/java/com/google/protobuf/nano/unittest_enum_class_multiple_nano.proto \
   javanano/src/test/java/com/google/protobuf/nano/map_test.proto                          \
   javanano/src/test/java/com/google/protobuf/nano/map_test.proto                          \
-  javanano/README.txt                                                                     \
+  javanano/README.md                                                                      \
   javanano/pom.xml
   javanano/pom.xml
 
 
 
 
@@ -277,7 +277,7 @@ python_EXTRA_DIST=                                                           \
   python/setup.py                                                            \
   python/setup.py                                                            \
   python/mox.py                                                              \
   python/mox.py                                                              \
   python/stubout.py                                                          \
   python/stubout.py                                                          \
-  python/README.txt
+  python/README.md
 
 
 ruby_EXTRA_DIST=                                                             \
 ruby_EXTRA_DIST=                                                             \
   ruby/README.md                                                             \
   ruby/README.md                                                             \

+ 41 - 22
javanano/README.txt → javanano/README.md

@@ -1,10 +1,14 @@
 Protocol Buffers - Google's data interchange format
 Protocol Buffers - Google's data interchange format
+===================================================
+
+[![Build Status](https://travis-ci.org/google/protobuf.svg?branch=master)](https://travis-ci.org/google/protobuf)
+
 Copyright 2008 Google Inc.
 Copyright 2008 Google Inc.
 
 
 This directory contains the Java Protocol Buffers Nano runtime library.
 This directory contains the Java Protocol Buffers Nano runtime library.
 
 
 Installation - With Maven
 Installation - With Maven
-=========================
+-------------------------
 
 
 The Protocol Buffers build is managed using Maven.  If you would
 The Protocol Buffers build is managed using Maven.  If you would
 rather build without Maven, see below.
 rather build without Maven, see below.
@@ -41,7 +45,7 @@ rather build without Maven, see below.
    The .jar will be placed in the "target" directory.
    The .jar will be placed in the "target" directory.
 
 
 Installation - Without Maven
 Installation - Without Maven
-============================
+----------------------------
 
 
 If you would rather not install Maven to build the library, you may
 If you would rather not install Maven to build the library, you may
 follow these instructions instead.  Note that these instructions skip
 follow these instructions instead.  Note that these instructions skip
@@ -66,7 +70,7 @@ running unit tests.
 4) Install the classes wherever you prefer.
 4) Install the classes wherever you prefer.
 
 
 Nano version
 Nano version
-============================
+------------
 
 
 JavaNano is a special code generator and runtime library designed specially for
 JavaNano is a special code generator and runtime library designed specially for
 resource-restricted systems, like Android. It is very resource-friendly in both
 resource-restricted systems, like Android. It is very resource-friendly in both
@@ -130,7 +134,9 @@ penalty. This is not a problem if the field has no default or is an
 empty default.
 empty default.
 
 
 Nano Generator options
 Nano Generator options
+----------------------
 
 
+```
 java_package           -> <file-name>|<package-name>
 java_package           -> <file-name>|<package-name>
 java_outer_classname   -> <file-name>|<package-name>
 java_outer_classname   -> <file-name>|<package-name>
 java_multiple_files    -> true or false
 java_multiple_files    -> true or false
@@ -139,8 +145,10 @@ optional_field_style   -> default or accessors
 enum_style             -> c or java
 enum_style             -> c or java
 ignore_services        -> true or false
 ignore_services        -> true or false
 parcelable_messages    -> true or false
 parcelable_messages    -> true or false
+```
+
+**java_package=\<file-name\>|\<package-name\>** (no default)
 
 
-java_package=<file-name>|<package-name> (no default)
   This allows overriding the 'java_package' option value
   This allows overriding the 'java_package' option value
   for the given file from the command line. Use multiple
   for the given file from the command line. Use multiple
   java_package options to override the option for multiple
   java_package options to override the option for multiple
@@ -149,7 +157,8 @@ java_package=<file-name>|<package-name> (no default)
   the same option defined in the file if present, or the
   the same option defined in the file if present, or the
   proto package if present, or the default Java package.
   proto package if present, or the default Java package.
 
 
-java_outer_classname=<file-name>|<outer-classname> (no default)
+**java_outer_classname=\<file-name\>|\<outer-classname\>** (no default)
+
   This allows overriding the 'java_outer_classname' option
   This allows overriding the 'java_outer_classname' option
   for the given file from the command line. Use multiple
   for the given file from the command line. Use multiple
   java_outer_classname options to override the option for
   java_outer_classname options to override the option for
@@ -160,7 +169,8 @@ java_outer_classname=<file-name>|<outer-classname> (no default)
   outer class will nest all classes and integer constants
   outer class will nest all classes and integer constants
   generated from file-scope messages and enums.
   generated from file-scope messages and enums.
 
 
-java_multiple_files={true,false} (no default)
+**java_multiple_files={true,false}** (no default)
+
   This allows overriding the 'java_multiple_files' option
   This allows overriding the 'java_multiple_files' option
   in all source files and their imported files from the
   in all source files and their imported files from the
   command line. The final value of this option for each
   command line. The final value of this option for each
@@ -178,10 +188,11 @@ java_multiple_files={true,false} (no default)
   incorrect references to the imported messages and enum
   incorrect references to the imported messages and enum
   constants.
   constants.
 
 
-java_nano_generate_has={true,false} (default: false)
+**java_nano_generate_has={true,false}** (default: false)
+
   DEPRECATED. Use optional_field_style=accessors.
   DEPRECATED. Use optional_field_style=accessors.
 
 
-  If true, generates a public boolean variable has<fieldname>
+  If true, generates a public boolean variable has\<fieldname\>
   accompanying each optional or required field (not present for
   accompanying each optional or required field (not present for
   repeated fields, groups or messages). It is set to false initially
   repeated fields, groups or messages). It is set to false initially
   and upon clear(). If parseFrom(...) reads the field from the wire,
   and upon clear(). If parseFrom(...) reads the field from the wire,
@@ -195,20 +206,21 @@ java_nano_generate_has={true,false} (default: false)
   many cases reading the default works and determining whether the
   many cases reading the default works and determining whether the
   field was received over the wire is irrelevant.
   field was received over the wire is irrelevant.
 
 
-optional_field_style={default,accessors,reftypes} (default: default)
+**optional_field_style={default,accessors,reftypes}** (default: default)
+
   Defines the style of the generated code for fields.
   Defines the style of the generated code for fields.
 
 
-  * default *
+  * default
 
 
   In the default style, optional fields translate into public mutable
   In the default style, optional fields translate into public mutable
   Java fields, and the serialization process is as discussed in the
   Java fields, and the serialization process is as discussed in the
   "IMPORTANT" section above.
   "IMPORTANT" section above.
 
 
-  * accessors *
+  * accessors
 
 
   When set to 'accessors', each optional field is encapsulated behind
   When set to 'accessors', each optional field is encapsulated behind
-  4 accessors, namely get<fieldname>(), set<fieldname>(), has<fieldname>()
-  and clear<fieldname>() methods, with the standard semantics. The hazzer's
+  4 accessors, namely get\<fieldname\>(), set\<fieldname\>(), has\<fieldname\>()
+  and clear\<fieldname\>() methods, with the standard semantics. The hazzer's
   return value determines whether a field is serialized, so this style is
   return value determines whether a field is serialized, so this style is
   useful when you need to serialize a field with the default value, or check
   useful when you need to serialize a field with the default value, or check
   if a field has been explicitly set to its default value from the wire.
   if a field has been explicitly set to its default value from the wire.
@@ -224,7 +236,7 @@ optional_field_style={default,accessors,reftypes} (default: default)
   reducing the final code size.
   reducing the final code size.
   TODO(maxtroy): find ProGuard config that would work the best.
   TODO(maxtroy): find ProGuard config that would work the best.
 
 
-  * reftypes *
+  * reftypes
 
 
   When set to 'reftypes', each proto field is generated as a public Java
   When set to 'reftypes', each proto field is generated as a public Java
   field. For primitive types, these fields use the Java reference types
   field. For primitive types, these fields use the Java reference types
@@ -254,10 +266,11 @@ optional_field_style={default,accessors,reftypes} (default: default)
   required field (you have no reason to), you can only use
   required field (you have no reason to), you can only use
   java_nano_generate_has=true.
   java_nano_generate_has=true.
 
 
-enum_style={c,java} (default: c)
+**enum_style={c,java}** (default: c)
+
   Defines where to put the int constants generated from enum members.
   Defines where to put the int constants generated from enum members.
 
 
-  * c *
+  * c
 
 
   Use C-style, so the enum constants are available at the scope where
   Use C-style, so the enum constants are available at the scope where
   the enum is defined. A file-scope enum's members are referenced like
   the enum is defined. A file-scope enum's members are referenced like
@@ -265,7 +278,7 @@ enum_style={c,java} (default: c)
   referenced as 'Message.ENUM_VALUE'. The enum name is unavailable.
   referenced as 'Message.ENUM_VALUE'. The enum name is unavailable.
   This complies with the Micro code generator's behavior.
   This complies with the Micro code generator's behavior.
 
 
-  * java *
+  * java
 
 
   Use Java-style, so the enum constants are available under the enum
   Use Java-style, so the enum constants are available under the enum
   name and referenced like 'EnumName.ENUM_VALUE' (they are still int
   name and referenced like 'EnumName.ENUM_VALUE' (they are still int
@@ -277,18 +290,21 @@ enum_style={c,java} (default: c)
   compiler inlines all referenced enum constants into the call sites,
   compiler inlines all referenced enum constants into the call sites,
   the interface remains unused and can be removed by ProGuard.
   the interface remains unused and can be removed by ProGuard.
 
 
-ignore_services={true,false} (default: false)
+**ignore_services={true,false}** (default: false)
+
   Skips services definitions.
   Skips services definitions.
 
 
   Nano doesn't support services. By default, if a service is defined
   Nano doesn't support services. By default, if a service is defined
   it will generate a compilation error. If this flag is set to true,
   it will generate a compilation error. If this flag is set to true,
   services will be silently ignored, instead.
   services will be silently ignored, instead.
 
 
-parcelable_messages={true,false} (default: false)
+**parcelable_messages={true,false}** (default: false)
+
   Android-specific option to generate Parcelable messages.
   Android-specific option to generate Parcelable messages.
 
 
 
 
 To use nano protobufs within the Android repo:
 To use nano protobufs within the Android repo:
+----------------------------------------------
 
 
 - Set 'LOCAL_PROTOC_OPTIMIZE_TYPE := nano' in your local .mk file.
 - Set 'LOCAL_PROTOC_OPTIMIZE_TYPE := nano' in your local .mk file.
   When building a Java library or an app (package) target, the build
   When building a Java library or an app (package) target, the build
@@ -313,17 +329,20 @@ To use nano protobufs within the Android repo:
   the two above.
   the two above.
 
 
 To use nano protobufs outside of Android repo:
 To use nano protobufs outside of Android repo:
+----------------------------------------------
 
 
 - Link with the generated jar file
 - Link with the generated jar file
-  <protobuf-root>java/target/protobuf-java-2.3.0-nano.jar.
+  \<protobuf-root\>java/target/protobuf-java-2.3.0-nano.jar.
 - Invoke with --javanano_out, e.g.:
 - Invoke with --javanano_out, e.g.:
-
+```
 ./protoc '--javanano_out=\
 ./protoc '--javanano_out=\
     java_package=src/proto/simple-data.proto|my_package,\
     java_package=src/proto/simple-data.proto|my_package,\
     java_outer_classname=src/proto/simple-data.proto|OuterName\
     java_outer_classname=src/proto/simple-data.proto|OuterName\
   :.' src/proto/simple-data.proto
   :.' src/proto/simple-data.proto
+```
 
 
 Contributing to nano:
 Contributing to nano:
+---------------------
 
 
 Please add/edit tests in NanoTest.java.
 Please add/edit tests in NanoTest.java.
 
 
@@ -348,7 +367,7 @@ Please run the following steps to test:
 - "make -j12" and check for build errors
 - "make -j12" and check for build errors
 
 
 Usage
 Usage
-=====
+-----
 
 
 The complete documentation for Protocol Buffers is available via the
 The complete documentation for Protocol Buffers is available via the
 web at:
 web at: