Newsgroup: it.comp.lang.delphi
Titolo: Standard nomi delle cose

Sto iniziando a utilizzare delphi, ma mi trovo in difficolta quando
devo dare i nomi alle cose
Ad iniziare dai nomi dei file 
File di codice, file di progetto e form
fino ad arrivare ai nomi degli oggetti
button1,button2,button3....
Per distinguerle un bottone da un altro oggetto
per esempio ho adottato il sistema di far precedere il nome da una
'b' ---  bMyButton.
Ritengo probabile che esista già uno standard per la nomencaltura
delle cose. 
Mi sapete dire dove reperirla?
Un altra cosa...
Volevo sapere se c'è un utility di <<beautify>> del testo oltre
naturalmente all'identazione automatica.
Ritengo che sarebbe utile qualcosa che una volta termminato di
scrivere la procedura la identasse correttamente al posto mio.
Magari che mi mettesse anche i commenti  //endproc pincopallino
//endif o //endfor //.... al termine degli end; che delimitano i
blocchi di istruzioni.

 blocchi di istruzioni.
non ne ho idea, anche se i guru dicono che un codice pascal scritto bene
non dovrebbe aver bisogno di commenti ;)
Ciao,
Alan Solo

"Z80" ha scritto nel messaggio
| Sto iniziando a utilizzare delphi, ma mi trovo in difficolta quando
| devo dare i nomi alle cose
|
Uno standard di 'formattazione' del sorgente esiste - roba della
Borland International ... - ma non do' dirti dove trovarlo :).
Per i componenti, io utilizzo i prefissi proposti sul libro "Delphi 4"
di Pacheco e Teixeira. Qualche esempio:
TLabel: lbl
TButton: btn
TSpeedButton: sb
e via cosi' ... (sono sei pagine intere, ogni componente fornito con
Delphi ha il suo prefisso!!!).
IMO, troverai il metodo a te piu' consono, con i prefissi e la
'nomeclatura' che ti facilitano e velocizzano lo sviluppo e il
mantenimento dell'applicazione, solo dopo un po' di esperienza
pratica. A quel punto scoprirai di avere un TUO standard personale,
con il quale ti troverai a meraviglia, e i 'nomi delle cose' ti
verranno spontaneamente.
Se devi fare un lavoro di gruppo, pero', dimentica tutto quanto ti ho
appena detto ... :)
| Volevo sapere se c'è un utility di <<beautify>> del testo oltre
| naturalmente all'identazione automatica.
Esiste DelForExp, un formatter freeware, ma non l'ho mai usato e non
posso darti giudizi in merito.
Lo trovi qui: 
http://www.slm.wau.nl/wkao/delforexp.html
Sicuramente ne esisteranno altri, ma purtroppo non li conosco.
Ciao.
---------------------------
ACSH
"Non voglio un mondo migliore:
 voglio un mondo piu' interessante!"

 non dovrebbe aver bisogno di commenti ;)
Io non sono un guru ma non sono d'accordo: i commenti servono eccome.
Certo che scrivere buoni commenti non è semplicissimo... ricordo un articolo
di Charlie Calvert (...inchino profondo...) a proposito... anche questo l'ho
stampato ma non ho il link...
Comunque potete sbirciare la "Object Pascal Style Guide" sul sito borland e
questo simpatico link: 
www.mindprod.com
 ci dovrebbero essere due sezioni:
"How To Write Unmaintainable Code" e "how to code like a newbie".... carine
davvero ma mi raccomando: sono cose da evitare ! ;-)
--
Andrea Magni
E-Mail: 
ama...@interac.it

naturalmente all'identazione automatica.
v. ad es. SourceCoder (se ancora esiste) a 
www.preview.org
 
hth
Paolo Arosio

non dovrebbe aver bisogno di commenti ;)
Si, per i gurù... Ma noi comuni programmatori più o meno dilettanti?
Ciao, Alla prossima.

Io non sono un guru ma non sono d'accordo: i commenti servono eccome.
Sono daccordo con Te' anche sulla difficoltà di scrivere commenti.
Quelle volte che ci provo, sono sempre più confusi del codice, che
tutto sommato non mi riesce male.
In quanto hai guru... Per alcuni è chiaro anche un bel codice
assembler...

Lo trovi qui: 
http://www.slm.wau.nl/wkao/delforexp.html
Appena ho un minuto ci guardo..
Grazie

On Wed, 10 Jan 2001 09:29:19 GMT, 
paolo...@yahoo.com
 (Paolo Arosio)
wrote:

Grazie anche a te. 
Nel fine settimana ci farò un salto.

2) Un Formattatore automatico di codice [....]
Ringrazio Tutti per il contributo fornito nella
ricerca e riassumo quanto da me scaricato
dopo aver seguito i link consigliati.
Per quanto riguarda la nomenclatura  ho trovato interessante
il seguente documento in formato PDF:
http://www.projectoo.com/free/stdcoddphv101.zip
(nota sul sito 
http://www.projectoo.com/
 ci sono anche altre
informazioni che potrebbero essere interessanti e lo stesso documento
in formato HTML)
Per quanto riguarda la formattazione del codice 
potete scaricare:
Delphi Formatter e Delphi Formatter Standalone version
dai seguenti link (contiene anche parte del sorgente)
http://www.slm.wau.nl/wkao/downloads/DelForEx.zip
http://www.slm.wau.nl/wkao/downloads/DelFor.zip
Di questi due programmi per ora ho provato solo la versione
DelForEx.zip su un progetto di piccole dimensioni, 100 righe,
e già sintatticamente corretto (non escludo danni se per esempio 
trova una parentesi aperta è non chiusa. in un caso simile
danni li ho visti fare dal beautify integrato di VisualFoxPro5.0
della Microsoft). Ad ogni modo ha fatto un bel lavoro e alla fine 
il programma funzionava ancora. Sul'IDE di  delphi 5 viene
aggiunta la voce Source formatter nel menu tools che apre una
maschera contenente anche la possibilità di configurazione del tools.
Mette ottimamente a posto l'identazione
A mio parere manca ancora un commento al termine degli end
che in caso di nidificazioni un poco spinte sarebbe utile.
procedure pippo
begin 
	while .... do 
	begin
		if...    
		begin
			if...
			begin
				......
			end //endif (magari con un Id di livello) 
		end //endif
	end //end while
end //endpippo

Chiaro il programma funziona anche con nomi a cazzo,
ricordo di aver letto di un programmatore, all'epoca della console 
Intellivision della Mattel, che dovette mettere mano ad un progetto 
iniziato da un altro sviluppatore, e grande fu la sua sorpresa quando vide 
che i nomi delle procedure e delle variabili consistevano in una serie di 
pesantissime ma ingegnosissime bestemmie, insulti e volgarità assortite :)

 Si, per i gurů... Ma noi comuni programmatori piů o meno dilettanti?
era una pseudo battuta, anche se un po' di verita' c'e'
....per prima cosa e bene scrivere il codice chiaro,
con nomi di variabili/eventi/membri che si autocommentino
es. che mi viene in mente
"Application.ShowMainForm" salta subito all'occhio a cosa serve,
se i prograqmmaroti Borland l'avessero chiamata 
"Application.smf" ?
cmq, come dici tu (a anche io), guro o no,
commentate gente, commentate, mi raccomando! ;)
Ciao,
Alan Solo