Unable to use javadoc -sourcepath with multiple paths

Question

I'm having trouble specifying multiple paths to the -sourcepath option of javadoc. I have two trees:

  /hd/c/src/SerialPort/src/main/java/serialPort
  /hd/c/src/drivers/src/main/java/zigbee

The first tree contains a single package, down in:

/hd/c/src/SerialPort/src/main/java/serialPort/SerialPort

The second tree has numerous packages, in:

  /hd/c/src/drivers/src/main/java/zigbee/stack
  /hd/c/src/drivers/src/main/java/zigbee/common
  /hd/c/src/drivers/src/main/java/zigbee/zcl

I can successfully create documents for either tree by saying:

  javadoc -d ./doc/serialPort \
    -sourcepath SerialPort/src/main/java \
    -subpackages serialPort

and

  javadoc -d ./doc/drivers 
    -sourcepath drivers/src/main/java \
    -subpackages zigbee

What I want is to create a single, set of documents for the whole works. It feels to me as if I should be able to say:

  javadoc -d ./doc \
    -sourcepath SerialPort/src/main/java;drivers/src/main/java \
    -subpackages \
      serialPort \
      zigbee

but any attempt to place multiple paths in my -sourcepath results in this message:

  javadoc: error - No packages or classes specified.

Does anyone have any idea what I'm doing wrong?

Answer 1

I don't know what platform uses /hd/c as a path, but I'm guessing something Unix based - possibly a Mac. In which case, you should be using : as your path separator, not ;