Changes between Version 25 and Version 26 of TolPackageRulesAndComments

Timestamp:

Oct 18, 2010, 5:50:07 PM (14 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

TolPackageRulesAndComments

@@ -3 +3 @@
 = !TolPackage: Un sistema de desarrollo modular en red  =
 
-== Objetivos ==
+== Introducción ==
 
 El objetivo principal de este sistema es que los usuarios finales que no
 colaboran en el desarrollo de las librerías de uso más o menos genérico, 
 no tengan que preocuparse de dónde se encuentra el código fuente de las 
-mismas ni tenga que tener instalados programas para compartir código como 
+mismas, ni tenga tampoco que tener instalados programas para compartir código como 
 CSV o SVN. El usuario sólo necesita saber una URL remota o un camino local 
 donde se encuentran los paquetes y el nombre de los que necesita. El 
@@ -16 +16 @@
 El otro gran objetivo es fomentar la creación de utilidades concretas que
 se puedan cargar atómicamente sin necesidad de compilar cantidades ingentes 
-de código del cual luego se usa sólo una pequeña parte la mayor parte de 
+de código, del cual luego se usa sólo una pequeña parte la mayoría de 
 las veces. El usuario no necesita saber qué paquetes dependen de cuáles 
 sino que son ellos mismos quienes se autogestionan.
@@ -33 +33 @@
 de los problemas que pueden resolver.
 
+=== El gestor de paquetes ===
+
+El gestor de paquetes TOL es el {{{NameBlock TolPakage}}} disponible en 
+la {{{StdLib}}}
+
+Los paquetes disponibles en repositorios remotos o locales se instalan,
+actualizan y manejarlos mediante las utilidades de 
+{{{TolPackage::Client}}}
+
+Las utilidades para la creación de repositorios se encuentran en 
+{{{TolPackage::Server}}}
+
 == Uso básico de paquetes ==
 
@@ -39 +51 @@
   #Require nombre_de_paquete;
 }}}
-y que se lee directamente de un archivo OIS almacenado previamente en un 
-directorio local predeterminado por el sistema al que llamaremos almacén
-del cliente y que es común para todas las instalaciones de TOL que haya
-en una misma máquina y ubicado en {{{Text TolPackage::Client::_.localRoot}}}.
+que se lee directamente de un archivo OIS almacenado previamente en un 
+directorio local predeterminado por el sistema. Llamaremos almacén
+del cliente a ese directorio común para todas las instalaciones de TOL 
+que haya en una misma máquina, que estará ubicado en 
+{{{
+#!cpp
+  Text TolPackage::Client::_.localRoot
+}}}
 
 La orden de requerimiento {{{#Require}}} es muy diferente a las órdenes 
@@ -49 +65 @@
 
  * No hay que dar el camino del archivo TOL sino el nombre del paquete
- * No hay que poner el nombre entre comillas
- * El NameBlock cargado es siempre global se llame desde donde se llame
+ * No hay que poner el nombre entre comillas.
+ * El NameBlock cargado es siempre global, se llame desde donde se llame.
  * No es posible deshacer un requerimiento: el paquete permanecerá 
-   disponible durante toda la sesión
-
-Un repositorio es un sitio web o un directorio local al que llamaremos
-también almacén servidor, donde se encuentra disponible una colección de 
-paquetes ya preparados para que los usuarios puedan descargarlos a su 
-almacén de cliente. Los paquetes se encuentran comprimidos en el 
-repositorio remoto mientras que en el almacén del cliente se encuentran
-los directorios descomprimidos para no perder tiempo en descomprimirlos 
+   disponible durante toda la sesión.
+ * Un paquete consta exclusivamente de código declarativo, para poder
+   residir en un .oza. La primera vez que se carga en una sesión se
+   ejecutarán las sentencias no declarativas programadas en el método
+   especial {{{StartActions}}}
+
+Un repositorio es un sitio web al que llamaremos también almacén del 
+servidor, donde se encuentra disponible una colección de paquetes ya 
+preparados para que los usuarios puedan descargarlos a su almacén de 
+cliente. Los paquetes se encuentran comprimidos en el repositorio 
+remoto mientras que en el almacén del cliente se encuentran los 
+directorios descomprimidos para no perder tiempo en descomprimirlos 
 cada vez.
 
-=== El gestor de paquetes ===
-
-El gestor de paquetes TOL es el {{{NameBlock TolPakage}}}
-
-Los paquetes disponibles en repositorios remotos o locales se instalan,
-actualizan y manejarlos mediante las utilidades de 
-{{{StdLib::TolPackage::Client}}}
-
-Las utilidades para la creación de repositorios se encuentran en 
-{{{StdLib::TolPackage::Server}}}
 
 === Uso on-line de paquetes ===
@@ -83 +93 @@
 }}}
 
-Por defecto, esta lista sólo contiene el [wiki:OfficialTolArchiveNetwork 
-repositorio oficial de bayes] pero es posible añadir otros mediante
+Por defecto, esta lista sólo contiene el 
+[wiki:OfficialTolArchiveNetwork repositorio oficial de bayes] pero es 
+posible añadir otros mediante
 {{{
   Real TolPackage::Client::AddRepository(Text url)
@@ -133 +144 @@
   Set  _.autodoc.dependencies = [["paquete1","paquete2", ...]];
    }}}
+ * Si el el paquete se está desarrollando en un entorno de edición compartida 
+   tipo CVS ó SVN es muy conveniente incluir la información acerca del estado
+   actual en el miembro opcional {{{Text _.autodoc.versionControl}}}. 
+   Para el caso de SVN quedaría así
+   {{{
+#!cpp
+  Text _.autodoc.versionControl = AvoidErr.NonDecAct(OSSvnInfo("."));
+   }}}
+   Falta hacer la función {{{OSSvnInfo}}} equivalente para el sistema CVS. 
+   Se trata de un campo opcional pero altamente recomendado.
  * Cuando un paquete requiera para su ejecución de recursos ajenos a TOL será 
    necesario añadir un nuevo miembro que será un conjunto de textos con los