aenf - Online în cloud

PROGRAM:

NUME

aegis new file - adăugați fișiere noi care urmează să fie create printr-o modificare

REZUMAT

egidă -Fișier_nou nume de fișier... [ opțiune... ]
egidă -Fișier_nou -Listă [ opțiune... ]
egidă -Fișier_nou -Ajutor

DESCRIERE

egidă -Fișier_nou comanda este folosită pentru a adăuga fișiere noi la o modificare. Fișierele numite vor
să fie adăugat la lista de fișiere din modificare.

Pentru fiecare fișier numit, se creează un fișier nou în directorul de dezvoltare, dacă nu
exista deja. Dacă fișierul există deja, acesta nu va fi modificat.

Dacă doriți ca un nou fișier sursă să fie executabil (scripturi shell, de exemplu), atunci dvs
pur și simplu folosește normalul chmod(1) comanda. Dacă oricare dintre biții executabili ai fișierului este setat la
aede(1) momentul în care fișierul este memorat ca executabil și toți biții de execuție (minus
umask-ul proiectului) va fi setat de ulterior aecp(1) comenzi.

Dacă denumiți un director pe linia de comandă, va fi căutat întregul arbore de directoare
pentru fișiere noi. (Notă: absolut totul va fi adăugat, inclusiv fișierele cu puncte și
fișiere binare, deci va trebui să curățați mai întâi orice nedorit.) Fișierele de mai jos sunt numite
directorul care se află deja în modificare sau în proiect, va fi ignorat. The
nume_fișier_accept și nume_fișier_reject modele din proiect aegis.conf dosarul va de asemenea
fi aplicat, vezi aepconf(5) pentru mai multe informații.

director Exemplu
Există momente în care o comandă precum
$ aenf fubar/*
aegis: proiect „exemplu”: modificare 42: „fubar/glorp” deja în schimbare
aegis: proiect „exemplu”: modificare 42: găsită 1 eroare fatală, nu s-au adăugat fișiere noi
$
va eșua așa cum se arată. Există mai multe moduri de a face față acestui lucru, cea mai ușoară fiind
pur și simplu numiți directorul:
$ aenf fubar
aegis: proiect „exemplu”: modificare 42: fișier „fubar/smiley” adăugat
aegis: proiect „exemplu”: modificare 42: fișier „fubar/frrownie” adăugat
$
Ați putea folosi și găsi(1) comandă pentru selecția unui fișier arbitrar complex, dar tu
trebuie mai întâi să excludă fișierele pe care comanda de mai sus le exclude automat:
$ aelcf > exclude
$ aelpf >> exclude
$ găsi fubar -Tip f | \
grep -v -f exclude | \
xargs egidă --new-file -v
aegis: proiect „exemplu”: modificare 42: fișier „fubar/smiley” adăugat
aegis: proiect „exemplu”: modificare 42: fișier „fubar/frrownie” adăugat
$
Dacă nu utilizați lista de excluderi, găsi(1) comanda va avea nevoie de reglaj fin pentru dvs
stilul directorului de dezvoltare. Dacă utilizați stilul de link simbolic, va trebui să adăugați
il găsi -nlink 1 opțiune în plus față de găsi -Tip f opțiune.
$ găsi fubar -Tip f -nlinkuri 1 | \
xargs egidă --new-file -v
aegis: proiect „exemplu”: modificare 42: fișier „fubar/smiley” adăugat
aegis: proiect „exemplu”: modificare 42: fișier „fubar/frrownie” adăugat
$
Dacă utilizați stilul directorului de dezvoltare cu copie completă, va trebui să utilizați
metoda de excludere a listei, mai sus.

Fișier Șabloane
Când un fișier nou este creat în directorul de dezvoltare proiectul config fișierul este
a căutat un șablon pentru noul fișier. Dacă se găsește un șablon, noul fișier va fi
initializat la șablon, altfel va fi creat gol. Vedea aepconf(5) pentru mai mult
informaţii.

Cea mai simplă formă este utilizarea fișierelor șablon, cum ar fi
șablon_fișier =
[
{
model = [ "*.c" ];
body = "${read_file ${source template/c abs}}";
},
{
model = [ "test/*/.sh" ];
body = "${read_file ${sursă șablon/test abs}}";
},
];
După cum puteți vedea, fișierele șablon fac parte din sursa proiectului, așa că puteți adăuga
notificări corespunzătoare privind drepturile de autor și învelișuri, etc. $sursa înlocuirea le localizează,
dacă nu fac parte din schimbarea curentă (și de obicei nu sunt).

