DesignGuidelines/es

From Free Pascal wiki
Jump to: navigation, search

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).