PDA

View Full Version : [JavaDoc] Cercasi genio!

petitof
10-06-2004, 16:07
qual'è secondo voi il metodo migliore per prelevare la documentazione da numerose classi java disposte in package differenti?:muro:
kingv
10-06-2004, 16:12
che vuol dire "prelevare"?


hai i file .java e devi generare il javadoc?
petitof
10-06-2004, 16:30
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
10-06-2004, 17:07
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
10-06-2004, 17:32
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
10-06-2004, 19:57
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
11-06-2004, 09:01
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
11-06-2004, 09:17
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
11-06-2004, 10:36
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
11-06-2004, 10:46
ma scusa in teoria non dovrebbe solamente analizzare i sorgenti e creare gli html...
kingv
11-06-2004, 11:36
sì.
e' un po' che non lo uso, cos'e' che fa, ricompila i sorgenti? :confused:
petitof
11-06-2004, 11:38
mi si blocca perchè trova degli errori...
kingv
11-06-2004, 11:39
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
11-06-2004, 11:47
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


???


:muro:
kingv
11-06-2004, 11:53
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
12-06-2004, 01:09
ma non fai prima a scaricarti la documentazione gia fatta?

---> qui (http://jdl.sun.com/webapps/download/Redirect/335702813/5847479377282807053505607246086069333228071972022813600060192859339008063305596058473206-3866/j2sdk-1_4_2-doc.zip) <---

---> oppure qui (http://jdl.sun.com/webapps/download/Display?BundleId=8602&Download+J2SE+1.4.2+Documentation.x=22&Download+J2SE+1.4.2+Documentation.y=7) <---
kingv
12-06-2004, 09:55
Originariamente inviato da Frank1962
ma non fai prima a scaricarti la documentazione gia fatta?

---> qui (http://jdl.sun.com/webapps/download/Redirect/335702813/5847479377282807053505607246086069333228071972022813600060192859339008063305596058473206-3866/j2sdk-1_4_2-doc.zip) <---

---> oppure qui (http://jdl.sun.com/webapps/download/Display?BundleId=8602&Download+J2SE+1.4.2+Documentation.x=22&Download+J2SE+1.4.2+Documentation.y=7) <---


:rotfl:

lui vuole la documentazione delle sue classi!
petitof
14-06-2004, 09:04
che roba...mi trovo delle A maiuscole accentate........ forse sono causate dal trasferimento da macchine linux a windows...