patsend - Online na nuvem

PROGRAMA:

NOME

pat - ferramentas geradoras de patch

SINOPSE

pancadinha [ -ahmnV ] [ lista de arquivos ]
patcil [ -abfhnpqsV ] [ lista de arquivos ]
paddiff [ -ahnV ] [ lista de arquivos ]
patbase [ -ahV ] [ lista de arquivos ]
patlog [ -hnruV ]
amassar [ -hV ]
enviar [ -hiquV ] [ lista de patches ] [ destinatários ]
patnotificar [ -hquV ] [ destinatários ]
patinete [ -hrV ] lista de patches grupos de notícias
patftp [ -hV ] [ lista de patches ]
nome de usuário [ -ahnmV ] -v versão [ lista de arquivos ]
estalar de dedos [ -ahV ] [ -o instantâneo ] [ lista de arquivos ]
patcol [ -achnmsCV ] [ -d anuário ] [ -f mãos ] [ -S estalo ] [ lista de arquivos ]
limpo [ -ahnmV ] [ lista de arquivos ]
índice de referência

DESCRIÇÃO

Palmadinha e seus programas associados geram patches para qualquer pacote que tenha sido armazenado
sob RCS. Esses programas escondem muitos dos detalhes do RCS que atrapalham quando
construir e manter um pacote. Tudo que você precisa fazer para criar um novo patch é
edite seus arquivos, execute o pat e forneça algumas descrições para o RCS e no patch gerado
Arquivo. Detalhes como inicializar um novo arquivo RCS, o que a string de comentário deve
ser, como criar um novo branch, como lidar com subdiretórios, como fazer diffs e como
organizar o arquivo de patch são tratados automaticamente.

Antes de usar qualquer um dos programas pat você deve inicializar seu pacote executando packinit
no diretório de nível superior do seu pacote. Isso produz um arquivo .package que todos os
programas dist fazem uso de.

Em qualquer um dos programas que deseja uma lista de arquivos, se você especificar -a em vez disso, todos os arquivos em
MANIFEST.new será processado. Em qualquer um dos programas que desejam uma lista de patch, um valor nulo
patchlist significa o patch atual. Você pode usar hifens, vírgulas e espaços para delimitar
números do patch. Se o lado direito de um hífen for a string nula, o nível do patch atual
é assumido como o valor máximo. Todos os programas invocados com -h irá imprimir um pequeno uso
mensagem com o significado de cada uma das opções disponíveis. o -V opção dá o atual
número da versão.

O próprio Pat é um programa wrapper que chama patcil, patdiff e patmake. Normalmente você pode
apenas invoque pat e ignore todos os outros. Pat irá atualizar o arquivo MANIFEST, se
necessário (será uma cópia exata do arquivo MANIFEST.new, desde que um MANIFEST
já existia), eventualmente chamando patcil nele.

Se você especificar -n em vez de uma lista de arquivos, pat encontrará todos os arquivos mais recentes que
patchlevel.h, coloque você em um editor para reduzir a lista e, em seguida, use essa lista de arquivos. Se
cada arquivo da lista é removido, pancadinha será abortado.

patcil é usado para fazer um ci -l em qualquer arquivo listado. (Presume-se que você sempre deseja
mantenha seus arquivos em check-out.) Além do -a interruptor, há um -b mudar qual
faz um check-in rápido de um conjunto de arquivos. Em vez de chamar rcs em cada arquivo, ele chama rcs
em toda a lista de arquivos. Isso é útil para fazer check-in em uma revisão de tronco. Quando você
está verificando uma nova revisão do tronco, você também pode querer usar o -s bandeira que vai
retire as entradas de Log RCS antigas da revisão anterior para que você possa começar do zero.
Você provavelmente também deve usar um -f que é passado para o ci para forçar inalterado
arquivos a serem registrados. Para fazer o check-in de uma nova revisão do tronco, eu digo

patcil -s -f -a

Patcil pedirá a entrada de log em vez de deixar ci fazer isso, e tem um pequeno aviso
integrado que permite manipular a mensagem de várias maneiras. Digite h para uma lista de
o que você pode fazer. Uma das coisas mais legais é que você pode abrir um editor,
opcionalmente com uma lista de diferenças das mudanças desde o último patch, no caso de você
esqueceu o que você mudou. Se você digitar um CR como a primeira coisa, ele inclui o anterior
mensagem de registro. Saia do prompter com um CR.

Existem duas maneiras diferentes de usar o patcil. Você pode ligar para o patcil sozinho ou
pat chamá-lo para você. Não importa quantas vezes você chame o patcil antes de executá-lo,
já que patdiff sabe qual é o último patch base para comparar. Patcil pode ser chamado em
qualquer um de seus diretórios; os outros programas devem ser chamados em seu diretório de nível superior (ou
em bugs, quando significativo).

