definitivamente tengo que aprender a documentar en alguna de esas cosas raras que...

[z.facultad/75.42/plaqui.git] / docs / coding_style.txt

diff --git a/docs/coding_style.txt b/docs/coding_style.txt
index ed2e152b87180c9e5ffe7d3cd4fbbe0a91346732..1420e7cf23ff2ce143b1cbc44bb28b90e16cc389 100644 (file)
--- a/docs/coding_style.txt
+++ b/docs/coding_style.txt
@@ -30,3 +30,40 @@ General:
                } else {
                        // otra cosa
                }
+
+Extension de archios :
+  - cpp : source
+       - h   : headers
+       - png : imagenes
+
+Diseño GUI:
+ Este pequeño apartado pretende sugerrir algunos detalles de como nombrar
+ los widgets en el glade para luego hacer mas facil la lectura del codigo
+ final y evitar algunos problemas.
+ La propuesta es nombrar todo Widget que se necesite acceder o al que se le debe
+ programar un callback de la siguiente forma :
+   <pre>_<nombre widget>
+ Donde pre podria ser :
+   - btn : boton
+        - txt : entry (caja de texto)
+        - cmb : combo box
+        - rdo : radio button
+        - img : imagenes
+        - draw : drawing areas
+        - mnu : para los menues
+
+        y asi puede seguir la lista. Un caso particular podria ser el menu.
+        Si tenemos por ejemplo :
+          Archivo   Edicion
+                  Salir    Copiar
+                                 Pegar
+
+       Se podrian nombrar como :
+       mnu_file             mnu_edit
+         mnu_file_exit        mnu_edit_copy
+                                    mnu_edit_paste
+
+       Puede resultar largo, pero por experiencia es mas comodo al trabajar en el
+       codigo y para leerlo. Da una sensacion clara de donde esta cada cosa y de que
+       tipo es widget se trata.
+