aenf - Online w chmurze

PROGRAM:

IMIĘ

aegis nowy plik - dodaj nowe pliki, które mają zostać utworzone przez zmianę

STRESZCZENIE

egida -Nowy plik Nazwa pliku... [ opcja...]
egida -Nowy plik -Lista [ opcja...]
egida -Nowy plik -Pomoc

OPIS

Połączenia egida -Nowy plik polecenie służy do dodawania nowych plików do zmiany. Nazwane pliki będą
zostać dodany do listy plików objętych zmianą.

Dla każdego nazwanego pliku tworzony jest nowy plik w katalogu programistycznym, jeśli tak nie jest
już istnieje. Jeśli plik już istnieje, nie zostanie zmieniony.

Jeśli chcesz, aby nowy plik źródłowy był wykonywalny (na przykład skrypty powłoki), to ty
po prostu użyj normalnego chmod(1) polecenie. Jeśli którykolwiek z bitów wykonywalnych pliku jest ustawiony na
aed(1) czas, w którym plik zostaje zapamiętany jako wykonywalny i wszystkie bity wykonania (minus
umask projektu) zostanie ustawiony przez next aekp(1) polecenia.

Jeśli w wierszu poleceń podasz nazwę katalogu, przeszukane zostanie całe drzewo katalogów
dla nowych plików. (Uwaga: dodane zostanie absolutnie wszystko, łącznie z plikami kropkowymi i
pliki binarne, więc najpierw musisz usunąć wszelkie śmieci.) Poniżej znajdują się pliki o nazwie
katalogi, które już znajdują się w zmianie lub w projekcie, zostaną zignorowane. The
nazwa_pliku_akceptacja i nazwa_pliku_odrzuć wzory w projekcie aegis.conf plik również będzie
zastosować, zob aepconf(5), aby uzyskać więcej informacji.

Informator Przykład
Są chwile, kiedy polecenie takie jak
$ aenf fubar/*
aegis: projekt „przykład”: zmiana 42: „fubar/glorp” już w zmianie
aegis: projekt „przykład”: zmiana 42: znaleziono 1 błąd krytyczny, nie dodano żadnych nowych plików
$
zakończy się niepowodzeniem, jak pokazano. Można sobie z tym poradzić na kilka sposobów, najłatwiejszy jest
po prostu nazwij katalog:
$ aenf fubar
aegis: projekt „przykład”: zmiana 42: dodano plik „fubar/smiley”.
aegis: projekt „przykład”: zmiana 42: dodano plik „fubar/frownie”.
$
Możesz także użyć odnaleźć(1) polecenie dowolnie złożonego wyboru pliku, ale ty
należy najpierw wykluczyć pliki, które powyższe polecenie wyklucza automatycznie:
$ aelcf > wykluczać
$ aelpf >> wykluczać
$ odnaleźć fubar -Type f | \
grep -v -f wykluczać | \
xargs egida --nowy plik -v
aegis: projekt „przykład”: zmiana 42: dodano plik „fubar/smiley”.
aegis: projekt „przykład”: zmiana 42: dodano plik „fubar/frownie”.
$
Jeśli nie używasz listy wykluczeń, plik odnaleźć(1) polecenie będzie wymagało dostrojenia twojego
styl katalogu programistycznego. Jeśli używasz stylu dowiązania symbolicznego, musisz dodać
dotychczasowy odnaleźć -nlink 1 opcja oprócz odnaleźć -Type f opcja.
$ odnaleźć fubar -Type f -n linki 1 | \
xargs egida --nowy plik -v
aegis: projekt „przykład”: zmiana 42: dodano plik „fubar/smiley”.
aegis: projekt „przykład”: zmiana 42: dodano plik „fubar/frownie”.
$
Jeśli używasz stylu katalogu programistycznego z pełną kopią, będziesz musiał użyć pliku
wyklucz metodę listy powyżej.

filet Szablony
Kiedy w katalogu deweloperskim tworzony jest nowy plik, plik projekt config plik jest
szukałem szablonu dla nowego pliku. Jeśli szablon zostanie znaleziony, nowy plik zostanie utworzony
zainicjowany do szablonu, w przeciwnym razie zostanie utworzony jako pusty. Widzieć aepconf(5) po więcej
informacje.

Najprostszą formą jest użycie plików szablonów, takich jak
szablon_pliku =
[
{
wzór = [ "*.c" ];
body = "${read_file ${szablon źródłowy/c abs}}";
},
{
wzór = [ "test/*/.sh" ];
body = "${read_file ${szablon źródłowy/test abs}}";
},
];
Jak widać, pliki szablonów są częścią źródła projektu, więc możesz dodać plik
odpowiednie informacje o prawach autorskich i opakowania, itp, $źródło podstawienie je lokalizuje,
jeśli nie są częścią bieżącej zmiany (a zwykle nie są).