Quando você está criando um novo arquivo em um determinado nível de patch, você deve corrigi-lo com o -p
opção. Caso contrário, será feito simplesmente o check-in como uma nova revisão de tronco. O nome do
será adicionado ao MANIFEST.new se ainda não aparecer nele. Se o nome é
encontrado junto com uma descrição, essa descrição será passada para o rcs para
inicialize o arquivo RCS.

Patbase pode ser usado para redefinir a base do patch para a versão atual quando você tiver descartado
a sequência de patch anterior e estão fazendo um novo kit de distribuição. O que realmente faz é
an rcs -Nlastpat: REV, onde REV é a revisão atual. Se o patdiff explodir e você quiser
para definir a base do patch de volta para alguma versão anterior, você deve chamar rcs -Nlastpat: REV
você mesmo.

Patdiff realmente faz as diferenças que vão para o patch, comparando qualquer versão
- Últimopat aponta para a versão com check-in mais recente. Em seguida, atualiza o -Núltimopat
para apontar para a versão atual. Isso deixa o diff no subdiretório bugs por
patmake para pegar. Ele pode usar rcsdiff ou um comando diff de sua escolha especificado
quando você executa o packinit, no caso do seu diff ser melhor do que o rcsdiff.

Patlog é invocado por amassar normalmente, para atualizar o ChangeLog arquivo (ou qualquer nome que
arquivo foi fornecido quando você executou empacotar) Ele irá reunir mensagens de log e lançar um
editor para você fazer as atualizações necessárias. Se você configurou seu pacote para também
incluem logs RCS no ChangeLog, outra sessão do editor será iniciada para aqueles também.
Finalmente, um registro final é construído como uma entrada candidata para ChangeLog, que você também pode
modifique como desejar.

Quando você não configurou um ChangeLog arquivo, patlog só vai reunir as informações
precisa passar para amassar e vai sair. Se você deseja chamá-lo você mesmo, você deve
faça isso depois de pelo menos um sucesso paddiff corre. Eu recomendo usar o -n opção o
primeira vez e, em seguida, use o -u opção junto com -n em execuções subsequentes para recriar arquivos
somente quando necessário. o -r opção (que substitui -u) impede patlog de recriar um
arquivo existente, mesmo que esteja desatualizado.

Patlog chamará patcil e paddiff na sua ChangeLog arquivo (depois de ter enchido o
entrada de registro do candidato que você editou na parte superior do arquivo), a menos que seja impedido de fazê-lo pelo
-n opção. Isso significa que o patch emitido será atualizado ChangeLog com patch atual
informações, como você esperaria.

patmake combina todas as partes do patch em um arquivo e invoca um editor para que você
pode adicionar o assunto e a descrição. Ele joga todas as suas mensagens de log como assuntos e
como descrição, partindo do pressuposto de que é mais fácil deletar o que você não quer do que
para lembrar tudo que você fez. Você também vai querer expandir cada item na descrição
para que eles não repitam apenas as linhas de assunto. Se você tem um ChangeLog arquivo, isso deve ter
já foi feito, ou o seu ChangeLog não representará com precisão o que está descrito em
o patch, visto que já foi atualizado quando amassar reúne todos os
peças (veja a nota sobre patlog acima).

Patches grandes serão divididos para manter o tamanho de cada patch em um tamanho razoável. Esse
é tratado automaticamente, então você não precisa se preocupar com isso. A prioridade de cada patch
é meramente intuído por amassar, dada a suposição de que pequenas mudanças têm uma grande
prioridade.

Patsend, patpost e patftp são usados ​​para distribuir seus patches para o mundo. Envio de mensagem
envia um conjunto de patches para um conjunto de destinatários. o -u switch adiciona todos os
usuários registrados que solicitaram o envio de patches para eles, bem como o
destinatários especificados durante a execução empacotar. O -i switch inclui informações com o
patch sobre como o usuário pode cancelar o registro para não receber patches futuros
automaticamente; este também é o padrão quando o -u interruptor é usado. postpost posta um conjunto
de patches para um conjunto de grupos de notícias. Patftp apenas copia o patch em seu ftp público
diretório.

Patnotificar simplesmente notifica os usuários que um novo patch foi lançado para que eles possam
recupere-o por conta própria em um site de arquivo ou por e-mail se estiverem interessados. o
-u switch pode ser usado para incluir todos os usuários registrados que solicitaram
tal notificação. A mensagem inclui a prioridade e a descrição do patch, bem como
instruções sobre como solicitar automaticamente o patch (que funcionará apenas se você tiver
agente postal instalado).

