Changes between Version 20 and Version 21 of TolPackageRulesAndComments

Timestamp:

Oct 13, 2010, 11:09:16 AM (14 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

TolPackageRulesAndComments

@@ -69 +69 @@
  * Los miembros obligatorios del NameBlock de un paquete son: [[BR]]
    {{{
-  Text _.autodoc.brief = "Descripción cortísima en una línea".
-  Text _.autodoc.description = "Descripción detallada"; }}}
-  Text _.autodoc.url = "http://.../"; }}}
-  Set  _.autodoc.keys = [["Palabras","Clave", ...]]; }}}
-  Set  _.autodoc.authors = [[ "fulanito@mail.tal", "menganito@mail.cual"]]; }}}
+  Text _.autodoc.name = "NombreDelPaquete";
+  Text _.autodoc.brief = "Descripción cortísima en una línea";
+  Text _.autodoc.description = "Descripción detallada"; 
+  Text _.autodoc.url = "http://.../"; 
+  Set  _.autodoc.keys = [["Palabras","Clave", ...]];
+  Set  _.autodoc.authors = [[ "fulanito@mail.tal", "menganito@mail.cual"]]; 
   Text _.autodoc.minTolVersion =  Copy(TolReleaseId);
   Real _.autodoc.version.high = 1;
@@ -108 +109 @@
   ]] };
    }}}
+
 === Control de versiones ===
 
@@ -141 +143 @@
    Llegados a este caso habría que plantearse si el paquete modificado debe sobreescribir el 
    existente en el repositorio o se debe usar sólo de forma local donde se precise.
+   Para el caso de SVN existe una forma muy sencilla de definir este campo opcional [[BR]]
+   {{{
+   Text _.autodoc.versionControl = AvoidErr.NonDecAct(OSSvnInfo("."));
+   }}}
 
 ==== Nomenclatura ====
@@ -276 +282 @@
 == Creación de repositorios ==
 
-En el archivo [source:/tolp/OfficialTolArchiveNetwork/_upload.tol] puede verse como 
-ejemplo el programa de creación y subida de [http://packages.tol-project.org/OfficialTolArchiveNetwork/  OfficialTolArchiveNetwork], el repositorio oficial de paquetes del equipo de 
-desarrollo de TOL.
-
- * El repositorio es un directorio con unos archivos y directorios obligatorios:
-  * archivos:
-    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/index.tol index.tol]: 
-      Contiene características generales del repositorio como el 
-      nombre, el tipo ("Private" ó "Public") y la descripción de los objetivos.
-    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/index.csv index.csv]: 
-      Listado de los paquetes y su información asociada: fecha, versión, 
-      dependencias, etc.
-  * subdirectorios:
-    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/register register]: 
-      Un fichero para cada paquete con un solo registro de información relativa 
-      al mismo. 
-    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/packages packages]: 
-      Los paquetes propiamente dichos, es decir, los archivos con extensión .oza 
-      listos para su descarga.
-    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/export export]: 
-      contiene un subdirectorio por cada paquete con los códigos fuente 
-      originales, la documentación, los tests y todo aquello que se usó en la 
-      construcción. Funciona al mismo tiempo como un backup y como una forma de
-      enlazar URL's a lo que haga falta del paquete.
-    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/resources resources]:
-      El servidor de creación de los paquetes se encargará de leer los recursos 
-      ajenos a TOL de {{{_.autodoc.nonTolResources}}}, comprimir los directorios 
-      enumerados y enviarlos al repositorio remoto dentro de este subdirectorio. 
-      También quedarán anotados en el archivo de índice en el campo de 
-      dependencias externas. El instalador del cliente se los bajará al mismo 
-      tiempo que el .oza los recursos comprimidos que correspondan a su plataforma, 
-      incluyendo los que son independientes de la plataforma, creando para ello 
-      un directorio propio del paquete [[BR]]
-      {{{
-  TolPackage::Client::_.localRoot+package.version+"/"
-      }}}
-      Luego descomprimirá ahí dentro cada uno de los recursos descargados de forma
-      que sean accesibles localmente.
-
- * 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.
+Un repositorio es un sistema de almacenamiento remoto de cada una de las 
+versiones publicadas históricamente de un grupo de paquetes gestionados
+por una misma organización que centralice el trabajo de uno o varios 
+grupos de desarrolladores.
+
+El sistema debe tener un protocolo de acceso vía URL que sumunistrará todo
+lo necesario para la instalación y mantenimiento de paquetes
+
+ * Información general del propio repositorio:
+  * Nombre
+  * Descripción
+  * URL
+  * Responsables
+ * Información sobre los paquetes 
+  * Listado de paquetes existentes 
+  * Listado de las versiones disponibles de cada paquete
+  * Nombre de la última versión de un paquete
+  * Nombre de la última versión de un paquete compatible con cierta versión de TOL
+  * Listado de paquetes requeridos directamente o indirectamente por un paquete dado
+ * Descarga de paquetes
+  * Descarga del archivo en formato comprimido
+  * Descarga del archivo en formato ASCII codificado
+
+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.