[PHPDOC] Lo usate? Ci sono alternative? Voi come vi regolate?

[gianiaz]

Ciao a tutti, da qualche settimana ho definitivamente mollato la programmazione procedurale in favore di quella ad oggetti.

I vantaggi sono innumerevoli e non devo essere io, ultimo arrivato, a enumerarli.

Lo sanno anche i sassi però, il vantaggio maggiore della programmazione a oggetti, è la possibilità di riutilizzare gli oggetti.

Il problema però è che (soprattutto in alcune occasioni in cui devo programmare da interfaccia testuale - e quindi non ho a disposizione un IDE come eclipse) è difficile tenere sott'occhio tutti i metodi di una classe.

Visto che ho appena iniziato vorrei farlo per bene, e ad esempio commentare come si deve tutti i metodi per poterne tirare fuori una specie di guida all'utilizzo.

Da una ricerca veloce ho trovato http://www.phpdoc.de/, e vorrei cominciare a studiarmelo.

Ecco un po' di domande:

Lo conoscete?
Lo avete già usato?
Conoscete alternative?
Ci sono particolari controindicazioni nel suo uso?

Qualsiasi commento è ben accetto.

ciao

[gianiaz]

Mi hanno consigliato questo

www.phpdoc.org

Lo sto già usando, a parte la grafica orribile funziona al volo...

[Ratatuia]

io sto iniziando oggi con UML dato che lo stiamo usando in ingegneria del software, se PhpDOC è il porting su Php di Java potrei adottarlo egualmente, solamente che a sempre in ing software era previsto ma quest'anno è stato soppiantato da JML...

[gianiaz]

si esatto, è una cosa del genere.. stessa grafica orribile

[Ratatuia]

Originariamente inviato da gianiaz
si esatto, è una cosa del genere.. stessa grafica orribile

è la grafica di java

[gianiaz]

infatti è orribile :P

comunque stracomoda, sto inzeppando le mie classi di commenti...

ciao

[gianiaz]

Originariamente inviato da Ratatuia
è la grafica di java

Ho sbagliato. :P

Ci sono diversi template, alcuni anche carini... ecco uno shot:

[astros3]

Salve a tutti, riapro questo vecchio thread per segnalaare un problema.
innanzitutto vorrei sapere se usate ancora phpdoc, o c'è qualche alternativa?
Comunque ecco la situazione

++ cat src/disney.php
class Pippo {
    /**
     * @uses Pluto::abbaia()
     */
    function canta() {}
}

class Pluto {
    function abbaia() {}
}
++ phpdoc -d src -t docs
phpDocumentor v3.0.0

Parsing files
...

Se con il mio browser apro la pagina docs/classes/Pluto.html#method_abbaia
dovrebbe comparire da qualche parte "usesby Pippo::canta"
Perchè non compare?

Almeno spero di aver capito il manuale
https://manual.phpdoc.org/HTMLSmarty....uses.pkg.html

Bohhh... qualche suggerimento?

[astros3]

Per maggiore chiarezza ecco un paio di screenshort

https://pasteboard.co/K1I7YFq.png
https://pasteboard.co/K1I8oHM.png

Come vedete, nella pagina Pippo c'è il tag uses Pluto::abbaia().
Di conseguenza, nella pagina Pluto ci dovrebbe essere il tag usesby Pippo::canta(), ma non c'è.
Perchè?

[Alhazred]

Salve a tutti, riapro questo vecchio thread ...

Cosa contraria al regolamento.
Apri una nuova discussione per favore.