Fișierele șablon în sine conțin substituții. The $nume fișier substituirea este
disponibil și conține numele fișierului creat. Acest lucru poate fi manipulat în
diferite moduri la construirea conținutului fișierului corespunzător. Vedea aesub(5) pentru mai mult
informații despre substituții.

De asemenea, este posibil să rulați o comandă pentru a crea noul fișier. Puteți face asta în loc de
specificarea unui șir de corp, și anume:
șablon_fișier =
[
{
model = [ "*" ];
body_command = "perl ${source template.pl abs} $filename";
},
];
Comanda este rulată cu un director curent setat în partea de sus a directorului de dezvoltare.
Este o eroare dacă comanda nu reușește să creeze fișierul. Puteți combina și potrivi cele două
tehnici, corp șir și comandă_corp, daca vrei.

Fișier Nume si Prenume Limitări
Există o serie de controale disponibile pentru a limita forma numelor fișierelor de proiect. Toate
aceste controale pot fi găsite în fișierul de configurare a proiectului, vezi aepconf(5) pentru mai mult
informație. Cele mai semnificative sunt descrise pe scurt aici:

lungime_nume_fișier_maximum = întreg;
Acest câmp este folosit pentru a limita lungimea numelor de fișiere. Este posibil ca toate fișierele noi să nu aibă
componentele căii mai lungi decât aceasta. Valoarea implicită la 255 dacă nu este setată. Pentru maxim
portabilitate ar trebui să setați acest lucru la 14.

posix_filename_charset = boolean;
Acest câmp poate fi folosit pentru a limita caracterele permise în numele fișierelor doar la acestea
permis în mod explicit de POSIX. Implicit la fals dacă nu este setat, adică orice ai
sistemul de operare va tolera, cu excepția spațiilor albe și a caracterelor cu conținut ridicat de biți.
Pentru o portabilitate maximă, ar trebui să setați acest lucru la adevărat.

dos_filename_required = boolean;
Acest câmp poate fi folosit pentru a limita numele fișierelor astfel încât să se conformeze cu DOS 8+3
limitele numelui de fișier și la setul de caractere pentru numele fișierului DOS. Implicit la fals dacă nu
set.

windows_filename_required = boolean;
Acest câmp poate fi folosit pentru a limita numele fișierelor astfel încât să fie conforme cu Windows98
și limitele de nume de fișiere și setul de caractere WindowsNT. Implicit la fals dacă nu se setează.

shell_safe_filenames = boolean;
Acest câmp poate fi folosit pentru a limita numele fișierelor, astfel încât acestea să nu conțină shell
caractere speciale. Implicit la adevărat dacă nu se setează. Dacă acest câmp este setat la fals,
va trebui să utilizați ${quote} înlocuire în jurul numelor de fișiere în comenzi, la
asigurați-vă că numele fișierelor care conțin caractere speciale shell nu au neintenționate
efecte secundare. Caracterele ciudate din numele fișierelor vă pot încurca și dependența
instrument de întreținere.

allow_white_space_in_filenames = boolean;
Acest câmp poate fi folosit pentru a permite caractere cu spații albe în numele fișierelor. Asta va
permiteți următoarele caractere să apară în numele fișierelor: backspace (BS, \b, 0x08),
filă orizontală (HT, \t, 0x09), linie nouă (NL, \n, 0x0A), filă verticală (VT, \v,
0x0B), avans de formular (FF, \f, 0x0C) și întoarcere carucior (CR, \r, 0x0D). Implicit la
fals dacă nu este setat.

