JAVADOC for SUBDIRs

Hallo,

I tried to create a documentation with javadoc. But the Sourcecodes are saved in differend Subdirs.

So I take the DOS command DIR /A:D /B /S > files

This should write all subdirs into the file named files.

The entries in Files lookes like this:

C:\hallo\com\portal\subdir1

C:\hallo\com\portal\subdir2

C:\hallo\com\portal\subdir3

...

C:\hallo\com\tools\subdir1

...

now I call JAVADOC with @files

c:\Jdk140\bin\javadoc -d DOCU-TARGET-PATH @files

if I understood the help of JAVADOC right, this should work!

But it doesn't.

WHY?

HOW should the entries of the file FILES look like?

DO files really don't need a specifier *.txt (or something else!)?

HOW cna I make this run?

Ps.: Sorry I know that my enlish is terrible, but I hope you can understand me!

[884 byte] By [PaddyGa] at [2007-9-27 23:19:14]

# 1

I can't tell from your example whether all the source files have the same root directory or not. Please show me the directory structure

of the source files before you move them.

First, you should never move source files that belong to packages into

a directory structure that does not correspond to the packages.

Javadoc won't work with those moved files.

In other words, if you have package com.portal.subdir1,

you must leave the source files in a directory named com\portal\subdir1.

Second, the proper way to document multiple source trees is to

simply add all the source file root directories to -sourcepath.

So your command might look something like this:

javadoc -sourcepath rootpath1;rootpath2;rootpath3 com.portal.subdir1 com.portal.subdir2 com.portal.subdir3

Please give us more details.

-Doug

dkramera at 2007-7-7 15:19:46 >

Developer Tools New Topic