aenf - Online nel cloud

PROGRAMMA:

NOME

aegis new file - aggiunge nuovi file da creare tramite una modifica

SINOSSI

egida -Nuovo file nome del file... [ opzione...]
egida -Nuovo file -Elenco [ opzione...]
egida -Nuovo file -Aiuto

DESCRIZIONE

I egida -Nuovo file il comando viene utilizzato per aggiungere nuovi file a una modifica. I file nominati lo faranno
essere aggiunto all'elenco dei file nella modifica.

Per ogni file nominato, se così non fosse, viene creato un nuovo file nella directory di sviluppo
esistono già. Se il file esiste già, non verrà modificato.

Se vuoi che un nuovo file sorgente sia eseguibile (script di shell, ad esempio), allora tu
usa semplicemente il normale chmod(1) comando. Se uno qualsiasi dei bit eseguibili del file è impostato su
aede(1) tempo in cui il file viene ricordato come eseguibile e tutti i bit di esecuzione (meno il
umask del progetto) verrà impostato dal successivo PCEA(1) comandi.

Se si nomina una directory sulla riga di comando, verrà cercata l'intera struttura delle directory
per i nuovi file. (Nota: verrà aggiunto assolutamente tutto, inclusi i file punto e
file binari, quindi dovrai prima ripulire tutta la spazzatura.) I file sotto questo nome
directory già presenti nella modifica o nel progetto verranno ignorate. IL
nome_file_accetta ed nome_file_rifiuta modelli nel progetto aegis.conf anche il file
essere applicato, vedi aepconf(5) per maggiori informazioni.

elenco Esempio
Ci sono momenti in cui un comando come
$ aenf fubar/*
aegis: progetto "esempio": modifica 42: "fubar/glorp" già in modifica
aegis: progetto "esempio": modifica 42: trovato 1 errore fatale, nessun nuovo file aggiunto
$
fallirà come mostrato. Esistono diversi modi per affrontare questo problema, il più semplice è quello
nomina semplicemente la directory:
$ aenf Fubar
egis: progetto "esempio": modifica 42: aggiunto il file "fubar/smiley".
aegis: progetto "esempio": modifica 42: aggiunto il file "fubar/frownie".
$
Puoi anche usare il Find(1) comando per la selezione di file arbitrariamente complessa, ma tu
deve prima escludere i file che il comando precedente esclude automaticamente:
$ aelcf > escludere
$ aelpf >> escludere
$ Find Fubar -Type f | \
grep -v -f escludere | \
xargs egida --nuovo file -v
egis: progetto "esempio": modifica 42: aggiunto il file "fubar/smiley".
aegis: progetto "esempio": modifica 42: aggiunto il file "fubar/frownie".
$
Se non stai utilizzando l'elenco di esclusione, il file Find(1) il comando richiederà una messa a punto per il tuo
stile della directory di sviluppo. Se stai utilizzando lo stile collegamento simbolico, dovrai aggiungere
, il Find -nlink 1 opzione in aggiunta a Find -Type f opzione.
$ Find Fubar -Type f -nlink 1 | \
xargs egida --nuovo file -v
egis: progetto "esempio": modifica 42: aggiunto il file "fubar/smiley".
aegis: progetto "esempio": modifica 42: aggiunto il file "fubar/frownie".
$
Se stai utilizzando lo stile di directory di sviluppo con copia completa, dovrai utilizzare il file
metodo dell'elenco di esclusioni, sopra.

Compila il Modelli
Quando viene creato un nuovo file nella directory di sviluppo, il progetto config il file è
cercato un modello per il nuovo file. Se viene trovato un modello, il nuovo file sarà
inizializzato al modello, altrimenti verrà creato vuoto. Vedere aepconf(5) per di più
informazioni.

La forma più semplice è utilizzare file modello, come
file_modello =
[
{
modello = [ "*.c" ];
body = "${read_file ${source template/c abs}}";
},
{
modello = ["prova/*/.sh"];
body = "${read_file ${modello di origine/test abs}}";
},
];
Come puoi vedere, i file modello fanno parte dell'origine del progetto, quindi puoi aggiungere il file
avvisi di copyright e wrapper appropriati, eccetera. $fonte la sostituzione li localizza,
se non fanno parte del cambiamento in corso (e di solito non lo sono).

I file modello stessi contengono sostituzioni. IL $nomefile la sostituzione è
disponibile e contiene il nome del file in fase di creazione. Questo può essere manipolato
vari modi durante la costruzione del contenuto del file appropriato. Vedere esub(5) per di più
informazioni sulle sostituzioni.

