gbp-dch - Online na nuvem

PROGRAMA:

NOME

gbp-dch - Gera o changelog Debian a partir de mensagens git commit

SINOPSE

gbp certo [ --versão ] [ --Socorro ] [ --verbose ] [ --color =[auto | ligado | desligado] ] [ --cor-
esquema =ESQUEMA DE CORES ] [ --debian-branch =nome_da_filial ] [ --debian-tag =formato de tag ] [
--upstream-branch =nome_da_filial ] [ --upstream-tag =formato de tag ] [ --ignore-branch ] [
--instantâneo | --liberar ] [ --auto | --since =comprometer ] [ --new-version =versão ] [ --bpo
| --nmu | --qa | --equipe ] [ --distribution =nome ] [ - distribuição de força ] [
--urgency =nível ] [ - [não-] cheio ] [ - [não-] meta ] [ --meta-closes = bug-close-tags ] [
--meta-closes-bugnum = formato do número do bug ] [ --snapshot-number =expressão ] [ --Eu iria-
comprimento =número ] [ --git-log =opções do git-log ] [ - [no-] git-author ] [ - [não-] multimaint ]
[ - [no-] multimaint-merge ] [ --spawn-editor = [always | snapshot | release] ] [ --comprometer-se-
msg =formato de msg ] [ --comprometer-se ] [ --customizations =arquivo de personalização ] [caminho1 caminho2]

DESCRIÇÃO

gbp certo lê as mensagens do git commit e gera o changelog do Debian a partir delas. Se não
argumentos são dados, gbp certo começa a partir da última versão do pacote Debian marcada até o
ponta atual do ramo atual. Se a distribuição da seção superior em
debian / changelog is NÃO LIBERADO, as entradas do changelog serão inseridas nesta seção.
Caso contrário, uma nova seção será criada.

If --auto é dada gbp certo, tenta adivinhar o último commit Git documentado no changelog
- isso só funciona no modo instantâneo. De outra forma, --Desde a pode ser usado para contar gbp certo at
qual ponto ele deve começar na história do Git.

Os argumentos de caminho adicionais podem ser usados ​​para restringir os caminhos do repositório gbp certo looks
no. Configuração caminho para debian / é uma boa escolha se o upstream usa Git e todos os pacotes Debian
as mudanças são restritas ao debian / subdir. Em casos mais sofisticados (como
backports), você pode usar --git-log para restringir ainda mais as entradas do changelog geradas,
por exemplo, usando --git-log ="--author = Foo Barra".

OPÇÕES

--versão
Versão para impressão do programa, ou seja, versão do pacote git-buildpackage

-v

--verbose
Execução detalhada

-h

--Socorro Imprimir ajuda e sair

--color =[auto | ligado | desligado]
Se deve usar saída colorida.

- esquema de cores =ESQUEMA DE CORES
Cores a serem usadas na saída (quando a cor está ativada). O formato de COLOR_SCHEME é
' : : : '. Valores numéricos e nomes de cores são aceitos,
campos vazios implicam na cor padrão. Por exemplo, --git-color-scheme ='ciano: 34 ::'
mostraria mensagens de depuração em ciano, mensagens de informação em azul e outras mensagens em
padrão (ou seja, mensagens de aviso e erro em vermelho).

--debian-branch =nome_da_filial
O branch no repositório Git no qual o pacote Debian está sendo desenvolvido, padrão
is dominar.

--upstream-branch =nome_da_filial
Ramifique para determinar a versão upstream. O padrão é rio acima.

--git-upstream-tag =FORMATO DE TAG
use este formato de tag ao procurar por tags de versões upstream, o padrão é
upstream /% (version) s.

--ignore-branch
Não verifique se o branch atual corresponde ramo debian.

--debian-tag =formato de tag
formato de tag usado, ao marcar versões do debian, o padrão é debian /% (version) s

--since =comprometido
Comece a ler mensagens de commit em comprometido.

--auto, -a
Adivinhe o último commit documentado no changelog do banner do instantâneo (ou de
a última tag se não houver banner de instantâneo).

- [não-] meta
Analisar meta tags como Fecha:, Obrigado: e GBP-Dch:. Veja META TAGS abaixo.

--meta-closes =tags de fechamento de bug
Quais meta tags procurar para gerar entradas de changelog de fechamento de bug. O padrão
é 'Closes | LP' para suportar Debian e Launchpad.

--meta-closes-bugnum =formato de número de bug
Qual expressão regular deve ser usada para analisar o número do bug. O padrão é
'(?: bug | problema)? \ #? \ s? \ d +'. Nota: o regex deve suprimir todas as partes do bug
número que não é desejado usando "(? :)", consulte o manual de regex do Python para obter detalhes.

Exemplo: --meta-closes-bugnum ="(?: bug)? \ s * ex- \ d +" corresponderia a todos os seguintes:

Possível correspondência de Txt? Resultado
------------ ------ ------
erro EX-12345 e EX-12345
ex-01273 e ex-01273
erro ex-1ab e ex-1
EX - 12345 N

- [não-] cheio
Inclui a mensagem de confirmação completa na saída do changelog.