Rețineți că acest câmp nu înlocuiește alte filtre de nume de fișier. Va fi
necesar să se stabilească în mod explicit shell_safe_filenames = fals de asemenea. Va fi
necesar pentru a seta dos_filename_required = fals (implicit) de asemenea. Va fi
necesar pentru a seta posix_filename_charset = fals (implicit) de asemenea.

Utilizatorul trebuie să aibă mare grijă să folosească substituția ${quote} în jurul tuturor fișierelor
nume în comenzile din configurația proiectului. Și chiar și atunci, înlocuiri
care se așteaptă la o listă de nume de fișiere separate de spații vor avea rezultate nedefinite.

allow_non_ascii_filenames = boolean;
Acest câmp poate fi utilizat pentru a permite nume de fișiere cu caractere care nu pot fi tipărite prin ascii
lor. De obicei, aceasta ar însemna un UTF8 sau un set de caractere internațional de vreun fel.
Setarea implicită la false dacă nu este setată.

Rețineți că acest câmp nu înlocuiește alte filtre de nume de fișier. Va fi
necesar să se stabilească în mod explicit shell_safe_filenames = fals de asemenea. Va fi
necesar pentru a seta dos_filename_required = fals (implicit) de asemenea. Va fi
necesar pentru a seta posix_filename_charset = fals (implicit) de asemenea.

filename_pattern_accept = [ șir ];
Acest câmp este folosit pentru a specifica o listă de modele de nume de fișiere acceptabile.
Setarea implicită la „*” dacă nu este setat.

filename_pattern_reject = [ șir ];
Acest câmp este folosit pentru a specifica o listă de modele de nume de fișiere inacceptabile.

Te rugăm să ne contactezi Notă: Aegis consultă, de asemenea, sistemul de fișiere de bază, pentru a determina noțiunea de
dimensiunea maximă a fișierului. Unde dimensiunea maximă a fișierului a sistemului de fișiere este mai mică decât
lungime_nume_fișier_maximum, sistemul de fișiere câștigă. Acest lucru se poate întâmpla, de exemplu, când ești
folosind sistemul de fișiere Linux UMSDOS sau când aveți un NFS montat un V7 antic
Sistemul de fișiere. Setare lungime_nume_fișier_maximum la 255 în aceste cazuri nu modifică
faptul că limitele sistemelor de fișiere subiacente sunt mult mai mici (12 și, respectiv, 14).

Dacă directoarele de dezvoltare (sau întregul proiect) se află pe sisteme de fișiere cu nume de fișier
limitări sau o parte din construcțiile eterogene au loc într-un astfel de mediu,
vă ajută să spuneți lui Aegis ce sunt (folosind proiectul config câmpurile fișierului) astfel încât să vă
nu intri in situatia in care proiectul se bazeaza pe cei mai permisivi
medii, dar eșuează cu erori misterioase în mediile mai limitate.

Dacă directoarele dvs. de dezvoltare sunt în mod obișnuit pe un sistem de fișiere Linux UMSDOS, ați face-o
probabil ar fi mai bine setat dos_filename_required = adevărat, și, de asemenea, schimbarea
șablon_director_de_dezvoltare camp. Dezvoltare eterogenă cu diferite Windows
mediile pot necesita, de asemenea, acest lucru.

Fișier Nume si Prenume Interpretare
Programul Aegis va încerca să determine numele fișierelor de proiect din numele fișierelor
dat pe linia de comandă. Toate numele fișierelor sunt stocate în proiectele Aegis ca relative
la rădăcina arborelui de directoare de bază. Directorul de dezvoltare și
directorul de integrare sunt umbre ale acestui director de bază și astfel aceste nume relative
aplica si aici. Fișierele numite pe linia de comandă sunt mai întâi convertite în căi absolute
daca este necesar. Acestea sunt apoi comparate cu calea de bază, directorul de dezvoltare
cale și calea directorului de integrare, pentru a determina un nume relativ de referință. Este
o eroare dacă fișierul numit este în afara unuia dintre acești arbori de directoare.

