Difference between revisions of "DesignGuidelines/es"
From Free Pascal wiki
Jump to navigationJump to searchMgsalvador (talk | contribs) |
|||
| (11 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{DesignGuidelines}} | {{DesignGuidelines}} | ||
| + | [[category:Castellano]][[category:Español]] | ||
| + | =Pautas de codificación para Lazarus= | ||
| − | + | '''Esto va dirigido a los desarrolladores de Lazarus:''' | |
| − | + | * Véase [http://svn.freepascal.org/svn/lazarus/trunk/docs/DesignGuidelines.txt docs/DesignGuidelines.txt] | |
| − | |||
| − | * | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
; Estilo de codificación: | ; Estilo de codificación: | ||
| − | * Puesto que un estilo es más fácil de leer, Lazarus sigue las líneas de la guía de estilo de | + | * Puesto que un estilo es más fácil de leer, Lazarus sigue las líneas de la guía de estilo de codificación de Borland. Por supuesto, casi cualquiera encontrará algunos aspectos discutibles, que son menos legibles que otros estilos. Eso es cierto, intente seguir por lo menos el 90%. |
| − | * Intente evitar | + | * Intente evitar unidades en forma de círculo. Esto hace más fácil gobernarla y cuando la unidad está creciendo permite partirla. |
| − | * Reduzca al mínimo el número de llamadas de interfaces | + | * Reduzca al mínimo el número de llamadas de interfaces al LCL, al realizar una acción pedida por el LCL. Los interfaces notifican solamente al LCL, nunca fuerzan algo. El LCL decide. |
* Nombre según la convención, vea [[Nomenclature/es|Nomenclatura]] | * Nombre según la convención, vea [[Nomenclature/es|Nomenclatura]] | ||
| − | * Todo el código debe funcionar con todas comprobaciones (rango, por ejemplo, desbordamiento, apilado). Además esto | + | * Todo el código debe funcionar con todas las comprobaciones (rango, por ejemplo, desbordamiento, apilado). Además esto facilita la depuración, algunos usuarios ponen esas comprobaciones en su fpc.cfg, de modo que se aplican a todo Lazarus. Incluyendo los paquetes y los ejemplos. |
;Archivos nuevos: | ;Archivos nuevos: | ||
| − | * Todos los archivos deben comenzar con una cabecera que | + | * Todos los archivos deben comenzar con una cabecera que contenga la licencia y algunas líneas que describan el contenido. |
* Las fuentes del PASCAL deben tener nombres de fichero en minúscula (pas, pp, inc, lfm, lrs) | * Las fuentes del PASCAL deben tener nombres de fichero en minúscula (pas, pp, inc, lfm, lrs) | ||
| Line 75: | Line 30: | ||
;Dialogos (formas modales): | ;Dialogos (formas modales): | ||
| − | * | + | * Se cierran con Escape (si esa tecla no tiene otro cometido). |
| − | * | + | * Se define el botón por defecto e Intro lo activa (si esa tecla no tiene otro cometido). |
| − | * | + | * Todos los diálogos, entre medios y complejos, deben ser redimensionables y su tamaño se debe almacenar. |
| − | + | ;Elementos del Menú Principal: | |
| − | * | + | * Deben tener una tecla en keymapping.pp |
| − | ' ' | + | ''La versión autorizada se puede encontrar en el [http://svn.freepascal.org/svn/lazarus/trunk/docs/DesignGuidelines.txt svn]. Se pueden añadir propuestas de mejora en la página de charla (discusión)''. |
Latest revision as of 22:21, 12 June 2008
│
Deutsch (de) │
English (en) │
español (es) │
français (fr) │
日本語 (ja) │
한국어 (ko) │
português (pt) │
русский (ru) │
Pautas de codificación para Lazarus
Esto va dirigido a los desarrolladores de Lazarus:
- Estilo de codificación
- Puesto que un estilo es más fácil de leer, Lazarus sigue las líneas de la guía de estilo de codificación de Borland. Por supuesto, casi cualquiera encontrará algunos aspectos discutibles, que son menos legibles que otros estilos. Eso es cierto, intente seguir por lo menos el 90%.
- Intente evitar unidades en forma de círculo. Esto hace más fácil gobernarla y cuando la unidad está creciendo permite partirla.
- Reduzca al mínimo el número de llamadas de interfaces al LCL, al realizar una acción pedida por el LCL. Los interfaces notifican solamente al LCL, nunca fuerzan algo. El LCL decide.
- Nombre según la convención, vea Nomenclatura
- Todo el código debe funcionar con todas las comprobaciones (rango, por ejemplo, desbordamiento, apilado). Además esto facilita la depuración, algunos usuarios ponen esas comprobaciones en su fpc.cfg, de modo que se aplican a todo Lazarus. Incluyendo los paquetes y los ejemplos.
- Archivos nuevos
- Todos los archivos deben comenzar con una cabecera que contenga la licencia y algunas líneas que describan el contenido.
- Las fuentes del PASCAL deben tener nombres de fichero en minúscula (pas, pp, inc, lfm, lrs)
- Archivos Include
- Deben comenzar con la directiva {%MainUnit}
- Paquetes
- Deben tener una entrada .lpl en packager/globallinks/
- Dialogos (formas modales)
- Se cierran con Escape (si esa tecla no tiene otro cometido).
- Se define el botón por defecto e Intro lo activa (si esa tecla no tiene otro cometido).
- Todos los diálogos, entre medios y complejos, deben ser redimensionables y su tamaño se debe almacenar.
- Elementos del Menú Principal
- Deben tener una tecla en keymapping.pp
La versión autorizada se puede encontrar en el svn. Se pueden añadir propuestas de mejora en la página de charla (discusión).
