Changes between Version 2 and Version 3 of NameBlock

Timestamp:

Feb 27, 2009, 10:16:27 AM (16 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

NameBlock

@@ -246 +246 @@
     Esto reduce el uso actual de scope dinámico en la pila local de llamadas de funciones, lo cual puede ayudar a medio plazo a reconducir a los usuarios de TOL a los estándares de programación.
 
-=== Ventajas ===
+== Ventajas ==
 
 Las ventajas que aportan los NameBlock's se pueden resumir en que da facilidades para alcanzar mayor modularidad, mejor organización y legibilidad y mayor reusabilidad del código.
 
-==== Modularidad ====
+=== Modularidad ===
 
     La principal utilidad del NameBlock es dotar a TOL de un mecanismo de modularidad más allá del fichero que permita construir módulos, paquetes y librerías robustamente organizados. Una forma prudente de anidar los NameBlock's sería en este caso: lib_id::package_id::module_id
@@ -269 +269 @@
     Real DBOpen(cfg::db::alias, cfg::db::user, cfg::db::pwd);
 
-==== Flexibilidad ====
+=== Flexibilidad ===
 
     Las funciones que devuelven conjuntos heterogéneos también ganarían flexibilidad, expresibilidad y facilidad de mantenimiento y uso sin recurrir a la definición de estructuras locales
@@ -293 +293 @@
     ]]};
 
-==== Generación automática de documentación ====
+=== Generación automática de documentación ===
     A efectos de generación automática de documentación de un NameBlock, se cuenta con la función Set Members(NameBlock root) que devuelve un listado de los miembros públicos contenidos en un NameBlock y sus hijos de forma recursiva, con un registro para cada uno con la siguiente estructura informativa ordenada de la forma natural indicada por los propios campos:
 {{{
@@ -306 +306 @@
     };
 }}}
-===== Miembros de documentación accesibles de sólo lectura =====
+==== Miembros de documentación accesibles de sólo lectura ====
     Son miembros de sólo lectura de la forma _.autodoc.<sufix>
 
@@ -314 +314 @@
         * _.autodoc.authors: Si un NameBlock contiene un miembro privado Set _.autodoc.authors este se usará en los mecanismos de generación automática para identificar a los autores del código. 
 
-===== Funciones de información relacionadas =====
+==== Funciones de información relacionadas ====
 
         * Text GetNameBlock(Anything obj): Devuelve el nombre completo del NameBlock al que pertenece un objeto. Si no pertenece a ninguno devuelve la cadena vacía "".