Newsgroup: it.comp.www.php
Titolo: Commenti con "@"

Qualcuno ha mai sentito parlare dei commenti prefissi da una
chiocciolina? del tipo:
@commento.
Ho sentito dire che alcuni editor li interpretano in modo particolare,
e volevo saperne di più.
Però in giro non riesco a trovare niente sull'argomento??
Ciao e grazie.

Kaisersose ha scritto:

http://phpdoc.org

 Però in giro non riesco a trovare niente sull'argomento??
Questo lo puoi sapere solo tu.

Sono per phpdoc come diceva Kaisersose...
Ad esempio in Eclipse se scrivi una funzione e la commenti in quel modo,
magari la richiami in un altro file, se ci passi sopra con il mouse esce
un popup con la tua mini-reference:
@param
@return
ecc...
Ciao, MrPink

Sai dove potrei trovare qualcosa sull'argomento??
Grazie, mille
MrPink ha scritto:


 Sai dove potrei trovare qualcosa sull'argomento??
Su google :)
Per Php documentor questa è la sua home:
http://www.phpdoc.org/
Se invece ti interessa il php ide di eclipse puoi andare a vedere qui:
http://www.eclipse.org/php/
Se non sei pratico di eclipse ti consiglio di scaricarti la versione
all-in-one di php ide
Ciao

 all-in-one di php ide
sconsiglio caldamente l'uso di eclipse. mi dico che per java sia io non
plus ultra, ma per php e' al limite dell'inusabilita'. parliamo di un
ide che non ha il wordwrap delle righe, devi scaricati un plugin apposta

 ide che non ha il wordwrap delle righe, devi scaricati un plugin apposta
E' vero che non ha il wordwrap ma è un editor in forte sviluppo, tra
l'altro con il supporto di zend. Ha un DEBUGGER, reference delle funzioni
di php via popup, highlight del codice di linguaggi diversi nello stesso
file ecc...
Insomma, non fa così schifo.
Ciao, MrPink



Personalmente mi ci trovo abbastanza bene. Ha quello che mi serve: tree
del progetto, tree delle classi, supporto CVS e SVN, highlight di php,
html, css e js, autocomplete anche delle funzioni di classi che scrivo io,
ecc.
Odio il wordwrap mentre programmo. Se una riga e` troppo lunga la spezzo.
Se una parte di codice e` troppo indentata (uso tab da 4 spazi) la metto
in una funzione e la richiamo.
Il codice che scrivo non supera mai le 90-100 colonne. Su un banale 17" a
1280x1024 ci stanno tranquillamente col tree del progetto a sinistra.
In Eclipse ho messo in tree delle classi SOTTO il tree del progetto,
altrimenti la finestra di editing e` veramente troppo piccola.
Bye.

 ecc.
parliamo dell'autocomplete:
quando apri una virgoletta ne mette una di chiusura automaticamente,
cosi' come per le tonde e le quadre. problema, se continui a scrivere e
ridigiti il carattere di chiusura con le tonde e le quadre, te lo
duplica. quindi o poi lo cancelli o sei costretto a spostarti colle
frecce cursore tra i caratteri aperti e chiusi, in ogni caso
interrompendo la continuita' di digitazione. altro problema di
autocompletamento: se sei in una stringa e vai a capo automaticamente
la chiude, la concatena e la riapre nella riga successiva, cosa
inutile, inelegante e che fa perdere tempo al parser: nota, questo
comportamento non si puo' disabilitare.
questi sono solo due esempi di cose banali ma gestite male, eclipse ne
e' pieno, sono le basi di qualsiasi buon editor (o semplicemente comodo
e che non ti obblighi a perdere tempo per adeguarti a quello che vuole
lui, invece che lui adeguarsi a quello che vuoi tu).
quanto al wordwrap: non e' concepibile che io condizioni la lunghezza
delle mie righe di codice ai limiti dell'editor. una programmazione
pulita puo' richiedere righe piu' lunghe di 90 caratteri (o quello che
era). se ci va un operatore ternario non e' che uso un if esteso solo
perche' altrimenti non vedrei la fine della stringa nel monitor.
e' un'altra delle ennesime funzioni di base che eclipse non gestisce o
gestisce male.
poi si puo' usare: io l'ho usato per tre mesi in ufficio, ma mi ha
fatto perdere un 30% del tempo impiegato per scrivere del codice
elegante e pulito.