È anche possibile eseguire un comando per creare il nuovo file. Puoi farlo invece di
specificando una stringa del corpo, cioè:
file_modello =
[
{
modello = [ "*" ];
body_command = "perl ${source template.pl abs} $nomefile";
},
];
Il comando viene eseguito con la directory corrente impostata all'inizio della directory di sviluppo.
È un errore se il comando non riesce a creare il file. Puoi mescolare e abbinare i due
tecniche, stile di vita corda e comando_corpo, se vuoi.

Compila il Nome Limiti
Sono disponibili numerosi controlli per limitare la forma dei nomi dei file di progetto. Tutto di
questi controlli possono essere trovati nel file di configurazione del progetto, vedere aepconf(5) per di più
informazione. I più significativi vengono qui brevemente descritti:

lunghezza_nome_file_massima = intero;
Questo campo viene utilizzato per limitare la lunghezza dei nomi di file. Tutti i nuovi file potrebbero non avere
componenti del percorso più lunghi di questo. Il valore predefinito è 255 se non impostato. Per il massimo
portabilità dovresti impostarlo su 14.

posix_filename_charset = booleano;
Questo campo può essere utilizzato per limitare i caratteri consentiti nei nomi dei file solo a quelli
esplicitamente consentito da POSIX. Il valore predefinito è falso se non impostato, significa qualunque sia il tuo
il sistema operativo tollererà, ad eccezione degli spazi bianchi e dei caratteri ad alto bit-on.
Per la massima portabilità dovresti impostarlo su vero.

dos_filename_required = booleano;
Questo campo può essere utilizzato per limitare i nomi dei file in modo che siano conformi al DOS 8+3
limiti dei nomi file e al set di caratteri dei nomi file DOS. Il valore predefinito è falso altrimenti
impostato.

windows_filename_required = booleano;
Questo campo può essere utilizzato per limitare i nomi dei file in modo che siano conformi a Windows98
e limiti dei nomi file e set di caratteri di Windows NT. Il valore predefinito è falso se non impostato.

shell_safe_filenames = booleano;
Questo campo può essere utilizzato per limitare i nomi dei file in modo che non contengano shell
personaggi speciali. Il valore predefinito è vero se non impostato. Se questo campo è impostato su falso,
dovrai usare il ${quote} sostituzione attorno ai nomi dei file nei comandi, a
assicurarsi che i nomi dei file contenenti caratteri speciali della shell non abbiano caratteri indesiderati
effetti collaterali. Anche i caratteri strani nei nomi dei file possono confondere la tua dipendenza
strumento di manutenzione.

consent_white_space_in_filenames = booleano;
Questo campo può essere utilizzato per consentire caratteri di spazio bianco nei nomi dei file. Questo sarà
consentire la visualizzazione dei seguenti caratteri nei nomi dei file: backspace (BS, \b, 0x08),
tabulazione orizzontale (HT, \t, 0x09), nuova riga (NL, \n, 0x0A), tabulazione verticale (VT, \v,
0x0B), avanzamento modulo (FF, \f, 0x0C) e ritorno a capo (CR, \r, 0x0D). Il valore predefinito è
false se non impostato.