-BAse_RElative opțiunea poate fi utilizată pentru a face ca numele de fișiere relative să fie interpretate ca
relativ la calea liniei de bază; nume de fișiere absolute vor fi în continuare comparate cu diferite
căi pentru a determina o denumire relativă de bază.

relative_filename_preference în fișierul de configurare utilizator poate fi utilizat pentru modificare
acest comportament implicit. Vedea aeuconf(5) pentru mai multe informații.

Schimbarea il Tip of a Fișier
Dacă doriți să schimbați tipul unui fișier (de exemplu, dintr-un fișier de test într-un fișier sursă sau viciu
versa) ați putea face acest lucru ca două modificări, utilizând mai întâi aerm(1) într-o singură schimbare și apoi
folosind aenf(1) sau aent(1) într-o a doua modificare sau puteți combina ambii pași în același timp
Schimbare. Amintiți-vă să utilizați aerm -nowhiteout opțiune sau veți primi o noutate foarte ciudată
șablon de fișier.

Fișier Acțiune Ajustare
Când rulează această comandă, mai întâi verifică fișierele de modificare cu fișierele proiectelor. Dacă
există inconsecvențe, acțiunile fișierului vor fi ajustate după cum urmează:

create Dacă se creează un fișier, dar este integrat un alt set de modificări care, de asemenea
creează fișierul, acțiunea fișierului din setul de modificări în curs de dezvoltare va fi
ajustat la „modificare”.

modifică Dacă un fișier este în curs de modificare, dar este integrat un alt set de modificări care elimină
fișierul, acțiunea fișierului din setul de modificări în curs de dezvoltare va fi
ajustat pentru a „crea”.

Eliminare Dacă un fișier este în curs de eliminare, dar este integrat un alt set de modificări care se elimină
fișierul, fișierul va fi eliminat din setul de modificări încă în curs de dezvoltare.

Notificare
comandă_fișier_nou în fișierul de configurare al proiectului este rulat, dacă este setat. The proiect_-
comandă_fișier este, de asemenea, rulat, dacă este setat și dacă a existat o integrare recent. Vedea
aepconf(5) pentru mai multe informații.

TEST CORELATII

Comanda „aegis -Test -SUGgest” poate fi folosită pentru ca aegis să sugereze o regresie adecvată
teste pentru modificarea dvs., pe baza fișierelor sursă din modificarea dvs. Aceasta automat
concentrează efortul de testare pe testele relevante, reducând numărul de teste de regresie
necesar să fii sigur că nu ai introdus un bug.

Corelațiile de testare sunt generate de comanda „aegis -Integrate_Pass”, care
asociază fiecare test din modificare cu fiecare fișier sursă din modificare. Astfel, fiecare
fișierul sursă acumulează o listă de teste care au fost asociate cu acesta în trecut.
Aceasta nu este la fel de exactă ca analiza acoperirii codului, dar este o aproximare rezonabilă în
practică.

aecp(1) și aenf(1) comenzile sunt folosite pentru a asocia fișiere cu o modificare. În timp ce ei
nu efectuați activ asocierea, acestea sunt fișierele folosite de aeipass(1) și
și(1) pentru a determina ce fișiere sursă sunt asociate cu ce teste.

Test Corelație Acuratete
Presupunând că corelațiile de testare sunt corecte și că testele sunt egale
distribuit în spațiul funcțional, va exista un mai puțin decât 1/număr sansa ca a
testul relevant nu a fost rulat de „aegis -Test -SUGgest număr” comanda. O mică
cantitatea de zgomot este adăugată la ponderarea testului, astfel încât să apară uneori lucruri neașteptate
testat, iar aceleași teste nu sunt executate de fiecare dată.

Precizia corelației testelor poate fi îmbunătățită asigurându-se că:

· Fiecare modificare ar trebui să fie puternic concentrată, fără includeri gratuite de fișiere. Acest
evită corelațiile false.