Same pliki szablonów zawierają podstawienia. The $nazwa pliku zastępstwo jest
dostępny i zawiera nazwę tworzonego pliku. Można tym manipulować
różne sposoby podczas konstruowania odpowiedniej zawartości pliku. Widzieć esub(5) po więcej
informacja o zastępstwach.

Możliwe jest także wykonanie polecenia utworzenia nowego pliku. Możesz to zrobić zamiast
określenie ciągu treści, mianowicie:
szablon_pliku =
[
{
wzór = [ "*" ];
body_command = "perl ${source template.pl abs} $nazwa pliku";
},
];
Polecenie jest uruchamiane z bieżącym katalogiem ustawionym na górze katalogu programistycznego.
Jeśli polecenie nie utworzy pliku, wystąpi błąd. Możesz mieszać i dopasowywać te dwa elementy
techniki, ciało sznurek i ciało_komenda, Jeśli chcesz.

filet Imię Ograniczenia
Dostępnych jest wiele elementów sterujących ograniczających formę nazw plików projektów. Wszystkie z
te kontrolki można znaleźć w pliku konfiguracyjnym projektu, patrz aepconf(5) po więcej
Informacja. Najważniejsze z nich zostały pokrótce opisane tutaj:

maksymalna_nazwa_pliku_długość = liczba całkowita;
To pole służy do ograniczenia długości nazw plików. Wszystkie nowe pliki mogą nie mieć
komponenty ścieżki dłuższe. Wartość domyślna to 255, jeśli nie jest ustawiona. Dla maksimum
przenośność, powinieneś ustawić to na 14.

posix_filename_charset = wartość logiczna;
Tego pola można użyć do ograniczenia liczby znaków dozwolonych w nazwach plików
wyraźnie dozwolone przez POSIX. Domyślnie fałszywy jeśli nie jest ustawiony, co oznacza, niezależnie od twojego
system operacyjny będzie tolerował, z wyjątkiem białych znaków i znaków o dużej zawartości bitów.
Aby uzyskać maksymalną przenośność, należy ustawić tę opcję prawdziwy.

dos_filename_required = wartość logiczna;
Tego pola można użyć do ograniczenia nazw plików, tak aby były zgodne z systemem DOS 8+3
limitów nazw plików i zestawu znaków nazwy pliku DOS. Domyślnie fałszywy Jeśli nie
ustawiony.

nazwa_pliku_Windows_wymagana = wartość logiczna;
To pole może zostać użyte do ograniczenia nazw plików, tak aby były zgodne ze standardem Windows98
oraz limity nazw plików i zestawów znaków systemu WindowsNT. Domyślnie fałszywy jeśli nie jest ustawiony.

powłoki_bezpieczne_pliki = wartość logiczna;
Pole to może zostać użyte do ograniczenia nazw plików tak, aby nie zawierały powłoki
znaki specjalne. Domyślnie prawdziwy jeśli nie jest ustawiony. Jeśli to pole jest ustawione na fałszywy,
będziesz musiał użyć ${cytat} podstawienie wokół nazw plików w poleceniach, to
upewnij się, że nazwy plików zawierające znaki specjalne powłoki nie są niezamierzone
skutki uboczne. Dziwne znaki w nazwach plików mogą również mylić twoją zależność
narzędzie do konserwacji.

zezwolenie_biała_przestrzeń_w_plikach = wartość logiczna;
To pole może być użyte do dopuszczenia białych znaków w nazwach plików. To będzie
pozwól, aby w nazwach plików pojawiały się następujące znaki: backspace (BS, \b, 0x08),
zakładka pozioma (HT, \t, 0x09), nowa linia (NL, \n, 0x0A), zakładka pionowa (VT, \v,
0x0B), wysuw formularza (FF, \f, 0x0C) i powrót karetki (CR, \r, 0x0D). Domyślnie
false, jeśli nie jest ustawiony.