Tieni presente che questo campo non sovrascrive altri filtri dei nomi di file. Sarà
necessario impostare esplicitamente nomifile_shell_safe = falso anche. Sarà
necessario impostare dos_nomefile_richiesto = falso (l'impostazione predefinita). Sarà
necessario impostare posix_filename_charset = falso (l'impostazione predefinita).

L'utente deve fare molta attenzione a utilizzare la sostituzione ${quote} attorno a tutti i file
nomi nei comandi nella configurazione del progetto. E anche allora, sostituzioni
che prevedono un elenco di nomi di file separati da spazi avranno risultati non definiti.

consentire_non_ascii_filenames = booleano;
Questo campo può essere utilizzato per consentire nomi di file con caratteri non stampabili ASCII
loro. Di solito questo significherebbe un UTF8 o un set di caratteri internazionale di qualche tipo.
Il valore predefinito è false se non impostato.

Tieni presente che questo campo non sovrascrive altri filtri dei nomi di file. Sarà
necessario impostare esplicitamente nomifile_shell_safe = falso anche. Sarà
necessario impostare dos_nomefile_richiesto = falso (l'impostazione predefinita). Sarà
necessario impostare posix_filename_charset = falso (l'impostazione predefinita).

nomefile_modello_accetta = [stringa];
Questo campo viene utilizzato per specificare un elenco di modelli di nomi di file accettabili.
Il valore predefinito è "*" se non impostato.

nomefile_modello_rifiuta = [stringa];
Questo campo viene utilizzato per specificare un elenco di modelli di nomi di file non accettabili.

Per favore, Nota: Aegis consulta anche il file system sottostante, per determinare la sua nozione di
dimensione massima del file. Dove la dimensione massima del file del file system è inferiore a
lunghezza_massima_nome_file, vince il filesystem. Questo può succedere, ad esempio, quando sei
usando il file system Linux UMSDOS, o quando hai un NFS montato un vecchio V7
file system. Collocamento lunghezza_massima_nome_file a 255 in questi casi non altera il
fatto che i limiti dei file system sottostanti sono molto più piccoli (rispettivamente 12 e 14).

Se le tue directory di sviluppo (o l'intero progetto) sono su filesystem con nome file
limitazioni, o una parte delle costruzioni eterogenee ha luogo in un tale ambiente,
aiuta a dire ad Aegis cosa sono (usando il progetto config campi del file) in modo che tu
non incorrere nella situazione in cui il progetto si basa sul più permissivo
ambienti, ma fallisce con misteriosi errori negli ambienti più limitati.

Se le tue directory di sviluppo si trovano regolarmente su un filesystem Linux UMSDOS, dovresti
probabilmente sarebbe meglio impostare dos_nomefile_richiesto = vero, e anche cambiando il
sviluppo_directory_template campo. Sviluppo eterogeneo con varie finestre
anche gli ambienti possono richiederlo.

Compila il Nome Interpretazione
Il programma aegis tenterà di determinare i nomi dei file di progetto dai nomi dei file
dato sulla riga di comando. Tutti i nomi dei file sono memorizzati all'interno dei progetti aegis come relativi
alla radice dell'albero di directory di base. La directory di sviluppo e il
directory di integrazione sono ombre di questa directory di base, e quindi questi nomi relativi
applica anche qui. I file nominati sulla riga di comando vengono prima convertiti in percorsi assoluti
se necessario. Vengono quindi confrontati con il percorso di base, la directory di sviluppo
percorso e il percorso della directory di integrazione per determinare un nome relativo alla linea di base. è
un errore se il file denominato è al di fuori di uno di questi alberi di directory.

I -BASE_RElativo l'opzione può essere usata per far interpretare i nomi di file relativi come
rispetto al percorso della linea di base; i nomi di file assoluti verranno comunque confrontati con i vari
percorsi per determinare un nome relativo alla linea di base.

I relativo_nome_file_preferenza nel file di configurazione utente può essere utilizzato per modificare
questo comportamento predefinito. Vedere aeuconf(5) per maggiori informazioni.

Cambiare , il Tipologia of a Compila il
Se vuoi cambiare il tipo di un file (diciamo, da un file di prova a un file sorgente, o vice
versa) potresti farlo come due modifiche, usando prima aerma(1) in un cambio e poi
utilizzando aenf(1) o aent(1) in una seconda modifica, oppure puoi combinare entrambi i passaggi nello stesso
modificare. Ricordati di usare il aerma -nessun bianco opzione o otterrai una novità molto particolare
modello di file.

Compila il Action Adattamento
Quando questo comando viene eseguito, verifica prima i file di modifica rispetto ai file di progetto. Se
ci sono incongruenze, le azioni del file verranno regolate come segue:

create Se si sta creando un file, ma è integrato un altro insieme di modifiche che anche
crea il file, l'azione del file nel set di modifiche ancora in fase di sviluppo sarà
regolato su "modifica".

modificare Se un file viene modificato, ma è integrato un altro insieme di modifiche che rimuove
il file, l'azione del file nella serie di modifiche ancora in fase di sviluppo sarà
regolato su "creare".

rimuovere Se un file viene rimosso, ma è integrato un altro insieme di modifiche che rimuove
il file, il file verrà eliminato dalla serie di modifiche ancora in fase di sviluppo.

Notifica
I nuovo_file_comando nel file di configurazione del progetto viene eseguito, se impostato. IL progetto_-
file_comando viene eseguito anche, se impostato, e se c'è stata un'integrazione di recente. Vedere
aepconf(5) per maggiori informazioni.

TEST CORRELAZIONI

Il comando "aegis -Test -SUGgest" può essere usato per fare in modo che aegis suggerisca una regressione adeguata
verifica la tua modifica, in base ai file di origine nella tua modifica. Questo automaticamente
concentra lo sforzo di test sui test pertinenti, riducendo il numero di test di regressione
necessario essere sicuri di non aver introdotto un bug.

Le correlazioni di test sono generate dal comando “aegis -Integrate_Pass”, che
associa ogni test nella modifica a ogni file sorgente nella modifica. Così, ogni
file sorgente accumula un elenco di test che sono stati associati in passato.
Questo non è esatto come l'analisi della copertura del codice, ma è un'approssimazione ragionevole in
pratica.

I PCEA(1) e aenf(1) i comandi vengono utilizzati per associare i file a una modifica. Mentre loro
non eseguire attivamente l'associazione, questi sono i file utilizzati da aeipass(1) e
e(1) per determinare quali file di origine sono associati a quali test.

Test Correlazione Precisione
Supponendo che le correlazioni dei test siano accurate e che i test siano uniformi
distribuito nello spazio delle funzioni, ci sarà meno di 1/numero possibilità che a
relativo test non è stato eseguito da “aegis -Test -SUGgest numerocomando. Un piccolo
la quantità di rumore viene aggiunta alla ponderazione del test, in modo che a volte si verifichino cose inaspettate
testato e gli stessi test non vengono eseguiti ogni volta.

L'accuratezza della correlazione del test può essere migliorata assicurando che:

· Ogni modifica dovrebbe essere fortemente focalizzata, senza inclusioni di file gratuite. Questo
evita correlazioni spurie.

· Ogni elemento di nuova funzionalità dovrebbe essere aggiunto in un singolo cambiamento, piuttosto che
diversi insieme. Questo correla fortemente i test con la funzionalità.

· Ogni bug dovrebbe essere corretto in un singolo cambiamento, piuttosto che diversi insieme. Questo
correla fortemente i test con la funzionalità.

· Le correlazioni di prova andranno perse se i file vengono spostati. Questo perché le correlazioni sono di
nome.

Il modo migliore per correlare accuratamente i test con i file di origine è quando un cambiamento
contiene un test ed esattamente quei file relativi alla funzionalità in prova. Pure
molti file spuri indeboliranno l'utilità delle correlazioni di test.

VERSIONI

Le seguenti opzioni sono comprese

-Costruire
Questa opzione può essere utilizzata per specificare che il file viene costruito durante una compilazione
(spesso solo una build integrata), in modo che la sua cronologia possa essere conservata. Questo è
utile per generare file patch, dove si trova una cronologia dei file generati
importante. Tuttavia, i file creati in questo modo non possono essere copiati in una modifica
potrebbero essere cancellati. Evita di utilizzare file di questo tipo, se possibile.

-BASE_RElativo
Questa opzione può essere usata per far sì che i nomi di file relativi siano considerati relativi a
la base dell'albero di origine. Vedere aeuconf(5) per l'utente corrispondente
preferenza.

-COrrent_RElativo
Questa opzione può essere usata per far sì che i nomi di file relativi siano considerati relativi a
la directory corrente. Di solito è l'impostazione predefinita. Vedere aeuconf(5) per la
corrispondente preferenza dell'utente.

-Modificare numero
Questa opzione può essere utilizzata per specificare una particolare modifica all'interno di un progetto. Vedere
egida(1) per una descrizione completa di questa opzione.

-CONFIGURATO
Questa opzione può essere utilizzata per specificare che il file è un progetto Aegis
file di configurazione. Viene richiamato il file di configurazione del progetto predefinito aegis.conf,
tuttavia è possibile utilizzare qualsiasi nome di file. Puoi anche utilizzare più di un file,
suddividere il contenuto su più file, che devono essere tutti di questo tipo.

-Aiuto
Questa opzione può essere utilizzata per ottenere maggiori informazioni su come utilizzare il egida
.

-Mantenere
Questa opzione può essere utilizzata per conservare file e/o directory solitamente eliminati o
sostituito dal comando. Default a quello dell'utente elimina_preferenza_file altrimenti
specificato, vedi aeuconf(5) per maggiori informazioni.

-No_Mantieni
Questa opzione può essere utilizzata per garantire che i file e/o le directory vengano eliminati
o sostituito dal comando. Default a quello dell'utente elimina_preferenza_file altrimenti
specificato, vedi aeuconf(5) per maggiori informazioni.

-Elenco
Questa opzione può essere utilizzata per ottenere un elenco di soggetti idonei per questo comando.
L'elenco potrebbe essere più generale del previsto.

-Non_registrazione
Questa opzione può essere utilizzata per disabilitare la registrazione automatica dell'output e degli errori per
un file. Questo è spesso utile quando diversi comandi di aegis sono combinati in una shell
script.

-Progetto Nome
Questa opzione può essere utilizzata per selezionare il progetto di interesse. quando no -Progetto
l'opzione è specificata, il AEGIS_PROGETTO viene consultata la variabile di ambiente. Se
che non esiste, l'utente $HOME/.aegisrc il file viene esaminato per un valore predefinito
campo del progetto (vedi aeuconf(5) per maggiori informazioni). Se ciò non esiste,
quando l'utente sta lavorando solo sulle modifiche all'interno di un singolo progetto, il progetto
nome predefinito su quel progetto. Altrimenti è un errore.

-Modello
Questa opzione può essere utilizzata anche per specificare che deve essere utilizzato un nuovo modello di file
se il file esiste già.

-No_TEMPlate
Questa opzione può essere utilizzata per specificare che non deve essere utilizzato un nuovo modello di file,
anche se il file non esiste (verrà creato l'eventuale file vuoto).

-TERse
Questa opzione può essere utilizzata per far sì che le inserzioni producano il minimo indispensabile di
informazione. Di solito è utile per gli script di shell.

-Verboso
Questa opzione può essere utilizzata per far sì che aegis produca più output. Per impostazione predefinita egida
produce solo output sugli errori. Se utilizzato con il -Elenco opzione questa opzione
causa l'aggiunta di intestazioni di colonna.

-Aspettare Questa opzione può essere utilizzata per richiedere ai comandi Aegis di attendere i blocchi di accesso, se
non possono essere ottenuti immediatamente. Impostazioni predefinite per l'utente lock_wait_preference
se non specificato, vedi aeuconf(5) per maggiori informazioni.

-Non aspettare
Questa opzione può essere utilizzata per richiedere ai comandi Aegis di emettere un errore fatale se access
i blocchi non possono essere ottenuti immediatamente. Impostazioni predefinite per l'utente
lock_wait_preference se non specificato, vedi aeuconf(5) per maggiori informazioni.

Vedi anche egida(1) per le opzioni comuni a tutti i comandi aegis.

Tutte le opzioni possono essere abbreviate; l'abbreviazione è documentata come le lettere maiuscole,
tutte le lettere minuscole ei caratteri di sottolineatura (_) sono facoltativi. Devi usare consecutivo
sequenze di lettere facoltative.

Tutte le opzioni non fanno distinzione tra maiuscole e minuscole, puoi digitarle in maiuscolo o minuscolo o a
combinazione di entrambi, il caso non è importante.

Ad esempio: gli argomenti "-project, "-PROJ" e "-p" sono tutti interpretati come il
-Progetto opzione. L'argomento "-prj" non sarà compreso, perché consecutivo
caratteri facoltativi non sono stati forniti.

Opzioni e altri argomenti della riga di comando possono essere mescolati arbitrariamente sulla riga di comando,
dopo i selettori di funzione.

I nomi lunghi delle opzioni GNU sono compresi. Poiché tutti i nomi delle opzioni per egida sono lunghi,
questo significa ignorare l'extra '-'. Il "--opzione=APPREZZIAMO"convenzione è anche
inteso.

CONSIGLIATO ALIAS

L'alias consigliato per questo comando è
csh% alias aenf 'aegis -nf \!* -v'
sh$ aenf(){aegis -nf "$@" -v}

ERRORI

È un errore se la modifica non è nel essendo sviluppato stato.
È un errore se la modifica non è assegnata all'utente corrente.
È un errore se il file fa già parte della modifica.
È un errore se il file fa già parte della baseline.
È un errore se i file nominati sulla riga di comando non sono file normali e non
directory. (Se hai bisogno di collegamenti simbolici o file speciali, creali in fase di compilazione.)

EXIT STATUS

I egida il comando uscirà con uno stato di 1 su qualsiasi errore. Il egida il comando sarà solo
esci con stato 0 se non ci sono errori.

AMBIENTE VARIABILI

See egida(1) per un elenco di variabili d'ambiente che possono influenzare questo comando. Vedere
aepconf(5) per i file di configurazione del progetto specifico del progetto campo per come impostare
variabili d'ambiente per tutti i comandi eseguiti da Aegis.

Utilizza aenf online utilizzando i servizi onworks.net