· Fiecare element de funcționalitate nouă ar trebui adăugat într-o modificare individuală, mai degrabă decât
mai multe împreună. Acest lucru corelează puternic testele cu funcționalitatea.

· Fiecare bug ar trebui remediat printr-o modificare individuală, mai degrabă decât mai multe împreună. Acest
corelează puternic testele cu funcționalitatea.

· Corelațiile de testare se vor pierde dacă fișierele sunt mutate. Acest lucru se datorează faptului că corelațiile sunt de
nume.

Cel mai bun mod pentru ca testele să se coreleze corect cu fișierele sursă este atunci când o schimbare
conține un test și exact acele fișiere referitoare la funcționalitatea testată. De asemenea
multe fișiere false vor slăbi utilitatea corelațiilor de testare.

OPŢIUNI

Următoarele opțiuni sunt înțelese

-Construi
Această opțiune poate fi folosită pentru a specifica faptul că fișierul este construit în timpul unei build
(de multe ori doar o construcție integrată), astfel încât istoria acesteia să poată fi păstrată. Aceasta este
util pentru generarea de fișiere de corecție, unde este un istoric al fișierelor generate
important. Totuși, fișierele create în acest fel nu pot fi copiate într-o modificare
pot fi șterse. Evitați utilizarea fișierelor de acest tip, dacă este posibil.

-BAse_RElative
Această opțiune poate fi folosită pentru a face ca numele de fișiere relative să fie considerate relativ la
baza arborelui sursă. Vedea aeuconf(5) pentru utilizatorul corespunzător
preferinţă.

-Current_RElative
Această opțiune poate fi folosită pentru a face ca numele de fișiere relative să fie considerate relativ la
directorul curent. Acesta este de obicei implicit. Vedea aeuconf(5) pentru
preferința corespunzătoare a utilizatorului.

-Schimbare număr
Această opțiune poate fi utilizată pentru a specifica o anumită modificare în cadrul unui proiect. Vedea
egidă(1) pentru o descriere completă a acestei opțiuni.

-CONFIGURAT
Această opțiune poate fi utilizată pentru a specifica faptul că fișierul este un proiect Aegis
Fișier de configurare. Fișierul implicit de configurare a proiectului este numit aegis.conf,
cu toate acestea, orice nume de fișier poate fi utilizat. De asemenea, puteți utiliza mai mult de un fișier,
împărțirea conținutului în mai multe fișiere, toate acestea trebuie să fie de acest tip.

-Ajutor
Această opțiune poate fi folosită pentru a obține mai multe informații despre cum să utilizați egidă
programul.

-A pastra
Această opțiune poate fi folosită pentru a păstra fișierele și/sau directoarele șterse de obicei sau
înlocuit cu comanda. Valori implicite ale utilizatorului delete_file_preference dacă nu
specificat, vezi aeuconf(5) pentru mai multe informații.

-Nu_ţine
Această opțiune poate fi utilizată pentru a vă asigura că fișierele și/sau directoarele sunt șterse
sau înlocuit cu comanda. Valori implicite ale utilizatorului delete_file_preference dacă nu
specificat, vezi aeuconf(5) pentru mai multe informații.

-Listă
Această opțiune poate fi folosită pentru a obține o listă de subiecte potrivite pentru această comandă.
Lista poate fi mai generală decât se aștepta.

-Nu_Logging
Această opțiune poate fi utilizată pentru a dezactiva înregistrarea automată a rezultatelor și a erorilor
un fișier. Acest lucru este adesea util atunci când mai multe comenzi Aegis sunt combinate într-un shell
script-ul.

-Proiect nume
Această opțiune poate fi utilizată pentru a selecta proiectul de interes. Când nu -Proiect
este specificată opțiunea AEGIS_PROJECT este consultată variabila de mediu. Dacă
care nu există, al utilizatorului $HOME/.aegisrc fișierul este examinat pentru o valoare implicită
domeniul proiectului (vezi aeuconf(5) pentru mai multe informații). Daca asta nu exista,
atunci când utilizatorul lucrează doar la modificări în cadrul unui singur proiect, proiectul
numele este implicit la acel proiect. Altfel, este o eroare.

