dpatch-edit-patch - Online na nuvem

PROGRAMA:

NOME

dpatch-edit-patch - mantém patches dpatch para um pacote fonte Debian

SINOPSE

dpatch-edit-patch [opções] comando dpatchname [remessa base]

DESCRIÇÃO

Este manual documenta o dpatch-edit-patch comando que mantém patches dpatch para um
pacote fonte Debian dpatch-using.

dpatch-edit-patch irá copiar a árvore completa para um diretório temporário para trabalhar.

ATENÇÃO

dpatch está obsoleto, por favor mude para o formato de pacote fonte Debian `3.0 (quilt) '
em vez de. Ver http://wiki.debian.org/Projects/DebSrc3.0#PERGUNTAS FREQUENTES para um breve guia sobre como fazer
.

OPÇÕES

dpatch-edit-patch assume duas formas de argumentos; opções e comandos. Atualmente, o único
O comando que existe é “patch”, que permite criar / editar dpatches. Quando nenhum comando
é fornecido, “patch” é assumido.

COMANDOS:
remendo Este comando requer um argumento obrigatório e aceita um argumento opcional
Sob certas circunstâncias. O argumento obrigatório é dpatchname. Isso se refere a
um dpatch, como seria listado em debian / patches / 00list. Não é necessário para
dpatchname existir antes de correr dpatch-edit-patch remendo dpatchname.

Quando dpatchname existe, dpatch-edit-patch irá configurar uma árvore de fontes de trabalho, aplique
todos os dpatches listados em debian / patches / 00list até e incluindo dpatchname e
gerar um shell interativo para o desenvolvedor. O desenvolvedor então edita os arquivos em
esta árvore de trabalho. Quando o desenvolvedor termina, ele sai do shell.
dpatch-edit-patch então atualizações dpatchname para refletir as alterações feitas. Deve o
desenvolvedor deseja abortar o processo do shell interativo, eles só precisam
faz com que o shell saia com um valor de saída de 230. Normalmente, isso é feito por
saindo do shell com o comando saída 230.

O desenvolvedor gostaria de ver o patch que está funcionando atualmente sem sair
o subshell, duas variáveis ​​de ambiente são exportadas para o subshell para ajudar com
esta: DPEP_SHELL_REFDIR, que é definido como o nome completo do diretório de referência e
DPEP_SHELL_WORKDIR, que é definido como o diretório de trabalho do subshell.

Esses dois podem ser usados ​​para - por exemplo - gerar uma diferença entre a referência
versão e a árvore atual:

diff -urNa $ DPEP_SHELL_REFDIR $ DPEP_SHELL_WORKDIR

Quando dpatchname não existe, dpatch-edit-patch irá assumir que um novo dpatch deve ser
criada. Tal como acontece com o cenário acima, dpatch-edit-patch primeiro cria uma fonte de trabalho
árvore. Se o argumento opcional remessa base é fornecido, todos os dpatches em
debian / patches / 00list até e incluindo remessa base será aplicado à árvore de trabalho.
If remessa base não é fornecido, nenhum dpatch é aplicado à árvore de trabalho. Então quando
o desenvolvedor sai do shell, dpatch-edit-patch irá criar dpatchname. Se
debian / patches / 00template não existe, um cabeçalho de dpatch codificado e um snippet de shell
ser usado. Se existir e não for executável, será copiado literalmente como o cabeçalho e
fragmento de shell.

Seu primeiro parâmetro é o nome do arquivo base do ser atualizado or para ser criado dpatch
(útil para adicionar títulos ao cabeçalho dpatch). Seu segundo parâmetro será o
descrição do novo patch.

OPÇÕES
Para as opções a seguir, os argumentos da linha de comando têm precedência sobre o ambiente
variáveis, que têm precedência sobre as variáveis ​​de configuração. Variáveis ​​de configuração são
ler de debian / patches / 00dpatch.conf e ~ / .dpatch.conf.

-sim, --sourcedir =valor
Diretório contendo o pacote fonte Debian descompactado. Variável de configuração
conf_sourcedir (configurável apenas em ~ / .dpatch.conf), variável de ambiente
DPEP_SOURCEDIR. O padrão é o diretório de trabalho atual.

-ó, --outdir =valor
Diretório onde o dpatch atualizado ou recém-criado será colocado. Configuração
variável conf_outdir (~ / .dpatch.conf), variável de ambiente DPEP_OUTDIR. Padrões
para ./debian/patches/

-c, --limpar
Indique para dpatch-edit-patch que o diretório de trabalho atual pode ser com segurança
limpo. Se não for dado, dpatch-edit-patch tenta preservar parcial ou total
constrói copiando primeiro o diretório de trabalho atual para um diretório de referência antes
invocando debian / rules limpar no diretório de referência. Se dado, o atual
O diretório é limpo e, em seguida, considerado um diretório de referência. Use esta opção se
seu pacote fonte é muito grande e nenhum trabalho significativo é destruído por
limpeza. Variável de configuração conf_clean (~ / .dpatch.conf), Variável de ambiente
DPEP_CLEAN.

-b, --debianonly [=caminho]
Indique para dpatch-edit-patch que o diretório de trabalho atual contém apenas um
subdiretório debian e que um tarball upstream deve ser descompactado na referência
diretório antes de copiar o diretório de trabalho atual para lá. O argumento opcional é
o caminho para o tarball upstream - incluindo o nome do tarball. Se nenhum valor for
dado, dpatch-edit-patch usará o script de gancho apontado por conf_getorigtargz
(~ / .dpatch.conf) ou DPEP_GETORIGTARGZ para obter o tarball do upstream. O gancho
o script deve ter um argumento: o diretório de destino onde o
arquivo deve ser colocado. Variáveis ​​de configuração: conf_debianonly
(debian / patches / 00dpatch.conf) e conf_origtargz (~ / .dpatch.conf), Ambiente
Variáveis DPEP_DEBIANONLY e DPEP_ORIGTARGZ.

-P, --origtargzpath =caminho
Quando -b está em uso, especifique o caminho onde os tarballs upstream devem ser procurados.
caminho é uma lista de diretórios separados por dois pontos. Variáveis ​​de configuração:
conf_origtargzpath (~ / .dpatch.conf), Variáveis ​​ambientais DPEP_ORIGTARGZPATH.

-r, --rootcmd =valor
Comando usado para obter privilégios de root usados ​​para limpar DPEP_SOURCEDIR. Configuração
variável conf_rootcmd, variável de ambiente DPEP_ROOTCMD. Padrões para raiz falsa, Se
instalado. Se nenhum dos itens acima for especificado e o fakeroot não estiver instalado,
dpatch-edit-patch vai abortar. Os autores do dpatch recomendam fortemente o uso de
fakeroot para este propósito.

-d, --description =valor
Descrição usada para um patch recém-criado. Variável de configuração conf_newdesc
(~ / .dpatch.conf), variável de ambiente DPEP_NEWDESC, o padrão é "Não Descrição."

-k, --keeptemp =valor
Valor booleano, também 0 or 1. Variável de configuração conf_keeptemp
(~ / .dpatch.conf), variável de ambiente DPEP_KEEPTEMP. Quando definido para 1, temporário
a árvore de trabalho não é excluída quando dpatch-edit-patch é feito.

-t, --tmpdir =valor
Diretório temporário dentro do qual dpatch-edit-patch irá criar a fonte de trabalho
árvore. Variável de configuração conf_tmpdir (~ / .dpatch.conf), variável de ambiente
DPEP_TMPDIR. Se nenhuma das opções acima for definida, dpatch-edit-patch vai primeiro tentar
usar a variável de ambiente TMPDIR, e voltará para / Tmp.

-p, --stampdir =valor
O diretório dpatch tem usado para criar carimbos de patch. Usado para verificar se
o patch a ser editado já está aplicado à árvore de trabalho. Variável de configuração
conf_stampdir (~ / .dpatch.conf), variável de ambiente DPEP_STAMPDIR. Nenhum de
o acima seja definido, dpatch-edit-patch vai cair de volta para debian / patcheado

-e --exclude =valuelista
Lista separada por espaço de nomes de arquivos e diretórios que dpatch-edit-patch precisarão
excluir de ser copiado e difundido. Variável de configuração conf_exclude
(~ / .dpatch.conf), variável de ambiente DPEP_EXCLUDE. O padrão é "CVS .svn .git
.arch .hg _darcs .bzr ", o que pode causar problemas se você usar arquivos nomeados como
isso em seu pacote.

-O, --diffopts =valuelista
Opções extras para passar diretamente para diff como é. Variável de configuração conf_diffopts
(~ / .dpatch.conf), variável de ambiente DPEP_DIFF_OPTIONS. Ele está vazio por padrão.

-eu, --shell =concha
Avisar dpatch-edit-patch qual shell invocar. Variável de configuração conf_shell
(~ / .dpatch.conf), variável de ambiente DPEP_SHELL, assumindo o padrão $ SHELL e o
shell padrão do usuário.

-n, --notimestamp
Avisar dpatch-edit-patch para remover carimbos de data / hora dos diffs que ele gera. Também pode
ser definido em debian / patches / 00options, Com o DPEP_OMIT_TIMESTAMPS variável.

-0, --add2list
adicione o novo patch ao arquivo 00list.

-uma, --aplicar tudo
aplique todos os patches disponíveis.

EXEMPLOS

Crie a novo remendo para be aplicado depois de an existente patch.
Para criar um novo patch, a ser aplicado após um patch existente 90_ctrlkeyfix:

$ dpatch-edit-patch remendo 95_newupstreamfix 90_ctrlkeyfix
dpatch-edit-patch: * debian / patches / 95_newupstreamfix.dpatch não existe, ele será criado como um novo dpatch.
dpatch-edit-patch: * Limpeza /home/david/temp/sopwith-1.6.0
...
dpatch-edit-patch: * Aplicação de patches
dpatch-edit-patch: ** Aplicando patch 90_ctrlkeyfix ... aplicado corretamente.
dpatch-edit-patch: * Copiando /home/david/temp/sopwith-1.6.0 para o diretório de trabalho.
...
$ editor arquivos
$ saída 0
dpatch-edit-patch: * Criando novo patch debian / patches / 95_newupstreamfix.dpatch
dpatch-edit-patch: Aviso: debian / patches / 00template não existe, usando o padrão embutido no código.
dpatch-edit-patch: debian / patches / 95_newupstreamfix.dpatch criado.

Crie a novo remendo não Dependendo on existente remendos
Para criar um novo patch, destinado a ser aplicado antes de quaisquer outros patches (ou um novo patch
que não requer que outros patches sejam aplicados primeiro):

$ dpatch-edit-patch 10_debianstrings
dpatch-edit-patch: * debian / patches / 10_debianstrings.dpatch não existe, ele será criado como um novo dpatch.
dpatch-edit-patch: * Limpeza /home/david/temp/sopwith-1.6.0
...
dpatch-edit-patch: Aviso: * Nenhum patch base fornecido, não aplicando nenhum patch.
dpatch-edit-patch: * Copiando /home/david/temp/sopwith-1.6.0 para o diretório de trabalho.
...
$ editor arquivos
$ saída 0
...
dpatch-edit-patch: * Criando novo patch debian / patches / 10_debianstrings.dpatch
dpatch-edit-patch: Aviso: debian / patches / 00template não existe, usando o padrão embutido no código.
dpatch-edit-patch: debian / patches / 10_debianstrings.dpatch criado.

Editar an existente correção:
$ dpatch-edit-patch 10_debianstrings
dpatch-edit-patch: * debian / patches / 10_debianstrings.dpatch existe, este patch será atualizado.
dpatch-edit-patch: * Limpeza /home/david/temp/sopwith-1.6.0
...
dpatch-edit-patch: * Aplicação de patches
dpatch-edit-patch: * Copiando /home/david/temp/sopwith-1.6.0 para o diretório de trabalho.
dpatch-edit-patch: * Aplicando 10_debianstrings atuais para edição.
...
$ editor arquivos
$ saída 0
dpatch-edit-patch: Atualizando patch debian / patches / 10_debianstrings.dpatch
dpatch-edit-patch: tag @ DPATCH @ encontrada, preservando o cabeçalho dpatch.
dpatch-edit-patch: debian / patches / 10_debianstrings.dpatch atualizado.

NOTAS

dpatch-edit-patch utiliza o DEBFULLNAME variável de ambiente como o nome do autor. Se for
não definido, o nome do autor será deixado em branco.

dpatch-edit-patch determina o endereço de e-mail do autor para novos patches usando o
seguinte algoritmo:
1) Deveria o DEBEMAIL variável de ambiente existe, ela é sempre usada.
2) Se o EMAIL variável de ambiente existe, ela será usada quando DEBEMAIL não existe.
3) Se nenhuma das duas primeiras tentativas for bem-sucedida, o e-mail será construído usando
o nome de login do usuário em execução dpatch-edit-patch combinado com a saída de hostname
-f.

Quando dpatch-edit-patch configura uma referência ou um diretório de trabalho, desreferencia todos
links simbólicos na fonte. Isso permite que os links relativos continuem funcionando e permite mudanças
apenas para um único arquivo e não para o arquivo vinculado e o destino do link. Se você usar
dpatch-edit-patch em árvores de origem que têm links simbólicos, você pode acabar com um patch
isso é inaplicável à árvore original.

Use dpatch-edit-patch online usando serviços onworks.net