Node:Ficheros informativos, Next:Subdirectorios, Up:Anatomia de una distribucion CVS
En el nivel superior del árbol de la distribución, encontrará algunos ficheros que contienen información útil (y enlaces a información más detallada). Estos ficheros son, en orden de importancia aproximado:
NEWS - Este fichero enumera los cambios de una versión a la siguiente,
en orden cronológico inverso (es decir, la más reciente al principio). Si
ya ha estado usando CVS durante un tiempo y se ha actualizado a una nueva
versión, debería mirar en el fichero NEWS para ver qué nuevas funciones
están disponibles. Además, aunque la mayoría de los cambios de CVS conservan
compatibilidad hacia atrás, de vez en cuando hay cambios no compatibles. Es
mejor leer algo acerca de ellos aquí que sorprenderse cuando CVS no se comporte
como espera que lo haga.
BUGS - Este fichero contiene exactamente lo que piensa: una lista de
errores conocidos en CVS. Generalmente no harán que la versión de CVS sea
inutilizable, pero debería leer el fichero cada vez que instale una nueva
versión.
DEVEL-CVS - Este fichero es la "constitución" de CVS. Describe
el proceso mediante el cual se aceptan los cambios en la distribución principal
de CVS y los procedimientos mediante los que una persona se convierte en
desarrollador de CVS. No necesita leerlo si sólo quiere usar CVS; sin embargo,
resulta muy interesante si quiere comprender cómo los esfuerzos descoordinados
de gente repartida por todo el mundo convergen en un programa que funciona. Y
por supuesto, hace falta leerlo si planea enviar un parche (sea para reparar
un error o para una nueva característica) a CVS.
HACKING - Pese a su nombre, el fichero HACKING no dice mucho
del diseño o implementación de CVS. Es principalmente una guía de
estándares de programación y otros asuntos técnicos para gente que piense
en escribir un parche para CVS. Puede verse como un apéndice del fichero
DEVEL-CVS. Después de comprender la filosofía básica del desarrollo
de CVS, debe leer el fichero HACKING para traducir esta filosofía a unas
prácticas concretas de programación.
FAQ - Éste es el documento de "Preguntas Frecuentes" (FAQ o "Frequently
Asked Questions" en inglés). Desgraciadamente ha tenido una historia de
mantenimiento bastante irregular. David Grubbs se encargó de él hasta
1995. En ese momento (presumiblemente) estaba muy ocupado, y el fichero
languideció durante un tiempo. Finalmente, in 1997, Pascal Molli retomó
el mantenimiento. Molli tampoco tuvo tiempo para mantenerlo a mano, pero al
menos encontró tiempo para ponerlo en su sistema automático FAQ-O-Matic,
que permite al público mantener las FAQ de un modo descentralizado
(básicamente, cualquiera puede editar o añadir entradas mediante un formulario
Web). Probablemente esto fue una buena idea, puesto que al menos las FAQ están
siendo actualizadas de nuevo; sin embargo, la organización general y el control
de calidad no son del mismo nivel que si una única persona las mantuviera.
La versión maestra de las FAQ está siempre disponible en el sitio Web de Molli (http://www.loria.fr/~molli/cvs-index.html, bajo el enlace "Documentation"). El fichero FAQ que se encuentra en las distribuciones CVS se genera automáticamente desde la base de datos de FAQ-O-Matic, así que para cuando llega al público está un poco anticuado. Sin embargo, puede ser de gran ayuda si busca sugerencias y ejemplos sobre cómo hacer algo específico (como fusionar una rama enorme al tronco o "resucitar" un fichero eliminado). La mejor forma de usarlo es como documento de referencia; puede abrirlo en su editor favorito y hacer búsquedas de los términos que le interesen. Intentar usarlo como un tutorial sería un error - le faltan demasiados puntos importantes sobre CVS para servir de guía completa.