Ir al contenido


Foto

Plantillas de documentación para GExperts


  • Por favor identifícate para responder
9 respuestas en este tema

#1 Delphius

Delphius

    Advanced Member

  • Administrador
  • 6.295 mensajes
  • LocationArgentina

Escrito 18 julio 2013 - 08:51

Hola a todos,
Técnicamente no es un programa utilitario, pero me parece el lugar más apropiado para dejarles mis plantillas o macro para documentación que yo utilizo. Esta diseñada para el experto GExpert, aunque con unos cuantos cambios bien que se la puede portar a la de CnPack.

La posición puede ser de tipo Línea o Cursor. La de tipo línea quiere decir que la documentación se colorará justo al comienzo del renglón en donde esté el cursor actualmente. Por su parte, la del tipo Cursor indica que se generará justamente donde esté el cursor.
Hay un tercer tipo de posición que le permite colocarse al principio del archivo pero yo no la utilizo.

Unidades


delphi
  1. {-------------------------------------------------------------------------------
  2.  Unidad: %UNIT%
  3.  Directorio: %UNITDIR%
  4.  Fecha: %DATETIME%
  5.  Autor: (%PROGRAMMERINITIALS%) %PROGRAMMERNAME%
  6.  Versión: 0.<M.n.c>
  7.  *******************************************************************************
  8.  Descripción:
  9.  |
  10.  Véase: <LISTA-DOCS>
  11.  Historial:
  12.  <Version>:
  13.   [+] <descripción-añadidos>
  14.   [-] <descripción-eliminados>
  15.   [=] <descripción-mejoras>
  16.   [/] <descripción-planificados>
  17.   [*] <descripción-defectos>
  18.  ------------------------------------------------------------------------------}



Posición: Cursor

Clases:


delphi
  1. {-------------------------------------------------------------------------------
  2.  Clase: %CLASS%
  3.  Fecha: %DATETIME%
  4.  Versión: 0.<M.n.c>
  5.  *******************************************************************************
  6.  Descripción:
  7.  |
  8.  Véase: <LISTA-DOCS>
  9.  ------------------------------------------------------------------------------}



Posición: Cursor, Antes de la clase

Interfaces:


delphi
  1. {-------------------------------------------------------------------------------
  2.  Interfaz: %INTERFACE%
  3.  Fecha: %DATETIME%
  4.  Versión: 0.<M.n.c>
  5.  *******************************************************************************
  6.  Descripción:
  7.  |
  8.  Véase: <LISTA-DOCS>
  9.  ------------------------------------------------------------------------------}



Posición: Línea, antes de la inferface

Métodos:


delphi
  1. %BEFORE%{---------------------------------------------------------------------------
  2.  Método: %CLASS%.%METHODCLASS%
  3.  Fecha: %DATETIME%
  4.  Versión: 0.<M.n.c>
  5.  ***************************************************************************
  6.  Parámetros:%BEGINPARAMLIST%
  7.  * %PARAMNAME%: %PARAMTYPE% = %PARAMDEF% 
  8.   <Descripción-parámetro-%PARAMNAME%>%ENDPARAMLIST%
  9.  Resultado: %RESULT%
  10.  * <valor>: <descripción-resultado>
  11.  Excepciones:
  12.  * <Excepction>: <Descripción-excepción>
  13.  Descripción:
  14.  |
  15.  Véase: <LISTA-DOCS>
  16.  --------------------------------------------------------------------------}



Posición: Cursor, antes del método

Registros:


delphi
  1. {-----------------------------------------------------------------------------
  2.  Registro: %CLIPBOARD%
  3.  Fecha: %DATETIME%
  4.  Versión: 0.<M.n.c>
  5.  *****************************************************************************
  6.  Campos:
  7.  * <campo>: <tipo>
  8.   <Descripción-campo>
  9.  Descripción:
  10.  |
  11.  Véase: <LISTA-DOCS>
  12.  ----------------------------------------------------------------------------}



