gbp-dch: en línea en la nube

PROGRAMA:

NOMBRE

gbp-dch: genera el registro de cambios de Debian a partir de los mensajes de confirmación de git

SINOPSIS

GBP dch [ --versión ] [ --ayuda ] [ --verboso ] [ --color =[automático | encendido | apagado] ] [ --color-
esquema =ESQUEMA DE COLORES ] [ --debian-branch =nombre_sucursal ] [ --debian-tag =formato de etiqueta ] [
--bifurcación-ascendente =nombre_sucursal ] [ --upstream-tag =formato de etiqueta ] [ --ignorar-rama ] [
--instantánea | --liberación ] [ --auto | --desde =comprometerse ] [ --new-version =versión ] [ --bpo
| --nmu | --qa | --equipo ] [ --distribución =nombre ] [ - distribución de fuerza ] [
--urgencia =nivel ] [ --[no lleno ] [ - [no-] meta ] [ --meta-closes = etiquetas de cierre de errores ] [
--meta-closes-bugnum = formato-número-error ] [ --snapshot-number =expresión ] [ --identificación-
longitud =número ] [ --git-log =opciones de git-log ] [ - [no-] git-author ] [ - [no-] multipunto ]
[ - [no-] multimaint-merge ] [ --spawn-editor = [siempre | instantánea | lanzamiento] ] [ --cometer-
msg =formato de mensaje ] [ --cometer ] [ - personalizaciones =archivo de personalización ] [ruta1 ruta2]

DESCRIPCIÓN

GBP dch lee los mensajes de confirmación de git y genera el registro de cambios de Debian a partir de él. Si no
se dan argumentos, GBP dch comienza desde la última versión etiquetada del paquete Debian hasta la
punta actual de la rama actual. Si la distribución de la sección superior en
debian / changelog is NO LIBERADO, las entradas del registro de cambios se insertarán en esta sección.
De lo contrario, se creará una nueva sección.

If --auto es dado GBP dch, intenta adivinar la última confirmación de Git documentada en el registro de cambios
- esto solo funciona en modo instantánea. De lo contrario, --ya que se puede usar para decir GBP dch at
qué punto debería comenzar en el historial de Git.

Los argumentos de ruta adicionales se pueden usar para restringir las rutas del repositorio GBP dch miradas
a. Configuración camino a debian / es una buena opción si upstream usa Git y todos los paquetes de Debian
los cambios se limitan a debian / subdir. En casos más sofisticados (como
backports), puede usar --git-registro para restringir aún más las entradas del registro de cambios generadas,
por ejemplo, usando --git-log ="--author = Foo Bar".

CAMPUS

--versión
Versión impresa del programa, es decir, versión de la suite git-buildpackage

-v

--verboso
Ejecución detallada

-h

--ayuda Imprimir ayuda y salir

--color =[automático | encendido | apagado]
Ya sea para utilizar salida en color.

- esquema de color =ESQUEMA DE COLORES
Colores para usar en la salida (cuando el color está habilitado). El formato de COLOR_SCHEME es
' : : : '. Se aceptan valores numéricos y nombres de colores,
los campos vacíos implican el color predeterminado. Por ejemplo, --git-color-esquema ='cian: 34 ::'
mostraría mensajes de depuración en cian, mensajes de información en azul y otros mensajes en
predeterminado (es decir, mensajes de advertencia y error en rojo).

--debian-branch =nombre_sucursal
La rama del repositorio de Git en la que se está desarrollando el paquete Debian, por defecto
is dominar.

--bifurcación-ascendente =nombre_sucursal
Rama desde la que determinar la versión ascendente. El valor predeterminado es río arriba.

--git-upstream-tag =FORMATO DE ETIQUETA
use este formato de etiqueta cuando busque etiquetas de versiones anteriores, el valor predeterminado es
upstream /% (versión) s.

--ignorar-rama
No compruebe si la rama actual coincide rama-debian.

--debian-tag =formato de etiqueta
formato de etiqueta utilizado, al etiquetar versiones de Debian, el valor predeterminado es debian /% (versión) s

--desde =comprometido
Empiece a leer los mensajes de confirmación en comprometido.

--auto, -a
Adivina la última confirmación documentada en el registro de cambios desde el banner de la instantánea (o desde
la última etiqueta si no existe un banner de instantánea).

- [no-] meta
Analizar metaetiquetas como Cierra:, Gracias: y GBP-Dch:. Consulte las ETIQUETAS META a continuación.

--meta-cierra =etiquetas de cierre de error
Qué metaetiquetas buscar para generar entradas de registro de cambios de cierre de errores. El valor por defecto
es 'Closes | LP' para admitir Debian y Launchpad.

--meta-closes-bugnum =formato de número de error
¿Qué expresión regular se debe usar para analizar el número de error? El valor predeterminado es
'(?: error | problema)? \ #? \ s? \ d +'. Nota: la expresión regular debería suprimir todas las partes del error
número que no se desea con "(? :)", consulte el manual de expresiones regulares de Python para obtener más detalles.

Ejemplo: --meta-closes-bugnum ="(?: bug)? \ s * ex- \ d +" coincidiría con todo lo siguiente:

¿Posible coincidencia de texto? Resultado
------------ ------ ------
error EX-12345 Y EX-12345
ex-01273 Y ex-01273
error ex-1ab Y ex-1
EX - 12345 N

--[no lleno
Incluya el mensaje de confirmación completo en la salida del registro de cambios.

--instantánea, -S
Cree una entrada de lanzamiento de instantánea. Esto agrega un número de lanzamiento de instantánea y una advertencia
banner a la entrada del registro de cambios. El número de versión de lanzamiento se incrementa automáticamente
con cada nueva versión de instantánea para evitar degradaciones de paquetes durante la instantánea
pruebas.

--snapshot-number =expresión
Expresión de Python que obtiene eval () ed al nuevo número de instantánea.

--liberación, -R
Elimine cualquier pancarta de lanzamiento de instantáneas y sufijos de versión, establezca el
distribución a redy abra el registro de cambios para realizar los ajustes finales.

--new-version =versión, -N versión
Agregar una nueva sección de registro de cambios con la versión nueva versión. Juntos con --instantánea, la
El número de instantánea se agregará a nueva versión.

--equipo Cree una entrada de registro de cambios de carga de equipo.

--bpo Aumente el número de versión de Debian para una carga en backports y agregue un backport
cargar el comentario del registro de cambios.

--nmu Aumente el número de versión de Debian para una carga de no mantenedor.

--qa Aumente el número de versión de Debian para una carga del equipo de control de calidad de Debian y agregue un control de calidad
cargar el comentario del registro de cambios.

--distribución =nombre
Establezca el campo de distribución en nombre .

- distribución de fuerza
Forzar la distribución especificada con --distribución para ser utilizado, incluso si no lo hace
coincidir con la lista de distribuciones conocidas.

--urgencia =nivel
Establezca el campo de urgencia en nivel.

--git-log =opciones de git-log
Las opciones se transmitieron literalmente a registro de git(1).

--id-length =N
Incluyendo N dígitos del ID de confirmación en la entrada del registro de cambios. El valor predeterminado es no incluir
cualquier ID de confirmación en absoluto.

--ignore-regex =expresiones regulares
Ignorar las líneas de confirmación que coinciden expresiones regulares al generar el registro de cambios.

--git-autor
Utilice user.name y user.email de git-config(1) para remolque de registro de cambios.

- [no-] multimaint-merge
Fusionar confirmaciones del mantenedor.

--spawn-editor =[siempre | instantánea | lanzamiento]
Ya sea para generar un editor: siempre, al hacer instantáneas o al hacer un lanzamiento.

--commit-msg =formato de mensaje
use esta cadena de formato para el mensaje de confirmación al confirmar el generado
archivo de registro de cambios (cuando --cometer es dado). El valor predeterminado es Actualizar cambios para
% (versión) s ,

--cometer
Confirme el registro de cambios generado.

- personalizaciones =archivo de personalización
Cargar código Python desde archivo de personalización. Por el momento, lo único útil
El código que puede hacer es definir una función format_changelog_entry () personalizada.

INSTANTÁNEA MODO

El modo de instantánea se puede utilizar para ciclos rápidos de prueba e instalación sin tener que preocuparse por
números de versión o entradas del registro de cambios.

Cuando usas --instantánea or -S, GBP dch utiliza un pseudo encabezado en el registro de cambios de Debian para
recuerde la última confirmación de git para la que agregó una entrada de registro de cambios. También establece un número de versión
terminando en ~ .GBP. Incrementa automáticamente la instantánea
número en invocaciones posteriores de GBP dch -S para que las instantáneas posteriores tengan
un número de versión más alto. Para salir del modo de instantánea, invoca GBP dch con el --liberación .
Esto elimina el pseudo encabezado y deshace el número de versión para que la versión publicada
tiene un número de versión más alto que las instantáneas.

META TAGS

Además de las opciones anteriores, el formato del mensaje de confirmación en debian / changelog
puede ser modificado por etiquetas especiales (llamadas Meta Tags) dadas en el mensaje de confirmación de git. Meta
El procesamiento de etiquetas se puede activar a través del --meta opción. Las etiquetas deben comenzar en la primera
columna de un mensaje de confirmación, pero puede aparecer en cualquier línea. Son de la forma Nombre de etiqueta:
propuesta de. Las metaetiquetas válidas son:

GBP-Dch: DE ACTUAR!
Las acciones admitidas son: pasar por alto que ignorará este compromiso al generar
debian / changelog, En Corto que solo usará la descripción (la primera línea) del
mensaje de confirmación al generar la entrada del registro de cambios (útil cuando --lleno es dado),
y Full que utilizará el mensaje de confirmación completo al generar la entrada del registro de cambios
(útil cuando --lleno no se da).

Además de nuestras localidaded en GBP-DCH, el desaprobado Git-Dch todavía es compatible.

Gracias: MSG
Agregue un mensaje de agradecimiento después del mensaje de confirmación.

Cierra: número de error
Indicar en el debian / changelog que el error fue cerrado por esta confirmación. Ver el
--meta-cierra sobre cómo extender esto para otros rastreadores de errores.

El siguiente mensaje de confirmación de git:

Metaetiquetas de documento

para no tener que consultar el manual

Gbp-Dch: corto
Cierra: # 636088
Gracias: Raphaël Hertzog por la sugerencia

Resultados en este debian / changelog entrada:

* Documento de metaetiquetas.
Gracias a Raphaël Hertzog por la sugerencia (Cierra: # 636088)

CONFIGURACIÓN ARCHIVOS

Varias gbp.conf Los archivos se analizan para establecer valores predeterminados para los argumentos de la línea de comandos anteriores.
Consulte las gbp.conf(5)> página de manual para obtener más detalles.

Use gbp-dch en línea usando los servicios de onworks.net