[JavaDoc] Cercasi genio!

[petitof]

qual'è secondo voi il metodo migliore per prelevare la documentazione da numerose classi java disposte in package differenti?

[kingv]

che vuol dire "prelevare"?


hai i file .java e devi generare il javadoc?

[petitof]

si ho le classi java disposte in tante sotto cartelle (package)...
il mio problema è che con NetBeans posso generare i JavaDoc dalla cartella radice solo che mi da un eccezione OutOfMemory.

Quindi posso crearli poco per volta, ossia cartella per cartella...ma il guaio è che aprendo l'index.html mi sovrascrive l'elenco delle classi dei package!!

come posso fare?

[kingv]

apri un prompt di DOS (o una console linux) e:


javadoc -d c:\dove_vuoi\mettere_gli_html -sourcepath c:\qui_hai\i_sorgenti;c:\qui_hai\altri_sorgenti *.java

(per linux sistema i path)

[petitof]

javadoc -d c:\Doc\html -sourcepath C:\Java\Projects\fabio\classpath *.java


io all'interno di C:\Java\Projects\fabio\classpath
ho un numero elevato di cartelle con package diversi.....come faccio?

non mi dire che devo inserire il path di ogni package...!!!

[kingv]

dipende, se hai una struttura delle directory tipo:


c:\src\it\petitof\package1\subpackage1
c:\src\it\petitof\package2\subpackage1


se fai puntare javadoc a c:\src

e scrivi:

javadoc -d c:\destinazione --sourcepath c:\src it.petitof

dovrebbe generare anche tutti i sottopackages (se non lo fa c'e' un'opzione per farglielo fare, son sicuro).

[petitof]

ho provato a fare come dici ......

javadoc -d c:\Doc\html -sourcepath C:\Java\Projects\Fabio\classpath it.fabio


(in classpath ho le cartelle it, poi Fabio e altre numerose sotto cartelle.....

ma mi si blocca dicendomi "no source files for package it.fabio"


eppure la macchina è installata non bene ... benissimo!!!

[kingv]

ho letto la documentazione, sembra sia cambiato qlc con il jdk 1.4


prova

javadoc -d c:\Doc\html -sourcepath C:\Java\Projects\Fabio\classpath -subpackages it.fabio

[petitof]

perfetto!! funziona!!grazie!!.. l'unica cosa è che si blocca perchè trova degli errori....ora controllo se c'è un opzione che eviti di ricompilare i sorgenti....

[petitof]

ma scusa in teoria non dovrebbe solamente analizzare i sorgenti e creare gli html...

[kingv]

sì.
e' un po' che non lo uso, cos'e' che fa, ricompila i sorgenti?

[petitof]

mi si blocca perchè trova degli errori...

[kingv]

Originariamente inviato da petitof
mi si blocca perchè trova degli errori...

ma trova degli errori nella sintassi javadoc o mentre ricompila?

postresti il messagio di errore?

[petitof]

Loading source files for package it.rgi.ext.sinistri.ania...
/home/rgi/javadoc/classpath/it/rgi/ext/sinistri/ania/CCICasellario.java:294: illegal character: \65533
bene.setPercentualeInvalidit�(Double.parseDouble(danni[IDX_NPERCIP]!=null ? danni[IDX_NPERCIP].toString() : "0"));
^
/home/rgi/javadoc/classpath/it/rgi/ext/sinistri/ania/CCICasellario.java:294: not a statement
bene.setPercentualeInvalidit�(Double.parseDouble(danni[IDX_NPERCIP]!=null ? danni[IDX_NPERCIP].toString() : "0"));
^
Loading source files for package it.rgi.ext.sinistri.ania.base...
/home/rgi/javadoc/classpath/it/rgi/ext/sinistri/ania/base/AniaBene.java:107: illegal character: \65533
public double getPercentualeInvalidit�() { return nPercentuale; }//getPercentualeInvalidit�


ed alla fine (perchè questo mess sta in mezzo ad una serie molto lunga di packages)


Loading source files for package it.rgi.appObj...
Loading source files for package it.rgi.appObj.operations...
13 errors


???

[kingv]

4: illegal character: \65533



il problema e' questo, javadoc non fa una vera compilazione ma vuole che i sorgenti siano formalemente corretti per estrarre la documentzione.

apri il file con un editor e guarda che carattere c'e' alla riga dove va in errore.

[Frank1962]

ma non fai prima a scaricarti la documentazione gia fatta?

---> qui <---

---> oppure qui <---

[kingv]

Originariamente inviato da Frank1962
ma non fai prima a scaricarti la documentazione gia fatta?

---> qui <---

---> oppure qui <---

lui vuole la documentazione delle sue classi!

[petitof]

che roba...mi trovo delle A maiuscole accentate........ forse sono causate dal trasferimento da macchine linux a windows...