PDA

Ver la Versión Completa : Nomenclatura Delphi


olbeup
09-09-2005, 04:13:32
Hola Gente,

Estoy buscando la nomenclatura de progracion en delphi, hay por la red un fichero que habla de ello, me podeis decir donde lo puedo encontrar.

Saludos. ;)

dec
09-09-2005, 04:50:32
Hola,

Tal vez te refieras a este documento: Object Pascal Style Guide (http://community.borland.com/soapbox/techvoyage/article/1,1795,10280,00.html). Hace tiempo se mencionó aquí mismo (http://www.clubdelphi.com/foros/showthread.php?t=6177).

DarKraZY
09-09-2005, 09:21:34
Yo mismo busqué información sobre este tema. Pero la verdad sin ninguna solución. El link que ha puesto Dec es a la "guía de Borland"... pero si miramos muchos de los pas de la VCL veremos que ni ellos la respetan, además de que está bastante desfasada.

La gente de JEDI también empezó a hacer algo, pero nunca la terminaron creo. Y como bien dice el artículo... lo mejor es utilizar una herramienta que te formatee el código. En sourceforge.net puedes encontrar una de los JEDI y por la red hay varias más.

Neftali [Germán.Estévez]
09-09-2005, 10:37:12
Yo acostumbro a utilizar ambos sistemas; Utilizo un sistema de formateo muy similar al de Borland (con algunos cambios que he realizado, porque algunas cosas no acaban de gustarme, pero el 95% está basado en ese documento); Y utilizo un experto que a veces utilizo cuando quiero revisar.

Se trata de DelForExp de Egbert van Nes (que por cierto al acceder a la página acabo de ver que hay versión nueva); Soporta hasta D2005 y es bastante configurable y simple; Gratuíto y con fuentes.

http://www.dow.wau.nl/aew/DelForExp.html

olbeup
09-09-2005, 10:54:05
dec, DarKraZY, Neftali Gracias.

El programa se instala en Delphi 5 en cuestión de segundos y esta en la segunda opción de "Tools" y se llama "Source Formatter Ctrl+D".

P.D.: Funciona Genial.

Saldudos. ;)

delphi.com.ar
09-09-2005, 14:05:13
...si miramos muchos de los pas de la VCL veremos que ni ellos la respetan..
No estoy de acuerdo con eso, o no he visto el código al que haces referencia... ¿Tienes un ejemplo?... simplemente curiosidad! ;)

La gente de JEDI también empezó a hacer algo, pero nunca la terminaron creo.
Existe hace tiempo, se llama Jedi Code Format (http://jedicodeformat.sourceforge.net/), y soy un usuario habitual de esta herramienta desde hace años, es formidable para procesar código sin formato bajado de Internet.

PD: Yo he sugerido ese link en el hilo viejo, que si no me equivoco lo leí de la página del Project Jedi, como exigencia para subir código a esta :D

Saludos!

DarKraZY
09-09-2005, 16:08:53
No estoy de acuerdo con eso, o no he visto el código al que haces referencia... ¿Tienes un ejemplo?... simplemente curiosidad! ;)

Por ejemplo en la unit Forms dentro de este método function TApplication.ValidateHelpSystem : Boolean;


Result := false;
if FHelpSystem = nil then begin
HelpIntfs.GetHelpSystem(FHelpSystem);
end;
if FHelpSystem <> nil then Result := true;

No es un código del que algunos habremos visto alguna vez y dicho: oh, que horrible! pero...
En el punto 4.4 del documento de Borland
Always place begin statements on their own line
y en el punto 8.2.3
If statements should always appear on at least two lines

PD1: Puede parecer quisquilloso... pero si hay una norma es para cumplirla, ¿no?
PD2: Los chicos de la Developer's Guide, en concreto la 4, también sacaron su guía de estilo.

Neftali [Germán.Estévez]
09-09-2005, 16:13:25
Ya que se ha comentado que el documeno de Borland está desfasado (???) aquí hay algunos otros links referentes al tema; Sobre gustos no hay nada escrito:

http://www.econos.de/delphi/cs.html
http://www.delphi-jedi.org/JCLOPSG:460483 (el ya comentado de la JEDI)
http://delphi.about.com/od/standards/l/bldnc.htm
http://community.borland.com/article/0,1410,10280,00.html (el ya comentado de Borland)

Lepe
09-09-2005, 16:33:06
Existe hace tiempo, se llama Jedi Code Format, y soy un usuario habitual de esta herramienta desde hace años, es formidable para procesar código sin formato bajado de Internet.


Pero advierto que se mire muy bien las preferencias del programa, y se entienda todas las opciones antes de pasarle el JCF a un programa real. Una de las opciones que me dejó frito fue el quitar begin...end cuando solo hay una instrucción. A veces son necesarios para resolver los if anidados que haya, y si el JCF los quita, quedan desfasados y la ejecución del programa varía. Esto ocurre en casos muy concretos, ¡¡pero ocurre!! :(

Una vez configurado correctamente, el JCF es maravilloso ;)

Un saludo

delphi.com.ar
09-09-2005, 16:46:04
Pero advierto que se mire muy bien las preferencias del programa, y se entienda todas las opciones antes de pasarle el JCF a un programa real. Una de las opciones que me dejó frito fue el quitar begin...end cuando solo hay una instrucción. A veces son necesarios para resolver los if anidados que haya, y si el JCF los quita, quedan desfasados y la ejecución del programa varía. Esto ocurre en casos muy concretos, ¡¡pero ocurre!! :(

Una vez configurado correctamente, el JCF es maravilloso ;)

Sino podes bajar el archivo de configuración "como borland suguiere", y listo...