--instantâneo, -S
Crie uma entrada de liberação de instantâneo. Isso adiciona um número de versão de instantâneo e um aviso
banner para a entrada do changelog. O número da versão de lançamento está sendo incrementado automaticamente
com cada novo lançamento de instantâneo para evitar downgrades de pacotes durante o instantâneo
teste.

--snapshot-number =expressão
Expressão Python que obtém eval () ed para o novo número do instantâneo.

--liberar, -R
Remova quaisquer banners de lançamento instantâneo e sufixos de versão, defina o atual
distribuição para instávele abra o changelog para ajustes finais.

--new-version =versão, -N versão
Adicionar uma nova seção do changelog com a versão nova versão. Junto com --instantâneo,
o número do instantâneo será anexado a nova versão.

--equipe Crie uma entrada de changelog de upload de equipe.

--bpo Aumente o número da versão Debian para um upload para backports e adicione um backport
fazer upload do comentário do changelog.

--nmu Aumente o número de lançamento do Debian para um upload de não-mantenedor.

--qa Aumente o número da versão Debian para um upload da equipe de QA do Debian e adicione um QA
fazer upload do comentário do changelog.

--distribution =nome
Defina o campo de distribuição para nome.

- distribuição de força
Força a distribuição especificada com --distribuição para ser usado, mesmo que não
correspondem à lista de distribuições conhecidas.

--urgency =nível
Defina o campo de urgência para nível.

--git-log =opções do git-log
Opções repassadas literalmente para git-log(1).

--id-length =N
Incluir N dígitos do ID do commit na entrada do changelog. O padrão é não incluir
quaisquer IDs de commit.

--ignore-regex =regex
Ignorar as linhas de confirmação correspondentes regex ao gerar o changelog.

--git-autor
Use user.name e user.email de git-config(1) para trailer do changelog.

- [no-] multimaint-merge
Mesclar commits pelo mantenedor.

--spawn-editor =[sempre | instantâneo | lançamento]
Se deseja gerar um editor: sempre, ao fazer instantâneos ou ao fazer um lançamento.

--commit-msg =formato de msg
use esta string de formato para a mensagem de confirmação ao confirmar a
arquivo changelog (quando --comprometer-se é dada). O padrão é Atualizar changelog para
% (version) s liberar

--comprometer-se
Confirme o changelog gerado.

--customizations =arquivo de personalização
Carregue o código Python de arquivo de personalização. No momento, a única coisa útil é
o código pode fazer é definir uma função customizada format_changelog_entry ().

INSTANTÂNEO MODA

O modo instantâneo pode ser usado para testes rápidos e ciclos de instalação sem ter que se preocupar com
números de versão ou entradas do changelog.

Ao usar --instantâneo or -S, gbp certo usa um pseudo cabeçalho no changelog do Debian para
lembre-se do último git commit para o qual ele adicionou uma entrada de changelog. Também define um número de versão
acabando ~ .GBP. Ele incrementa automaticamente o instantâneo
número em invocações subsequentes de gbp certo -S para que os instantâneos posteriores tenham automaticamente
um número de versão superior. Para sair do modo instantâneo, invoque gbp certo com o --liberar opção.
Isso remove o pseudo cabeçalho e desmancha o número da versão para a versão lançada
tem um número de versão maior do que os instantâneos.

META TAGS

Além das opções acima, a formatação da mensagem de confirmação em debian / changelog
podem ser modificados por tags especiais (chamadas de Meta Tags) fornecidas na mensagem git commit. Meta
O processamento de tags pode ser ativado por meio do --meta opção. As tags devem começar no primeiro
coluna de uma mensagem de confirmação, mas pode aparecer em qualquer linha. Eles são da forma Nome da etiqueta:
valor. Meta tags válidas são:

GBP-Dch: açao
As ações com suporte são: ignorar que irá ignorar este commit ao gerar
debian / changelog, Baixo que usará apenas a descrição (a primeira linha) do
mensagem de confirmação ao gerar a entrada do changelog (útil quando --cheio é dada),
e completo que usará a mensagem de confirmação completa ao gerar a entrada do changelog
(útil quando --cheio não é fornecido).

Além de GBP-Dch, o obsoleto Git-DchName ainda é compatível.

Obrigado: msg
Adicione uma mensagem de agradecimento após a mensagem de confirmação.

Fecha: número do bug
Indique no debian / changelog que o bug foi fechado por este commit. Veja o
--meta-fecha sobre como estender isso para outros rastreadores de bugs.

A seguinte mensagem git commit:

Metatags de documento

então não é preciso consultar o manual

Gbp-Dch: Curto
Fecha: # 636088
Obrigado: Raphaël Hertzog pela sugestão

Resultados neste debian / changelog entrada:

* Documentar metatags.
Agradecimentos a Raphaël Hertzog pela sugestão (fecha: # 636088)

CONFIGURAÇÃO ARQUIVOS

Vários gbp.conf os arquivos são analisados ​​para definir padrões para os argumentos de linha de comando acima.
veja a gbp.conf(5)> página de manual para detalhes.

Use gbp-dch online usando serviços onworks.net