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.