aecp - Online w chmurze

PROGRAM:

IMIĘ

aegis copy file - skopiuj plik do zmiany

STRESZCZENIE

egida -Skopiuj plik [ opcja...] filename...
egida -Skopiuj plik -Niezależny [ opcja...] filename...
egida -Skopiuj plik -Lista [ opcja...]
egida -Skopiuj plik -Pomoc

OPIS

Połączenia egida -Skopiuj plik Polecenie służy do kopiowania pliku do zmiany. Nazwane pliki będą
skopiowane z wersji bazowej do katalogu deweloperskiego i dodane do listy
pliki w zmianie. Zapamiętywana jest wersja plików skopiowanych z linii bazowej.

To polecenie może służyć do kopiowania testów do zmian, a nie tylko plików źródłowych. Testy są
traktowane jak każdy inny plik źródłowy i podlegają temu samemu procesowi.

Ostrzeżenie: Jeśli w katalogu deweloperskim znajdują się pliki o tej samej nazwie, to będą
nadpisany przez to polecenie.

Możesz także nazwać katalogi. Wszystkie pliki źródłowe w nazwanych katalogach i wszystkie
katalogi pod nimi zostaną skopiowane z bazy do katalogu deweloperskiego,
i dodane do listy plików w zmianie.

Podczas jawnego kopiowania plików, błąd jest błędem, jeśli plik jest już częścią zmiany.
Kiedy nazwiesz katalog, wszystkie pliki źródłowe w projekcie poniżej tego katalogu
są kopiowane, z wyjątkiem tych, które są już w zmianie. Jest to błąd, jeśli żaden z
można używać plików niejawnie nazwanych przez katalog.

Jeśli chcesz zmienić skopiowany plik źródłowy na wykonywalny (na przykład skrypty powłoki)
wtedy po prostu użyjesz normalnego chmod(1) polecenie; odwrotnie, aby nie był wykonywalny.
Jeśli którykolwiek z wykonywalnych bitów pliku jest ustawiony na aed(1) czas zapamiętywania pliku jako
wykonywalny i wszystkie bity wykonania (bez umask projektu) zostaną ustawione przez kolejne
aekp(1) polecenia.

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.

Przetwarzanie Bok Dodawanie efektów
To polecenie anuluje wszelkie rejestracje kompilacji lub testów, ponieważ dodanie kolejnego pliku
logicznie je unieważnia. Jeśli plik konfiguracyjny projektu został dodany, wszelkie różnice
rejestracja również zostanie anulowana.

Gdy pliki zmian są wymienione (egida -Lista Zmień_Pliki -Lakoniczny) skopiowane pliki będą
pojawiają się na liście. Gdy pliki projektu są wymienione z wyraźnym numerem zmiany
(egida -Lista Pliki_projektu -Lakoniczny -Zmiana N) żaden z plików zmian, w tym
skopiowane pliki, pojawią się w zwięzłej liście. Te dwie funkcje są bardzo pomocne, gdy
wywołanie aegis z poziomu DMT w celu wygenerowania listy plików źródłowych.

THE LINIA BAZOWA LOCK

Blokada linii bazowej służy do zapewnienia, że ​​linia bazowa pozostaje w spójnym stanie przez
czas trwania poleceń, które muszą odczytać zawartość plików w linii bazowej.

Polecenia, które wymagają, aby linia bazowa była spójna (zaliczają się do nich: aeb(1)
aekp(1) i aed(1) polecenia) weź linię bazową czytać Zamek. To jest niewyłączny zamek, więc
równoczesny rozwój zmian nie jest utrudniony.

Polecenie modyfikujące linię bazową, aeipass(1), przyjmuje linię bazową napisać Zamek. Ten
to zamek ekskluzywny, forsujący aeipass(1) blokować, dopóki nie będzie aktywnego odczytu linii bazowej
zamki

Możliwe, że jedno z powyższych poleceń programistycznych zablokuje się do czasu, gdy jest to w toku
egida -Integracja_PASS kończy. Zwykle trwa to krótko, podczas gdy projekt
historia jest aktualizowana. Opóźnienie jest niezbędne, aby te polecenia otrzymały spójne
widok linii bazowej. Żadne inne polecenie integracji nie spowoduje powyższego rozwoju
polecenia do zablokowania.

Gdy używana jest funkcja oddziału aegis, blokada odczytu (niewyłączna) jest pobierana na
linia bazowa gałęzi, a także każda z linii bazowych „macierzystych”. Jednak podstawowy zapis
(ekskluzywna) blokada jest pobierana tylko na linii bazowej oddziału; „rodzice” linie bazowe są tylko
odczyt (nie na wyłączność) zablokowany.

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.

Zgłoszenie
Połączenia polecenie copy_file_command w projekcie config plik jest uruchamiany, jeśli jest ustawiony. ten plik_projektu_‐
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.

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.

OPCJE

Rozumie się następujące opcje:

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