Posición: Cursor
NOTA: El nombre del registro debe haberse copiado previamente. La plantilla lee el contenido del portapapeles para armar la plantilla.

Enumerados:


delphi
  1. {-----------------------------------------------------------------------------
  2.  Enumerado: %CLIPBOARD%
  3.  Fecha: %DATETIME%
  4.  Versión: 0.<M.n.c>
  5.  *****************************************************************************
  6.  Valores:
  7.  * <valor>: <descripción-valor>
  8.  Descripción:
  9.  |
  10.  Véase: <LISTA-DOCS>
  11.  ----------------------------------------------------------------------------}


Posición: Cursor
NOTA: Funciona igual que la plantilla para registros, lee la info desde el portapapeles.

Proyectos (.dpr)


delphi
  1. {-------------------------------------------------------------------------------
  2.  Proyecto: %PROJECTNAME%
  3.  Fecha: %DATETIME%
  4.  Versión: 0.<M.n.c>
  5.  ===============================================================================
  6.  Producto: %VERPRODUCTNAME%
  7.  Nombre Interno: %VERINTERNALNAME%
  8.  Descripción Projecto: %VERFILEDESCRIPTION%
  9.  Versión Producto: %VERPRODUCTVERSION%
  10.  Versión Archivo: %VERFILEVERSION%
  11.  *******************************************************************************
  12.  Descripción:
  13.  |
  14.  Véase: <LISTA-DOCS>
  15.  ------------------------------------------------------------------------------}


Posición: Línea

Separadores:


delphi
  1. // -------------------------------------------------------------------------- //
  2. // %SELECTION%
  3. // -------------------------------------------------------------------------- //


Posición: Línea

Fin Método:


delphi
  1. %BEFORE%{* Fin M. %METHODCLASS% *}


Posición: Cursor

Espero que les sea de utilidad para ustedes.

Saludos,
  • 0

#2 Desart

Desart

    Advanced Member

  • Miembro Platino
  • PipPipPip
  • 715 mensajes
  • LocationEspaña

Escrito 18 julio 2013 - 09:11

Lo acabo de probar y funciona genial, muchas gracias Delphius  (y)
  • 0

#3 Rolphy Reyes

Rolphy Reyes

    Advanced Member

  • Moderadores
  • PipPipPip
  • 2.092 mensajes
  • LocationRepública Dominicana

Escrito 18 julio 2013 - 09:17

Saludos.

Disculpen mi ignorancia, he utilizado el Source Template de CnPack pero no encuentro el GExperts.

¿Me podrían guiar?
  • 0

#4 Delphius

Delphius

    Advanced Member

  • Administrador
  • 6.295 mensajes
  • LocationArgentina

Escrito 18 julio 2013 - 09:36

Hola Rolphy,
GExperts es otro experto. La página oficial es ésta.
Una vez que los tengas instalado ve a GExpert > GExpert Configuration.
En la solapa Editor Experts verás al experto Expand Macro Template (no recuerdo cual era el shortcut por defecto, yo lo alteré, por ello te indico por estos pasos). Selecciónalo y y luego presiona en Configure.
Allí ya podrás crear tus propias plantillas.

Saludos,
  • 0

#5 egostar

egostar

    missing my father, I love my mother.

  • Administrador
  • 14.446 mensajes
  • LocationMéxico

Escrito 18 julio 2013 - 10:40

Hola

Yo no uso ni GExpert ni cnPack, pero me gusta documentar todo mi código, cambios, fechas, quien lo solicitó, quien lo hizo, motivo, etc....

Saludos
  • 0

#6 Delphius

Delphius

    Advanced Member

  • Administrador
  • 6.295 mensajes
  • LocationArgentina

Escrito 18 julio 2013 - 11:48

Hola

