aerm - Online na nuvem

PROGRAMA:

NOME

aegis remover arquivo - adicionar arquivos a serem excluídos para uma mudança

SINOPSE

Aegis -Remover arquivo nome do arquivo... [ opção...]
Aegis -Remover arquivo -Lista [ opção...]
Aegis -Remover arquivo -Ajuda

DESCRIÇÃO

A Aegis -Remover arquivo comando é usado para adicionar arquivos a serem excluídos para uma alteração. O arquivo
será adicionado à lista de arquivos na mudança e será removido da linha de base
no momento da integração.

Este comando pode ser usado para remover testes, não apenas arquivos de origem. Os testes são tratados apenas
como qualquer outro arquivo de origem, e estão sujeitos ao mesmo processo.

Um arquivo será criado no diretório de desenvolvimento contendo 1 KB de texto aleatório. o
texto aleatório é suficientemente revoltante para que a maioria dos compiladores forneça mensagens de erro,
caso o arquivo seja referenciado acidentalmente. Isso geralmente é muito útil ao remover
incluir arquivos.

Você pode especificar um nome de diretório para remover todos os arquivos na árvore de diretórios nomeada. Isto é
um erro se não houver arquivos relevantes.

Envie o Nome Interpretação
O programa aegis tentará determinar os nomes dos arquivos do projeto a partir dos nomes dos arquivos
fornecido na linha de comando. Todos os nomes de arquivo são armazenados em projetos aegis como relativos
para a raiz da árvore de diretórios da linha de base. O diretório de desenvolvimento e o
diretório de integração são sombras deste diretório de linha de base e, portanto, esses nomes relativos
aplique aqui também. Os arquivos nomeados na linha de comando são primeiro convertidos em caminhos absolutos
se necessário. Eles são então comparados com o caminho da linha de base, o diretório de desenvolvimento
caminho e o caminho do diretório de integração, para determinar um nome relativo à linha de base. Isto é
um erro se o arquivo nomeado estiver fora de uma dessas árvores de diretório.

A -BAse_RElativo opção pode ser usada para fazer com que os nomes de arquivos relativos sejam interpretados como
em relação ao caminho da linha de base; nomes de arquivos absolutos ainda serão comparados com os vários
caminhos para determinar um nome relativo à linha de base.

A valor_do_arquivo_relativo no arquivo de configuração do usuário pode ser usado para modificar
este comportamento padrão. Ver Aeuconf(5) para mais informações.

Extração Lado Efeito
Este comando irá cancelar qualquer compilação ou registro de teste, porque adicionar um arquivo logicamente
os invalida.

Quando os arquivos de mudança são listados (Aegis -Lista Alterar_Arquivos -TERse) os arquivos removidos irão
não aparecem na lista concisa. Da mesma forma, quando os arquivos do projeto são listados com um
número de mudança explícito (Aegis -Lista Arquivos_do Projeto -TERse -Mudar N) nenhuma das mudanças
os arquivos, incluindo os arquivos removidos, não aparecerão na lista concisa. Estes dois
recursos são muito úteis ao chamar aegis de dentro de um DMT para gerar a lista de
Arquivos Fonte.

Mudar que o Formato of a Envie o
Se você quiser alterar o tipo de um arquivo (por exemplo, de um arquivo de teste para um de origem, ou vício
versa) você pode fazer isso como duas alterações, usando primeiro armar(1) em uma mudança e depois
utilização aenf(1) ou ente(1) em uma segunda mudança, ou você pode combinar as duas etapas no mesmo
mudança. Lembre-se de usar o armar - nada branco ou você obterá uma nova opção muito peculiar
modelo de arquivo.

Notificação
A remove_file_command no projeto configuração arquivo é executado, se definido. o projeto_arquivo_‐
comando também é executado, se definido e se houve uma integração recentemente. Ver
aepconf(5) para mais informações.

BRANCO

O Aegis fornece o que costuma ser chamado de "caminho de visão", que indica o desenvolvimento
ferramentas (compiladores, sistemas de construção, etc.) procure primeiro no diretório de desenvolvimento, depois em
a linha de base do ramo e assim por diante até a linha de base do tronco.

O problema com os caminhos de exibição é que, para remover arquivos, você precisa de algum tipo de
"whiteout" para dizer “pare de procurar, foi removido”.

Quando você usa o armar(1) ou aemv(1) comandos, isso significa "adicionar informações a esta mudança
que irá remover o arquivo da linha de base quando esta mudança for integrada ". Ou seja enquanto
a mudança está no ser desenvolvido estado, o arquivo é apenas "removido" no desenvolvimento
diretório - ainda está presente na linha de base e estará até que a mudança seja
integrado com sucesso.

Quando você usa o armar(1) ou aemv(1) comandos, o Aegis criará um arquivo de 1K para atuar como o
whiteout. Seu conteúdo é bastante feio, então se você compilar ou incluir o "removido"
arquivo acidentalmente, você obtém um erro fatal. Isso irá lembrá-lo de remover obsoletos
referências.

Quando a mudança está integrada, o arquivo removido é não copiado / vinculado da linha de base para
o diretório de integração, e é não copiado do diretório de desenvolvimento. Neste
tempo ele está fisicamente desaparecido (sem whiteout). Presume-se que por causa do erro
induzindo o branco todas as referências antigas foram encontradas e corrigidas enquanto a mudança estava no
ser desenvolvido Estado.

Envie o Manifestos
Ao gerar a lista de arquivos a serem compilados ou vinculados, é importante que o arquivo
manifesto ser gerado a partir de informações conhecidas pelo Aegis, ao invés do sistema de arquivos.
Isto é por várias razões:

(a) Aegis sabe exatamente quais arquivos (fonte) estão onde, enquanto todo o resto está
inferir o conhecimento do Aegis; e

(b) procurar no sistema de arquivos é difícil quando o caminho de visualização é maior que 2 diretórios
(e o método de ramificação do Aegis pode torná-lo arbitrariamente longo); e

(c) Os arquivos de whiteout, e qualquer coisa deixada "por aí", irão confundir qualquer método
que interroga o sistema de arquivos.

A maneira mais fácil de usar o conhecimento de arquivo do Aegis é com algo como um awk(1) roteiro
processamento das listas de arquivos Aegis. Por exemplo, você pode fazer isso com fazer(1) da seguinte forma:
# gerar o manifesto do arquivo
manifest.make.inc: manifest.make.awk
(aegis -l cf -ter; aegis -l pf -ter) | \
awk -f manifest.make.awk> manifest.make.inc
# agora inclui o manifesto do arquivo
inclua manifest.make.inc
Nota: isso seria ineficiente de você fazer uma vez por diretório, mas não há nada
impedindo você de escrever várias tarefas no manifesto.make.inc arquivo, tudo em um
passar.

É possível fazer a mesma coisa com o gerador de relatórios do Aegis (ver aer(1) para mais
informações), mas isso está mais envolvido do que o awk(1) script. No entanto, com o
informações "direto da boca do cavalo", por assim dizer, também podem ser muito mais inteligentes.

Este manifesto de arquivo se tornaria desatualizado sem um bloqueio ao arquivo Aegis
comandos de operações. Usando o comando-arquivo_projeto e change_file_command campos de
o projeto configuração arquivo (ver aepconf(5) para obter mais informações), você pode excluir este arquivo
em momentos estratégicos.
/ * executado quando o manifesto do arquivo de mudança é alterado * /
change_file_command = "rm -f manifest.make.inc";
/ * executado quando o manifesto do arquivo do projeto é alterado * /
project_file_command = "rm -f manifest.make.inc";
O novo manifesto do arquivo será, portanto, reconstruído durante o próximo aeb(1) comando.

Opções e Preferencias
Há um -Não-WhiteOut opção, que pode ser usada para suprimir arquivos em branco quando você usa
que o armar(1) e aemv(1) comandos. Há um correspondente -WhiteOut opção, que é
geralmente o padrão.

Há um preferência_branca campo no arquivo de preferências do usuário (ver Aeuconf(5) para
mais informações) se desejar definir esta opção de forma mais permanente.

Whiteout Envie o Modelos
A modelo_branco campo do projeto configuração arquivo pode ser usado para produzir linguagem
arquivos de erro específicos. Se nenhuma entrada de modelo de whiteout corresponder, um arquivo muito feio de 1 KB irá
ser produzido - deve induzir erros do compilador para praticamente qualquer linguagem.

Se você quiser uma mensagem de erro mais legível, entradas como
whiteout_template=
[
{
padrão = ["*. [ch]"];
body = "#error Este arquivo foi removido.";
}
];
pode ser muito eficaz (este exemplo assume gcc(1) está sendo usado).

Se é essencial que não arquivo whiteout seja produzido, digamos, para arquivos de origem C, você pode
use um modelo de whiteout, como
whiteout_template=
[
{padrão = ["* .c"]; }
];
porque um ausente corpo subcampo significa não gerar nenhum arquivo whiteout.

Você pode ter mais de uma entrada de modelo de whiteout, mas observe que a ordem do
entradas são importantes. A primeira entrada que corresponder será usada.

Envie o Açao Social Ajustamento
Quando esse comando é executado, ele primeiro verifica os arquivos de mudança em relação aos arquivos de projetos. Se
existem inconsistências, as ações do arquivo serão ajustadas da seguinte forma:

criar Se um arquivo está sendo criado, mas outro conjunto de mudanças está integrado, o qual também
cria o arquivo, a ação do arquivo no conjunto de mudanças ainda em desenvolvimento será
ajustado para "modificar".

modificar Se um arquivo está sendo modificado, mas outro conjunto de mudanças é integrado e remove
o arquivo, a ação do arquivo no conjunto de mudanças ainda em desenvolvimento será
ajustado para "criar".

remove Se um arquivo está sendo removido, mas outro conjunto de mudanças está integrado e remove
o arquivo, o arquivo será removido do conjunto de alterações ainda em desenvolvimento.

OPÇÕES

As seguintes opções são compreendidas:

-BAse_RElativo
Esta opção pode ser usada para fazer com que nomes de arquivos relativos sejam considerados relativos a
a base da árvore de origem. Ver Aeuconf(5) para o usuário correspondente
preferência.

-CUrrent_RElative
Esta opção pode ser usada para fazer com que nomes de arquivos relativos sejam considerados relativos a
o diretório atual. Normalmente, este é o padrão. Ver Aeuconf(5) para o
preferência do usuário correspondente.

-Mudar número
Esta opção pode ser usada para especificar uma mudança particular dentro de um projeto. Ver
Aegis(1) para uma descrição completa desta opção.

-Ajuda
Esta opção pode ser usada para obter mais informações sobre como usar o Aegis
.

-Lista
Esta opção pode ser usada para obter uma lista de assuntos adequados para este comando.
A lista pode ser mais geral do que o esperado.

-Not_Logging
Esta opção pode ser usada para desativar o registro automático de saída e erros para
um arquivo. Isso geralmente é útil quando vários comandos aegis são combinados em um shell
script.

-Projeto nome
Esta opção pode ser usada para selecionar o projeto de interesse. Quando não -Projeto
opção é especificada, o AEGIS_PROJECT variável de ambiente é consultada. Se
que não existe, o usuário $ HOME / .aegisrc arquivo é examinado para um padrão
campo do projeto (ver Aeuconf(5) para mais informações). Se isso não existe,
quando o usuário está trabalhando apenas nas mudanças dentro de um único projeto, o projeto
nome padrão para esse projeto. Caso contrário, é um erro.

-TERse
Esta opção pode ser usada para fazer com que as listagens produzam o mínimo de
em formação. Geralmente é útil para scripts de shell.

-Detalhado
Esta opção pode ser usada para fazer com que aegis produza mais saída. Por padrão égide
só produz saída em caso de erros. Quando usado com o -Lista escolha esta opção
faz com que os cabeçalhos das colunas sejam adicionados.

-Espere Esta opção pode ser usada para exigir que os comandos Aegis esperem pelos bloqueios de acesso, se
eles não podem ser obtidos imediatamente. Padrões para o usuário lock_wait_preference
se não for especificado, veja Aeuconf(5) para mais informações.

-Não_Espere
Esta opção pode ser usada para exigir que os comandos Aegis emitam um erro fatal se o acesso
os bloqueios não podem ser obtidos imediatamente. Padrões para o usuário
lock_wait_preference se não for especificado, veja Aeuconf(5) para mais informações.

-WhiteOut
Esta opção pode ser usada para solicitar que os arquivos excluídos sejam substituídos por um "branco"
arquivo no diretório de desenvolvimento. A ideia é que a compilação de tal arquivo irá
resultar em um erro fatal, para que todas as referências possam ser encontradas. Isto é
geralmente o padrão.

-No_WhiteOut
Esta opção pode ser usada para solicitar que nenhum arquivo "branco" seja colocado no
diretório de desenvolvimento.

Veja também Aegis(1) para opções comuns a todos os comandos aegis.

Todas as opções podem ser abreviadas; a abreviatura é documentada em letras maiúsculas,
todas as letras minúsculas e sublinhados (_) são opcionais. Você deve usar consecutivos
sequências de letras opcionais.

Todas as opções não diferenciam maiúsculas de minúsculas, você pode digitá-las em maiúsculas ou minúsculas ou um
combinação de ambos, o caso não é importante.

Por exemplo: os argumentos "-project," -PROJ "e" -p "são todos interpretados como significando o
-Projeto opção. O argumento "-prj" não será compreendido, pois consecutivo
caracteres opcionais não foram fornecidos.

As opções e outros argumentos da linha de comando podem ser misturados arbitrariamente na linha de comando,
após os seletores de função.

Os nomes de opção longos GNU são compreendidos. Uma vez que todos os nomes de opções para Aegis são longos,
isso significa ignorar o inicial extra '-'. O "--opção=valor"convenção também é
Entendido.

RECOMENDADO ALIAS

O alias recomendado para este comando é
csh% alias aerm 'aegis -rm \! * -v'
sh $ aerm () {aegis -rm "$ @" -v}

ERROS

É um erro se a mudança não estiver no ser desenvolvido Estado.
É um erro se a mudança não for atribuída ao usuário atual.
É um erro se o arquivo não existir na linha de base.
É um erro se o arquivo já faz parte da alteração.

SAIR STATUS

A Aegis o comando sairá com um status de 1 em qualquer erro. o Aegis comando vai apenas
saia com um status de 0 se não houver erros.

MEIO AMBIENTE VARIÁVEIS

See Aegis(1) para uma lista de variáveis ​​de ambiente que podem afetar este comando. Ver
aepconf(5) para o arquivo de configuração do projeto projeto_específico campo para saber como definir
variáveis ​​de ambiente para todos os comandos executados pelo Aegis.

Use aerm online usando serviços onworks.net