Należy pamiętać, że to pole nie zastępuje innych filtrów nazw plików. To będzie
konieczne do wyraźnego ustawienia nazwy_bezpiecznych_plików powłoki = fałszywy również. To będzie
konieczne do ustawienia dos_nazwa_pliku_wymagany = fałszywy (domyślnie) również. To będzie
konieczne do ustawienia posix_nazwa_pliku_zestaw znaków = fałszywy (domyślnie) również.

Użytkownik musi zachować szczególną ostrożność, aby zastosować podstawienie ${quote} wokół całego pliku
nazwy w poleceniach w konfiguracji projektu. A nawet wtedy, zastępstwa
które oczekują listy nazw plików oddzielonych spacjami, będą miały niezdefiniowane wyniki.

zezwolenie_non_ascii_filenames = wartość logiczna;
Tego pola można użyć, aby zezwolić na wprowadzanie nazw plików zawierających znaki niedrukowalne w formacie ASCII
ich. Zwykle oznaczałoby to jakiś rodzaj zestawu znaków UTF8 lub międzynarodowy.
Domyślnie ustawiona jest wartość false, jeśli nie jest ustawiona.

Należy pamiętać, że to pole nie zastępuje innych filtrów nazw plików. To będzie
konieczne do wyraźnego ustawienia nazwy_bezpiecznych_plików powłoki = fałszywy również. To będzie
konieczne do ustawienia dos_nazwa_pliku_wymagany = fałszywy (domyślnie) również. To będzie
konieczne do ustawienia posix_nazwa_pliku_zestaw znaków = fałszywy (domyślnie) również.

nazwa_pliku_wzorzec_akceptacja = [ ciąg ];
To pole służy do określenia listy wzorców akceptowalnych nazw plików.
Domyślnie jest to „*”, jeśli nie jest ustawione.

nazwa_pliku_wzorzec_odrzucenia = [ ciąg ];
To pole służy do określenia listy wzorców niedopuszczalnych nazw plików.

Proszę Uwaga: Aegis konsultuje się również z podstawowym systemem plików, aby określić jego pojęcie
maksymalny rozmiar pliku. Gdzie maksymalny rozmiar pliku systemu plików jest mniejszy niż
maksymalna_długość_pliku, wygrywa system plików. Może się to zdarzyć na przykład, gdy jesteś
używając systemu plików Linux UMSDOS lub gdy masz zamontowany NFS, starą wersję V7
system plików. Ustawienie maksymalna_długość_pliku do 255 w tych przypadkach nie zmienia
fakt, że podstawowe limity systemów plików są znacznie mniejsze (odpowiednio 12 i 14).

Jeśli twoje katalogi programistyczne (lub cały projekt) znajdują się na systemach plików o nazwie pliku
ograniczenia lub część heterogenicznych kompilacji ma miejsce w takim środowisku,
pomaga powiedzieć Aegis, kim są (korzystając z projektu config pola pliku) tak, że
nie wpadaj w sytuację, w której projekt opiera się na bardziej liberalnych
środowisk, ale kończy się niepowodzeniem z tajemniczymi błędami w bardziej ograniczonych środowiskach.

Jeśli twoje katalogi programistyczne są rutynowo w systemie plików Linux UMSDOS, powinieneś:
prawdopodobnie lepiej ustawić dos_nazwa_pliku_wymagany = prawdziwy, a także zmiana
szablon_katalogu_rozwojowego pole. Heterogeniczny rozwój z różnymi systemami Windows
środowiska mogą również tego wymagać.

filet Imię Interpretacja
Program aegis spróbuje określić nazwy plików projektu na podstawie nazw plików
podane w wierszu poleceń. Wszystkie nazwy plików są przechowywane w projektach aegis jako względne
do katalogu głównego drzewa katalogów linii bazowej. Katalog deweloperski i
katalog integracyjny to cienie tego katalogu bazowego, a więc te względne nazwy
tutaj również aplikuj. Pliki wymienione w wierszu poleceń są najpierw konwertowane na ścieżki bezwzględne
Jeśli to konieczne. Następnie są porównywane ze ścieżką bazową, katalogiem deweloperskim
ścieżka i ścieżka katalogu integracji, aby określić nazwę względną względem linii bazowej. To jest
błąd, jeśli nazwany plik znajduje się poza jednym z tych drzew katalogów.

