Remove javadoc generation for apache_* projects.

Add link to javadoc in index.rst.
Add package-info.java files to top level packages in org.ros.internal.

docs/build.gradle

@@ -17,7 +17,9 @@
 import org.apache.tools.ant.filters.ReplaceTokens
 
 task javadoc(type: Javadoc) {
-  def javaProjects = rootProject.subprojects.findResults { (it.name != 'docs') ? it : null }
+  def javaProjects = rootProject.subprojects.findResults {
+    (it.name != 'docs' && !it.name.startsWith('apache')) ? it : null
+  }
   source javaProjects.collect { it.sourceSets.main.allJava }
   classpath = files(javaProjects.collect { it.sourceSets.main.compileClasspath })
   destinationDir = new File("${buildDir}/html", 'javadoc')

docs/src/main/sphinx/index.rst

@@ -17,8 +17,13 @@ Support is best found on http://answers.ros.org/.
 Please file bugs and feature requests on the rosjava `issues`_ page. Starring
 issues that are important to you will help developers prioritize their work.
 
+In addition to the following documentation, rosjava makes liberal use of
+`Javadoc`_. Links to the appropriate Javadoc are used throughout this
+documentation.
+
 .. _roscore:  http://ros.org/wiki/roscore
 .. _issues: http://code.google.com/p/rosjava/issues/list
+.. _Javadoc: javadoc/index.html
 
 Contents:
 

rosjava/src/main/java/org/ros/internal/loader/package-info.java

+/*
+ * Copyright (C) 2012 Google Inc.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+/**
+ * Provides internal classes for loading node configurations.
+ * <p>
+ * These classes should _not_ be used directly outside of the org.ros package.
+ */
+package org.ros.internal.loader;
\ No newline at end of file

rosjava/src/main/java/org/ros/internal/node/package-info.java

+/*
+ * Copyright (C) 2012 Google Inc.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+/**
+ * Provides internal classes for creating and communicating with nodes in the ROS graph.
+ * <p>
+ * These classes should _not_ be used directly outside of the org.ros package.
+ */
+package org.ros.internal.node;
\ No newline at end of file

rosjava/src/main/java/org/ros/internal/package-info.java

@@ -15,7 +15,7 @@
  */
 
 /**
- * Provides internal classes that are core to the implementation of rosjava.
+ * Provides internal classes for working with the network layer.
  * <p>
  * These classes should _not_ be used directly outside of the org.ros package.
  */

rosjava/src/main/java/org/ros/internal/system/package-info.java

+/*
+ * Copyright (C) 2012 Google Inc.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+/**
+ * Provides internal utility classes for system operations.
+ * <p>
+ * These classes should _not_ be used directly outside of the org.ros package.
+ */
+package org.ros.internal.system;
\ No newline at end of file

rosjava/src/main/java/org/ros/internal/transport/package-info.java

+/*
+ * Copyright (C) 2012 Google Inc.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+/**
+ * Provides internal classes that are core to the implementation of rosjava.
+ * <p>
+ * These classes should _not_ be used directly outside of the org.ros package.
+ */
+package org.ros.internal.transport;
\ No newline at end of file

rosjava/src/main/java/org/ros/internal/transport/tcp/package-info.java

+/*
+ * Copyright (C) 2012 Google Inc.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+/**
+ * Provides internal classes for implementing TCPROS.
+ * <p>
+ * These classes should _not_ be used directly outside of the org.ros package.
+ * 
+ * @see <a href="http://www.ros.org/wiki/ROS/TCPROS">TCPROS documentation</a>
+ */
+package org.ros.internal.transport.tcp;
\ No newline at end of file