Ambos enviar e patnotificar permitem que você edite a lista de endereços antes de enviar qualquer coisa,
a menos que você adicione o -q opção.

Nome do nome pode ser usado para marcar um conjunto de arquivos com um nome simbólico (especificado com -v). Este
irá definir o nome da revisão mais recente de cada arquivo.

Patsnap obterá um instantâneo do seu lançamento criando um arquivo SNAPSHOT (o nome pode ser
mudou via -o) listando os nomes dos arquivos e o número de revisão RCS mais recente para esse arquivo.
Esses instantâneos podem ser usados ​​para identificar o lançamento em algum patchlevel aleatório e então
mais tarde, será capaz de recuperá-lo, alimentando o arquivo de instantâneo para patcol.

Patcol fará o check-out de uma versão bloqueada de um arquivo, eventualmente em um diretório alternativo
(especificado com -d, espelhando assim a árvore de distribuição). Todos os arquivos que não têm
A contraparte RCS (por exemplo, patchlevel.h) será simplesmente copiada por patcol. Isso é usado por
makedist para falsificar a distribuição antes de fazer os kits. Por padrão, patcol não fará
o processamento de expansão de direitos autorais, mas os clientes gostam madedista force-o usando seu -C
opção. Alternativamente, você pode forçar a cópia da versão em check-out em um diretório
usando o -c mudar em conjunto com -d (ou essa opção anterior é simplesmente ignorada).

Patcol também pode obter sua lista de arquivos de um arquivo SNAPSHOT através do -S mudar, nesse caso
ele fará o check-out dos arquivos usando a versão RCS especificada pelo arquivo de instantâneo, como
um criado por estalar de dedos. Em vez disso, você pode especificar -a, -m or -n para, respectivamente, usar todos os
arquivos em MANIFEST.new, todos os arquivos modificados (aquele que foi patciled), ou todos
os arquivos mais novos que patchlevel.h.

Patclean irá remover os arquivos de trabalho após ter verificado todas as alterações. Você pode
restaura seus arquivos de trabalho usando patcol.

Patindex pode ser usado a partir do diretório de nível superior ou dentro do erros diretório. Será
liste todos os patches e seus Assunto: linhas. Este programa conhece patches compactados
e irá descompactá-los enquanto produz a listagem.

RCS CAMADA

Esta seção descreve a camada RCS, no caso de algo quebrar nas ferramentas, para que você
pode consertar seus arquivos RCS e reiniciar a operação.

Todas as ferramentas de patch obtêm o número de revisão do tronco RCS principal de seu .pacote arquivos, digamos
é 2.5. Então, no momento em que você correu empacotar, você escolheu um branch para patches,
geralmente o número 1, o que significa que todas as suas modificações serão armazenadas no 2.5.1 RCS
filial. As ferramentas criarão o ramo para você quando chegar a hora.

Cada última revisão lançada é marcada com um RCS última patada símbolo. Quando o patch é construído
by paddiff, a versão mais recente no ramo 2.5.1 é comparada com aquela marcada como
última patada. É por isso que você pode emitir com segurança mais de um patcil antes de emitir o patch
e ainda tem tudo resolvido. Claro paddiff vai mover o última patada tag para o
última revisão do ramo após o processamento de um determinado arquivo.

Todas as mensagens de log e os arquivos modificados são mantidos em seu erros diretório, em oculto
arquivos (nome começando com um ponto). Esses logs serão coletados quando o patch for lançado
e os arquivos modificados são usados ​​por pancadinha's -m interruptor.

Patdiff coleta seus pedaços de patch sob o erros diretório, em arquivos que terminam com um .nn
extensão, onde nn representa o nível de patch atual + 1. (que será o próximo
patchlevel quando o patch será feito por amassar, a menos que seja muito grande para caber em um
arquivo).

Patlog prepara um conjunto de arquivos para amassar: .entupir arquivo coleta as informações que
irá na seção Descrição: dentro do patch, e .xlog aqueles coletam o
ChangeLog entrada do candidato. Finalmente, .rlog arquivos armazenam as informações RCS que devem ser
incluído em ChangeLog, se solicitado. Observe que as três linhas superiores são lixo e
são ignorados por todas as ferramentas que lidam com esses arquivos.

A fim de iniciar uma nova linha de base (ou seja, para alterar o número de revisão do tronco RCS), você
precisa reexecutar empacotar e mude esse número. Em seguida, emita um novo patcil, provavelmente com o
-s, -a e -f opções ...

Use patsend online usando serviços onworks.net