blob: 2330f67a24683799d9395270bf7a523724233dd3 [file] [log] [blame]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-parsechangelog 1 2011\-08\-14 "Proyecto Debian" "Herramientas de dpkg"
.SH NOMBRE
dpkg\-parsechangelog \- Análisis de ficheros de registro de cambios de Debian
.
.SH SINOPSIS
\fBdpkg\-parsechangelog\fP [\fIoption\fP...]
.
.SH DESCRIPCIÓN
\fBdpkg\-parsechangelog\fP lee y analiza el registro de cambios de un árbol de
fuentes de Debian desempaquetado, mostrando la información contenida a
través de la salida estándar en un formato legible por el sistema.
.
.SH OPCIONES
.TP
\fB\-l\fP\fIfichero\-cambios\fP
Define el fichero de registro de cambios del que leer la información. Por
omisión es \fBdebian/changelog\fP.
.TP
\fB\-F\fP\fIformato\-registro\-cambios\fP
Define el formato del registro de cambios. Por omisión, el formato se lee de
una línea especial cerca del final del registro de cambios o, en caso de
fallo, usa el formato estándar debian.
.TP
\fB\-L\fP\fIdirectorio\-bibliotecas\fP
Define un directorio adicional en el que buscar scripts de análisis. Este
directorio se analiza antes que los directorios predefinidos,
\fB/usr/local/lib/dpkg/parsechangelog\fP y \fB/usr/lib/dpkg/parsechangelog\fP.
.TP
\fB\-h\fP, \fB\-\-help\fP
Muestra el modo de uso y termina.
.TP
\fB\-\-version\fP
Muestra la versión y termina.
.SS "Opciones de análisis"
Las siguientes opciones permiten modificar la salida del analizador de
registros de cambio, por ejemplo, el rango de las entradas o el formato de
la salida. Deben ser compatibles con el script analizador en cuestión. Véase
también \fBADVERTENCIAS\fP.
.TP
\fB\-\-format\fP\fI formato\-salida\fP
Define el formato de la salido. Los valores compatibles son \fIdpkg\fP y
\fIrfc822\fP. \fIdpkg\fP es el formato de salida clásico (anterior a la existencia
de esta opción) y el valor predefinido. Consiste de un párrafo con el
formato de control de Debian (consulte \fBdeb\-control\fP(5)). En caso de
requerir más de una entrada, la mayoría de campos se toman de la última
entrada, a menos que se especifique lo contrario:
.RS
.TP
\fBSource:\fP\fI pkg\-name\fP
.TP
\fBVersion:\fP\fI version\fP
.TP
\fBDistribution:\fP\fI target\-distribution\fP
.TP
\fBUrgency:\fP\fI urgency\fP
Se usa la urgencia más elevada presente entre todas las entradas incluidas.
.TP
\fBMaintainer:\fP\fI author\fP
.TP
\fBDate:\fP\fI date\fP
.TP
\fBCloses:\fP\fI bug\-number\fP
Los campos «Closes» de todas las entradas incluidas se fusionan.
.TP
\fBChanges:\fP\fI changelog\-entries\fP
El texto de todas las entradas del registro de cambios se encadena. Para que
ésto tenga un formato de control multi\-línea de Debian válido, las líneas
vacías se reemplazan por un retorno de línea, y se inserta un sangrado de un
carácter de espacio en todas las líneas. El contenido exacto depende del
formato del registro de cambios.
.RE
.IP
Pueden que aparezcan campos adicionales definidos por el usuario.
.IP
El formato \fBrfc822\fP emplea los mismos campos, pero devuelve por la salida
un párrafo por cada entrada en el registro de cambios, de forma que se
preservan los metadatos de cada entrada.
.TP
\fB\-\-since\fP \fIversión\fP, \fB\-s\fP\fIversión\fP,\fB \-v\fP\fIversión\fP
Incluye todos los cambios posteriores a la \fIversión\fP.
.TP
\fB\-\-until\fP \fIversión\fP, \fB\-u\fP\fIversión\fP
Incluye todos los cambios anteriores a la \fIversión\fP.
.TP
\fB\-\-from\fP \fIversión\fP, \fB\-f\fP\fIversión\fP
Incluye todos los cambios posteriores o de la misma \fIversión\fP.
.TP
\fB\-\-to\fP \fIversión\fP, \fB\-t\fP\fIversión\fP
Incluye todos los cambios anteriores o de la misma \fIversión\fP.
.TP
\fB\-\-count\fP \fInúmero\fP, \fB\-c\fP\fInúmero\fP, \fB\-n\fP\fInúmero\fP
Incluye un \fInúmero\fP de entradas desde el inicio (o el final en caso de que
el \fInúmero\fP sea menor que 0).
.TP
\fB\-\-offset\fP \fInúmero\fP, \fB\-o\fP\fInúmero\fP
Modifica el punto de inicio para «\-\-count» (cuenta), empezando por el
principio (o el final si el \fInúmero\fP es menor que 0).
.TP
\fB\-\-all\fP
Incluye todos los cambios. Nota: otras opciones no tendrán efecto cuando
esta esté en uso.
.
.SH ADVERTENCIAS
Todas las \fBOpciones de análisis\fP, a excepción de «\-v», son compatibles a
partir de la versión 1.14.16 y posteriores de \fBdpkg\fP. Puede que los
analizadores de formatos de registro de cambios además de \fIdebian\fP y
procedentes de otras fuentes no acepten todas las opciones.
.
.SH FICHEROS
.TP
\fBdebian/changelog\fP
El fichero de registro de cambios se usa para obtener información
dependiente de la versión acerca del paquete fuente, así como la urgencia y
la distribución de una subida, los cambios realizados desde una versión en
concreto y el propio número de versión de la fuente.
.
.SH AUTORES
Copyright \(co 1995\-1996 Ian Jackson
.br
Copyright \(co 2000 Wichert Akkerman
.br
Copyright \(co 2007, 2008 Frank Lichtenheld
.sp
Esto es software libre; vea la versión 2 o posterior de la Licencia Pública
General GNU para condiciones de copia. NO hay ninguna garantía.
.SH "TRADUCTOR"
Rudy Godoy <rudy@kernel\-panik.org>,
Rubén Porras <nahoo@inicia.es>,
Bruno Barrera C. <bruno.barrera@igloo.cl>,
Carlos Izquierdo <gheesh@ertis.net>,
Esteban Manchado y
NOK.
Debian L10n Spanish <debian\-l10n\-spanish@lists.debian.org>.
.br
Revisiones por Santiago Vila <sanvila@unex.es>,
Javier Fernández\-Sanguino, Rubén Porras,
Luis Uribe y Omar Campagne.