Połączenia -BAse_REWzględny opcja może być użyta do spowodowania, że ​​względne nazwy plików będą interpretowane jako
względem ścieżki bazowej; bezwzględne nazwy plików będą nadal porównywane z różnymi
ścieżki w celu określenia nazwy względem linii bazowej.

Połączenia względna_nazwa_pliku_preferencje w pliku konfiguracyjnym użytkownika może służyć do modyfikacji
to domyślne zachowanie. Widzieć aeuconf(5), aby uzyskać więcej informacji.

Wymiana pieniędzy dotychczasowy Rodzaj Nieruchomości of a filet
Jeśli chcesz zmienić typ pliku (powiedzmy z pliku testowego na plik źródłowy lub wice
versa) możesz to zrobić jako dwie zmiany, najpierw używając powietrze(1) w jednej zmianie i potem
za pomocą aenf(1) lub nie(1) w drugiej zmianie lub możesz połączyć oba kroki w ten sam sposób
zmiana. Pamiętaj o użyciu powietrze -brak przebarwień opcję lub otrzymasz najbardziej osobliwą nowość
szablon pliku.

filet Działania Regulacja
Po uruchomieniu tego polecenia najpierw sprawdza pliki zmian względem plików projektów. Gdyby
występują niespójności, działania na plikach zostaną dostosowane w następujący sposób:

create Jeśli plik jest tworzony, ale zintegrowany jest inny zbiór zmian, który również
tworzy plik, akcja pliku w zbiorze zmian, który jest nadal opracowywany, będzie
dostosowane do "modyfikowania".

modyfikować Jeśli plik jest modyfikowany, ale zintegrowany jest inny zbiór zmian, który usuwa
plik, akcja pliku w zbiorze zmian, który jest nadal opracowywany, będzie
dostosowane do "tworzenia".

usuń Jeśli plik jest usuwany, ale zintegrowany jest inny zbiór zmian, który usuwa
plik, plik zostanie usunięty z zestawu zmian, który jest nadal opracowywany.

Zgłoszenie
Połączenia nowe_polecenie_pliku w pliku konfiguracyjnym projektu jest uruchamiany, jeśli jest ustawiony. ten projekt_-
plik_komenda jest również uruchamiany, jeśli jest ustawiony i jeśli ostatnio miała miejsce integracja. Widzieć
aepconf(5), aby uzyskać więcej informacji.

TESTOWANIE KORELACJE

Polecenie „egida -Test -SUGgest” może być użyte do sugerowania przez egidę odpowiedniej regresji
testuje Twoją zmianę na podstawie plików źródłowych w Twojej zmianie. To automatycznie
skupia wysiłek testowy na odpowiednich testach, zmniejszając liczbę testów regresji
musisz mieć pewność, że nie wprowadziłeś błędu.

Korelacje testowe są generowane przez polecenie „aegis -Integrate_Pass”, które:
kojarzy każdy test w zmianie z każdym plikiem źródłowym w zmianie. Tak więc każdy
plik źródłowy gromadzi listę testów, które były z nim powiązane w przeszłości.
Nie jest to tak dokładne jak analiza pokrycia kodu, ale jest rozsądnym przybliżeniem w
ćwiczyć.

Połączenia aekp(1) i aenf(1) komendy służą do kojarzenia plików ze zmianą. Podczas gdy oni
nie realizuj aktywnie skojarzenia, są to pliki używane przez aeipass(1) i
aet(1) w celu określenia, które pliki źródłowe są powiązane z jakimi testami.

Testowanie Korelacja Dokładność
Zakładając, że testowe korelacje są dokładne i że testy są równomierne
rozłożone w przestrzeni funkcjonalnej, będzie mniej niż 1/liczba szansa, że
odpowiedni test nie został przeprowadzony przez „aegis -Test -SUGgest numer" Komenda. Mały
ilość szumu jest dodawana do wagi testu, więc czasami zdarzają się nieoczekiwane rzeczy
przetestowane, a te same testy nie są uruchamiane za każdym razem.

