Changes between Version 8 and Version 9 of NameBlock

Timestamp:

Feb 27, 2009, 11:22:17 AM (16 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

NameBlock

@@ -252 +252 @@
 
   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
-Legibilidad
+
+=== Legibilidad === 
   Pero un NameBlock podría también ayudar a la legibilidad del código en tareas más humildes, al sustituir llamadas a set[num_field] por set::name_field sin el coste computacional añadido de set["name_field"] y sin tener que definir estructuras de datos espúreas para usar set->name_field 
-Eliminación de variables globales
+
+=== Eliminación de variables globales === 
   Un caso especialmente recomendable es el que afecta a todos los parámetros de configuración y variables globales en general que deberían incluirse dentro de un único NameBlock global para evitar colisiones de nombres.
 {{{
@@ -292 +294 @@
   ]]};
 }}}
+
 === 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:
@@ -305 +308 @@
   };
 }}}
+
 ==== Miembros de documentación accesibles de sólo lectura ====
   Son miembros de sólo lectura de la forma _.autodoc.<sufix>