debchange - Online na Nuvem

PROGRAMA:

NOME

debchange - Ferramenta para manutenção do arquivo debian / changelog em um pacote fonte

SINOPSE

debchange [opções] [texto ...]
certo [opções] [texto ...]

DESCRIÇÃO

debchange ou seu apelido certo irá adicionar uma nova linha de comentário ao changelog Debian no
árvore de origem atual. Este comando deve ser executado a partir dessa árvore. Se o texto do
a mudança é fornecida na linha de comando, debchange será executado em lote e simplesmente adicionar o
texto, com quebras de linha conforme necessário, no local apropriado em debian / changelog (Ou o
changelog especificado por opções, conforme descrito abaixo). Se nenhum texto for especificado, então
debchange irá executar o editor conforme determinado por editor sensato para você editar o arquivo.
(As variáveis ​​de ambiente VISUAL e EDITOR são usados ​​nesta ordem para determinar quais
editor para usar.) Editores que entendem o +n opção para iniciar a edição em um
a linha especificada usará isso para mover para a linha correta do arquivo para edição. Se o
o editor é fechado sem modificar o arquivo temporário, debchange vai sair sem tocar
o changelog existente. Note que da changelog is assumiu para be codificado com da UTF-8
codificação. If it is não, problemas pode ocorrer. Por favor, consulte a iconv(1) página de manual para descobrir
como converter changelogs de codificações legadas. Finalmente, um changelog or NOTÍCIAS arquivo pode ser
criado do zero usando o --Criar opção descrita abaixo.