-Oddział numer
Ta opcja może być używana raczej do określenia innej gałęzi dla pliku źródłowego
niż linia bazowa. (Zobacz też -Pień opcja. Uwaga: -Oddział opcja
nie przyjmuje nazwy projektu, tylko przyrostek numeru oddziału.

-Dziadek
Ta opcja może być użyta do określenia gałęzi dziadka (jednej w górę od
current branch) dla pliku pochodzenia, a nie dla linii bazowej. (-dziadek
opcja jest taka sama jak opcja „-branch ..”

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

-Delta numer
Ta opcja może być użyta do określenia określonej delty w historii projektu, aby:
skopiuj plik z, a nie z najnowszej wersji. Jeśli delta była
otrzymał imię (patrz edn(1) jak) możesz użyć nazwy delta zamiast delty
numer. Jest to błąd, jeśli określona delta nie istnieje. Liczby delta
zacznij od 1 i zwiększ; delta 0 to szczególny przypadek oznaczający „kiedy gałąź
zaczęła się".

-DELta_Data ciąg
Ta opcja może być użyta do określenia konkretnej daty i godziny w projekcie
historię, z której ma zostać skopiowany plik, a nie najnowszą wersję. To jest
błąd, jeśli podanego ciągu znaków nie można zinterpretować jako prawidłowej daty i godziny.
Cytuj ciąg, jeśli musisz użyć spacji.

-DELta_Od_Zmiany numer
Ta opcja może być wykorzystana do określenia określonej delty projektu od jego zmiany
liczba.

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

-Niezależny
Ta opcja służy do określenia, że ​​kopia ma być uruchamiana niezależnie od jakichkolwiek
konkretna zmiana. Pliki zostaną skopiowane względem bieżącego katalogu.

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

-Wyjście filename
Ta opcja może być użyta do określenia pliku wyjściowego pliku kopiowanego z
linia bazowa. W przypadku użycia tej opcji można nazwać tylko jeden plik linii bazowej. ten
nazwa pliku "-" oznacza standardowe wyjście. Ta opcja nie
dodaj plik do zestawu plików zmian. Nie zamki są brane, gdy ta opcja jest
używana, nawet blokada odczytu linii bazowej.

-Nadpisywanie
Ta opcja może być użyta do wymuszenia nadpisywania plików. Domyślną akcją jest
dać błąd, jeśli istniejący plik zostałby nadpisany.

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

-Tylko czytać
Ta opcja może być użyta do określenia, że ​​plik ma być używany do izolowania
zmiana w stosunku do stanu wyjściowego. Użytkownik nie zamierza edytować pliku. Te
pliki muszą zostać rozpakowane przed zakończeniem opracowywania.

-Odwołać
Ta opcja może służyć do cofnięcia (cofnięcia) zakończonej zmiany. Zmiana na
rescid (cofanie) jest określany w zwykły sposób, z jednym z --delta
opcje.

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

-Pień
Ta opcja może być raczej użyta do określenia linii głównej projektu dla pliku źródłowego
niż linia bazowa. (Zobacz też -Oddział opcja -trunk jest taka sama jak
opcja „-gałąź -”.)

-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 aecp 'aegis -cp \!* -v'
sh$ aecp(){aegis -cp "$@" -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.
To jest błąd, jeśli plik jest już w zmianie, a -Przepisać opcja nie jest
określony.

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.

PRZYKŁADY

Oto kilka prostych przykładów. Pamiętaj, że większość poleceń odnosi się do prądu
katalog, mimo że te przykłady zakładają, że jesteś u podstaw rozwoju
drzewo katalogów.

Skopiuj Całość Projekty
Aby skopiować cały projekt do swojej zmiany, użyj polecenia
aekp.
Końcowa kropka jest częścią polecenia, oznacza „aktualny katalog i wszystko
poniżej”. Działa to dla dowolnego katalogu w drzewie źródłowym projektu, jeśli chcesz być
bardziej selektywny.

Wyprodukuj Wcześniej Projekty Wersja
Chcesz dokładnie odtworzyć źródła wcześniejszej wersji swojego projektu,
musisz znać numer edelta (użyj ael historia-projektu znaleźć to). Następnie użyj tego
polecenie:
aecp-delta n .
gdzie n to liczba delta z historii projektu. Ponownie, końcowa kropka jest częścią
Komenda. Używając $wersja substytucja (patrz esub(5) aby uzyskać więcej informacji) ty
może osadzić ten numer delta w twoim programie przed jego dystrybucją.

Zamiast tego można również nadać numer poprzedniej zmiany za pomocą tego polecenia:
aecp -delta-od-zmiany n .
gdzie n to numer zmiany zainteresowania. Ponownie, końcowa kropka jest częścią
dowództwo.

Odwołać a zmiana
Kiedy musisz cofnąć (wycofać się) zakończoną zmianę, prawdopodobnie będzie to trochę
czas temu, więc musisz znać numer delta lub zmienić numer. Użyj tego polecenia:
aecp-delta n -wycofać się .
gdzie n to interesująca liczba delta. Wszystkie inne warianty -delta również działają, więc
jeśli znasz numer zmiany, możesz bardziej selektywnie wybierać pliki do skopiowania:
aecp -delta-od-zmiany n `egida -l cf -ter -c n`
gdzie n to numer zmiany zainteresowania. Kopiuje to tylko pliki, które były w
obraźliwa zmiana.

Korzystaj z aecp online za pomocą usług onworks.net