Newsgroup: it.comp.lang.perl
Titolo: Javadoc per perl

Premessa:
java non mi piace sono completamente votato a perl!!! Pero' penso anche che 
le buone idee sono sempre buone idee quindi...
Domanda:
se in programma java metti i commenti in un certo modo poi c'e' un'utility 
che ti stampa tutta la documentazione alle tue funzioni (si chiama 
javadoc).
Esiste una cosa simile in perl (che non sia POD)?
viva perl,
DW
PS: Con tutte le dovute precauzioni (cioe' sono conscio che sono cose 
diverse per usi diversi con linguaggi profondamente diversi) mi sento di 
affermare che POD non e' paragonabile a javadoc... per questo la domanda di 
cui sopra.

affermare che POD non e' paragonabile a javadoc...
E di questo siamo tutti molto lieti.
Ciao.

Esiste una cosa simile in perl (che non sia POD)?
pod2html ?
--
www.pigmalion.info
www.pigmalion.info/perl/

Sě.
Ho letto male: "... (che non sia POD?)..." invece di "(che non sia POD)?".
Intendevo, quindi: sě, certo che č POD.
Per la domanda che realmente hai fatto, invece, non so. Forse c'č anche
qualcosa d'altro (qualcuno si sarŕ forse scritto un preprocessore: di gente
strana ce n'č), ma non saprei proprio. Potresti dare un'occhiata a Lion, se
sei *quel* tipo di persona.
Comunque, POD secondo me riesce giŕ a coprire tutte le esigenze di
documentazione. E anche di presentazione della documentazione, potendo
uscire in svariati formati, da html a PostScript a LaTeX e altri.
Ciao.

 E di questo siamo tutti molto lieti.
Sento un tono lievemente polemico... ma la premessa a mo' di giuramento non 
bastava?

 pod2html ?
Grazie per il suggerimento ma hai mai visto cosa generano le Javadoc?
In pratica creano un sito intero con ogni classe descritta (secondo i tuoi 
commenti nel codice) con l'elenco di tutti i metodi (funzioni) con tutte le 
variabili, parametri ed eccezioni. Inoltre ogni funzione che usa un'altra 
funzione ha un link alla pagina relativa... questo vale anche per i tipi 
(ad esempio se usi una Stringa, cioe' java.lang.String, ti rimanda alla 
documentazione della Sun).
La mia non vuole essere una provocazione ma una constatazione che un sistema 
simile farebbe comodo quando si scrivono applicazioni grosse...
grazie ancora,
DW

Beh, vuoi aiutarmi o no? Mi suggerisci qualcosa?
Ho letto male, ti dico.
Ciao.

ti rimanda alla documentazione della Sun).
Mi pare che sia, nella sostanza, equivalente a quello che si ottiene con
qualunque editor in grado di "taggare" perl; Emacs, per dirne uno. Da qui,
ottenere qualcosa di presentabile non dovrebbe essere particolarmente
complicato. Prova a dare un'occhiata ad Emacs, magari c'è anche già
qualcosa.
Ciao.

Giovanni Zezza wrote:

Ok. Incomprensione risolta. :)

Potresti dare un'occhiata a Lion, se sei *quel* tipo di persona.
Per altre cose nello stesso ordine di pensiero (javadoc, al mio sguardo
affrettato e ignaro assomiglia maledettamente al vecchissimo cweb), prova
questa ricerca su google: "perl literate programming".
Ciao.



De facto, per la documentazione Perl il formato POD rimane quello 
'ufficiale', assai portabile e facilmente stampabile (come stampi e/o gestisci 
una documentazione cartacea a frame?).
Scrivendo un opportuno POD, come tra l'altro dovresti fare con i commenti Java
per javadoc, ottieni ottime documentazioni.
Prova cmq a vedere su 
http://www.officevision.com/pub/p5ee/components.html
(ad es 
http://pdoc.sourceforge.net/
 che genera documentazione del tipo 
http://doc.bioperl.org/releases/bioperl-1.0.2/
): sono componenti proposti
per il progetto P5EE, che ho come obiettivo l'implementazione di un sistema
enterprise scritto in Perl per lo sviluppo di applicazioni complesse.
by
	- Enrico

Giovanni Zezza wrote:

Grazie. Guardo subito.
ciao

 complesse.
Tutti i link sono molto interessanti. Leggero' attentamente.
Grazie,
DW