Want to be able to specify a root package on the command line and
have javadoc traverse and generate docs for all subpackages.
Would also need to be able to exclude packages and/or classes
you want to skip over.

Also known as "recursive descent" (or "recursively descend").

From: "Blackett, Darren (IS - XCEL & Application Infrastructure)" <###@###.###>
To: "'###@###.###'" <Doug.Kramer@Eng>
Subject: RE: Javadoc - Recursive package search
Date: Fri, 22 Aug 1997 09:24:05 +0100

I think I've probably got my wires crossed! What I was trying to say
was that if you have a directory tree as follows:

Halifax
    |----General
|------HxDate
          | |-------HxData.java
          |
|------HxInt
          | |--------HxInt.java
          |
|------HxString
          | |-------HxString.java
          |
|-------HxGeneral.java
          |
|-------HxFile.java

In which all files/classes belong to the package Halifax.General you
would expect the following command to pick up all of the source files
even the ones in the sub directories:

Javadoc Halifax.General

or at least.

Javadoc Halifax.General.*

Unfortunately it doesn't happen.