Node:El manual Cederqvist, Next:Otras fuentes de informaci�n, Previous:Subdirectorios, Up:Anatomia de una distribucion CVS
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.