Dokładność korelacji testów można poprawić, zapewniając, że:

· Każda zmiana powinna być mocno skoncentrowana, bez nieuzasadnionych wtrąceń plików. Ten
unika fałszywych korelacji.

· Każdy element nowej funkcjonalności powinien być dodany w indywidualnej zmianie, a nie
kilka razem. To silnie koreluje testy z funkcjonalnością.

· Każdy błąd powinien być naprawiany w ramach indywidualnej zmiany, a nie kilku razem. Ten
silnie koreluje testy z funkcjonalnością.

· Korelacje testowe zostaną utracone, jeśli pliki zostaną przeniesione. Dzieje się tak, ponieważ korelacje są przez
nazwa.

Najlepszym sposobem na dokładne skorelowanie testów z plikami źródłowymi jest zmiana
zawiera test i dokładnie te pliki, które odnoszą się do testowanej funkcjonalności. Także
wiele fałszywych plików osłabi użyteczność korelacji testowych.

OPCJE

Następujące opcje są zrozumiałe

-Budować
Opcji tej można użyć do określenia, że ​​plik jest tworzony podczas kompilacji
(często tylko kompilacja integrująca), aby można było zachować jej historię. To jest
przydatne do generowania plików poprawek, gdzie znajduje się historia wygenerowanych plików
ważny. Plików utworzonych w ten sposób nie można jednak skopiować do zmiany
mogą zostać usunięte. Jeśli to możliwe, unikaj używania plików tego typu.

-BAse_REWzględny
Ta opcja może być użyta do spowodowania, aby względne nazwy plików były uważane za względne do
podstawa drzewa źródłowego. Widzieć aeuconf(5) dla odpowiedniego użytkownika
pierwszeństwo.

-CUrrent_REWzględny
Ta opcja może być użyta do spowodowania, aby względne nazwy plików były uważane za względne do
bieżący katalog. Jest to zwykle ustawienie domyślne. Widzieć aeuconf(5) dla
odpowiednie preferencje użytkownika.

-Zmiana numer
Ta opcja może służyć do określenia konkretnej zmiany w projekcie. Widzieć
egida(1) pełny opis tej opcji.

-KONFIGUROWANY
Opcji tej można użyć do określenia, że ​​plik jest projektem Aegis
plik konfiguracyjny. Wywoływany jest domyślny plik konfiguracyjny projektu aegis.conf,
jednakże można użyć dowolnej nazwy pliku. Możesz także użyć więcej niż jednego pliku,
podzielenie zawartości na kilka plików, z których wszystkie muszą być tego typu.

-Pomoc
Ta opcja może być wykorzystana do uzyskania dodatkowych informacji o tym, jak używać egida
program.

-Trzymać
Ta opcja może być używana do przechowywania plików i/lub katalogów, które zwykle są usuwane lub
zastąpione przez polecenie. Domyślnie do użytkownika usuń_preferencje_pliku Jeśli nie
określone, patrz aeuconf(5), aby uzyskać więcej informacji.

-Nie_Zachowaj
Ta opcja może być użyta, aby upewnić się, że pliki i/lub katalogi zostaną usunięte
lub zastąpiony przez polecenie. Domyślnie do użytkownika usuń_preferencje_pliku Jeśli nie
określone, patrz aeuconf(5), aby uzyskać więcej informacji.

-Lista
Ta opcja może być użyta do uzyskania listy odpowiednich tematów dla tego polecenia.
Lista może być bardziej ogólna niż oczekiwano.

-Nie_logowanie
Ta opcja może być użyta do wyłączenia automatycznego rejestrowania danych wyjściowych i błędów do
plik. Jest to często przydatne, gdy kilka poleceń aegis jest połączonych w powłoce
skrypt.

-Projekt Nazwa
Ta opcja może być wykorzystana do wybrania interesującego Cię projektu. Kiedy nie -Projekt
opcja jest określona, PROJEKT AEGIS konsultowana jest zmienna środowiskowa. Gdyby
który nie istnieje, użytkownika $HOME/.aegisrc plik jest sprawdzany pod kątem wartości domyślnych
pole projektu (patrz aeuconf(5), aby uzyskać więcej informacji). Jeśli to nie istnieje,
gdy użytkownik pracuje tylko nad zmianami w ramach jednego projektu, projekt
domyślna nazwa tego projektu. W przeciwnym razie jest to błąd.