-Placă TEMP
Această opțiune poate fi folosită pentru a specifica faptul că ar trebui să fie utilizat un șablon de fișier nou, chiar și
dacă fișierul există deja.

-Nu_Placă_TEMP
Această opțiune poate fi utilizată pentru a specifica că nu trebuie utilizat un nou șablon de fișier,
chiar dacă fișierul nu există (se va crea orice fișier gol).

-Concis
Această opțiune poate fi folosită pentru a determina ca listările să producă minimum
informație. Este de obicei util pentru scripturile shell.

- Verbos
Această opțiune poate fi folosită pentru a determina ca Aegis să producă mai multă ieșire. Implicit egida
produce numai rezultate pentru erori. Când este utilizat cu -Listă opțiunea acestei opțiuni
determină adăugarea titlurilor de coloană.

-Aștepta Această opțiune poate fi utilizată pentru a solicita comenzilor Aegis să aștepte blocarea accesului, dacă
nu pot fi obținute imediat. Valori implicite ale utilizatorului lock_wait_preference
dacă nu este specificat, vezi aeuconf(5) pentru mai multe informații.

-Nu așteptați
Această opțiune poate fi utilizată pentru a solicita comenzilor Aegis să emită o eroare fatală în cazul accesului
încuietori nu pot fi obținute imediat. Valori implicite ale utilizatorului
lock_wait_preference dacă nu este specificat, vezi aeuconf(5) pentru mai multe informații.

Vezi si egidă(1) pentru opțiunile comune tuturor comenzilor Aegis.

Toate opțiunile pot fi prescurtate; abrevierea este documentată ca litere mari,
toate literele mici și literele de subliniere (_) sunt opționale. Trebuie să utilizați consecutive
secvențe de litere opționale.

Toate opțiunile nu fac distincție între majuscule și minuscule, le puteți tasta cu litere mari sau mici sau a
combinația dintre ambele, cazul nu este important.

De exemplu: argumentele „-proiect, „-PROJ” și „-p” sunt toate interpretate ca însemnând
-Proiect opțiune. Argumentul „-prj” nu va fi înțeles, deoarece consecutiv
caracterele opționale nu au fost furnizate.

Opțiunile și alte argumente ale liniei de comandă pot fi amestecate în mod arbitrar pe linia de comandă,
după selectoarele de funcţii.

Numele lungi ale opțiunilor GNU sunt înțelese. Deoarece toate numele opțiunilor pentru egidă sunt lungi,
aceasta înseamnă ignorarea semnului „-” suplimentar. "--opțiune=valoare„Convenția este, de asemenea
înțeles.

RECOMANDAT ALIAS

Aliasul recomandat pentru această comandă este
csh% alias aenf 'aegis -nf \!* -v'
sh$ aenf(){aegis -nf "$@" -v}

ERORI

Este o eroare dacă modificarea nu este în fiind dezvoltat de stat.
Este o eroare dacă modificarea nu este atribuită utilizatorului curent.
Este o eroare dacă fișierul face deja parte din modificare.
Este o eroare dacă fișierul face deja parte din linia de bază.
Este o eroare dacă fișierele numite pe linia de comandă nu sunt fișiere normale și nu
directoare. (Dacă aveți nevoie de legături simbolice sau fișiere speciale, creați-le în timpul construirii.)

EXIT STAREA

egidă comanda va ieși cu starea 1 la orice eroare. The egidă comanda va numai
ieșiți cu starea 0 dacă nu există erori.

MEDIUL VARIABILE

Vedea egidă(1) pentru o listă de variabile de mediu care pot afecta această comandă. Vedea
aepconf(5) pentru fișierele de configurare a proiectului specific_proiectului câmp pentru modul de setare
variabile de mediu pentru toate comenzile executate de Aegis.

Utilizați aenf online folosind serviciile onworks.net