Node:log, Next:login, Previous:kserver, Up:Ordenes y Opciones

log

Sinopsis: log [OPCIONES] [FICHEROS]

• Nombres alternativos - lo, rlog
• Requiere - Copia de trabajo, repositorio
• Cambia - Nada

Muestra mensajes de registro para un proyecto, o para ficheros dentro de un proyecto. La salida de resitro no est� precisamente en el mismo estilo que la salida de otros mandatos CVS, porque el registro se basa en un programa RCS m�s viejo (rlog). Su formato de salida da una cabecera, conteniendo varias piezas de informaci�n sobre el fichero no-espec�fica-de-una-revisi�n, seguida de los mensajes de registro (arreglados por revisi�n). Cada revisi�n no muestra meramente el n�mero de revisi�n y los mensajes de registro, sino tambi�n el autor y la fecha de el cambio y el n�mero de l�neas a�adidas o borradas. Siempre imprimidas en UTC (GMT), no en fecha local.

Debido a que la salida de log es por fichero, una simple entrega que involucra m�ltiples ficheros puede no parecer conceptualmente como un cambio at�mico. Sin embargo, si lee todos los mensajes de registro y fechas cuidadosamente, podr� reconstruir qu� ocurri�. (Para obtener m�s informaci�n sobre una herramienta que puede reformatear salida de log de muchos ficheros de una forma m�s legible, vea cvs2cl - Genera ChangeLogs al estilo GNU en Herramientas de terceros para obtener m�s detalles). (Ver tambi�n history file).

Opciones:

Mientras lee las siguientes opciones de filtrado, puede no quedar completamente claro c�mo se comportan cuando se combinan. Un descripci�n precisa del comportamiento del registro es la que toma la intersecci�n de las revisiones seleccionadas por -d, -s y -w, cuando intersectan con la uni�n de las seleccionadas por -b y -r.

• -b - Imprime informaci�n de registro acerca de la rama por omisi�n solamente (usualmente la rama m�s alta del tronco). Esto se hace usualmente para evitar la impresi�n de los mensajes de registro de ramas laterales de desarrollo.
• -dFECHAS - Imprime informaci�n de registro para s�lo las revisiones que coincidan con la fecha o rango de fechas dado por FECHAS, una lista separada por comas. Las fechas se pueden dar en cualquiera de los formatos usuales (ver Formatos de Fecha anteriormente en esta secci�n) y puede ser combinado en rangos como a continuaci�n:
  • FECHA1<FECHA2 - Selecciona las revisiones creadas entre FECHA1 y FECHA2. Si FECHA1 es m�s vieja que FECHA2, use en cambio >; de otro modo no se obtendr�n mensajes de registro.
  • <FECHA FECHA> - Todas las fechas desde FECHA o m�s tempranas.
  • >FECHA FECHA< - Todas las revisiones de FECHA o m�s adelante.
  • FECHA - Simplemente selecciona la revisi�n simple m�s reciente desde FECHA o m�s temprana.

  Puede usar <= y >= en vez de < y > para indicar un rango exclusivo (de otro modo, los rangos son inclusivos). Los rangos m�ltiples pueden ser separados por comas, por ejemplo
  

  floss$ cvs log -d"1999-06-01<1999-07-01;1999-08-01<1999-09-01"
  

  selecciona los mensajes de registro de revisiones entregadas en junio o agosto de 1999 (pasando julio). No puede haber espacio entre -d y sus argumentos.

• -h - Imprime s�lo la informaci�n de cabecera de cada fichero, que incluye el nombre del fichero, el directorio de trabajo, la revisi�n de cabecera, la rama por omisi\'n, la lista de acceso, los bloqueos, los nombres simb�licos (etiquetas) y la clave de modo de sustituci\'n por omisi�n. No se imprimen mensajes de registro.
• -l - Local. Se ejecuta s�lo para los ficheros en el directorio de trabajo actual.
• -N - Omite la lista de nombres simb�licos (etiquetas) de la cabecera. Esto puede ser �til cuando su proyecto tiene muchas etiquetas que no est� interesado en ver en los mensajes de registro.
• -R - Imprime el nombre del fichero RCS en el repositorio.

  Esto es diferente del significado usual de -R: "recursivo". No hay modo de contrarrestar un -l para este mandato, as� que no ponga log -l en su .cvsrc.

• -rREVS - Muestra informaci�n de registro para las revisiones especificadas en REVS, una lista separada por comas. REVS puede contener tanto n�meros de revisi�n y etiquetas. Los rangos pueden ser especificados as�:
  • REV1:REV2 - Revisiones desde REV1 a REV2 (deben estar en la misma rama).
  • :REV - Revisiones desde el comienzo de la rama de REV hasta, e incluyendo REV.
  • REV: - Revisiones desde REV hasta el final de la rama de REV.
  • RAMA - Todas las revisiones de esta rama, desde la ra�z hasta la punta.
  • RAMA1:RAMA2 - Un rango de ramas - todas las revisiones de todas las ramas de este rango.
  • RAMA. - La �ltima revisi�n (punta) de una RAMA.

  Finalmente, un solo -r, sin argumento, significa seleccionar la �ltima revisi�n en la rama por omisi�n (normalmente el tronco). No puede haber espacio entre -r y sus argumentos.

  Si el argumento a -r es una lista, est� separada por comas, no por punto y coma, como -d.

• -sESTADOS - Selecciona las revisiones cuyos atributos de estado coincida con uno de los estados dados por ESTADOS, una lista separada por comas. No puede haber espacios entre -s y sus argumentos.

  Si los argumentos a -s son una lista, est�n separado por comas, no por puntos y comas como -d.

• -t - Como -h, pero tambi�n incluye la descripci�n del fichero (su mensaje de creaci�n).
• -wUSUARIOS - Selecciona las revisiones entregadas por usuarios cuyos nombres de usuario aparezcan en la lista de usuarios separada por comas. Un -w suelto sin USUARIOS significa tomar el nombre de usuario de la persona que ejecute cvs log.

  Recuerde que cuando los sobrenombres de usuario se efect�an (ver secci�n El servidor de autentificacion de contrasen~as en Administracion del Repositorio), CVS registra el nombre de usuario CVS, no el nombre de usuario de sistema, en cada entrega. Puede no haber espacio entre -w y sus argumentos.

  Si el argumento a -w es una lista, est� separada por comas, no separada por puntos y comas como -d.