Commit fa527024 authored by Feng Xiao's avatar Feng Xiao

Include javadoc/source in Java release packages.

Also fixed javadoc errors.

[ci skip]
parent 2078f614
...@@ -490,7 +490,7 @@ public abstract class AbstractMessage ...@@ -490,7 +490,7 @@ public abstract class AbstractMessage
/** /**
* Used to support nested builders and called to mark this builder as clean. * Used to support nested builders and called to mark this builder as clean.
* Clean builders will propagate the {@link BuildParent#markDirty()} event * Clean builders will propagate the {@link BuilderParent#markDirty()} event
* to their parent builders, while dirty builders will not, as their parents * to their parent builders, while dirty builders will not, as their parents
* should be dirty already. * should be dirty already.
* *
......
...@@ -37,11 +37,11 @@ import java.nio.ByteBuffer; ...@@ -37,11 +37,11 @@ import java.nio.ByteBuffer;
* An output target for raw bytes. This interface provides semantics that support two types of * An output target for raw bytes. This interface provides semantics that support two types of
* writing: * writing:
* *
* <p/><b>Traditional write operations:</b> * <p><b>Traditional write operations:</b>
* (as defined by {@link java.io.OutputStream}) where the target method is responsible for either * (as defined by {@link java.io.OutputStream}) where the target method is responsible for either
* copying the data or completing the write before returning from the method call. * copying the data or completing the write before returning from the method call.
* *
* <p/><b>Lazy write operations:</b> where the caller guarantees that it will never modify the * <p><b>Lazy write operations:</b> where the caller guarantees that it will never modify the
* provided buffer and it can therefore be considered immutable. The target method is free to * provided buffer and it can therefore be considered immutable. The target method is free to
* maintain a reference to the buffer beyond the scope of the method call (e.g. until the write * maintain a reference to the buffer beyond the scope of the method call (e.g. until the write
* operation completes). * operation completes).
......
...@@ -611,12 +611,12 @@ public final class Internal { ...@@ -611,12 +611,12 @@ public final class Internal {
int getInt(int index); int getInt(int index);
/** /**
* Like {@link #add(Integer)} but more efficient in that it doesn't box the element. * Like {@link #add(Object)} but more efficient in that it doesn't box the element.
*/ */
void addInt(int element); void addInt(int element);
/** /**
* Like {@link #set(int, Integer)} but more efficient in that it doesn't box the element. * Like {@link #set(int, Object)} but more efficient in that it doesn't box the element.
*/ */
int setInt(int index, int element); int setInt(int index, int element);
...@@ -639,12 +639,12 @@ public final class Internal { ...@@ -639,12 +639,12 @@ public final class Internal {
boolean getBoolean(int index); boolean getBoolean(int index);
/** /**
* Like {@link #add(Boolean)} but more efficient in that it doesn't box the element. * Like {@link #add(Object)} but more efficient in that it doesn't box the element.
*/ */
void addBoolean(boolean element); void addBoolean(boolean element);
/** /**
* Like {@link #set(int, Boolean)} but more efficient in that it doesn't box the element. * Like {@link #set(int, Object)} but more efficient in that it doesn't box the element.
*/ */
boolean setBoolean(int index, boolean element); boolean setBoolean(int index, boolean element);
...@@ -667,12 +667,12 @@ public final class Internal { ...@@ -667,12 +667,12 @@ public final class Internal {
long getLong(int index); long getLong(int index);
/** /**
* Like {@link #add(Long)} but more efficient in that it doesn't box the element. * Like {@link #add(Object)} but more efficient in that it doesn't box the element.
*/ */
void addLong(long element); void addLong(long element);
/** /**
* Like {@link #set(int, Long)} but more efficient in that it doesn't box the element. * Like {@link #set(int, Object)} but more efficient in that it doesn't box the element.
*/ */
long setLong(int index, long element); long setLong(int index, long element);
...@@ -695,12 +695,12 @@ public final class Internal { ...@@ -695,12 +695,12 @@ public final class Internal {
double getDouble(int index); double getDouble(int index);
/** /**
* Like {@link #add(Double)} but more efficient in that it doesn't box the element. * Like {@link #add(Object)} but more efficient in that it doesn't box the element.
*/ */
void addDouble(double element); void addDouble(double element);
/** /**
* Like {@link #set(int, Double)} but more efficient in that it doesn't box the element. * Like {@link #set(int, Object)} but more efficient in that it doesn't box the element.
*/ */
double setDouble(int index, double element); double setDouble(int index, double element);
...@@ -723,12 +723,12 @@ public final class Internal { ...@@ -723,12 +723,12 @@ public final class Internal {
float getFloat(int index); float getFloat(int index);
/** /**
* Like {@link #add(Float)} but more efficient in that it doesn't box the element. * Like {@link #add(Object)} but more efficient in that it doesn't box the element.
*/ */
void addFloat(float element); void addFloat(float element);
/** /**
* Like {@link #set(int, Float)} but more efficient in that it doesn't box the element. * Like {@link #set(int, Object)} but more efficient in that it doesn't box the element.
*/ */
float setFloat(int index, float element); float setFloat(int index, float element);
......
...@@ -39,7 +39,7 @@ import java.io.InputStream; ...@@ -39,7 +39,7 @@ import java.io.InputStream;
* *
* <p>All methods may throw {@link InvalidProtocolBufferException}. In the event of invalid data, * <p>All methods may throw {@link InvalidProtocolBufferException}. In the event of invalid data,
* like an encoding error, the cause of the thrown exception will be {@code null}. However, if an * like an encoding error, the cause of the thrown exception will be {@code null}. However, if an
* I/O problem occurs, an exception is thrown with an {@link IOException} cause. * I/O problem occurs, an exception is thrown with an {@link java.io.IOException} cause.
* *
* @author liujisi@google.com (Pherl Liu) * @author liujisi@google.com (Pherl Liu)
*/ */
......
...@@ -45,7 +45,7 @@ import java.util.Map.Entry; ...@@ -45,7 +45,7 @@ import java.util.Map.Entry;
* *
* <p>The locations of primary fields values are retrieved by {@code getLocation} or * <p>The locations of primary fields values are retrieved by {@code getLocation} or
* {@code getLocations}. The locations of sub message values are within nested * {@code getLocations}. The locations of sub message values are within nested
* {@code TextFormatParseInfoTree}s and are retrieve by {@getNestedTree} or {code @getNestedTrees}. * {@code TextFormatParseInfoTree}s and are retrieve by {@code getNestedTree} or {@code getNestedTrees}.
* *
* <p>The {@code TextFormatParseInfoTree} is created by a Builder. * <p>The {@code TextFormatParseInfoTree} is created by a Builder.
*/ */
...@@ -197,7 +197,7 @@ public class TextFormatParseInfoTree { ...@@ -197,7 +197,7 @@ public class TextFormatParseInfoTree {
* Set for a sub message. * Set for a sub message.
* *
* <p>A new builder is created for a sub message. The builder that is returned is a new builder. * <p>A new builder is created for a sub message. The builder that is returned is a new builder.
* The return is <emph>not</emph> the invoked {@code builder.getBuilderForSubMessageField}. * The return is <em>not</em> the invoked {@code builder.getBuilderForSubMessageField}.
* *
* @param fieldDescriptor the field whose value is the submessage * @param fieldDescriptor the field whose value is the submessage
* @return a new Builder for the sub message * @return a new Builder for the sub message
......
...@@ -151,6 +151,32 @@ ...@@ -151,6 +151,32 @@
<id>release</id> <id>release</id>
<build> <build>
<plugins> <plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>2.2.1</version>
<executions>
<execution>
<id>attach-sources</id>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9.1</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin> <plugin>
<artifactId>maven-gpg-plugin</artifactId> <artifactId>maven-gpg-plugin</artifactId>
<version>1.6</version> <version>1.6</version>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment