aenf - Online na nuvem

PROGRAMA:

NOME

aegis new file - adicionar novos arquivos a serem criados por uma mudança

SINOPSE

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

DESCRIÇÃO

A Aegis -Novo arquivo comando é usado para adicionar novos arquivos a uma mudança. Os arquivos nomeados irão
ser adicionado à lista de arquivos na alteração.

Para cada arquivo nomeado, um novo arquivo é criado no diretório de desenvolvimento, se não
já existe. Se o arquivo já existe, ele não será alterado.

Se você quiser que um novo arquivo de origem seja executável (scripts de shell, por exemplo), você
simplesmente use o normal chmod(1) comando. Se algum dos bits executáveis ​​do arquivo estiver definido em
aede(1) momento em que o arquivo é lembrado como executável e todos os bits de execução (menos o
umask do projeto) será definido por aecp(1) comandos.

Se você nomear um diretório na linha de comando, toda a árvore de diretório será pesquisada
para novos arquivos. (Nota: absolutamente tudo será adicionado, incluindo arquivos de ponto e
arquivos binários, então você precisará limpar qualquer lixo primeiro.) Arquivos abaixo deste nome
diretório que já está na mudança, ou no projeto, será ignorado. o
nome_do_arquivo_aceitar e nome_do_arquivo_rejeitar padrões no projeto aegis.conf arquivo também
ser aplicado, veja aepconf(5) para mais informações.

Diretório Exemplo
Há momentos em que um comando como
$ aenf danoso/*
aegis: projeto "exemplo": mudança 42: "fubar / glorp" já em mudança
aegis: projeto "exemplo": mudança 42: encontrado 1 erro fatal, nenhum novo arquivo adicionado
$
irá falhar conforme mostrado. Existem várias maneiras de lidar com isso, sendo a mais fácil
simplesmente nomeie o diretório:
$ aenf danoso
aegis: projeto "exemplo": mudança 42: arquivo "fubar / smiley" adicionado
aegis: projeto "exemplo": mudança 42: arquivo "fubar / frownie" adicionado
$
Você também pode usar o find(1) comando para seleção de arquivos arbitrariamente complexos, mas você
deve primeiro excluir os arquivos que o comando acima exclui automaticamente:
$ aelcf > excluir
$ aelpf >> excluir
$ find danoso -Tipo f | \
grep -v -f excluir | \
xargs Aegis --novo arquivo -v
aegis: projeto "exemplo": mudança 42: arquivo "fubar / smiley" adicionado
aegis: projeto "exemplo": mudança 42: arquivo "fubar / frownie" adicionado
$
Se você não estiver usando a lista de exclusão, o find(1) o comando precisará de um ajuste fino para o seu
estilo de diretório de desenvolvimento. Se você estiver usando o estilo de link simbólico, você precisará adicionar
que o find -nlink 1 opção além do find -Tipo f opção.
$ find danoso -Tipo f -nlinks 1 | \
xargs Aegis --novo arquivo -v
aegis: projeto "exemplo": mudança 42: arquivo "fubar / smiley" adicionado
aegis: projeto "exemplo": mudança 42: arquivo "fubar / frownie" adicionado
$
Se você estiver usando o estilo de diretório de desenvolvimento de cópia completa, você terá que usar o
método de lista de exclusão, acima.

Envie o Modelos
Quando um novo arquivo é criado no diretório de desenvolvimento, o projeto configuração arquivo é
procurou um modelo para o novo arquivo. Se um modelo for encontrado, o novo arquivo será
inicializado com o modelo, caso contrário, será criado vazio. Ver aepconf(5) para mais
informações.

A forma mais simples é usar arquivos de modelo, como
arquivo_template =
[
{
padrão = ["* .c"];
body = "$ {read_file $ {template / c abs}}";
},
{
padrão = ["teste / * /. sh"];
body = "$ {read_file $ {modelo de fonte / abs de teste}}";
},
];
Como você pode ver, os arquivos de modelo são parte da fonte do projeto, então você pode adicionar o
avisos de direitos autorais apropriados, e wrappers, etc.. O $ source a substituição os localiza,
se não fizerem parte da mudança atual (e geralmente não fazem).

Os próprios arquivos de modelo contêm substituições. o $ filename substituição é
disponível e contém o nome do arquivo que está sendo criado. Isso pode ser manipulado em
várias maneiras ao construir o conteúdo de arquivo apropriado. Ver aesub(5) para mais
informações sobre substituições.

Também é possível executar um comando para criar o novo arquivo. Você pode fazer isso em vez de
especificando uma string de corpo, veja:
arquivo_template =
[
{
padrão = ["*"];
body_command = "perl $ {template.pl abs} $ filename";
},
];
O comando é executado com um diretório atual definido no topo do diretório de desenvolvimento.
É um erro se o comando falhar ao criar o arquivo. Você pode misturar e combinar os dois
técnicas, corpo corda e comando_corpo, se você quiser.

Envie o Nome Limitações
Existem vários controles disponíveis para limitar a forma dos nomes dos arquivos de projeto. Tudo de
esses controles podem ser encontrados no arquivo de configuração do projeto, consulte aepconf(5) para mais
em formação. Os mais significativos são descritos resumidamente aqui:

comprimento_do_arquivo_máximo = inteiro;
Este campo é usado para limitar o comprimento dos nomes dos arquivos. Todos os novos arquivos podem não ter
componentes do caminho mais longos do que isso. O padrão é 255 se não for definido. Para o máximo
portabilidade você deve definir isso para 14.

posix_filename_charset = booleano;
Este campo pode ser usado para limitar os caracteres permitidos em nomes de arquivos apenas para aqueles
permitido explicitamente por POSIX. Padrões para falso se não for definido, o que significa qualquer que seja o seu
sistema operacional tolerará, exceto espaço em branco e caracteres high-bit-on.
Para máxima portabilidade, você deve definir isso para verdadeiro.

dos_filename_required = booleano;
Este campo pode ser usado para limitar os nomes dos arquivos para que estejam em conformidade com o DOS 8 + 3
limites de nome de arquivo e ao conjunto de caracteres de nome de arquivo DOS. Padrões para falso se não
definido.

windows_filename_required = booleano;
Este campo pode ser usado para limitar os nomes dos arquivos para que estejam em conformidade com o Windows 98
e limites de nome de arquivo e conjunto de caracteres do WindowsNT. Padrões para falso se não for definido.

shell_safe_filenames = booleano;
Este campo pode ser usado para limitar os nomes dos arquivos de forma que eles não contenham shell
caracteres especiais. Padrões para verdadeiro se não for definido. Se este campo for definido como falso,
você precisará usar o $ {quote} substituição em torno de nomes de arquivos em comandos, para
certifique-se de que os nomes dos arquivos contendo caracteres especiais do shell não tenham
efeitos colaterais. Caracteres estranhos em nomes de arquivos também podem confundir sua dependência
ferramenta de manutenção.

allow_white_space_in_filenames = booleano;
Este campo pode ser usado para permitir caracteres de espaço em branco em nomes de arquivo. Isso vai
permite que os seguintes caracteres apareçam nos nomes dos arquivos: backspace (BS, \ b, 0x08),
guia horizontal (HT, \ t, 0x09), nova linha (NL, \ n, 0x0A), guia vertical (VT, \ v,
0x0B), avanço de formulário (FF, \ f, 0x0C) e retorno de carro (CR, \ r, 0x0D). Padrões para
false se não for definido.

Observe que este campo não substitui outros filtros de nome de arquivo. Será
necessário definir explicitamente shell_safe_filenames = falso também. Será
necessário definir dos_filename_required = falso (o padrão) também. Será
necessário definir posix_filename_charset = falso (o padrão) também.

O usuário deve ter muito cuidado ao usar a substituição $ {quote} em todo o arquivo
nomes em comandos na configuração do projeto. E mesmo assim, as substituições
que esperam uma lista de nomes de arquivos separados por espaço, terão resultados indefinidos.

allow_non_ascii_filenames = booleano;
Este campo pode ser usado para permitir nomes de arquivo com caracteres não ascii imprimíveis em
eles. Normalmente, isso significaria um UTF8 ou conjunto de caracteres internacional de algum tipo.
O padrão é falso se não for definido.

Observe que este campo não substitui outros filtros de nome de arquivo. Será
necessário definir explicitamente shell_safe_filenames = falso também. Será
necessário definir dos_filename_required = falso (o padrão) também. Será
necessário definir posix_filename_charset = falso (o padrão) também.

filename_pattern_accept = [string];
Este campo é usado para especificar uma lista de padrões de nomes de arquivos aceitáveis.
O padrão é "*" se não for definido.

filename_pattern_reject = [string];
Este campo é usado para especificar uma lista de padrões de nomes de arquivos inaceitáveis.

. Observação: Aegis também consulta o sistema de arquivos subjacente, para determinar sua noção de
tamanho máximo do arquivo. Onde o tamanho máximo do arquivo do sistema é menor que
comprimento_máximo do nome_do_arquivo, o sistema de arquivos vence. Isso pode acontecer, por exemplo, quando você está
usando o sistema de arquivos UMSDOS do Linux ou quando você tem um NFS montado em um V7 antigo
sistema de arquivo. Configuração comprimento_máximo do nome_do_arquivo a 255, nesses casos, não altera o
fato de que os limites dos sistemas de arquivos subjacentes são muito menores (12 e 14, respectivamente).

Se seus diretórios de desenvolvimento (ou todo o seu projeto) estiverem em sistemas de arquivos com nome de arquivo
limitações, ou uma parte das construções heterogêneas ocorrem em tal ambiente,
ajuda a dizer ao Aegis o que eles são (usando o projeto configuração campos do arquivo) para que você
não corra para a situação em que o projeto baseia-se no mais permissivo
ambientes, mas falha com erros misteriosos nos ambientes mais limitados.

Se seus diretórios de desenvolvimento estiverem rotineiramente em um sistema de arquivos UMSDOS Linux, você deve
provavelmente seria melhor definir dos_filename_required = verdadeiro, e também mudando o
desenvolvimento_diretório_template campo. Desenvolvimento heterogêneo com várias janelas
ambientes também podem exigir isso.

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.

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.

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.

Notificação
A novo_arquivo_comando no arquivo de configuração do projeto é executado, se definido. o projeto_-
comando_arquivo também é executado, se definido e se houve uma integração recentemente. Ver
aepconf(5) para mais informações.

TESTE CORRELAÇÕES

O comando “aegis -Test -SUGgest” pode ser usado para que a égide sugira uma regressão adequada
testa sua alteração, com base nos arquivos de origem em sua alteração. Isso automaticamente
concentra o esforço de teste em testes relevantes, reduzindo o número de testes de regressão
necessário ter certeza de que você não introduziu um bug.

As correlações de teste são geradas pelo comando “aegis -Integrate_Pass”, que
associa cada teste na mudança a cada arquivo de origem na mudança. Assim, cada
o arquivo de origem acumula uma lista de testes que foram associados a ele no passado.
Isso não é tão exato quanto a análise de cobertura de código, mas é uma aproximação razoável em
prática.

A aecp(1) e aenf(1) comandos são usados ​​para associar arquivos a uma mudança. Enquanto eles
não realizam ativamente a associação, estes são os arquivos usados ​​por aeipass(1) e
aet(1) para determinar quais arquivos de origem estão associados a quais testes.

Test Correlação Precisão
Supondo que as correlações de teste sejam precisas e que os testes sejam uniformemente
distribuído por todo o espaço de função, haverá menos de 1 / número chance de que um
o teste relevante não foi executado pelo “aegis -Test -SUGgest número”Comando. Um pequeno
quantidade de ruído é adicionada à ponderação de teste, de modo que coisas inesperadas às vezes são
testado e os mesmos testes não são executados todas as vezes.

A precisão da correlação de teste pode ser melhorada garantindo que:

· Cada mudança deve ser fortemente focada, sem inclusões gratuitas de arquivos. Esse
evita correlações espúrias.

· Cada item de nova funcionalidade deve ser adicionado em uma mudança individual, ao invés de
vários juntos. Isso correlaciona fortemente os testes com a funcionalidade.

· Cada bug deve ser corrigido em uma mudança individual, ao invés de várias juntas. Esse
correlaciona fortemente os testes com a funcionalidade.

· As correlações de teste serão perdidas se os arquivos forem movidos. Isso ocorre porque as correlações são por
nome.

A melhor maneira para os testes se correlacionarem com precisão com os arquivos de origem é quando uma mudança
contém um teste e exatamente os arquivos relacionados à funcionalidade em teste. Também
muitos arquivos espúrios enfraquecerão a utilidade das correlações de teste.

OPÇÕES

As seguintes opções são compreendidas

-Construir
Esta opção pode ser usada para especificar que o arquivo é construído durante uma construção
(geralmente apenas uma compilação integrada), de modo que o histórico dela possa ser mantido. Isto é
útil para gerar arquivos de patch, onde um histórico de arquivos gerados é
importante. Os arquivos criados desta forma não podem ser copiados para uma mudança, embora
eles podem ser excluídos. Evite usar arquivos desse tipo, se possível.

-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.

-CONFIGURADO
Esta opção pode ser usada para especificar que o arquivo é um projeto Aegis
arquivo de configuração. O arquivo de configuração padrão do projeto é chamado aegis.conf,
entretanto, qualquer nome de arquivo pode ser usado. Você também pode usar mais de um arquivo,
dividir o conteúdo em vários arquivos, todos os quais devem ser desse tipo.

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

-Guarda
Esta opção pode ser usada para reter arquivos e / ou diretórios geralmente excluídos ou
substituído pelo comando. Padrões para o usuário delete_file_preference se não
especificado, veja Aeuconf(5) para mais informações.

-Não_Manter
Esta opção pode ser usada para garantir que os arquivos e / ou diretórios sejam excluídos
ou substituído pelo comando. Padrões para o usuário delete_file_preference se não
especificado, veja Aeuconf(5) para mais informações.

-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.

-Modelo
Esta opção pode ser usada para especificar que um novo modelo de arquivo deve ser usado, mesmo
se o arquivo já existe.

-No_TEMplaca
Esta opção pode ser usada para especificar que um novo modelo de arquivo não deve ser usado,
mesmo se o arquivo não existir (qualquer arquivo vazio será criado).

-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.

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 aenf 'aegis -nf \! * -v'
sh $ aenf () {aegis -nf "$ @" -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 já faz parte da alteração.
É um erro se o arquivo já faz parte da linha de base.
É um erro se os arquivos nomeados na linha de comando não forem arquivos normais e não
diretórios. (Se você precisar de links simbólicos ou arquivos especiais, crie-os no momento da compilaçã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 aenf online usando serviços onworks.net