Yo no uso ni GExpert ni cnPack, pero me gusta documentar todo mi código, cambios, fechas, quien lo solicitó, quien lo hizo, motivo, etc....

Saludos

Tengo entendido que las versiones 2006+ ya cuenta con plantillas para esto así que en este sentido GExperts y/o CnPack sobran.

Saludos,
  • 0

#7 Rolphy Reyes

Rolphy Reyes

    Advanced Member

  • Moderadores
  • PipPipPip
  • 2.092 mensajes
  • LocationRepública Dominicana

Escrito 18 julio 2013 - 05:04

Hola Rolphy,
GExperts es otro experto. La página oficial es ésta.
Una vez que los tengas instalado ve a GExpert > GExpert Configuration.
En la solapa Editor Experts verás al experto Expand Macro Template (no recuerdo cual era el shortcut por defecto, yo lo alteré, por ello te indico por estos pasos). Selecciónalo y y luego presiona en Configure.
Allí ya podrás crear tus propias plantillas.

Saludos,


Saludos.

@Delphius, no me exprese correctamente, si uso GExperts y CnPack, lo que desconocía era que GExperts podía generar templates como lo hace CnPack.

En la empresa usamos D2007, D2010 y DXE2, aún con los generadores nativos opto por los de CnPack y ahora incluiré a GExperts.

Gracias por el tip.
  • 0

#8 Delphius

Delphius

    Advanced Member

  • Administrador
  • 6.295 mensajes
  • LocationArgentina

Escrito 18 julio 2013 - 06:47


Hola Rolphy,
GExperts es otro experto. La página oficial es ésta.
Una vez que los tengas instalado ve a GExpert > GExpert Configuration.
En la solapa Editor Experts verás al experto Expand Macro Template (no recuerdo cual era el shortcut por defecto, yo lo alteré, por ello te indico por estos pasos). Selecciónalo y y luego presiona en Configure.
Allí ya podrás crear tus propias plantillas.

Saludos,


Saludos.

@Delphius, no me exprese correctamente, si uso GExperts y CnPack, lo que desconocía era que GExperts podía generar templates como lo hace CnPack.

En la empresa usamos D2007, D2010 y DXE2, aún con los generadores nativos opto por los de CnPack y ahora incluiré a GExperts.

Gracias por el tip.

Ha, ya veo. Yo entendí mal. Pensé que cuando dijiste que no encontrabas GExperts te referías a que no lo veías entre las opciones de CnPack y que era del mismo "paquete". Mil disculpas.

Yo opté por el de GExperts porque tiene algo, al menos el de para D6, que no me ofrece CnPack (yo al menos no le encontré): el %BEFORE%. Esto permite que en lugar de que examine hacia adelante, lo haga hacia atrás.
Con CnPack no he logrado esto y me obliga a que la documentación preceda siempre a la declaración. ¿Tu sabrías decirme si se puede hacer eso con CnPack? Porqueyo no lo logré.
Y otra cosa que no le entendí es el uso de %ARGLIST% y el de %ARGUMENTS%.

Saludos,
  • 0

#9 Rolphy Reyes

Rolphy Reyes

    Advanced Member

  • Moderadores
  • PipPipPip
  • 2.092 mensajes
  • LocationRepública Dominicana

Escrito 18 julio 2013 - 06:51

Saludos.

No he usado la herramienta a plenitud en ese sentido como para poder explicarte, solo la he usado para agregar Initialization y Finalization a las unidades además de una breve descripción al inicio de la unidad.

Pero ya que estamos en eso, haré lo posible por sacar tiempo para realizar pruebas. ;)

  • 0

#10 ELKurgan

ELKurgan

    Advanced Member

  • Miembro Platino
  • PipPipPip
  • 566 mensajes
  • LocationEspaña

Escrito 18 julio 2013 - 11:16

Gracias por el aporte

(y) (y)
  • 0




IP.Board spam blocked by CleanTalk.