Changes between Version 12 and Version 13 of TolPackageRulesAndComments

Timestamp:

Jun 22, 2010, 6:47:38 AM (15 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

TolPackageRulesAndComments

@@ -56 +56 @@
 {{{StdLib::TolPackage::Server}}}
 
-== Creación de paquetes ==
+== Creación y uso de paquetes ==
  
 Un paquete se crea como un NameBlock pero con una serie de restricciones de 
@@ -78 +78 @@
   * Set _.autodoc.dependencies = [["paquete1","paquete2", ...]];
 
-=== Nomenclatura ===
+=== Nomenclatura y versionado ===
 
  * Los nombres de los paquetes deben seguir el estilo CamelCase 
@@ -87 +87 @@
    como la concatenación del nombre del paquete seguido de un punto, el número 
    _.autodoc.version.high, otro punto y el número _.autodoc.version.low
- * El nombre del NameBlock sin embargo es el mismo siempre por lo que se invocará 
+ * El nombre del NameBlock sin embargo es el mismo siempre, por lo que se invocará 
    sin usar los números de versión.
  * No es posible por tanto cargar dos versiones distintas de un mismo paquete en
    la misma sesión TOL.
  * Sí es posible cargar diferentes versiones de un mismo NameBlock en una misma
-   máquina en sesiones de TOL distintas, coincidentes o no en el tiempo. 
+   máquina en sesiones de TOL distintas, coincidentes o no en el tiempo.
 
 === Código declarativo ===
@@ -141 +141 @@
   * Uso de {{{MakeGlobal}}} (De hecho no debería usarse nunca)
  * Como excepción a lo anterior sí está permitido el uso de {{{ PutStructure }}} ya 
-   que se usa a menudo como mecanismo de documentación interna del código fuente.
+   que se emplea a menudo como mecanismo de documentación interna del código fuente.
  * Si un paquete necesita ejecutar alguna acción antes de ser utilizado deberá
    tener un método [[BR]] {{{ Real StartActions(Real void) { ... }; }}} [[BR]] el 
@@ -151 +151 @@
    sentencias #Require antes de la declaración del primer miembro.
  * Si no se especifican números de versión el #Require cargará la versión más 
-   actual que corresponderá siempre al archivo con el nombre del paquete nada 
-   más. En este caso los paquetes que requiera directa o indirectamente serán
-   también las últimas versiones y no hace falta hacer nada previamente.
- * Si se necesita una versión concreta distinta de la última entonces se debe 
-   cargar previamente cada uno de los paquetes requeridos directa o 
-   indirectamente. Se puede hacer manualmente o bien mediante el método 
-   [[BR]] {{{StdLib::TolPackage::Client::ForceExactRequirements(Text package)}}} [[BR]], 
-   al que hay que llamar antes del #Require de cualquiera de sus dependencias.
+   actual compatible con la versión de TOL que se esté ejecutando. En el
+   caso de la última versión de TOL, corresponderá al archivo con el nombre del 
+   paquete nada más. En este caso, los paquetes que requiera directa o 
+   indirectamente serán también las últimas versiones compatibles con TOL.
+ * Si se solicita una versión concreta, entonces se debe cargar previamente cada 
+   uno de los paquetes requeridos directa o indirectamente. El propio 
+   {{{#Require}}} se encargará de buscar las versiones adecuadas en el 
+   repositorio local, de instalarlas si no las encuentra, y de dar un mensaje 
+   de error si no lo consigue para que se haga manualmente.
  * Téngase en cuenta que no es posible cargar versiones concretas de paquetes que 
    tengan requerimientos de diferentes versiones de un mismo paquete.
@@ -210 +211 @@
       originales, la documentación, los tests y todo aquello que se usó en la 
       construcción.
- * Debe haber un comité o alguien responsable de probar todos los paquetes de
+ * Debería haber un comité o alguien responsable de probar todos los paquetes de
    un repositorio antes de publicar las actualizaciones de los paquetes para 
    asegurar la compatibilidad conjunta de todos ellos.
+