-Szablon
Opcji tej można użyć nawet do określenia, czy ma zostać użyty nowy szablon pliku
jeśli plik już istnieje.

-Brak_szablonu
Opcji tej można użyć do określenia, że ​​nowy szablon pliku nie powinien być używany,
nawet jeśli plik nie istnieje (zostanie utworzony dowolny pusty plik).

-Lakoniczny
Ta opcja może być używana, aby aukcje generowały minimum
Informacja. Jest to zwykle przydatne w przypadku skryptów powłoki.

-Gadatliwy
Ta opcja może być użyta, aby spowodować, że aegis będzie produkować więcej. Domyślnie egida
generuje dane wyjściowe tylko w przypadku błędów. W przypadku użycia z -Lista opcja ta opcja
powoduje dodanie nagłówków kolumn.

-Czekać Ta opcja może być użyta do zażądania, aby komendy Aegis czekały na blokady dostępu, jeśli:
nie można ich uzyskać natychmiast. Domyślnie do użytkownika preferencje_blokady_oczekiwania
jeśli nie określono, zobacz aeuconf(5), aby uzyskać więcej informacji.

-Nie, czekaj
Ta opcja może być użyta do zażądania, aby polecenia Aegis wyemitowały błąd krytyczny w przypadku dostępu
zamków nie można uzyskać natychmiast. Domyślnie do użytkownika
preferencje_blokady_oczekiwania jeśli nie określono, zobacz aeuconf(5), aby uzyskać więcej informacji.

Zobacz też egida(1) dla opcji wspólnych dla wszystkich komend egidy.

Wszystkie opcje mogą być skrócone; skrót jest dokumentowany jako wielkie litery,
wszystkie małe litery i podkreślenia (_) są opcjonalne. Musisz użyć kolejnego
sekwencje opcjonalnych liter.

Wszystkie opcje nie uwzględniają wielkości liter, można je wpisywać wielkimi lub małymi literami lub a
połączenie obu, przypadek nie jest ważny.

Na przykład: argumenty „-project”, „-PROJ” i „-p” są interpretowane jako
-Projekt opcja. Argument "-prj" nie zostanie zrozumiany, ponieważ konsekutywne
nie podano znaków opcjonalnych.

Opcje i inne argumenty wiersza poleceń mogą być dowolnie mieszane w wierszu poleceń,
po selektorach funkcji.

Długie nazwy opcji GNU są zrozumiałe. Ponieważ wszystkie nazwy opcji dla egida są długie,
oznacza to ignorowanie dodatkowego początkowego „-”. Ten "--opcja=wartość„Konwencja też jest
zrozumiany.

POLECAMY ALIAS

Zalecany alias dla tego polecenia to
csh% alias aenf 'aegis -nf \!* -v'
sh$ aenf(){aegis -nf "$@" -v}

BŁĘDY

Jest to błąd, jeśli zmiana nie znajduje się w jest rozwinięty stan.
Jest to błąd, jeśli zmiana nie jest przypisana do bieżącego użytkownika.
Jest to błąd, jeśli plik jest już częścią zmiany.
Jest to błąd, jeśli plik jest już częścią linii bazowej.
Jest to błąd, jeśli pliki wymienione w wierszu poleceń nie są normalnymi plikami i nie
katalogi. (Jeśli potrzebujesz dowiązań symbolicznych lub plików specjalnych, utwórz je w czasie kompilacji.)

EXIT STATUS

Połączenia egida polecenie zakończy się ze statusem 1 w przypadku każdego błędu. ten egida polecenie będzie tylko
zakończ ze statusem 0, jeśli nie ma błędów.

ŚRODOWISKO ZMIENNE

See egida(1) dla listy zmiennych środowiskowych, które mogą mieć wpływ na to polecenie. Widzieć
aepconf(5) dla pliku konfiguracyjnego projektu specyficzny dla projektu pole jak ustawić
zmienne środowiskowe dla wszystkich poleceń wykonywanych przez Aegis.

Użyj aenf online, korzystając z usług onworks.net