I've been digging into this more. The errors are resulting because of a package name that includes a dash in it. Shouldn't the folder names be something like javax.websocket.client instead of -client? [javadoc] javadoc: error - Illegal package name: "connectors.javax.websocket-client.src.main.java.quarks.javax.websocket.impl" [javadoc] javadoc: error - Illegal package name: "connectors.wsclient-javax.websocket.src.main.java.quarks.connectors.wsclient.javax.websocket" [javadoc] javadoc: error - Illegal package name: "connectors.wsclient-javax.websocket.src.main.java.quarks.connectors.wsclient.javax.websocket.runtime"
I also get this warning: [javadoc] javadoc: warning - No source files for package connectors.quarks.javax.websocket.src.main.java.quarks.javax.websocket I'm not sure why I'm getting that warning since there actually is a source file there: QuarksSslContainerProvider.java Do people agree that the setup is wrong? Should I change the folder names in the connectors package? Or is this a problem with how I'm doing the build since the folder names at that level aren't really part of the package name? Here is the latest comparison: https://github.com/apache/incubator-quarks/compare/master...Alex-Cook4:master Thanks for the help! Here is what I'm using for the javadoc build now: <fileset dir="${basedir}"> <include name="*/*/src/main/java/*"/> <exclude name="android/**"/> <exclude name="samples/scenarios/src/main/java/quarks/samples/scenarios/**"/> </fileset> <packageset dir="${basedir}"> <include name="*/*/src/main/java/**"/> </packageset> On Wed, Apr 13, 2016 at 3:49 PM, Alexander Cook <[email protected]> wrote: > Hi, > > I have developed a Quarks Watson IoT Platform sample that connects to a > real range/proximity sensor using Pi4J that I would like to contribute to > Quarks. It fits in with this recipe that I wrote: > https://developer.ibm.com/recipes/tutorials/apache-quarks-on-pi-to-watson-iot-foundation/ > . > > I have updated the build.xml to exclude my sample since the dependency on > Pi4J leads to errors. However, I am still getting failures from Javadoc > warnings. In order to exclude the sample from Javadoc, I followed this > solution: > http://stackoverflow.com/questions/6060998/how-can-i-make-an-ant-javadoc-class-exclude-two-files > (supposedly allowing me to exclude multiple locations). Here is the code of > interest: > > <fileset dir="${basedir}"> > <include name="*/*/src/main/java/**/*.java"/> > <exclude name="android/**"/> > <exclude > name="samples/scenarios/src/main/java/quarks/samples/scenarios/**"/> > </fileset> > <packageset dir="${basedir}"> > <include name="*/*/src/main/java/**/*.java"/> > </packageset> > > This seemed to work, except now I get these warnings for code that I never > touched: > > [javadoc] javadoc: warning - Multiple sources of package comments found > for package "javax.servlet" > [javadoc] javadoc: warning - Multiple sources of package comments found > for package "javax.servlet.http" > [javadoc] Standard Doclet version 1.8.0 > [javadoc] Building tree for all the packages and classes... > [javadoc] > /home/streamsadmin/git/incubator-quarks/connectors/iotf/src/main/java/quarks/connectors/iotf/IotfDevice.java:60: > warning - Tag @see: reference not found: quarks.connectors.iot Quarks > generic device model > > Are these warnings I should actually fix, or am I doing something wrong? > > You can see the changes I have made here: > https://github.com/apache/incubator-quarks/compare/master...Alex-Cook4:master > > > The files of interest will be build.xml, common-build.xml, > and samples/scenarios/build.xml. > Thanks for the help! > > Alex >
