Node:El manual Cederqvist, Next:, Previous:Subdirectorios, Up:Anatomia de una distribucion CVS


El manual Cederqvist

Con esto llegamos al subdirectorio doc/, cuyo habitante más importante es el famoso Cederqvist. Hoy en día seguramente sea excesivo llamarlo "el Cederqvist". Aunque Per Cederqvist (de Signum Support, Linkoping Suecia, www.signum.se) escribió la primera versión alrededor de 1992, muchas otras personas lo han actualizado desde entonces. Por ejemplo, cuando los desarrolladores añaden una nueva característica a CVS, generalmente también la documentan en el Cederqvist.

El Manual Cederqvist está escrito en formato Texinfo, usado por el proyecto GNU porque es relativamente fácil producir salidas tanto en línea como impresas a partir de él (en los formatos Info y PostScript respectivamente). El fichero maestro Texinfo es doc/cvs.texinfo, pero las distribuciones CVS vienen con los ficheros Info y PostScript pregenerados, así que no tiene que preocuparse de ejecutar herramientas Texinfo.

Aunque el Cederqvist puede usarse como introducción y tutorial, probablemente sea más útil como documento de referencia. Por esa razón, la mayoría de la gente navega por él en línea en lugar de imprimirlo (aunque el fichero PostScript es doc/cvs.ps, para aquellos que tengan papel de sobra). Si ésta es la primera vez que ha instalado CVS en su sistema, tendrá que hacer un paso extra para asegurarse de que el manual está accesible en línea.

Los ficheros Info (doc/cvs.info, doc/cvs.info-1, doc/cvs.info-2, etc.) se instalaron cuando ejecutó "make install". Aunque los ficheros se copiaron en el árbol Info del sistema, puede que aún tenga que añadir una línea para CVS en la tabla de contenidos de Info, el nodo "Top". (Esto sólo será necesario si es la primera vez que ha instalado CVS en su sistema; de lo contrario, la entrada de instalaciones anteriores debería estar ya en la tabla de contenidos.)

Si ha añadido nueva documentación Into antes, puede que esté familiarizado con el proceso. Primero averigüe dónde se instalaron las páginas Info. Si usó la instalación por defecto (en /usr/local/), entonces los ficheros Info son /usr/local/info/cvs.info*. Si al instalar usó 

floss$ ./configure --prefix=/usr

los ficheros acabaron siendo /usr/info/cvs.*. Después de localizar los ficheros, necesitará añadir una línea para CVS en la tabla de contenidos de Info, que está en un fichero llamado dir en ese directorio (así que en el último caso sería /usr/info/dir). Si no tiene acceso como root pídale a su administrador que lo haga. Aquí hay un extracto de dir antes de añadir la referencia a la documentación CVS: 

* Bison: (bison).         The Bison parser generator.
* Cpp: (cpp).             The GNU C preprocessor.
* Flex: (flex).           A fast scanner generator

Y aquí está la misma zona de dir despues: 

* Bison: (bison).         The Bison parser generator.
* Cpp: (cpp).             The GNU C preprocessor.
* Cvs: (cvs).             Concurrent Versions System
* Flex: (flex).           A fast scanner generator

El formato de la línea es muy importante. Debe incluir el asterisco, los espacios y los dos puntos en * Cvs:, y los paréntesis y el punto en (cvs). detrás de él. Si falta cualquiera de estos elementos, el formato del Info dir estará corrupto, y será incapaz de leer el Cederqvist.

Una vez que el manual esté instalado y referenciado desde la tabla de contenidos, podrá leerlo con cualquier navegador compatible con Info. Los que estarán instalados con mayor seguridad en un sistema Unix típico son el lector Info de línea de órdenes, que puede invocarse así si quiere ir directo a las páginas de CVS 

floss$ info cvs

y el incluido en Emacs, que se invoca escribiendo 

M-x info

o 

C-h i

Tómese el tiempo necesario para conseguir poner a punto el Cederqvist correctamente en su sistema cuando instale CVS; acortará mucho el camino cuando tenga que buscar algo.