debchange também suporta a produção automática de entradas de changelog de fechamento de bug, usando o
- fecha opção. Isso geralmente irá consultar o BTS, o Debian Bug Tracking System (consulte
https://bugs.debian.org/) to determine the title of the bug and the package in which it
ocorre. Este comportamento pode ser interrompido dando um --noquery opção ou definindo o
variável de configuração DEBCHANGE_QUERY_BTS para não, como descrito abaixo. Em qualquer caso, o
editor (conforme descrito acima) sempre será chamado para dar a oportunidade de modificar o
entradas, e o changelog será aceito independentemente de modificações serem feitas ou não. Um
entradas extras do changelog podem ser fornecidas na linha de comando além das entradas fechadas.

No máximo um de --acrescentar, --incremento, --editar, --liberar e --nova versão pode ser especificado
conforme listado abaixo. Se nenhuma opção for especificada, debchange usará heurísticas para adivinhar
se o pacote foi lançado com sucesso ou não, e se comporte como se --incremento
foi especificado se o pacote foi lançado, ou de outra forma, como se --acrescentar foi
Especificadas.

Dois conjuntos diferentes de heurísticas podem ser usados, controlados pelo --release-heurística
opção ou o DEBCHANGE_RELEASE_HEURISTIC variável de configuração. O padrão changelog
heurística assume que o pacote foi lançado a menos que seu changelog contenha NÃO LIBERADO
no campo da distribuição. Se esta heurística estiver habilitada, a distribuição será o padrão
para NÃO LIBERADO em novas entradas do changelog, e o --mainttrailer opção descrita abaixo irá
ser ativado automaticamente. Isso pode ser útil se um pacote puder ser lançado por diferentes
mantenedores, ou se você não mantiver os logs de upload. O suplente log heurística determina
se um pacote foi lançado procurando um apropriado dupload(1) ou dput(1) registro
arquivo no diretório pai. Um aviso será emitido se o arquivo de log for encontrado, mas um
o upload bem-sucedido não é registrado. Isso pode ser porque o upload anterior foi realizado
com uma versão de dupload antes de 2.1 ou porque o upload falhou.

Se --incremento or --nova versão for usado, o nome e e-mail para a nova versão serão
ser determinado como segue. Se a variável de ambiente DEBFULLNAME está definido, este será
usado para o nome completo do mantenedor; se não então NOME será verificado. Se o ambiente
variável DEBEMAIL estiver definido, será usado para o endereço de e-mail. Se esta variável tiver
o formulário "nome ", então o nome do mantenedor também será retirado daqui se nenhum
DEBFULLNAME nem NOME está definido. Se esta variável não for definida, o mesmo teste é realizado em
a variável de ambiente EMAIL. Em seguida, se o nome completo ainda não foi determinado,
em seguida, usar getpwuid(3) para determinar o nome do arquivo de senha. Se isso falhar, use o
entrada anterior do changelog. Para o endereço de e-mail, se não tiver sido definido a partir de DEBEMAIL or
EMAIL, então olhe dentro / etc / mailname, em seguida, tente construí-lo a partir do nome de usuário e FQDN,
caso contrário, use o endereço de e-mail da entrada anterior do changelog. Em outras palavras, é um
boa ideia para definir DEBEMAIL e DEBFULLNAME ao usar este script.

O suporte está incluído para changelogs que registram mudanças por vários co-mantenedores de um
pacote. Se uma entrada é anexada às entradas da versão atual, e o mantenedor é
diferente do mantenedor que está listado como tendo feito as entradas anteriores, então
linhas serão adicionadas ao changelog para informar quais mantenedores fizeram quais mudanças.
Atualmente, apenas um dos vários estilos de registro dessas informações é compatível,
em que o nome do mantenedor que fez um conjunto de mudanças aparece em uma linha antes do
alterações, entre colchetes. Isso pode ser ligado e desligado usando o
--[não]multimanutenção opção ou o DEBCHANGE_MULTIMINT opção de arquivo de configuração; o padrão
é habilitá-lo. Observe que se uma entrada já foi marcada desta forma, então este
opção será silenciosamente ignorada.

Se o nome do diretório da árvore de origem tiver a forma pacote-versão, Em seguida debchange precisarão
também tente renomeá-lo se o número da versão (upstream) mudar. Isso pode ser evitado
usando o --preservar linha de comando ou opção de arquivo de configuração conforme descrito abaixo.

If --force-versão ruim or --permitir-versão-inferior é usado, debchange não vai parar se o
a nova versão é menor que a atual. Isso é especialmente útil ao fazer
backports.

Diretório nome a verificação

Em comum com vários outros scripts no scripts de desenvolvimento pacote debchange vai escalar o
árvore de diretórios até encontrar um debian / changelog Arquivo. Como uma proteção contra arquivos perdidos
causando problemas potenciais, ele examinará o nome do diretório pai assim que encontrar
da debian / changelog arquivo e verifique se o nome do diretório corresponde ao pacote
nome. Exatamente como ele faz isso é controlado por duas variáveis ​​de arquivo de configuração
DEVSCRIPTS_CHECK_DIRNAME_LEVEL e DEVSCRIPTS_CHECK_DIRNAME_REGEX, e seus correspondentes
opções de linha de comando --check-dirname-level e --check-dirname-regex.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL pode assumir os seguintes valores:

0 Nunca verifique o nome do diretório.

1 Apenas verifique o nome do diretório se tivermos que mudar de diretório em nossa busca por
debian / changelog. Este é o comportamento padrão.

2 Sempre verifique o nome do diretório.

O nome do diretório é verificado testando se o nome do diretório atual (conforme determinado
by pwd(1) corresponde ao regex fornecido pela opção do arquivo de configuração
DEVSCRIPTS_CHECK_DIRNAME_REGEX ou pela opção de linha de comando --check-dirname-regex regex.
Aqui você encontra regex é uma regex Perl (veja Perlre(3perl)), que será ancorado no início
e o fim. Se regex contém um '/', então ele deve corresponder ao caminho completo do diretório. Se
não, então ele deve corresponder ao nome completo do diretório. Se regex contém a string ´PACKAGE',
ele será substituído pelo nome do pacote fonte, conforme determinado no changelog. o
o valor padrão para o regex é: ´PACOTE (-. +)?', correspondendo assim a nomes de diretório, como
PACKAGE e PACOTE-versão.

O changelog padrão a ser editado é debian / changelog; no entanto, isso pode ser alterado usando
da --changelog or --notícia opções ou o CHANGELOG variável de ambiente, conforme descrito
abaixo.

OPÇÕES

--acrescentar, -a
Adicione uma nova entrada do changelog ao final das entradas da versão atual.

--incremento, -i
Aumente o componente final do número de lançamento do Debian ou, se este for um
pacote Debian nativo, o número da versão. No Ubuntu ou Tanglu, isso também
mude o sufixo de buildX para ubuntu1 / tanglu1. Usar -R, --reconstruir para um não
alterar incremento de reconstrução. Isso cria uma nova seção no início do
changelog com cabeçalhos e rodapés apropriados. Além disso, se esta for uma nova versão do
um pacote Debian nativo, o nome do diretório é alterado para refletir isso. Se
DEBCHANGE_RELEASE_HEURISTIC is changelog (padrão) e a versão atual é
NÃO LIBERADO, isso apenas mudará a versão da estrofe atual do changelog.
Caso contrário, isso criará uma nova estrofe do changelog com a nova versão.

--nova versão versão, -v versão
Isso especifica o número da versão (incluindo a parte de lançamento do Debian) explicitamente
e se comporta como o --incremento opção em outros aspectos. Isso também mudará o
nome do diretório se o número da versão upstream foi alterado. Se
DEBCHANGE_RELEASE_HEURISTIC is changelog (padrão) e a versão atual é
NÃO LIBERADO, isso apenas mudará a versão da estrofe atual do changelog.
Caso contrário, isso criará uma nova estrofe do changelog com a nova versão.

--editar, -e
Edite o changelog em um editor.

--liberar, -r
Finalize o changelog para um lançamento. Atualize o registro de data e hora do changelog. Se o
distribuição está definida para NÃO LIBERADO, mude para a distribuição do anterior
entrada do changelog (ou outra distribuição conforme especificado por --distribuição) Se lá
não há entradas de changelog anteriores e uma distribuição explícita não foi
Especificadas, instável será usada.

--force-save-on-release
Quando --liberar for usado, um editor é aberto para permitir a inspeção do changelog.
O usuário deve salvar o arquivo para aceitar o changelog modificado, caso contrário
o original será mantido (padrão).

--no-force-save-on-release
Não faça isso. Observe que uma entrada fictícia do changelog pode ser fornecida para atingir
o mesmo efeito - por exemplo debchange --liberar "". A entrada não será adicionada ao
changelog, mas sua presença irá suprimir o editor.

--Criar
Isso criará um novo debian / changelog arquivo (ou NOTÍCIAS se o --notícia opção
usado). Você deve estar no diretório de nível superior para usar isso; nenhum nome de diretório
a verificação será realizada. O nome do pacote e a versão podem ser especificados
usando o --pacote e --nova versão opções, determinadas a partir do nome do diretório
usando o --fromdirnome opção ou inserida manualmente no changelog
Arquivo. O nome do mantenedor é determinado a partir do ambiente, se isso for possível,
e a distribuição é especificada usando o --distribuição opção ou no
gerado changelog arquivo.

--vazio
Quando usado em combinação com --Criar, suprime a adição automática de um
" do estado inicial, liberar"entrada do changelog (de modo que a próxima invocação de debchange acrescenta
a primeira entrada). Observe que isso causará um dpkg-parsechangelog aviso no
próxima invocação devido à falta de mudanças.

--pacote pacote
Isso especifica o nome do pacote a ser usado no novo changelog; isso só pode ser
usado em conjunto com o --Criar, --incremento e --nova versão opções.

--nmu, -n
Aumente o número de lançamento do Debian para um upload de não-mantenedor anexando
uma ".1"para um número de versão não NMU (a menos que o pacote seja nativo do Debian, no qual
caso "+ nmu1"é anexado) ou incrementando um número de versão NMU e adicionando um NMU
comentário do changelog. Isso acontece automaticamente se o empacotador não estiver no
Mantenedor nem o Carregadores campo em debian / control, a menos que DEBCHANGE_AUTO_NMU is
definido para não ou de --no-auto-nmu opção é usada.

--bin-nmu
Aumente o número de lançamento do Debian para um upload binário de não-mantenedor por qualquer
anexando um "+ b1"para um número de versão não binNMU ou incrementando um binNMU
número da versão e adicione um comentário do log de mudanças binNMU.

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

--reconstruir, -R
Aumente o número de lançamento do Debian para uma reconstrução sem alterações anexando um "build1"
ou incrementando um número de versão de reconstrução.

--segurança, -s
Aumente o número de lançamento do Debian para um não-mantenedor do time de segurança do Debian
faça upload e adicione um Segurança Time carregar comentário do changelog.

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

--upstream, -U
Não anexe nome da distro1 para a versão em uma distribuição derivada. Incrementar o
Versão Debian.

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

--local, -lsufixo
Adicione um sufixo ao número da versão Debian para uma construção local.

--force-versão ruim, -b
Força um número de versão a ser menor do que o atual (por exemplo, quando backporting).

--permitir-versão-inferior de cinto de segurança
Permitir que um número de versão seja menor que o atual se a nova versão corresponder
o padrão especificado.

- distribuição de força
Força a distribuição fornecida a ser usada, mesmo que não corresponda à lista de
distribuições conhecidas (por exemplo, para distribuições não oficiais).

--auto-nmu
Tentar determinar automaticamente se uma mudança no changelog representa um
Upload de não mantenedor. Este é o padrão.

--no-auto-nmu
Desative a detecção automática de NMU. Equivalente a configuração DEBCHANGE_AUTO_NMU para não.

--fromdirnome, -d
Isso pegará o número da versão upstream do nome do diretório, que deve ser
do formulário pacote-versão. Se o número da versão upstream aumentou do
entrada do changelog mais recente, então uma nova entrada será feita com o número da versão
versão-1 (ou versão se o pacote for nativo do Debian), com a mesma época do
versão anterior do pacote. Se o número da versão upstream for o mesmo, esta opção
vai se comportar da mesma maneira que -i.

- fecha nnnnn[,nnnnn ...]
Adicione entradas de changelog para fechar os números de bug especificados. Também invoque o editor
depois de adicionar essas entradas. Irá gerar avisos se o BTS não puder ser contatado
(E --noquery não foi especificado), ou se houver problemas com o bug
relatório localizado.

--[não]pergunta
Devemos tentar consultar o BTS ao gerar entradas fechadas?

--preservar, -p
Preserve o nome do diretório da árvore de origem se o número da versão upstream (ou o
número da versão de um pacote nativo Debian). Veja também a configuração
seção de variáveis ​​abaixo.

--sem preservação, --nopreserve
Não preserve o nome do diretório da árvore de origem (padrão).

--fornecedor fornecedor
Substitua o ID do distribuidor sobre o padrão retornado por dpkg-vendor. Este nome é
usado para heurísticas aplicadas a novas versões de pacotes e para verificação de sanidade do
distribuição alvo.

--distribuição dist, -D dist
Use a distribuição especificada na entrada do changelog que está sendo editado, em vez de
usando a distribuição da entrada do changelog anterior para novas entradas ou as existentes
valor para entradas existentes.

--urgência urgência, -u urgência
Use a urgência especificada na entrada do changelog que está sendo editado, em vez de usar o
predefinição "média"para novas entradas ou o valor existente para entradas existentes.

--changelog lima, -c lima
Isto irá editar o changelog lima em vez do padrão debian / changelog. Este
opção substitui qualquer CHANGELOG configuração de variável de ambiente. Além disso, nenhum diretório
atravessar ou verificar será executado quando esta opção for usada.

--notícia [arquivo de notícias]
Isso vai editar arquivo de notícias (por padrão, debian / NEWS) em vez do changelog regular.
A pesquisa de diretório será executada. O changelog será examinado para
determinar a versão atual do pacote.

--[não]multimanutenção
Devemos indicar que partes de uma entrada do changelog foram feitas por diferentes
mantenedores? O padrão é sim; veja a discussão acima e também o
DEBCHANGE_MULTIMINT opção de arquivo de configuração abaixo.

--[não]fusão multimanutenção
Todas as alterações feitas pelo mesmo autor devem ser mescladas no mesmo changelog
seção? O padrão é não; veja a discussão acima e também o
DEBCHANGE_MULTIMAINT_MERGE opção de arquivo de configuração abaixo.

--manutenção, -m
Não modifique os detalhes do mantenedor listados anteriormente no changelog. Isto é
útil principalmente para patrocinadores que desejam adicionar automaticamente uma mensagem de patrocínio
sem interromper os outros detalhes do changelog. Observe que pode haver alguns
interações interessantes se o modo multi-mantenedor estiver em uso; você provavelmente desejará
para verificar o changelog manualmente antes de enviá-lo em tais casos.

--controlmaint, -M
Use os detalhes do mantenedor do debian / control Mantenedor campo ao invés de
variáveis ​​de ambiente relevantes (DEBFULLNAME, DEBEMAIL, etc.). Esta opção pode ser
útil para restaurar os detalhes do mantenedor principal no trailer do changelog após um
edição falsa (por exemplo, quando -m foi intencional, mas esqueci) ou ao lançar um pacote em
o nome do mantenedor principal (por exemplo, a equipe).

--[não]mantenedor, -t
If mantenedor estiver definido, isso evitará a modificação da linha de trailer do changelog existente
(ou seja, o mantenedor e os detalhes do carimbo de data), a menos que seja usado com opções que requeiram
o trailer a ser modificado (por exemplo --Criar, --liberar, -i, --qa, etc.) Esta opção
difere --manutenção na medida em que usará o modo multi-mantenedor, se apropriado,
com exceção da edição do trailer. Veja também o DEBCHANGE_MAINTTRAILER
opção de arquivo de configuração abaixo.

--check-dirname-level N
Veja a seção acima "Diretório nome a verificação"para obter uma explicação sobre essa opção.

--check-dirname-regex regex
Veja a seção acima "Diretório nome a verificação"para obter uma explicação sobre essa opção.

--no-conf, --noconf
Não leia nenhum arquivo de configuração. Isso só pode ser usado como a primeira opção
fornecido na linha de comando.

--release-heurística log|changelog
Controla como debchange determina se um pacote foi lançado, ao decidir
se deve criar uma nova entrada do changelog ou anexar a uma entrada do changelog existente.

--Socorro, -h
Exibir uma mensagem de ajuda e sair com sucesso.

--versão
Mostra a versão e as informações de copyright e sai com sucesso.

CONFIGURAÇÃO VARIÁVEIS

Os dois arquivos de configuração /etc/devscripts.conf e ~ / .devscripts são originados naquele
para definir as variáveis ​​de configuração. As opções de linha de comando podem ser usadas para substituir
configurações do arquivo de configuração. As configurações da variável de ambiente são ignoradas para este propósito.
As variáveis ​​atualmente reconhecidas são:

DEBCHANGE_PRESERVE
Se estiver definido para sim, então é o mesmo que o --preservar parâmetro de linha de comando
sendo usado.

DEBCHANGE_QUERY_BTS
Se estiver definido para não, então é o mesmo que o --noquery parâmetro de linha de comando
sendo usado.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
Veja a seção acima "Diretório nome a verificação"para uma explicação destes
variáveis. Observe que essas são variáveis ​​de configuração de todo o pacote e irão
portanto, afeta todos scripts de desenvolvimento scripts que verificam seu valor, conforme descrito em
suas respectivas páginas de manual e em devscripts.conf(5).

DEBCHANGE_RELEASE_HEURISTIC
Controla como debchange determina se um pacote foi lançado, ao decidir
se deve criar uma nova entrada do changelog ou anexar a uma entrada do changelog existente.
Pode ser qualquer um log or changelog.

DEBCHANGE_MULTIMINT
Se definido para não, debchange não irá introduzir distinções de múltiplos mantenedores quando um
mantenedor diferente adiciona uma entrada a um changelog existente. Veja a discussão
acima de. O padrão é sim.

DEBCHANGE_MULTIMAINT_MERGE
Se definido para sim, ao adicionar mudanças no modo de múltiplos mantenedores debchange irá verificar
se as mudanças anteriores pelo mantenedor atual existem e adicionar as novas mudanças ao
o bloco existente em vez de criar um novo bloco. O padrão é não.

DEBCHANGE_MAINTTRAILER
Se estiver definido para não, então é o mesmo que o --nomainttrailer linha de comando
parâmetro sendo usado.

DEBCHANGE_TZ
Use este fuso horário para entradas do changelog. O padrão é o fuso horário do usuário / sistema como
mostrado por `dados -R`e afetado pela variável de ambiente TZ.

DEBCHANGE_LOWER_VERSION_PATTERN
Se estiver definido, é o mesmo que o --permitir-versão-inferior linha de comando
parâmetro sendo usado.

DEBCHANGE_AUTO_NMU
Se estiver definido para não então debchange não tentará determinar automaticamente
se a sub-rotina atual do changelog representa um NMU. O padrão é sim. Ver
a discussão do --nmu opção acima.

DEBCHANGE_FORCE_SAVE_ON_RELEASE
Se estiver definido para não, então é o mesmo que o --no-force-save-on-release comando
parâmetro de linha sendo usado.

DEBCHANGE_VENDOR
Use este fornecedor em vez do padrão (saída dpkg-vendor). Ver --fornecedor for
Detalhes.

MEIO AMBIENTE

DEBEMAIL, EMAIL, DEBFULLNAME, NOME
Veja a descrição acima sobre o uso dessas variáveis ​​de ambiente.

CHANGELOG
Esta variável especifica o changelog a ser editado no lugar de debian / changelog. Não
a travessia ou verificação do diretório é executada quando essa variável é definida. Esse
variável é substituída pelo --changelog configuração de linha de comando.

VISUAL, EDITOR
Essas variáveis ​​de ambiente (nesta ordem) determinam o editor usado por sensato
editor.

Use o debchange online usando os serviços onworks.net