Jest to polecenie hg, które można uruchomić u dostawcy bezpłatnego hostingu OnWorks przy użyciu jednej z naszych wielu bezpłatnych stacji roboczych online, takich jak Ubuntu Online, Fedora Online, emulator online systemu Windows lub emulator online systemu MAC OS
PROGRAM:
IMIĘ
hg - System zarządzania kodem źródłowym Mercurial
STRESZCZENIE
hg komenda [opcja]... [argument] ...
OPIS
Połączenia hg polecenie udostępnia interfejs wiersza poleceń dla systemu Mercurial.
COMMAND ELEMENTY
akta...
wskazuje jedną lub więcej nazw plików lub względnych nazw plików; zobacz Wzorce nazw plików
aby uzyskać informacje na temat dopasowywania wzorców
ścieżka wskazuje ścieżkę na komputerze lokalnym
rewizja
wskazuje zestaw zmian, który można określić jako numer wersji zestawu zmian, znacznik,
lub unikalny podciąg wartości skrótu zestawu zmian
składnica ścieżka
albo ścieżka do lokalnego repozytorium, albo identyfikator URI zdalnego repozytorium.
OPCJE
-R,--magazyn
Katalog główny repozytorium lub nazwa pliku pakietu nakładki
--cwd
zmień katalog roboczy
-y, --nieinteraktywny
nie pytaj, automatycznie wybierz pierwszy wybór dla wszystkich podpowiedzi
-Q, --cichy
tłumić wyjście
-v, --gadatliwy
włączyć dodatkowe wyjście
--konfig
ustaw/zastąp opcję konfiguracji (użyj „section.name=value”)
--odpluskwić
włącz wyjście debugowania
--Debugger.
uruchom debuger
--kodowanie
ustaw kodowanie zestawu znaków (domyślnie: UTF-8)
--tryb kodowania
ustaw tryb kodowania zestawu znaków (domyślnie: ścisły)
--śledzenie wsteczne
zawsze drukuj ślad w przypadku wyjątku
--czas czas, jak długo trwa wykonanie polecenia
--profil
wydrukuj profil wykonania polecenia
--wersja
Informacje o wersji i zakończ
-H, --help
wyświetl pomoc i wyjdź
--ukryty
rozważ ukryte zestawy zmian
Opcja zaznaczona [+] może być określona wielokrotnie
POLECENIA
Dodaj
dodaj określone pliki przy następnym zatwierdzeniu:
hg dodaj [OPCJA]... [PLIK]...
Zaplanuj kontrolę wersji plików i dodanie ich do repozytorium.
Pliki zostaną dodane do repozytorium przy następnym zatwierdzeniu. Aby cofnąć dodanie wcześniej,
widzieć hg zapomnieć.
Jeśli nie podano nazw, dodaj wszystkie pliki do repozytorium (z wyjątkiem plików pasujących .hgignore).
Przykłady:
· Nowe (nieznane) pliki są dodawane automatycznie przez hg Dodaj:
$ls
foo.c
$ status hg
? foo.c
$ hg dodać
dodanie foo.c
$ status hg
Foo.c
· Można określić konkretne pliki do dodania:
$ls
bar.c foo.c
$ status hg
? bar.c
? foo.c
$ hg dodaj bar.c
$ status hg
Bar.c
? foo.c
Zwraca 0, jeśli wszystkie pliki zostały pomyślnie dodane.
Opcje:
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-S, --podrepozytoria
wracaj do podrepozytoriów
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
Opcja zaznaczona [+] może być określona wielokrotnie
Dodaj usuń
dodaj wszystkie nowe pliki, usuń wszystkie brakujące pliki:
hg adresusuń [OPCJA]... [PLIK]...
Dodaj wszystkie nowe pliki i usuń wszystkie brakujące pliki z repozytorium.
Jeśli nie podano nazw, nowe pliki są ignorowane, jeśli pasują do któregokolwiek wzorca w pliku
.hgignore. Podobnie jak w przypadku dodawania, zmiany te zaczynają obowiązywać przy następnym zatwierdzeniu.
Użyj opcji -s/--similarity, aby wykryć pliki o zmienionych nazwach. Ta opcja wymaga procentu
jako parametr od 0 (wyłączone) do 100 (pliki muszą być identyczne). Z parametrem
większa niż 0, porównuje każdy usunięty plik z każdym dodanym plikiem i rejestruje je
wystarczająco podobne jak zmiany nazw. Wykrywanie w ten sposób plików o zmienionych nazwach może być kosztowne. Po użyciu
ta opcja, hg status -C można użyć do sprawdzenia, które pliki zostały zidentyfikowane jako przeniesione lub
przemianowany. Jeśli nie określono, -s/--similarity domyślnie przyjmuje wartość 100 i zmienia tylko nazwy identycznych
wykryto pliki.
Przykłady:
· Wiele plików (bar.c i foo.c) jest nowych, natomiast foobar.c został usunięty (bez
za pomocą hg usunąć) z repozytorium:
$ls
bar.c foo.c
$ status hg
! foobar.c
? bar.c
? foo.c
$ hg adresusuń
dodanie bar.c
dodanie foo.c
usuwanie foobara.c
$ status hg
Bar.c
Foo.c
R foobar.c
· Plik foobar.c został przeniesiony do foo.c bez użycia hg przemianować. Potem było
lekko zmodyfikowane:
$ls
foo.c
$ status hg
! foobar.c
? foo.c
$ hg adresusuń --podobieństwo 90
usuwanie foobara.c
dodanie foo.c
nagrywanie usunięcia foobar.c jako zmiana nazwy na foo.c (94% podobnych)
$ status hg -C
Foo.c
foobar.c
R foobar.c
Zwraca 0, jeśli wszystkie pliki zostały pomyślnie dodane.
Opcje:
-tak,--podobieństwo
zgadnij nazwy plików o zmienionej nazwie według podobieństwa (0<=s<=100)
-S, --podrepozytoria
wracaj do podrepozytoriów
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
Opcja zaznaczona [+] może być określona wielokrotnie
komentować
pokaż informacje o zestawie zmian według linii dla każdego pliku:
hg adnotacja [-r REW] [-f] [-a] [-u] [-d] [-n] [-c] [-l] PLIK...
Wyświetla listę zmian w plikach, pokazując identyfikator wersji odpowiedzialny za każdą linię.
To polecenie jest przydatne do sprawdzenia, kiedy i przez kogo dokonano zmiany.
Jeśli dołączysz --file, --user lub --date, numer wersji zostanie pominięty, chyba że podasz
uwzględnij także --number.
Bez opcji -a/--text polecenie annotate uniknie przetwarzania plików, które wykryje jako binarne.
Opcja -a powoduje, że adnotacja i tak doda adnotację do pliku, chociaż prawdopodobnie skutki takie będą
ani przydatne, ani pożądane.
Zwraca 0 w przypadku powodzenia.
Opcje:
-R,--obrót silnika
opisz określoną wersję
--śledzić
śledź kopie/zmień nazwy i podaj nazwę pliku (przestarzałe)
--nie-śledź
nie postępuj zgodnie z kopiami i zmianami nazw
-za, --tekst
traktuj wszystkie pliki jako tekst
-ty, --użytkownik
wymień autora (długie z -v)
-F, --plik
podaj nazwę pliku
-D, --Data
podaj datę (krótko z -q)
-N, --numer
podaj numer wersji (domyślnie)
-C, --zestaw zmian
wypisz zestaw zmian
-ja, --numer linii
pokaż numer linii przy pierwszym pojawieniu się
-w, --ignoruj całą przestrzeń
ignoruj białe znaki podczas porównywania linii
-B, --ignoruj-zmianę-spacji
zignoruj zmiany w ilości spacji
-B, --ignoruj puste linie
ignoruj zmiany, których wiersze są puste
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
Opcja zaznaczona [+] może być określona wielokrotnie
pseudonimy: wina
archiwum
utwórz niewersjonowane archiwum wersji repozytorium:
hg archiwum [OPCJA]... DEST
Domyślnie używana wersja jest rodzicem katalogu roboczego; użyj -r/--rev do
określić inną wersję.
Typ archiwum jest wykrywany automatycznie na podstawie rozszerzenia pliku (aby zastąpić, użyj
-t/--typ).
Przykłady:
· utwórz plik zip zawierający wersję 1.0:
hg archiwum -r 1.0 projekt-1.0.zip
· utwórz archiwum tar z wyłączeniem plików .hg:
hg archiwum projekt.tar.gz -X ".hg*"
Prawidłowe typy to:
pliki
katalog pełen plików (domyślnie)
smoła
archiwum tar, nieskompresowane
tbz2
archiwum tar, skompresowane przy użyciu bzip2
tgz
archiwum tar, skompresowane przy użyciu programu gzip
uzip
archiwum zip, nieskompresowane
zamek błyskawiczny
archiwum zip, skompresowane przy użyciu deflate
Dokładna nazwa docelowego archiwum lub katalogu jest podawana za pomocą ciągu formatującego; Widzieć
hg pomoc eksport dla szczegółów.
Każdy element dodany do pliku archiwum ma przedrostek katalogu. Użyj -p/--przedrostka do
określ ciąg formatujący dla przedrostka. Wartość domyślna to nazwa bazowa archiwum, z
przyrostki usunięte.
Zwraca 0 w przypadku powodzenia.
Opcje:
--bez-dekodowania
nie przepuszczaj plików przez dekodery
-P,prefix
przedrostek katalogu dla plików w archiwum
-R,--obrót silnika
wersja do dystrybucji
-T,--rodzaj
typ dystrybucji do utworzenia
-S, --podrepozytoria
wracaj do podrepozytoriów
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
wycofać się
odwrotny efekt wcześniejszego zestawu zmian:
hg wycofanie [OPCJA]... [-r] WER
Przygotuj nowy zestaw zmian z efektem cofnięcia REV w bieżącym katalogu roboczym. Jeśli
nie napotkano żadnych konfliktów, zostanie ono popełnione natychmiast.
Jeśli REV jest rodzicem katalogu roboczego, wówczas ten nowy zestaw zmian zostaje zatwierdzony
automatycznie (chyba że określono --no-commit).
Note hg wycofać się nie można użyć do naprawienia niechcianego lub nieprawidłowego scalania.
Przykłady:
· Odwróć efekt nadrzędny katalogu roboczego. To wycofanie się będzie
popełnione natychmiast:
hg wycofanie -r.
· Odwróć efekt poprzedniej złej wersji 23:
hg wycofanie -r 23
· Odwróć efekt poprzedniej złej wersji 23 i pozostaw zmiany niezatwierdzone:
hg wycofanie -r 23 --no-commit
hg commit -m „Wersja wycofania 23”
Domyślnie oczekujący zestaw zmian będzie miał jednego rodzica, zachowując historię liniową. Z
--merge, oczekujący zestaw zmian będzie miał zamiast tego dwóch rodziców: starego rodzica
katalog roboczy i nowe dziecko REV, które po prostu cofa REV.
Przed wersją 1.7 zachowanie bez --merge było równoznaczne z podaniem --merge
następnie hg aktualizacja --czysty . anulować fuzję i pozostawić dziecko REV na stanowisku głowy
zostać połączone oddzielnie.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
See hg pomoc przywrócić aby znaleźć sposób na przywrócenie plików do stanu z innej wersji.
Zwraca 0 w przypadku powodzenia, 1, jeśli nie ma nic do wycofania lub istnieją nierozwiązane pliki.
Opcje:
--łączyć
połącz się ze starym rodzicem Distate po wycofaniu się
--popełniać
zatwierdzić, jeśli nie napotkano żadnych konfliktów (przestarzałe)
--bez zobowiązań
nie popełniaj
--rodzic
element nadrzędny do wyboru podczas wycofywania scalania (przestarzałe)
-R,--obrót silnika
rewizja do wycofania
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-T,--narzędzie
określ narzędzie scalania
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
Opcja zaznaczona [+] może być określona wielokrotnie
przepoławiać
wyszukiwanie podpodziałów zbiorów zmian:
hg na pół [-gbsr] [-U] [-c CMD] [REV]
To polecenie pomaga znaleźć zestawy zmian, które powodują problemy. Aby skorzystać, zaznacz najwcześniej
zestaw zmian, o którym wiesz, że problem jest poważny, a następnie zaznacz najnowszy zestaw zmian, który jest
wolny od problemu jako dobry. Bisect zaktualizuje Twój katalog roboczy do wersji
testowanie (chyba że określono opcję -U/--noupdate). Po przeprowadzeniu testów,
oznacz katalog roboczy jako dobry lub zły, a bisect albo zaktualizuje się do innego
kandydat wprowadza zmiany lub ogłasza, że znalazł złą wersję.
W skrócie możesz także użyć argumentu wersji, aby oznaczyć wersję jako dobrą lub złą
bez uprzedniego sprawdzenia.
Jeśli podasz polecenie, zostanie ono użyte do automatycznej bisekcji. Środowisko
zmienna HG_NODE będzie zawierać identyfikator testowanego zestawu zmian. Stan wyjścia
polecenie zostanie użyte do oznaczenia wersji jako dobrej lub złej: status 0 oznacza dobrą, 125 oznacza
pomiń wersję, 127 (nie znaleziono polecenia) przerwie bisekcję i każdą inną
niezerowy status wyjścia oznacza, że wersja jest zła.
Kilka przykładów:
· rozpocznij bisekcję ze znaną złą wersją 34 i dobrą wersją 12:
hg na pół – zły 34
hg bisect – dobrze 12
· przesunąć bieżącą dwusieczną, zaznaczając bieżącą wersję jako dobrą lub złą:
hg bisect – dobrze
hg bisect – źle
· zaznaczyć bieżącą wersję lub znaną wersję do pominięcia (np. jeśli ta wersja jest
nie nadaje się do użytku z powodu innego problemu):
hg bisect --pomiń
hg bisect --pomiń 23
· pomiń wszystkie wersje, które nie dotyczą katalogów bla or bar:
hg bisect --skip "!( plik('ścieżka:foo') & plik('ścieżka:bar') )"
· zapomnij o bieżącej dwusekcji:
hg bisect --reset
· użyj opcji „make && make testy”, aby automatycznie znaleźć pierwszą uszkodzoną wersję:
hg bisect --reset
hg na pół – zły 34
hg bisect – dobrze 12
hg bisect --polecenie „wykonaj i& wykonaj testy”
· zobacz wszystkie zestawy zmian, których stany są już znane w bieżącym bisekcji:
hg log -r "przepołacz (przycięty)"
· Zobacz zestaw zmian aktualnie dzielony na pół (szczególnie przydatne, jeśli pracujesz z
-U/--noupdate):
hg log -r "dwusieczna (bieżąca)"
· zobacz wszystkie zestawy zmian, które wzięły udział w bieżącej dwusekcji:
hg log -r "połowa (zakres)"
· możesz nawet uzyskać ładny wykres:
hg log --graph -r "podział na pół(zakres)"
See hg pomoc resetuje aby dowiedzieć się więcej o przepoławiać() słowo kluczowe.
Zwraca 0 w przypadku powodzenia.
Opcje:
-R, --Resetowanie
zresetuj stan dwusieczny
-G, --Dobry
zaznacz zestaw zmian jako dobry
-B, --zły
zaznacz zestaw zmian jako zły
-tak, --pominąć
pomiń testowanie zestawu zmian
-mi, --rozszerzyć
rozszerzyć zakres dwusieczny
-C,--Komenda
użyj polecenia, aby sprawdzić stan zestawu zmian
-Ty, --brak aktualizacji
nie aktualizuj do wersji docelowej
bookmarks
utwórz nową zakładkę lub wyświetl listę istniejących zakładek:
hg zakładki [OPCJE]... [NAZWA]...
Zakładki to etykiety na zestawach zmian, które pomagają śledzić kierunki rozwoju. Zakładki są
niewersjonowane i można je przenosić, zmieniać nazwę i usuwać. Usunięcie lub przeniesienie zakładki nie ma żadnego skutku
wpływ na powiązane zestawy zmian.
Utworzenie lub aktualizacja zakładki powoduje oznaczenie jej jako „aktywnej”. Aktywny
zakładka jest oznaczona znakiem „*”. Po dokonaniu zatwierdzenia aktywna zakładka zostanie przesunięta
do nowego zatwierdzenia. Zwykły hg aktualizacja jeśli to możliwe, przesunie również aktywną zakładkę.
Aktualizacja z poziomu zakładki spowoduje jej dezaktywację.
Zakładki można przesuwać i przeciągać pomiędzy repozytoriami (patrz hg pomoc naciskać i hg pomoc Ciągnąć
). Jeśli udostępniona zakładka uległa rozbieżności, zostanie utworzona nowa „rozbieżna zakładka” w postaci „nazwa@ścieżka”
zostanie stworzony. Za pomocą hg łączyć rozwiąże rozbieżność.
Zakładka o nazwie „@” ma tę specjalną właściwość, że hg klonować sprawdzi to domyślnie
jeśli istnieje.
Przykłady:
· utwórz aktywną zakładkę dla nowej linii rozwoju:
hg book nowa funkcja
· utwórz nieaktywną zakładkę jako znacznik miejsca:
hg book - zrecenzowałem
· utwórz nieaktywną zakładkę na innym zestawie zmian:
hg book -r .^ przetestowane
· zmień nazwę zakładki indyk na obiad:
hg book -m obiad z indyka
· przenieś zakładkę „@” z innej gałęzi:
hg książka -f @
Opcje:
-F, --siła
siła
-R,--obrót silnika
wersja akcji zakładek
-D, --kasować
usunąć daną zakładkę
-M,--Przemianować
zmienić nazwę danej zakładki
-ja, --nieaktywny
oznaczyć zakładkę jako nieaktywną
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
aliasy: zakładka
oddział
ustaw lub pokaż aktualną nazwę oddziału:
hg oddział [-fC] [NAZWA]
Uwaga Nazwy oddziałów są stałe i globalne. Używać hg zakładka aby stworzyć lekką masę
zamiast tego zakładkę. Widzieć hg pomoc słowniczek aby uzyskać więcej informacji na temat nazwanych oddziałów
i zakładki.
Bez argumentu pokaż nazwę bieżącej gałęzi. Za pomocą jednego argumentu ustaw Working
nazwa gałęzi katalogu (gałąź nie będzie istnieć w repozytorium aż do następnego zatwierdzenia).
Standardowa praktyka zaleca, aby podstawowy rozwój odbywał się w „domyślnej” gałęzi.
Jeśli nie podano -f/--force, gałąź nie pozwoli ci ustawić nazwy gałęzi, która już istnieje
istnieje.
Użyj -C/--clean, aby zresetować gałąź katalogu roboczego do gałęzi nadrzędnej pliku roboczego
katalog, negując poprzednią zmianę gałęzi.
Użyj polecenia hg aktualizacja aby przejść do istniejącego oddziału. Używać hg popełnić --zamknięty oddział do
oznacz tę główkę gałęzi jako zamkniętą. Kiedy wszystkie głowy oddziału zostaną zamknięte, oddział to zrobi
uznać za zamknięte.
Zwraca 0 w przypadku powodzenia.
Opcje:
-F, --siła
ustaw nazwę gałęzi, nawet jeśli przesłania istniejącą gałąź
-DO, --czysty
zresetuj nazwę oddziału do nazwy oddziału nadrzędnego
gałęzie
lista repozytorium o nazwach oddziałów:
gałęzie hg [-c]
Wyświetl listę nazwanych gałęzi repozytorium, wskazując, które z nich są nieaktywne. Jeśli -c/--zamknięte
jest określony, należy także wyświetlić listę oddziałów, które zostały oznaczone jako zamknięte (patrz hg popełnić
--zamknięty oddział).
Użyj polecenia hg aktualizacja aby przejść do istniejącego oddziału.
Zwraca 0.
Opcje:
-za, --aktywny
pokaż tylko gałęzie, które mają niepołączone głowy (przestarzałe)
-C, --Zamknięte
pokaż gałęzie normalne i zamknięte
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
zapakować
utwórz plik grupy zmian:
hg pakiet [-f] [-t TYP] [-a] [-r WER]... [--podstawowy WER]... PLIK [CEL]
Wygeneruj plik grupy zmian zawierający zestawy zmian, które mają zostać dodane do repozytorium.
Aby utworzyć pakiet zawierający wszystkie zestawy zmian, użyj -a/--all (lub --base null). W przeciwnym razie hg
zakłada, że miejsce docelowe będzie miało wszystkie węzły określone za pomocą parametrów --base.
W przeciwnym razie hg założy, że repozytorium ma wszystkie węzły w miejscu docelowym, lub
default-push/default, jeśli nie określono miejsca docelowego.
Możesz zmienić format pakietu za pomocą opcji -t/--type. Można określić kompresję, a
wersję pakietu lub obie, używając myślnika (wersja-komp). Dostępne metody kompresji to:
none, bzip2 i gzip (domyślnie pakiety są kompresowane przy użyciu bzip2). Dostępne
formaty to: v1, v2 (domyślnie najbardziej odpowiedni).
Plik pakietu można następnie przenieść w konwencjonalny sposób i zastosować do innego
repozytorium za pomocą polecenia unbundle lub pull. Jest to przydatne w przypadku bezpośredniego pchania i ciągnięcia
niedostępne lub gdy eksport całego repozytorium jest niepożądany.
Zastosowanie pakietów zachowuje całą zawartość zestawu zmian, w tym uprawnienia, kopiowanie/zmianę nazwy
informacje i historię zmian.
Zwraca 0 w przypadku powodzenia, 1 w przypadku braku zmian.
Opcje:
-F, --siła
uruchamiaj, nawet jeśli miejsce docelowe nie jest powiązane
-R,--obrót silnika
zestaw zmian przeznaczony do dodania do miejsca docelowego
-B,--Oddział
konkretną gałąź, którą chcesz spakować
--baza
zakłada się, że podstawowy zestaw zmian jest dostępny w miejscu docelowym
-za, --wszystko
spakuj wszystkie zestawy zmian w repozytorium
-T,--rodzaj
typ kompresji pakietu, którego należy użyć (domyślnie: bzip2)
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
jak
wyprowadź bieżącą lub podaną wersję plików:
hg cat [OPCJA]... PLIK...
Wydrukuj określone pliki w takiej postaci, w jakiej były w danej wersji. Jeżeli nie zostanie podana żadna rewizja,
używany jest katalog nadrzędny katalogu roboczego.
Dane wyjściowe mogą być kierowane do pliku, w którym to przypadku nazwa pliku jest podawana w formacie
strunowy. Zasady formatowania są następujące:
%%
dosłowny znak „%”.
%s
nazwa bazowa drukowanego pliku
%d
nazwa katalogu drukowanego pliku lub '.' jeśli w katalogu głównym repozytorium
%p
nazwa ścieżki względna dla katalogu głównego drukowanego pliku
%H
skrót zestawu zmian (40 cyfr szesnastkowych)
%R
numer wersji zestawu zmian
%h
skrót skrótu zestawu zmian (12 cyfr szesnastkowych)
%r
numer wersji zestawu zmian uzupełniony zerami
%b
nazwa bazowa repozytorium eksportującego
Zwraca 0 w przypadku powodzenia.
Opcje:
-o,--wyjście
wydrukuj dane wyjściowe do pliku ze sformatowaną nazwą
-R,--obrót silnika
wydrukuj podaną wersję
--rozszyfrować
zastosuj dowolny pasujący filtr dekodowania
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
klonować
wykonaj kopię istniejącego repozytorium:
hg clone [OPCJA]... ŹRÓDŁO [CEL]
Utwórz kopię istniejącego repozytorium w nowym katalogu.
Jeśli nie określono nazwy katalogu docelowego, domyślnie jest to nazwa bazowa źródła.
Lokalizacja źródła zostanie dodana do nowego repozytorium .hg/hgrc plik, jako domyślny
do wykorzystania w przyszłych ściągach.
Tylko ścieżki lokalne i ssh:// Adresy URL są obsługiwane jako miejsca docelowe. Dla ssh:// miejsca docelowe,
brak katalogu roboczego lub .hg/hgrc zostanie utworzony po stronie zdalnej.
Jeśli repozytorium źródłowe ma ustawioną zakładkę o nazwie „@”, ta wersja zostanie pobrana
domyślnie w nowym repozytorium.
Aby sprawdzić konkretną wersję, użyj -u/--update lub -U/--noupdate, aby utworzyć klon
bez katalogu roboczego.
Aby pobrać tylko podzbiór zestawów zmian, określ jeden lub więcej identyfikatorów wersji za pomocą
-r/--rev lub gałęzie z -b/--branch. Powstały klon będzie zawierał tylko określone
zestawy zmian i ich przodkowie. Te opcje (lub „clone src#rev dest”) oznaczają --pull, nawet
dla lokalnych repozytoriów źródłowych.
Uwaga Określenie znacznika uwzględni oznaczony zestaw zmian, ale nie zawierający go zestaw zmian
metka.
Aby zapewnić wydajność, do klonowania używane są twarde łącza, gdy włączone jest źródło i miejsce docelowe
ten sam system plików (pamiętaj, że dotyczy to tylko danych repozytorium, a nie roboczego
informator). Niektóre systemy plików, takie jak AFS, nieprawidłowo implementują dowiązanie twarde, ale tego nie robią
zgłaszać błędy. W takich przypadkach użyj opcji --pull, aby uniknąć twardego dowiązania.
W niektórych przypadkach można klonować repozytoria i katalog roboczy przy użyciu pełnych twardych dowiązań
w
$ cp -al REPOCLONE REPO
Jest to najszybszy sposób klonowania, ale nie zawsze jest bezpieczny. Operacja nie jest atomowa
(upewnienie się, że REPO nie zostanie zmodyfikowane podczas operacji, zależy od Ciebie) i musisz to zrobić
upewnij się, że twój edytor łamie twarde linki (tak robi Emacs i większość narzędzi jądra Linuksa). To także jest
nie jest kompatybilny z niektórymi rozszerzeniami, które umieszczają swoje metadane w katalogu .hg,
takie jak mkw.
Mercurial zaktualizuje katalog roboczy do pierwszej obowiązującej wersji z tego
lista:
A. null jeśli -U lub repozytorium źródłowe nie ma żadnych zestawów zmian
B. Jeśli ty . a repozytorium źródłowe jest lokalne i stanowi pierwszy element nadrzędny repozytorium źródłowego
katalog roboczy
C. zestaw zmian określony za pomocą -u (jeśli nazwa gałęzi, oznacza to jej najnowszy początek
gałąź)
D. zestaw zmian określony za pomocą -r
mi. najbardziej wysunięta głowa określona przez -b
F. najbardziej wysunięta głowa określona w składni źródła url#branch
G. wersja oznaczona zakładką „@”, jeśli występuje
H. najbardziej wysunięta głowa domyślnej gałęzi
I. wskazówka
Podczas klonowania z serwerów, które to obsługują, Mercurial może pobrać wstępnie wygenerowane dane z:
URL reklamowany przez serwer. Gdy to nastąpi, haki działające na przychodzących zestawach zmian i
Changegroups może uruchomić się dwukrotnie, raz dla pakietu pobranego z adresu URL i drugi dla dowolnego
dodatkowe dane, które nie zostały pobrane z tego adresu URL. Ponadto, jeśli wystąpi błąd, repozytorium
można przywrócić do częściowego klonu. To zachowanie może ulec zmianie w przyszłych wersjach. Widzieć hg
pomoc -e pakiety klonów więcej.
Przykłady:
· sklonuj zdalne repozytorium do nowego katalogu o nazwie hg/:
hg klon http://selenic.com/hg
· utwórz lekki klon lokalny:
projekt klonowania hg/funkcja projektu/
· klonuj ze ścieżki bezwzględnej na serwerze ssh (zwróć uwagę na podwójny ukośnik):
hg klon ssh://użytkownik@serwer//home/projects/alpha/
· wykonaj szybkie klonowanie przez sieć LAN, sprawdzając określoną wersję:
hg clone – nieskompresowany http://server/repo -u 1.5
· utwórz repozytorium bez zestawów zmian po określonej wersji:
hg clone -r 04e544 eksperymentalny/dobry/
· sklonuj (i śledź) konkretną nazwaną gałąź:
hg klon http://selenic.com/hg#stabilny
See hg pomoc urls aby uzyskać szczegółowe informacje na temat określania adresów URL.
Zwraca 0 w przypadku powodzenia.
Opcje:
-Ty, --brak aktualizacji
klon będzie zawierał pusty katalog roboczy (tylko repozytorium)
-ty,--aktualizacja
wersja, znacznik lub gałąź do wyewidencjonowania
-R,--obrót silnika
uwzględnij określony zestaw zmian
-B,--Oddział
sklonuj tylko określoną gałąź
--ciągnąć użyj protokołu pull do kopiowania metadanych
--nieskompresowany
użyj nieskompresowanego transferu (szybkiego przez LAN)
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
popełnić
zatwierdź określone pliki lub wszystkie zaległe zmiany:
hg commit [OPCJA]... [PLIK]...
Zatwierdź zmiany w podanych plikach w repozytorium. W przeciwieństwie do scentralizowanego SCM, to
operacja jest operacją lokalną. Widzieć hg naciskać aby aktywnie rozpowszechniać zmiany.
W przypadku pominięcia listy plików wszystkie zmiany zgłaszane przez hg status zostanie popełnione.
Jeśli zatwierdzasz wynik scalania, nie podawaj żadnych nazw plików ani opcji -I/-X
filtry.
Jeśli nie określono żadnego komunikatu zatwierdzenia, Mercurial uruchomi skonfigurowany edytor, gdzie tylko jest to możliwe
wpisz wiadomość. Jeśli zatwierdzenie nie powiedzie się, kopię zapasową wiadomości znajdziesz w pliku
.hg/ostatnia wiadomość.txt.
Flagi --close-branch można użyć do oznaczenia aktualnej głowicy gałęzi jako zamkniętej. Kiedy wszystkie głowy
oddziału są zamknięte, oddział zostanie uznany za zamknięty i nie będzie już wymieniony.
Flagi --amend można użyć do zmiany katalogu nadrzędnego katalogu roboczego na nowy
commit, który zawiera zmiany w elemencie nadrzędnym oprócz tych aktualnie raportowanych przez
hg status, Jeśli znajdują się jakiekolwiek. Stare zatwierdzenie jest przechowywane w pakiecie kopii zapasowych w
.hg/strip-backup (Patrz hg pomoc zapakować i hg pomoc rozpakować jak go przywrócić).
Wiadomość, użytkownik i data są pobierane ze zmienionego zatwierdzenia, chyba że określono inaczej. Kiedy wiadomość
nie jest określony w wierszu poleceń, edytor otworzy się z komunikatem o poprawieniu
popełnić.
Nie ma możliwości zmiany publicznych zestawów zmian (patrz hg pomoc fazy) lub zestawy zmian, które mają
dzieci.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Zwraca 0 w przypadku powodzenia, 1, jeśli nic się nie zmieniło.
Przykłady:
· zatwierdź wszystkie pliki kończące się na .py:
hg commit --include „set:**.py”
· zatwierdzaj wszystkie pliki niebinarne:
hg commit --exclude "set:binary()"
· zmień bieżące zatwierdzenie i ustaw datę na teraz:
hg commit --amend --date teraz
Opcje:
-DO, --Dodaj usuń
oznacz nowe/brakujące pliki jako dodane/usunięte przed zatwierdzeniem
--zamknięty oddział
oznaczyć główkę gałęzi jako zamkniętą
--poprawiać
zmień rodzica katalogu roboczego
-tak, --sekret
użyj tajnej fazy do zatwierdzenia
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-ja, --interaktywny
użyj trybu interaktywnego
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
pseudonimy: ci
config
pokaż połączone ustawienia konfiguracyjne ze wszystkich plików hgrc:
hg konfiguracja [-u] [NAZWA]...
Bez argumentów wypisz nazwy i wartości wszystkich elementów konfiguracji.
Przy jednym argumencie formularza nazwa sekcji. wypisz tylko wartość tego elementu konfiguracji.
W przypadku wielu argumentów wypisz nazwy i wartości wszystkich elementów konfiguracji z pasującą sekcją
nazwy.
Za pomocą --edit uruchom edytor pliku konfiguracyjnego na poziomie użytkownika. Za pomocą --global edytuj plik
ogólnosystemowy plik konfiguracyjny. Za pomocą opcji --local edytuj plik konfiguracyjny na poziomie repozytorium.
Opcja --debug powoduje wypisanie źródła (nazwy pliku i numeru linii) dla każdego elementu konfiguracji.
See hg pomoc config aby uzyskać więcej informacji na temat plików konfiguracyjnych.
Zwraca 0 w przypadku powodzenia, 1 jeśli NAZWA nie istnieje.
Opcje:
-ty, --niezaufany
pokaż niezaufane opcje konfiguracji
-mi, --edytować
edytuj konfigurację użytkownika
-ja, --lokalny
edytuj konfigurację repozytorium
-G, --światowy
edytuj konfigurację globalną
aliasy: showconfig debugconfig
kopia
zaznacz pliki jako skopiowane do następnego zatwierdzenia:
hg copy [OPCJA]... [ŹRÓDŁO]... CEL
Oznacz miejsce docelowe jako zawierające kopie plików źródłowych. Jeśli dest jest katalogiem, kopie są w nim umieszczane
informator. Jeśli dest jest plikiem, źródłem musi być pojedynczy plik.
Domyślnie to polecenie kopiuje zawartość plików istniejącą w środowisku roboczym
informator. Jeśli zostanie wywołana z -A/--after, operacja zostanie zarejestrowana, ale nie będzie kopiowania
wykonane.
To polecenie zaczyna obowiązywać od następnego zatwierdzenia. Aby cofnąć wcześniejszą kopię, zobacz hg przywrócić.
Zwraca 0 w przypadku powodzenia, 1 w przypadku napotkania błędów.
Opcje:
-DO, --po
zapisz kopię, która już miała miejsce
-F, --siła
wymusić skopiowanie istniejącego pliku zarządzanego
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: kp
diff
repozytorium diff (lub wybrane pliki):
hg diff [OPCJA]... ([-c REV] | [-r REV1 [-r REV2]]) [PLIK]...
Pokaż różnice pomiędzy wersjami określonych plików.
Różnice między plikami są pokazane przy użyciu ujednoliconego formatu różnic.
Note hg diff może generować nieoczekiwane wyniki w przypadku scalania, ponieważ domyślnie będzie porównywane
względem pierwszego nadrzędnego zestawu zmian katalogu roboczego, jeśli nie ma żadnych wersji
określony.
Jeśli podane są dwa argumenty wersji, pokazane zostaną zmiany pomiędzy tymi wersjami. Jeśli
określona jest tylko jedna wersja, następnie ta wersja jest porównywana z katalogiem roboczym,
i jeśli nie określono żadnych wersji, pliki katalogu roboczego są porównywane z jego plikami
pierwszy rodzic.
Alternatywnie możesz podać -c/--change z wersją, aby zobaczyć zmiany w niej
zestaw zmian w stosunku do swojego pierwszego rodzica.
Bez opcji -a/--text diff będzie unikać generowania różnic plików, które wykryje
dwójkowy. Z opcją -a diff i tak wygeneruje różnicę, prawdopodobnie z niepożądanymi wynikami.
Użyj opcji -g/--git, aby wygenerować różnice w rozszerzonym formacie różnic git. Aby uzyskać więcej
informacje, przeczytaj hg pomoc różnice.
Przykłady:
· porównaj plik w bieżącym katalogu roboczym z jego rodzicem:
hg diff foo.c
· porównaj dwie historyczne wersje katalogu z informacją o zmianie nazwy:
hg diff --git -r 1.0:1.2 lib/
· uzyskać statystyki zmian w stosunku do ostatniej zmiany w określonym dniu:
hg diff --stat -r "data('2 maja')"
· różnicuj wszystkie nowo dodane pliki zawierające słowo kluczowe:
hg diff „zestaw: dodano () i grep (GNU)”
· porównaj wersję i jej rodziców:
hg diff -c 9353 # porównaj z pierwszym rodzicem
hg diff -r 9353^:9353 # to samo przy użyciu składni revset
hg diff -r 9353^2:9353 # porównaj z drugim rodzicem
Zwraca 0 w przypadku powodzenia.
Opcje:
-R,--obrót silnika
rewizja
-C,--zmiana
zmiana dokonana poprzez rewizję
-za, --tekst
traktuj wszystkie pliki jako tekst
-G, --git
użyj rozszerzonego formatu różnic git
--nodaty
pomijaj daty w nagłówkach różnic
--noprzedrostek
pomijaj przedrostki a/ i b/ w nazwach plików
-P, --pokaż-funkcję
pokaż, w której funkcji znajduje się każda zmiana
--odwrócić
wygeneruj różnicę, która cofa zmiany
-w, --ignoruj całą przestrzeń
ignoruj białe znaki podczas porównywania linii
-B, --ignoruj-zmianę-spacji
zignoruj zmiany w ilości spacji
-B, --ignoruj puste linie
ignoruj zmiany, których wiersze są puste
-Ty,--ujednolicony
liczba wierszy kontekstu do pokazania
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
--źródło
generuje różnice w stosunku do podkatalogu
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
eksport
zrzuć nagłówek i różnice dla jednego lub więcej zestawów zmian:
hg eksport [OPCJA]... [-o SPECYFIKACJA PLIKU] [-r] [REW]...
Wydrukuj nagłówek zestawu zmian i różnice dla jednej lub więcej wersji. Jeżeli nie zostanie podana rewizja,
używany jest katalog nadrzędny katalogu roboczego.
Informacje pokazane w nagłówku zestawu zmian to: autor, data, nazwa gałęzi (jeśli
inne niż domyślne), skrót zestawu zmian, elementy nadrzędne i komentarz zatwierdzenia.
Note hg eksport może wygenerować nieoczekiwane wyjście różnicowe dla scalonych zestawów zmian, tak jak to się stanie
porównaj zestaw zmian scalania tylko z jego pierwszym rodzicem.
Dane wyjściowe mogą być kierowane do pliku, w którym to przypadku nazwa pliku jest podawana w formacie
strunowy. Zasady formatowania są następujące:
%%
dosłowny znak „%”.
%H
skrót zestawu zmian (40 cyfr szesnastkowych)
%N
liczba generowanych poprawek
%R
numer wersji zestawu zmian
%b
nazwa bazowa repozytorium eksportującego
%h
skrót skrótu zestawu zmian (12 cyfr szesnastkowych)
%m
pierwsza linia komunikatu zatwierdzenia (tylko znaki alfanumeryczne)
%n
numer kolejny dopełniony zerami, zaczynający się od 1
%r
numer wersji zestawu zmian uzupełniony zerami
Bez opcji -a/--text eksport uniknie generowania różnic między plikami, które wykryje
dwójkowy. W przypadku opcji -a eksport i tak wygeneruje różnicę, prawdopodobnie z niepożądanymi wynikami.
Użyj opcji -g/--git, aby wygenerować różnice w rozszerzonym formacie różnic git. Widzieć hg pomoc
różnice po więcej informacji.
W przypadku opcji --switch-parent różnica będzie skierowana przeciwko drugiemu rodzicowi. To może być
przydatne do przeglądu scalania.
Przykłady:
· użyj eksportu i importu, aby przeszczepić poprawkę do bieżącej gałęzi:
hg eksport -r 9353 | hg import -
· wyeksportuj wszystkie zestawy zmian pomiędzy dwiema wersjami do pliku z informacją o zmianie nazwy:
hg eksport --git -r 123:150 > zmiany.txt
· podzielić wychodzące zmiany na serię poprawek o opisowych nazwach:
hg eksport -r "wychodzące()" -o "%n-%m.patch"
Zwraca 0 w przypadku powodzenia.
Opcje:
-o,--wyjście
wydrukuj dane wyjściowe do pliku ze sformatowaną nazwą
--przełącz-rodzica
diff w stosunku do drugiego rodzica
-R,--obrót silnika
poprawki do eksportu
-za, --tekst
traktuj wszystkie pliki jako tekst
-G, --git
użyj rozszerzonego formatu różnic git
--nodaty
pomijaj daty w nagłówkach różnic
Opcja zaznaczona [+] może być określona wielokrotnie
pliki
lista śledzonych plików:
hg [OPCJA]... [WZÓR]...
Drukuj pliki pod kontrolą Mercurial w katalogu roboczym lub określonej wersji, której
nazwy odpowiadają podanym wzorcom (z wyłączeniem usuniętych plików).
Jeśli nie podano pasujących wzorców, polecenie to wypisuje nazwy wszystkich plików
Kontrola Mercurial w katalogu roboczym.
Przykłady:
· lista wszystkich plików w bieżącym katalogu:
pliki hg.
· pokazuje rozmiary i flagi dla aktualnej wersji:
hg pliki -vr .
· lista wszystkich plików o nazwie README:
hg pliki -I „**/README”
· lista wszystkich plików binarnych:
hg pliki „set:binary()”
· znajdź pliki zawierające wyrażenie regularne:
hg pliki „set:grep('bob')”
· przeszukaj zawartość śledzonego pliku za pomocą xargs i grep:
pliki hg -0 | xargs -0 grep foo
See hg pomoc wzory i hg pomoc zestawy plików aby uzyskać więcej informacji na temat określania pliku
wzorce.
Zwraca 0, jeśli znaleziono dopasowanie, 1 w przeciwnym razie.
Opcje:
-R,--obrót silnika
przeszukaj repozytorium tak, jak jest w wersji REV
-0, --drukuj0
zakończ nazwy plików wartością NUL, do użycia z xargs
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
zapomnieć
zapomnij o określonych plikach przy następnym zatwierdzeniu:
hg zapomnij [OPCJA]... PLIK...
Zaznacz określone pliki, aby nie były już śledzone po następnym zatwierdzeniu.
Spowoduje to usunięcie plików tylko z bieżącej gałęzi, a nie z całej historii projektu
nie usuwa ich z katalogu roboczego.
Aby usunąć plik z katalogu roboczego, zobacz hg usunąć.
Aby cofnąć zapomnienie przed następnym zatwierdzeniem, zobacz hg Dodaj.
Przykłady:
· zapomnij o nowo dodanych plikach binarnych:
hg zapomnij o „set:added() i binary()”
· zapomnij o plikach, które zostałyby wykluczone przez .hgignore:
hg zapomnij o „set:hgignore()”
Zwraca 0 w przypadku powodzenia.
Opcje:
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
zaszczepić
skopiuj zmiany z innych gałęzi do bieżącej gałęzi:
hg przeszczep [OPCJA]... [-r WER]... WER...
To polecenie wykorzystuje logikę scalania Mercurial do kopiowania poszczególnych zmian z innych gałęzi
bez łączenia gałęzi na wykresie historii. Nazywa się to czasami „backportowaniem” lub
'zbieranie wiśni'. Domyślnie przeszczep skopiuje użytkownika, datę i opis ze źródła
zestawy zmian.
Zestawy zmian, które są przodkami bieżącej wersji, które zostały już przeszczepione, lub
które są połączeniami, zostaną pominięte.
Jeśli określono --log, do komunikatów dziennika będzie dołączony komentarz w postaci:
(przeszczepiony z CHANGESETHASH)
Jeśli określono --force, wersje zostaną przeszczepione, nawet jeśli są już przodkami
lub zostały zaszczepione do miejsca przeznaczenia. Jest to przydatne, gdy zmiany zostały już wprowadzone
został wycofany.
Jeśli połączenie przeszczepów powoduje konflikty, proces przeszczepu zostaje przerwany, tak że
bieżące scalanie można rozwiązać ręcznie. Po rozwiązaniu wszystkich konfliktów następuje przeszczep
proces można kontynuować za pomocą opcji -c/--continue.
Uwaga Opcja -c/--continue nie powoduje ponownego zastosowania wcześniejszych opcji, z wyjątkiem opcji --force.
Przykłady:
· skopiuj pojedynczą zmianę do gałęzi stabilnej i edytuj jej opis:
hg aktualizacja stabilna
hg przeszczep – edycja 9393
· przeszczepić szereg zestawów zmian z jednym wyjątkiem, aktualizacja dat:
hg przeszczep -D "2085::2093, a nie 2091"
· kontynuować przeszczep po rozwiązaniu konfliktów:
hg przeszczep -c
· pokaż źródło przeszczepionego zestawu zmian:
hg log --debug -r.
· pokaż wersje posortowane według daty:
hg log -r 'sort(wszystko(), data)'
See hg pomoc rewizje i hg pomoc resetuje aby uzyskać więcej informacji na temat określania wersji.
Zwraca 0 po pomyślnym zakończeniu.
Opcje:
-R,--obrót silnika
poprawki do przeszczepu
-C, --kontyntynuj
wznowić przerwany przeszczep
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
--Dziennik dołącz informacje o przeszczepie do wiadomości dziennika
-F, --siła
przeszczep na siłę
-D, --bieżąca data
zapisz bieżącą datę jako datę zatwierdzenia
-Ty, --aktualny użytkownik
zapisz bieżącego użytkownika jako osobę zatwierdzającą
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
-T,--narzędzie
określ narzędzie scalania
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
Opcja zaznaczona [+] może być określona wielokrotnie
grep
wyszukaj wzór w określonych plikach i wersjach:
hg grep [OPCJA]... WZÓR [PLIK]...
Wyszukaj wersje plików pod kątem wyrażenia regularnego.
To polecenie zachowuje się inaczej niż uniksowe grep. Akceptuje tylko wyrażenia regularne Python/Perl. To
przeszukuje historię repozytorium, a nie katalog roboczy. Zawsze drukuje wersję
liczba, w której pojawia się dopasowanie.
Domyślnie grep wypisuje dane wyjściowe tylko dla pierwszej wersji pliku, w którym znajdzie plik a
mecz. Aby drukował każdą wersję zawierającą zmianę w statusie dopasowania („-” dla a
dopasowanie, które staje się dopasowaniem, lub „+” w przypadku braku dopasowania, które staje się dopasowaniem), użyj
--wszystkie flagi.
Zwraca 0, jeśli znaleziono dopasowanie, 1 w przeciwnym razie.
Opcje:
-0, --drukuj0
zakończ pola wartością NUL
--wszystko wydrukuj wszystkie pasujące wersje
-za, --tekst
traktuj wszystkie pliki jako tekst
-F, --śledzić
śledź historię zestawu zmian lub historię plików w kopiach i zmianach nazw
-ja, --ignoruj-przypadek
ignoruj wielkość liter podczas dopasowywania
-ja, --pliki-z-dopasowaniami
drukuj tylko pasujące nazwy plików i wersje
-N, --numer linii
wydrukuj pasujące numery linii
-R,--obrót silnika
wyszukiwać tylko pliki zmienione w zakresie wersji
-ty, --użytkownik
wymień autora (długie z -v)
-D, --Data
podaj datę (krótko z -q)
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
głowice
pokaż głowy oddziałów:
hg głowy [-ct] [-r STARTREV] [REV]...
Bez argumentów pokaż wszystkie otwarte nagłówki oddziałów w repozytorium. Szefowie oddziałów są
zestawy zmian, które nie mają potomków w tej samej gałęzi. Są tam, gdzie rozwój
zazwyczaj ma miejsce i są zwykłymi celami operacji aktualizacji i scalania.
Jeśli podano jeden lub więcej REV, otwieraj tylko główki odgałęzień na odgałęzieniach powiązanych z
pokazane zostaną określone zestawy zmian. Oznacza to, że możesz używać hg głowice . żeby zobaczyć głowy
aktualnie sprawdzany oddział.
Jeśli podano -c/--closed, pokaż także główki odgałęzień oznaczone jako zamknięte (zobacz hg popełnić
--zamknięty oddział).
Jeśli określono STARTREV, będą to tylko te głowy, które są potomkami STARTREV
wystawiany.
Jeśli podano -t/--topo, nazwana mechanika gałęzi zostanie zignorowana i będzie tylko topologiczna
głowy (zestawy zmian bez dzieci) zostaną pokazane.
Zwraca 0, jeśli znaleziono pasujące głowy, 1, jeśli nie.
Opcje:
-R,--obrót silnika
pokaż tylko głowy, które są potomkami STARTREV
-T, --topo
pokaż tylko głowy topologiczne
-za, --aktywny
pokaż tylko aktywne rozgałęzienia (przestarzałe)
-C, --Zamknięte
pokaż normalne i zamknięte główki gałęzi
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
pomoc
pokaż pomoc na dany temat lub przegląd pomocy:
hg pomoc [-ecks] [TEMAT]
Bez argumentów wypisz listę poleceń z krótkimi komunikatami pomocy.
Po podaniu tematu, rozszerzenia lub nazwy polecenia wydrukuj pomoc dotyczącą tego tematu.
Zwraca 0, jeśli się powiedzie.
Opcje:
-mi, --rozbudowa
pokaż tylko pomoc dla rozszerzeń
-C, --Komenda
pokaż tylko pomoc dla poleceń
-k, --słowo kluczowe
pokaż tematy pasujące do słowa kluczowego
-tak,--system
pokaż pomoc dla określonych platform
Opcja zaznaczona [+] może być określona wielokrotnie
zidentyfikować
zidentyfikuj katalog roboczy lub określoną wersję:
hg identyfikacja [-nibtB] [-r REV] [ŹRÓDŁO]
Wydrukuj podsumowanie identyfikujące stan repozytorium w REV, używając jednego lub dwóch skrótów nadrzędnych
identyfikatory, po którym następuje „+”, jeśli katalog roboczy zawiera niezatwierdzone zmiany, plik
nazwa oddziału (jeśli nie jest domyślna), lista tagów i lista zakładek.
Jeżeli nie podano REV, wydrukuj podsumowanie bieżącego stanu repozytorium.
Określenie ścieżki do katalogu głównego repozytorium lub pakietu Mercurial spowoduje uruchomienie wyszukiwania
to repozytorium/pakiet.
Przykłady:
· wygeneruj identyfikator kompilacji dla katalogu roboczego:
hg id --id > id-kompilacji.dat
· znajdź wersję odpowiadającą tagowi:
hg id -n -r 1.3
· sprawdź najnowszą wersję zdalnego repozytorium:
hg id -r wskazówka http://selenic.com/hg/
See hg log do generowania większej ilości informacji na temat konkretnych wersji, w tym pełnego skrótu
identyfikatory.
Zwraca 0, jeśli się powiedzie.
Opcje:
-R,--obrót silnika
zidentyfikować określoną wersję
-N, --liczba
pokaż lokalny numer wersji
-ja, --NS
pokaż globalny identyfikator wersji
-B, --Oddział
pokaż oddział
-T, --tagi
Pokaż tagi
-B, --zakładki
pokaż zakładki
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
aliasy: id
importować
zaimportuj uporządkowany zestaw poprawek:
hg import [OPCJA]... PATCH...
Zaimportuj listę poprawek i zatwierdź je indywidualnie (chyba że określono opcję --no-commit).
Aby odczytać poprawkę ze standardowego wejścia, użyj „-” jako nazwy poprawki. Jeśli określono adres URL, plik
stamtąd zostanie pobrana łatka.
Import najpierw powoduje zastosowanie zmian w katalogu roboczym (chyba że określono opcję --bypass),
import zostanie przerwany, jeśli istnieją zaległe zmiany.
Użyj --bypass, aby zastosować i zatwierdzić poprawki bezpośrednio w repozytorium, bez wpływu na
katalog roboczy. Bez opcji --exact łatki zostaną nałożone na plik roboczy
wersja nadrzędna katalogu.
Możesz zaimportować łatkę bezpośrednio z wiadomości e-mail. Nawet łatki jako załączniki działają (do
użyj części ciała, musi ona mieć typ tekst/zwykły lub tekst/x-patch). Nagłówki Od i Temat
wiadomości e-mail jest używana jako domyślna osoba zatwierdzająca i wiadomość zatwierdzenia. Cały tekst/zwykła treść
części przed pierwszą różnicą są dodawane do komunikatu zatwierdzenia.
Jeśli zaimportowana poprawka została wygenerowana przez hg eksport, użytkownik i opis z zastąpienia poprawki
wartości z nagłówków i treści wiadomości. Wartości podane w wierszu poleceń z opcją -m/--message i
-u/--user zastępuje je.
Jeśli podano --exact, import ustawi katalog roboczy na katalog nadrzędny każdej łatki
przed jego zastosowaniem i zostanie przerwane, jeśli wynikowy zestaw zmian będzie miał inny identyfikator niż identyfikator
jeden nagrany w patchu. Może się to zdarzyć z powodu problemów z zestawem znaków lub innych
braki w formacie poprawki tekstowej.
Użyj --partial, aby mieć pewność, że zestaw zmian zostanie utworzony z łatki, nawet jeśli niektóre fragmenty zawiodą
aplikować. Kawałki, które nie zostaną zastosowane, zostaną zapisane do plik .rej. Konflikty
można następnie rozwiązać ręcznie wcześniej hg popełnić --poprawiać jest uruchamiany w celu aktualizacji utworzonego pliku
zestaw zmian. Ta flaga istnieje, aby umożliwić ludziom importowanie poprawek, które częściowo obowiązują bez niej
utratę powiązanych metadanych (autor, data, opis, ...).
Uwaga Jeśli nie ma kawałków, należy je nakładać czysto, hg importować --częściowy utworzy pusty zestaw zmian,
importowanie tylko metadanych poprawki.
Z -s/--similarity, hg będzie próbował odkryć zmiany nazw i kopie w łatce w pliku
tak samo jak hg Dodaj usuń.
Możliwe jest użycie zewnętrznych programów łatających do wykonania łatki poprzez ustawienie łatka interfejsu użytkownika
opcja konfiguracji. W przypadku domyślnego narzędzia wewnętrznego fuzz można również skonfigurować za pomocą
patch.fuzz. Zobaczyć hg pomoc config aby uzyskać więcej informacji na temat plików konfiguracyjnych i sposobu ich tworzenia
użyj tych opcji.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Przykłady:
· zaimportuj tradycyjną łatkę ze strony internetowej i wykryj zmiany nazw:
hg import -s 80 http://example.com/bugfix.patch
· zaimportuj zestaw zmian z serwera hgweb:
import hg http://www.selenic.com/hg/rev/5ca8c111e9aa
· zaimportuj wszystkie łatki do mboxa w stylu uniksowym:
hg importuj przychodzące-łatki.mbox
· spróbuj dokładnie przywrócić wyeksportowany zestaw zmian (nie zawsze jest to możliwe):
hg import --exact propozycja-poprawka.łatka
· użyj zewnętrznego narzędzia, aby zastosować łatkę, która jest zbyt rozmyta dla domyślnego narzędzia wewnętrznego.
hg import --config ui.patch="patch --merge" fuzzy.patch
· zmień domyślne fuzzing z 2 na mniej rygorystyczne 7
hg import --config ui.fuzz=7 fuzz.patch
Zwraca 0 w przypadku powodzenia, 1 w przypadku częściowego sukcesu (zobacz --partial).
Opcje:
-P,--rozebrać się
opcja paska katalogów dla łatki. Ma to takie samo znaczenie jak odpowiednik
opcja łatki (domyślnie: 1)
-B,--baza
ścieżka podstawowa (przestarzała)
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-F, --siła
pomiń sprawdzanie zaległych niezatwierdzonych zmian (przestarzałe)
--bez zobowiązań
nie zatwierdzaj, po prostu zaktualizuj katalog roboczy
--objazd
zastosuj łatkę bez dotykania katalogu roboczego
--częściowy
popełnij, nawet jeśli niektóre porcje zawiodą
--dokładny
zastosuj łatkę do węzłów, z których została wygenerowana
prefix
zastosuj poprawkę do podkatalogu
--import-oddział
użyj dowolnej informacji o gałęzi w łatce (co sugeruje --exact)
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
-tak,--podobieństwo
zgadnij nazwy plików o zmienionej nazwie według podobieństwa (0<=s<=100)
aliasy: patch
przychodzące
pokaż nowe zestawy zmian znalezione w źródle:
hg przychodzące [-p] [-n] [-M] [-f] [-r REV]... [--bundle NAZWA PLIKU] [ŹRÓDŁO]
Pokaż nowe zestawy zmian znalezione w określonej ścieżce/adresie URL lub w domyślnej lokalizacji pobierania. Te
to zestawy zmian, które zostałyby pobrane, gdyby zostało to pobrane w momencie wydania tego
dowództwo.
Zobacz pobieranie, aby uzyskać szczegółowe informacje na temat prawidłowego formatu źródłowego.
W przypadku -B/--bookmarks, wynik porównania zakładek pomiędzy lokalnymi i zdalnymi
wyświetlane są repozytoria. W przypadku opcji -v/--verbose wyświetlany jest także status każdej zakładki
jak poniżej:
Dodano BM1 01234567890a
BM2 1234567890ab zaawansowane
BM3 234567890abc rozbieżne
BM4 34567890abcd zmieniony
Akcja podejmowana lokalnie podczas przeciągania zależy od stanu każdej zakładki:
w dodatku
pull go utworzy
zaawansowany
pull zaktualizuje to
rozbieżne
pull utworzy rozbieżną zakładkę
zmieniony
wynik zależy od zdalnych zestawów zmian
Z punktu widzenia zachowania ciągnącego zakładka istniejąca tylko na pilocie
repozytorium są traktowane jako w dodatku, nawet jeśli w rzeczywistości jest on lokalnie usunięty.
W przypadku zdalnego repozytorium użycie --bundle pozwala uniknąć dwukrotnego pobierania zestawów zmian, jeśli
po wejściu następuje pociągnięcie.
Przykłady:
· pokaż nadchodzące zmiany wraz z poprawkami i pełnym opisem:
hg przychodzące -vp
· pokaż nadchodzące zmiany z wyłączeniem fuzji, przechowuj paczkę:
hg w -vpM --pakiet przychodzący.hg
hg pobierz przychodzące.hg
· krótka lista zmian wewnątrz pakietu:
hg w pliku zmian.hg -T "{desc|pierwsza linia}\n"
Zwraca 0, jeśli nadchodzą zmiany, 1 w przeciwnym razie.
Opcje:
-F, --siła
uruchom, nawet jeśli zdalne repozytorium nie jest powiązane
-N, --najnowsze-pierwsze
pokaż najpierw najnowszą płytę
--pakiet
plik, w którym będą przechowywane pakiety
-R,--obrót silnika
zdalny zestaw zmian, który ma zostać dodany
-B, --zakładki
porównaj zakładki
-B,--Oddział
konkretną gałąź, którą chcesz pociągnąć
-P, --łata
pokaż poprawkę
-G, --git
użyj rozszerzonego formatu różnic git
-ja,--limit
limit liczby wyświetlanych zmian
-M, --no-scalania
nie pokazuj połączeń
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
-G, --wykres
pokaż wersję DAG
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: w
startowych
utwórz nowe repozytorium w podanym katalogu:
hg init [-e CMD] [--remotecmd CMD] [DEST]
Zainicjuj nowe repozytorium w podanym katalogu. Jeżeli podany katalog nie istnieje,
zostanie stworzony.
Jeśli nie zostanie podany żaden katalog, używany będzie katalog bieżący.
Istnieje możliwość określenia ssh:// Adres URL jako miejsce docelowe. Widzieć hg pomoc urls więcej
informacje.
Zwraca 0 w przypadku powodzenia.
Opcje:
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
zlokalizować
zlokalizuj pliki pasujące do określonych wzorców (przestarzałe):
hg zlokalizować [OPCJA]... [WZÓR]...
Wydrukuj pliki pod kontrolą Mercurial w katalogu roboczym, których nazwy odpowiadają podanym
wzorce.
Domyślnie to polecenie przeszukuje wszystkie katalogi w katalogu roboczym. Aby po prostu wyszukać
bieżący katalog i jego podkatalogi, użyj „--include .”.
Jeśli nie podano pasujących wzorców, polecenie to wypisuje nazwy wszystkich plików
Kontrola Mercurial w katalogu roboczym.
Jeśli chcesz przekazać wynik tego polecenia do polecenia „xargs”, użyj opcji -0
zarówno do tego polecenia, jak i do „xargs”. Pozwoli to uniknąć problemu „xargs” traktowania pojedynczych
nazwy plików zawierające spacje jako wiele nazw plików.
See hg pomoc pliki dla bardziej wszechstronnego polecenia.
Zwraca 0, jeśli znaleziono dopasowanie, 1 w przeciwnym razie.
Opcje:
-R,--obrót silnika
przeszukaj repozytorium tak, jak jest w wersji REV
-0, --drukuj0
zakończ nazwy plików wartością NUL, do użycia z xargs
-F, --Pełna ścieżka
wypisz pełne ścieżki z katalogu głównego systemu plików
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
log
pokaż historię wersji całego repozytorium lub plików:
hg log [OPCJA]... [PLIK]
Wydrukuj historię wersji określonych plików lub całego projektu.
Jeśli nie określono żadnego zakresu wersji, wartością domyślną jest wskazówka: 0 chyba że ustawiono --follow, w którym
w przypadku, gdy katalog roboczy nadrzędny jest używany jako wersja początkowa.
Historia plików jest wyświetlana bez śledzenia historii zmiany nazwy lub kopiowania plików. Użyj -f/--follow
z nazwą pliku, aby śledzić historię zmian nazw i kopii. --follow bez nazwy pliku
pokaże tylko przodków i potomków wersji początkowej.
Domyślnie to polecenie drukuje numer wersji i identyfikator zestawu zmian, znaczniki, co nie jest trywialne
rodzice, użytkownik, data i godzina oraz podsumowanie każdego zatwierdzenia. Gdy przełącznik -v/--verbose
jest używany, wyświetlana jest lista zmienionych plików i komunikat o pełnym zatwierdzeniu.
Za pomocą opcji --graph wersje są wyświetlane jako grafika ASCII DAG z najnowszym zestawem zmian pod adresem
szczyt. „o” to zestaw zmian, „@” to katalog roboczy nadrzędny, „x” jest przestarzały, a „+”
reprezentuje rozwidlenie, w którym zestaw zmian z poniższych linii jest rodzicem połączenia „o”.
ta sama linia.
Note hg log --łata może wygenerować nieoczekiwane wyjście różnicowe dla scalonych zestawów zmian, tak jak to się stanie
porównuj tylko zestaw zmian scalania z jego pierwszym rodzicem. Poza tym tylko pliki
różni się od OBU rodziców, pojawią się w plikach:.
Uwaga Ze względu na wydajność hg log FILE może pominąć duplikaty zmian dokonanych w oddziałach
i nie będzie wyświetlać usunięć ani zmian trybu. Aby zobaczyć wszystkie takie zmiany, użyj przycisku
-usunięty przełącznik.
Kilka przykładów:
· zestawy zmian z pełnymi opisami i listami plików:
hg log -v
· zmienia ustawienia przodka na katalog roboczy:
hg log -f
· ostatnie 10 zatwierdzeń w bieżącej gałęzi:
hg log -l 10 -b .
· zestawy zmian pokazujące wszystkie modyfikacje pliku, w tym usunięcia:
hg log --usunięty plik.c
· wszystkie zestawy zmian, które dotykają katalogu, z różnicami, z wyłączeniem połączeń:
hg log -Mp lib/
· wszystkie numery wersji pasujące do słowa kluczowego:
hg log -k błąd --template "{rev}\n"
· pełny identyfikator skrótu nadrzędnego katalogu roboczego:
hg log -r. --template "{węzeł}\n"
· lista dostępnych szablonów logów:
hg log -T lista
· sprawdź, czy dany zestaw zmian jest zawarty w otagowanej wersji:
hg log -r "a21ccf i przodek (1.9)"
· znajdź wszystkie zestawy zmian jakiegoś użytkownika w zakresie dat:
hg log -k alice -d „od maja 2008 do lipca 2008”
· podsumowanie wszystkich zestawów zmian po ostatnim tagu:
hg log -r "last(tagged())::" --template "{desc|pierwsza linia}\n"
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
See hg pomoc rewizje i hg pomoc resetuje aby uzyskać więcej informacji na temat specyfikacji i zamawiania
poprawki.
See hg pomoc Szablony aby uzyskać więcej informacji na temat gotowych stylów i określania szablonów niestandardowych.
Zwraca 0 w przypadku powodzenia.
Opcje:
-F, --śledzić
śledź historię zestawu zmian lub historię plików w kopiach i zmianach nazw
--follow-first
podążaj tylko za pierwszym rodzicem zestawów zmian scalających (przestarzałe)
-D,--Data
pokaż wersje pasujące do specyfikacji daty
-DO, --kopie
pokaż skopiowane pliki
-k,--słowo kluczowe
wykonaj wyszukiwanie bez uwzględniania wielkości liter dla danego tekstu
-R,--obrót silnika
pokaż określoną wersję lub zmianę ustawień
--REMOVED
uwzględnij wersje, w których pliki zostały usunięte
-M, --tylko-scala
pokaż tylko połączenia (przestarzałe)
-ty,--użytkownik
poprawki wprowadzone przez użytkownika
--tylko-oddział
pokaż tylko zestawy zmian w podanej nazwanej gałęzi (przestarzałe)
-B,--Oddział
pokaż zestawy zmian w podanej nazwanej gałęzi
-P,--suszona śliwka
nie wyświetlaj wersji ani żadnego z jej przodków
-P, --łata
pokaż poprawkę
-G, --git
użyj rozszerzonego formatu różnic git
-ja,--limit
limit liczby wyświetlanych zmian
-M, --no-scalania
nie pokazuj połączeń
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
-G, --wykres
pokaż wersję DAG
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
pseudonimy: historia
manifestować
wyprowadź bieżącą lub daną wersję manifestu projektu:
hg manifest [-r REV]
Wydrukuj listę plików kontrolowanych przez wersję dla danej wersji. Jeżeli nie zostanie podana rewizja,
używany jest pierwszy element nadrzędny katalogu roboczego lub wersja zerowa, jeśli nie ma wersji
wyrejestrowany.
Z -v, drukuj uprawnienia do plików, dowiązania symboliczne i bity wykonywalne. Z --debug wydrukuj plik
skróty wersji.
Jeśli określono opcję --all, drukowana jest lista wszystkich plików ze wszystkich wersji. Ten
obejmuje usunięte pliki i zmienione nazwy.
Zwraca 0 w przypadku powodzenia.
Opcje:
-R,--obrót silnika
wersja do wyświetlenia
--wszystko wyświetla listę plików ze wszystkich wersji
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
łączyć
połącz kolejną wersję z katalogiem roboczym:
hg merge [-P] [[-r] WER]
Bieżący katalog roboczy jest aktualizowany o wszystkie zmiany wprowadzone w żądanej wersji
od ostatniej wspólnej wersji poprzedzającej.
Pliki, które uległy zmianie pomiędzy którymkolwiek z rodziców, są oznaczane jako zmienione przy następnym zatwierdzeniu i a
zatwierdzenie musi zostać wykonane, zanim możliwe będą dalsze aktualizacje repozytorium. The
następne zatwierdzenie będzie miało dwóch rodziców.
--narzędzie można użyć do określenia narzędzia scalania używanego do łączenia plików. Zastępuje
Zmienna środowiskowa HGMERGE i pliki konfiguracyjne. Widzieć hg pomoc narzędzia do łączenia dla
opcje.
Jeśli nie określono żadnej wersji, rodzicem katalogu roboczego jest wersja główna, a wersja
bieżąca gałąź zawiera dokładnie jedną inną głowę, z którą druga głowa jest domyślnie scalana.
W przeciwnym razie należy podać wyraźną wersję, z którą można się połączyć.
See hg pomoc rozwiązać aby uzyskać informacje na temat obsługi konfliktów plików.
Aby cofnąć niezatwierdzone scalanie, użyj hg aktualizacja --czysty . który sprawdzi czystą kopię
oryginalny element nadrzędny scalania, tracąc wszystkie zmiany.
Zwraca 0 w przypadku powodzenia, 1 w przypadku nierozwiązanych plików.
Opcje:
-F, --siła
wymusić połączenie, łącznie z zaległymi zmianami (przestarzałe)
-R,--obrót silnika
wersja do połączenia
-P, --zapowiedź
przejrzyj wersje, aby je scalić (nie jest wykonywane żadne scalanie)
-T,--narzędzie
określ narzędzie scalania
towarzyski
pokaż zestawy zmian, których nie znaleziono w miejscu docelowym:
hg wychodzące [-M] [-p] [-n] [-f] [-r REV]... [DEST]
Pokaż zestawy zmian, których nie znaleziono w określonym repozytorium docelowym lub w domyślnym pushie
Lokalizacja. Są to zestawy zmian, które zostałyby wypchnięte, gdyby zażądano wypchnięcia.
Zobacz pull, aby uzyskać szczegółowe informacje na temat prawidłowych formatów docelowych.
W przypadku -B/--bookmarks, wynik porównania zakładek pomiędzy lokalnymi i zdalnymi
wyświetlane są repozytoria. W przypadku opcji -v/--verbose wyświetlany jest także status każdej zakładki
jak poniżej:
Dodano BM1 01234567890a
BM2 usunięty
BM3 234567890abc zaawansowane
BM4 34567890abcd rozbieżne
BM5 4567890abcde zmienione
Akcja podejmowana po naciśnięciu zależy od stanu każdej zakładki:
w dodatku
pchnij z -B go stworzy
usunięte
pchnij z -B usunie to
zaawansowany
push go zaktualizuje
rozbieżne
pchnij z -B zaktualizuje to
zmieniony
pchnij z -B zaktualizuje to
Z punktu widzenia zachowania push zakładki istnieją tylko na pilocie
repozytorium są traktowane jako usunięte, nawet jeśli w rzeczywistości jest dodawany zdalnie.
Zwraca 0, jeśli istnieją zmiany wychodzące, 1 w przeciwnym razie.
Opcje:
-F, --siła
uruchamiaj, nawet jeśli miejsce docelowe nie jest powiązane
-R,--obrót silnika
zestaw zmian, który ma zostać uwzględniony w miejscu docelowym
-N, --najnowsze-pierwsze
pokaż najpierw najnowszą płytę
-B, --zakładki
porównaj zakładki
-B,--Oddział
konkretną gałąź, którą chcesz wypchnąć
-P, --łata
pokaż poprawkę
-G, --git
użyj rozszerzonego formatu różnic git
-ja,--limit
limit liczby wyświetlanych zmian
-M, --no-scalania
nie pokazuj połączeń
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
-G, --wykres
pokaż wersję DAG
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: out
rodzice
pokaż rodziców katalogu roboczego lub wersji (przestarzałe):
hg rodzice [-r REV] [PLIK]
Wydrukuj wersje nadrzędne katalogu roboczego. Jeśli wersja zostanie podana poprzez -r/--rev, plik
zostanie wydrukowany element nadrzędny tej wersji. Jeśli podany jest argument plik, wersja w
którym plik był ostatnio zmieniany (przed rewizją katalogu roboczego lub argumentem do
--rev, jeśli podano) jest drukowane.
To polecenie jest równoważne z:
hg log -r "p1()+p2()" lub
hg log -r "p1(REV)+p2(REV)" lub
hg log -r "max(::p1() i plik(PLIK))+max(::p2() i plik(PLIK))" lub
hg log -r "max(::p1(REV) i plik(PLIK))+max(::p2(REV) i plik(PLIK))"
See hg streszczenie i hg pomoc resetuje aby uzyskać powiązane informacje.
Zwraca 0 w przypadku powodzenia.
Opcje:
-R,--obrót silnika
pokaż elementy nadrzędne określonej wersji
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
ścieżki
pokaż aliasy dla zdalnych repozytoriów:
ścieżki hg [NAZWA]
Pokaż definicję ścieżki symbolicznej NAZWA. Jeśli nie podano nazwy, pokaż definicję wszystkich
dostępne nazwy.
Opcja -q/--quiet blokuje wszystkie dane wyjściowe podczas wyszukiwania NAZWY i pokazuje tylko ścieżkę
nazwy podczas wymieniania wszystkich definicji.
Nazwy ścieżek są zdefiniowane w sekcji [ścieżki] pliku konfiguracyjnego oraz w
/etc/mercurial/hgrc. Jeśli zostanie uruchomiony w repozytorium, .hg/hgrc jest również używany.
Nazwy ścieżek domyślnym i domyślne-push mają szczególne znaczenie. Podczas wykonywania pchnięcia lub
pull, są one używane jako rezerwowe, jeśli nie określono lokalizacji w pliku
wiersz poleceń. Gdy domyślne-push jest ustawiony, będzie używany do push i domyślnym będzie użyty
do ciągnięcia; W przeciwnym razie domyślnym jest używany jako rezerwowy dla obu. Podczas klonowania repozytorium
źródło klonu jest zapisane jako domyślnym in .hg/hgrc.
Note domyślnym i domyślne-push dotyczy wszystkich przychodzących (np hg przychodzące) i wychodzące
(na przykład hg towarzyski, hg E-mail i hg zapakować) operacji.
See hg pomoc urls po więcej informacji.
Zwraca 0 w przypadku powodzenia.
Opcje:
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
faza
ustaw lub pokaż nazwę bieżącej fazy:
hg faza [-p|-d|-s] [-f] [-r] [REV...]
Bez argumentu pokaż nazwę fazy bieżących wersji.
Za pomocą opcji -p/--public, -d/--draft lub -s/--secret zmień wartość fazy
określone poprawki.
O ile nie określono opcji -f/--force, hg faza nie przeniesie zestawu zmian z niższej fazy do
faza wyższa. Fazy są uporządkowane w następujący sposób:
publiczne < wersja robocza < tajne
Zwraca 0 w przypadku powodzenia, 1, jeśli nie można zmienić niektórych faz.
(Aby uzyskać więcej informacji na temat koncepcji faz, zobacz hg pomoc fazy.)
Opcje:
-P, --publiczny
ustaw fazę zestawu zmian na publiczną
-D, --projekt
ustaw fazę zestawu zmian na wersję roboczą
-tak, --sekret
ustaw fazę zestawu zmian na tajną
-F, --siła
pozwalają na przesunięcie granicy do tyłu
-R,--obrót silnika
rewizja celu
Opcja zaznaczona [+] może być określona wielokrotnie
Ciągnąć
pobierz zmiany z określonego źródła:
hg pull [-u] [-f] [-r WER.]... [-e CMD] [--remotecmd CMD] [ŹRÓDŁO]
Wyciągnij zmiany ze zdalnego repozytorium do lokalnego.
Spowoduje to znalezienie wszystkich zmian w repozytorium pod określoną ścieżką lub adresem URL i dodanie ich do pliku
repozytorium lokalne (bieżące, chyba że podano -R). Domyślnie tak nie jest
zaktualizuj kopię projektu w katalogu roboczym.
Zastosowanie hg przychodzące jeśli chcesz zobaczyć, co zostałoby dodane przez pociągnięcie w tym momencie
wydał to polecenie. Jeśli następnie zdecydujesz się dodać te zmiany do repozytorium, powinieneś to zrobić
posługiwać się hg Ciągnąć -r X gdzie X to ostatni zestaw zmian wymieniony przez hg przychodzące.
Jeżeli pominięto SOURCE, użyta zostanie ścieżka domyślna. Widzieć hg pomoc urls więcej
informacje.
Zwraca 0 w przypadku powodzenia, 1, jeśli aktualizacja zawierała nierozwiązane pliki.
Opcje:
-ty, --aktualizacja
zaktualizuj do nowego nagłówka oddziału, jeśli pobrano zestawy zmian
-F, --siła
uruchamiaj nawet wtedy, gdy zdalne repozytorium nie jest powiązane
-R,--obrót silnika
zdalny zestaw zmian, który ma zostać dodany
-B,--zakładka
zakładka do pociągnięcia
-B,--Oddział
konkretną gałąź, którą chcesz pociągnąć
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
naciskać
wypchnij zmiany do określonego miejsca docelowego:
hg push [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]
Wypchnij zestawy zmian z lokalnego repozytorium do określonego miejsca docelowego.
Ta operacja jest symetryczna w stosunku do ciągnięcia: jest identyczna z ciągnięciem w miejscu docelowym
repozytorium z bieżącego.
Domyślnie push nie pozwala na tworzenie nowych głów w miejscu docelowym, ponieważ jest ich wiele
głowice sprawiłyby, że nie byłoby jasne, której głowicy użyć. W tej sytuacji zaleca się
pociągnij i połącz przed pchnięciem.
Użyj --new-branch, jeśli chcesz zezwolić Push na utworzenie nowej nazwanej gałęzi, która nie jest
obecny w miejscu docelowym. Dzięki temu możesz tylko utworzyć nową gałąź bez wymuszania
inne zmiany.
Uwaga Należy zachować szczególną ostrożność w przypadku opcji -f/--force, która spowoduje wypchnięcie wszystkiego nowego
głowy na wszystkich gałęziach, co prawie zawsze powoduje zamieszanie
współpracownicy.
Jeśli zostanie użyte -r/--rev, określona wersja i wszyscy jej przodkowie zostaną przeniesieni do
zdalne repozytorium.
Jeśli używana jest zakładka -B/--, określona wersja z zakładkami, jej przodkowie i plik
zakładka zostanie wypchnięta do zdalnego repozytorium.
Proszę zobaczyć hg pomoc urls aby poznać ważne szczegóły dot ssh:// Adresy URL. Jeśli DESTINATION to
pominięta, zostanie użyta ścieżka domyślna.
Zwraca 0, jeśli wypchnięcie się powiodło, 1, jeśli nie ma nic do wypchnięcia.
Opcje:
-F, --siła
pchnięcie siłą
-R,--obrót silnika
zestaw zmian, który ma zostać uwzględniony w miejscu docelowym
-B,--zakładka
zakładka do wypchnięcia
-B,--Oddział
konkretną gałąź, którą chcesz wypchnąć
--Nowa gałąź
pozwolić na wypchnięcie nowej gałęzi
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
wyzdrowieć
wycofaj przerwaną transakcję:
hg wyzdrowieć
Odzyskaj po przerwanym zatwierdzeniu lub ściągnięciu.
To polecenie próbuje naprawić status repozytorium po przerwanej operacji. Powinno
konieczne tylko wtedy, gdy Mercurial to zasugeruje.
Zwraca 0, jeśli się powiedzie, 1, jeśli nic do odzyskania lub sprawdzenia nie powiedzie się.
usunąć
usuń określone pliki przy następnym zatwierdzeniu:
hg usuń [OPCJA]... PLIK...
Zaplanuj usunięcie wskazanych plików z bieżącego oddziału.
To polecenie planuje usunięcie plików przy następnym zatwierdzeniu. Aby cofnąć usunięcie
wcześniej, zobacz hg przywrócić. Aby cofnąć dodane pliki, zobacz hg zapomnieć.
-A/--after może zostać użyte do usunięcia tylko plików, które zostały już usunięte, -f/--force może
można użyć do wymuszenia usunięcia, a -Af można użyć do usunięcia plików z następnej wersji
bez usuwania ich z katalogu roboczego.
W poniższej tabeli szczegółowo opisano zachowanie polecenia usuwania dla różnych stanów plików (kolumn) i
kombinacje opcji (wiersze). Stany plików to: Dodano [A], Wyczyszczono [C], Zmodyfikowano [M] i
Zaginiony [!] (jak podaje hg status). Dostępne akcje to Ostrzegaj, Usuń (z gałęzi) i
Usuń (z dysku):
┌──────────┬───┬────┬────┬───┐
│opcja/stan │ A │ C │ M │ ! │
├──────────┼───┼────┼─────────────
│brak │ W │ RD │ W │ R │
├──────────┼───┼────┼─────────────
│-f │ R │ RD │ RD │ R │
├──────────┼───┼────┼─────────────
│-A │ W │ W │ W │ R │
├──────────┼───┼────┼─────────────
│-Af │ R │ R │ R │ R │
└──────────┴───┴────┴────┴───┘
Note hg usunąć nigdy nie usuwa plików w stanie Dodano [A] z katalogu roboczego, nie
choćby --siła jest specyficzne.
Zwraca 0 w przypadku powodzenia, 1 w przypadku napotkania ostrzeżeń.
Opcje:
-DO, --po
usuwanie rekordów w przypadku brakujących plików
-F, --siła
usuń (i usuń) plik, nawet jeśli został dodany lub zmodyfikowany
-S, --podrepozytoria
wracaj do podrepozytoriów
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: rm
przemianować
zmienić nazwę plików; odpowiednik kopiuj + usuń:
hg zmień nazwę [OPCJA]... ŹRÓDŁO... CEL
Oznacz miejsce docelowe jako kopie źródeł; zaznacz źródła do usunięcia. Jeśli dest jest katalogiem, kopie
są umieszczone w tym katalogu. Jeśli dest jest plikiem, może istnieć tylko jedno źródło.
Domyślnie to polecenie kopiuje zawartość plików istniejącą w środowisku roboczym
informator. Jeśli zostanie wywołana z -A/--after, operacja zostanie zarejestrowana, ale nie będzie kopiowania
wykonane.
To polecenie zaczyna obowiązywać przy następnym zatwierdzeniu. Aby cofnąć wcześniejszą zmianę nazwy, zobacz hg przywrócić.
Zwraca 0 w przypadku powodzenia, 1 w przypadku napotkania błędów.
Opcje:
-DO, --po
zapisz zmianę nazwy, która już nastąpiła
-F, --siła
wymusić skopiowanie istniejącego pliku zarządzanego
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: przenieś mv
rozwiązać
ponów scalanie lub ustaw/wyświetl status scalania plików:
hg rozwiązać [OPCJA]... [PLIK]...
Połączenia z nierozwiązanymi konfliktami są często wynikiem nieinteraktywnego łączenia za pomocą
wewnętrzne:scal ustawienie konfiguracyjne lub narzędzie do scalania z wiersza poleceń, takie jak różnica3. Rozwiązanie
polecenie służy do zarządzania plikami objętymi scalaniem, po hg łączyć został uruchomiony i
zanim hg popełnić jest uruchamiany (tzn. katalog roboczy musi mieć dwóch rodziców). Widzieć hg pomoc
narzędzia do łączenia aby uzyskać informacje na temat konfigurowania narzędzi scalania.
Polecenie „Resolve” może być użyte w następujący sposób:
· hg rozwiązać [--narzędzie NARZĘDZIE] PLIK...: próba ponownego połączenia określonych plików, odrzucanie
wszelkie poprzednie próby scalania. Ponowne łączenie nie jest wykonywane dla plików już oznaczonych jako
rozwiązany. Używać --wszyscy/-a aby wybrać wszystkie nierozwiązane pliki. --narzędzie może być użyty do określenia
narzędzie scalania używane dla danych plików. Zastępuje zmienną środowiskową HGMERGE i
swoje pliki konfiguracyjne. Zawartość poprzedniego pliku jest zapisywana z rozszerzeniem .pochodzenie przyrostek.
· hg rozwiązać -m [PLIK]: zaznacz plik jako rozwiązany (np. po ręcznym
naprawiłem pliki). Domyślnie zaznaczane są wszystkie nierozwiązane pliki.
· hg rozwiązać -u [PLIK]...: zaznacz plik jako nierozwiązany. Domyślnie oznaczane jest, że wszystkie zostały rozwiązane
akta.
· hg rozwiązać -l: wyświetla listę plików, w których występowały lub nadal występują konflikty. Na drukowanej liście m.in. U =
nierozwiązane i R = rozwiązany.
Uwaga Mercurial nie pozwoli na zatwierdzenie plików z nierozwiązanymi konfliktami scalania. Musisz
posługiwać się hg rozwiązać -m ... zanim będziesz mógł zatwierdzić po kolidującym scalaniu.
Zwraca 0 w przypadku powodzenia, 1, jeśli próba rozwiązania dowolnego pliku zakończy się niepowodzeniem.
Opcje:
-za, --wszystko
wybierz wszystkie nierozwiązane pliki
-ja, --lista
wyświetla stan plików wymagających scalania
-M, --ocena
zaznacz pliki jako rozwiązane
-ty, --odznacz
zaznacz pliki jako nierozwiązane
-N, --brak statusu
ukryj prefiks stanu
-T,--narzędzie
określ narzędzie scalania
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
Opcja zaznaczona [+] może być określona wielokrotnie
przywrócić
przywróć pliki do stanu wyewidencjonowania:
hg revert [OPCJA]... [-r WER] [NAZWA]...
Uwaga Aby sprawdzić wcześniejsze wersje, należy użyć hg aktualizacja REV. Aby anulować
niezatwierdzone scalanie (i utrata zmian), użyj hg aktualizacja --czysty ..
Jeśli nie określono żadnej wersji, przywróć określoną zawartość plików lub katalogów
miał w katalogu nadrzędnym katalogu roboczego. Spowoduje to przywrócenie zawartości plików do formatu
niezmodyfikowany stan i anulowanie harmonogramu dodaje, usuwa, kopiuje i zmienia nazwę. Jeśli pracujący
katalog ma dwóch rodziców, należy jawnie określić wersję.
Używając opcji -r/--rev lub -d/--date, przywróć podane pliki lub katalogi do ich pierwotnego stanu.
stanowi, że obowiązuje konkretna rewizja. Ponieważ revert nie zmienia katalogu roboczego
rodzice, spowoduje to, że te pliki będą wyglądać na zmodyfikowane. Może to być pomocne w „wycofaniu się”
część lub całość wcześniejszej zmiany. Widzieć hg wycofać się dla powiązanej metody.
Zmodyfikowane pliki są zapisywane z rozszerzeniem .orig przed przywróceniem. Aby wyłączyć te kopie zapasowe,
użyj --no-backup.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
See hg pomoc wycofać się aby znaleźć sposób na odwrócenie efektu wcześniejszego zestawu zmian.
Zwraca 0 w przypadku powodzenia.
Opcje:
-za, --wszystko
cofnij wszystkie zmiany, jeśli nie podano żadnych argumentów
-D,--Data
najwyższa data dopasowania wersji
-R,--obrót silnika
powrócić do określonej wersji
-DO, --bez kopii zapasowej
nie zapisuj kopii zapasowych plików
-ja, --interaktywny
interaktywnie wybierz zmiany (EKSPERYMENTALNIE)
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
Opcja zaznaczona [+] może być określona wielokrotnie
rollback
wycofaj ostatnią transakcję (NIEBEZPIECZNE) (WYCOFANE):
hg wycofanie
Proszę używać hg popełnić --poprawiać zamiast wycofywania, aby poprawić błędy w ostatnim zatwierdzeniu.
Tego polecenia należy używać ostrożnie. Jest tylko jeden poziom wycofywania zmian i tak jest
nie ma możliwości cofnięcia wycofania. Przywróci także stan brudu z czasu ostatniego
transakcji, tracąc wszelkie zmiany stanu nieczystości od tego czasu. To polecenie nie zmienia
katalog roboczy.
Transakcje służą do hermetyzacji efektów wszystkich poleceń tworzących nowe
zestawy zmian lub propaguj istniejące zestawy zmian do repozytorium.
Na przykład poniższe polecenia mają charakter transakcyjny, a ich efekty można losować
plecy:
· popełniać
· import
· ciągnąć
· push (z tym repozytorium jako miejscem docelowym)
· rozłączyć
Aby uniknąć trwałej utraty danych, funkcja wycofania odmówi wycofania transakcji zatwierdzenia, jeśli tak się stanie
nie jest wymeldowany. Użyj --force , aby zastąpić to zabezpieczenie.
To polecenie nie jest przeznaczone do użytku w repozytoriach publicznych. Gdy zmiany będą widoczne dla
ściągane przez innych użytkowników, lokalne wycofanie transakcji jest nieskuteczne (ktoś inny może to zrobić).
już pobrałem zmiany). Ponadto możliwy jest wyścig z czytelnikami
magazyn; na przykład trwające pobieranie z repozytorium może zakończyć się niepowodzeniem, jeśli nastąpi wycofanie
wykonane.
Zwraca 0 w przypadku powodzenia, 1, jeśli nie są dostępne żadne dane dotyczące wycofania.
Opcje:
-N, --próba
nie wykonuj żadnych działań, po prostu wydrukuj dane wyjściowe
-F, --siła
ignorować środki bezpieczeństwa
korzeń
wydrukuj katalog główny (na górze) bieżącego katalogu roboczego:
hg korzeń
Wydrukuj katalog główny bieżącego repozytorium.
Zwraca 0 w przypadku powodzenia.
służyć
uruchom samodzielny serwer WWW:
hg służyć [OPCJA]...
Uruchom lokalną przeglądarkę repozytorium HTTP i serwer ściągania. Można tego używać do udostępniania ad hoc
i przeglądanie repozytoriów. Zaleca się użycie prawdziwego serwera WWW do obsługi pliku
repozytorium przez dłuższy okres czasu.
Należy pamiętać, że serwer nie implementuje kontroli dostępu. Oznacza to, że wg
domyślnie każdy może czytać z serwera i domyślnie nikt nie może na nim pisać. Ustaw
web.allow_push opcja do * aby umożliwić wszystkim przesyłanie danych na serwer. Powinieneś użyć prawdziwego
serwer WWW, jeśli chcesz uwierzytelnić użytkowników.
Domyślnie serwer rejestruje dostęp do stdout i błędy do stderr. Użyj
Opcje -A/--accesslog i -E/--errorlog umożliwiające logowanie do plików.
Aby serwer wybrał wolny numer portu do nasłuchiwania, podaj numer portu 0; W
w takim przypadku serwer wydrukuje numer portu, którego używa.
Zwraca 0 w przypadku powodzenia.
Opcje:
-DO,--dziennik dostępu
nazwa pliku dziennika dostępu do zapisu
-D, --demon
uruchom serwer w tle
--daemon-pipefds
używany wewnętrznie przez tryb demona
-MI,--dziennik błędów
nazwa pliku dziennika błędów do zapisu
-P,--Port
port do nasłuchiwania (domyślnie: 8000)
-za,--adres
adres do nasłuchiwania (domyślnie: wszystkie interfejsy)
prefix
przedrostek ścieżki, z której ma być obsługiwany (domyślnie: katalog główny serwera)
-N,--Nazwa
nazwa wyświetlana na stronach internetowych (domyślnie: katalog roboczy)
--konf.web
nazwa pliku konfiguracyjnego hgweb (patrz „hg help hgweb”)
--webdir-conf
nazwa pliku konfiguracyjnego hgweb (przestarzałe)
--plik-pid
nazwa pliku, do którego ma zostać zapisany identyfikator procesu
--stdio
dla klientów zdalnych
--cmdserver
dla klientów zdalnych
-T,--szablony
szablony internetowe do wykorzystania
--styl
styl szablonu, którego chcesz użyć
-6, --ipv6.
używaj protokołu IPv6 oprócz protokołu IPv4
--certyfikat
Plik certyfikatu SSL
status
pokaż zmienione pliki w katalogu roboczym:
hg status [OPCJA]... [PLIK]...
Pokaż stan plików w repozytorium. Jeśli podano nazwy, zostaną podane tylko pasujące pliki
pokazane. Pliki, które są czyste lub ignorowane, lub źródło operacji kopiowania/przenoszenia, nie są
wymienione, chyba że podano -c/--clean, -i/--ignored, -C/--copy lub -A/--all. Chyba że opcje
opisane jako „pokaż tylko …”, używane są opcje -mardu.
Opcja -q/--quiet ukrywa nieśledzone (nieznane i ignorowane) pliki, chyba że wyraźnie o to poprosimy
z -u/--unknown lub -i/--ignored.
Note hg status może wydawać się, że nie zgadza się z różnicą, jeśli uprawnienia uległy zmianie lub doszło do połączenia
Wystąpił. Standardowy format różnic nie raportuje zmian uprawnień ani różnic
raportuje tylko zmiany w odniesieniu do jednego elementu nadrzędnego scalania.
Jeśli podana jest jedna wersja, jest ona używana jako wersja podstawowa. Jeżeli zostaną wprowadzone dwie poprawki,
pokazane są różnice między nimi. Opcja --change może być również używana jako skrót
aby wyświetlić listę zmienionych plików wersji z jej pierwszego elementu nadrzędnego.
Kody używane do pokazania statusu plików to:
M = zmodyfikowany
A = dodano
R = usunięte
C = czysty
! = brak (usunięty poleceniem innym niż hg, ale nadal śledzony)
? = nie śledzone
Ja = ignorowane
= pochodzenie poprzedniego pliku (z --copy)
Przykłady:
· pokaż zmiany w katalogu roboczym względem zestawu zmian:
hg status --rev 9353
· pokaż zmiany w katalogu roboczym w stosunku do katalogu bieżącego (patrz hg pomoc
wzory po więcej informacji):
status hg dotyczący:
· pokaż wszystkie zmiany łącznie z kopiami w istniejącym zestawie zmian:
hg status --copys --change 9353
· uzyskaj rozdzieloną NUL listę dodanych plików, odpowiednią dla xargs:
status hg -an0
Zwraca 0 w przypadku powodzenia.
Opcje:
-DO, --wszystko
pokaż stan wszystkich plików
-M, --zmodyfikowany
pokaż tylko zmodyfikowane pliki
-za, --dodany
pokaż tylko dodane pliki
-R, --REMOVED
pokaż tylko usunięte pliki
-D, --usunięte
pokaż tylko usunięte (ale prześledzone) pliki
-C, --czysty
pokaż tylko pliki bez zmian
-ty, --nieznany
pokaż tylko nieznane (nie śledzone) pliki
-ja, --ignorowany
pokaż tylko ignorowane pliki
-N, --brak statusu
ukryj prefiks stanu
-DO, --kopie
pokaż źródło skopiowanych plików
-0, --drukuj0
zakończ nazwy plików wartością NUL, do użycia z xargs
--obrót silnika
pokaż różnicę w stosunku do wersji
--zmiana
wylistuj zmienione pliki wersji
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-S, --podrepozytoria
wracaj do podrepozytoriów
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
Opcja zaznaczona [+] może być określona wielokrotnie
pseudonimy: ul
streszczenie
podsumować stan katalogu roboczego:
hg podsumowanie [--remote]
Generuje to krótkie podsumowanie stanu katalogu roboczego, w tym katalogów nadrzędnych, gałęzi,
status zatwierdzenia, faza i dostępne aktualizacje.
Opcja --remote powoduje sprawdzenie domyślnych ścieżek przychodzących i wychodzących
zmiany. Może to być czasochłonne.
Zwraca 0 w przypadku powodzenia.
Opcje:
--zdalny
sprawdź pchanie i ciągnięcie
aliasy: suma
etykieta
dodaj jeden lub więcej tagów dla bieżącej lub danej wersji:
hg tag [-f] [-l] [-m TEKST] [-d DATA] [-u UŻYTKOWNIK] [-r REW] NAZWA...
Nazwij konkretną wersję za pomocą .
Tagi służą do nazywania poszczególnych wersji repozytorium i są do tego bardzo przydatne
porównać różne wersje, wrócić do znaczących wcześniejszych wersji lub zaznaczyć gałąź
punkty jako wydania itp. Zmiana istniejącego tagu jest zwykle niedozwolona; użyj -f/--force
przekroczyć.
Jeśli nie podano żadnej wersji, używany jest katalog nadrzędny katalogu roboczego.
Aby ułatwić kontrolę wersji, dystrybucję i łączenie tagów, są one przechowywane jako
plik o nazwie „.hgtags”, który jest zarządzany podobnie jak inne pliki projektu i może być
w razie potrzeby ręcznie edytowane. Oznacza to również, że tagowanie tworzy nowe zatwierdzenie. Plik
„.hg/localtags” jest używane dla tagów lokalnych (nieudostępnianych pomiędzy repozytoriami).
Zatwierdzenia tagów są zwykle dokonywane na czele gałęzi. Jeśli rodzic pracujący
katalog nie jest dyrektorem oddziału, hg etykieta przerywa; użyj -f/--force, aby wymusić zatwierdzenie tagu
opierać się na zestawie zmian innym niż głowa.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Ponieważ nazwy znaczników mają pierwszeństwo przed nazwami gałęzi podczas wyszukiwania wersji, należy użyć istniejącego pliku
nazwa oddziału jako nazwa znacznika jest odradzana.
Zwraca 0 w przypadku powodzenia.
Opcje:
-F, --siła
znacznik siły
-ja, --lokalny
ustaw tag jako lokalny
-R,--obrót silnika
wersja do tagu
--usunąć
usuń znacznik
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
tagi
lista tagów repozytorium:
tagi hg
Zawiera listę zarówno tagów zwykłych, jak i lokalnych. Gdy używany jest przełącznik -v/--verbose, trzeci
kolumna „local” jest drukowana dla tagów lokalnych. Kiedy używany jest przełącznik -q/--quiet, tylko
drukowana jest nazwa znacznika.
Zwraca 0 w przypadku powodzenia.
Opcje:
-T,--szablon
wyświetlacz z szablonem (EKSPERYMENTALNY)
typ
pokaż wersję końcówki (przestarzałe):
końcówka hg [-p] [-g]
Wersja końcówki (zwykle nazywana po prostu końcówką) to zestaw zmian ostatnio dodany do
repozytorium (a co za tym idzie ostatnio zmieniona głowa).
Jeśli właśnie dokonałeś zatwierdzenia, zatwierdzenie to będzie wskazówką. Jeśli właśnie pociągnąłeś
zmian z innego repozytorium, końcówka tego repozytorium staje się bieżącą końcówką. The
Znacznik „tip” jest wyjątkowy i nie można zmienić jego nazwy ani przypisać go do innego zestawu zmian.
To polecenie jest przestarzałe, użyj go hg głowice zamiast.
Zwraca 0 w przypadku powodzenia.
Opcje:
-P, --łata
pokaż poprawkę
-G, --git
użyj rozszerzonego formatu różnic git
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
rozpakować
zastosuj jeden lub więcej plików grupy zmian:
hg rozpakuj [-u] PLIK...
Zastosuj jeden lub więcej skompresowanych plików grupy zmian wygenerowanych przez polecenie pakunku.
Zwraca 0 w przypadku powodzenia, 1, jeśli aktualizacja zawiera nierozwiązane pliki.
Opcje:
-ty, --aktualizacja
zaktualizuj do nowego szefa oddziału, jeśli zestawy zmian zostały rozdzielone
aktualizacja
zaktualizuj katalog roboczy (lub zmień wersje):
hg aktualizacja [-c] [-C] [-d DATA] [[-r] WER.]
Zaktualizuj katalog roboczy repozytorium do określonego zestawu zmian. Jeśli nie ma zestawu zmian
określony, zaktualizuj do końcówki aktualnie nazwanej gałęzi i przesuń aktywną zakładkę (patrz
hg pomoc bookmarks).
Aktualizacja ustawia nadrzędną wersję katalogu roboczego na określony zestaw zmian (patrz hg
pomoc rodzice).
Jeśli zestaw zmian nie jest potomkiem ani przodkiem elementu nadrzędnego katalogu roboczego, plik
aktualizacja została przerwana. Opcja -c/--check powoduje sprawdzenie katalogu roboczego
niezatwierdzone zmiany; jeśli żaden nie zostanie znaleziony, katalog roboczy zostanie zaktualizowany do określonego
zestaw zmian.
Jeśli katalog roboczy zawiera niezatwierdzone zmiany, obowiązują następujące zasady:
1. Jeśli nie określono ani -c/--check, ani -C/--clean i jeśli żądany zestaw zmian jest
przodkiem lub potomkiem katalogu nadrzędnego katalogu roboczego, niezatwierdzone zmiany to
scalone z żądanym zestawem zmian, a scalony wynik pozostaje niezatwierdzony. Jeśli
żądany zestaw zmian nie jest przodkiem ani potomkiem (to znaczy znajduje się na innym
oddział), aktualizacja zostanie przerwana, a niezatwierdzone zmiany zostaną zachowane.
2. Opcja -c/--check powoduje przerwanie aktualizacji i niezatwierdzone zmiany
zachowane.
3. Opcja -C/--clean powoduje odrzucenie niezatwierdzonych zmian i katalogu roboczego
jest aktualizowany do żądanego zestawu zmian.
Aby anulować niezatwierdzone scalanie (i utracić zmiany), użyj hg aktualizacja --czysty ..
Użyj wartości null jako zestawu zmian, aby usunąć katalog roboczy (np hg klonować -U).
Jeśli chcesz przywrócić tylko jeden plik do starszej wersji, użyj hg przywrócić [-R OBRÓT SILNIKA] IMIĘ.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Zwraca 0 w przypadku powodzenia, 1 w przypadku nierozwiązanych plików.
Opcje:
-DO, --czysty
odrzuć niezatwierdzone zmiany (bez kopii zapasowej)
-C, --sprawdzać
zaktualizuj w gałęziach, jeśli nie ma niezatwierdzonych zmian
-D,--Data
najwyższa data dopasowania wersji
-R,--obrót silnika
rewizja
-T,--narzędzie
określ narzędzie scalania
aliasy: up checkout co
zweryfikować
sprawdź integralność repozytorium:
hg sprawdź
Sprawdź integralność bieżącego repozytorium.
Spowoduje to szczegółowe sprawdzenie integralności repozytorium, weryfikując skróty
i sumy kontrolne każdego wpisu w dzienniku zmian, manifeście i śledzonych plikach, a także plik
integralność ich powiązań poprzecznych i indeksów.
Więcej informacji na ten temat można znaleźć na stronie https://mercurial-scm.org/wiki/RepositoryCorruption
odzyskanie danych po uszkodzeniu repozytorium.
Zwraca 0 w przypadku powodzenia, 1 w przypadku napotkania błędów.
wersja
wersja wyjściowa i informacje o prawach autorskich:
wersja hg
wersja wyjściowa i informacje o prawach autorskich
DATA FORMATY
Niektóre polecenia umożliwiają określenie daty, np.:
· wycofanie, zatwierdzenie, import, tag: Określ datę zatwierdzenia.
· zaloguj, przywróć, zaktualizuj: Wybierz wersję(y) według daty.
Prawidłowych jest wiele formatów daty. Oto kilka przykładów:
· Śr grudzień 6 13:18:29 2006 (założono lokalną strefę czasową)
· grudzień 6 13:18 -0600 (założony rok, zapewnione przesunięcie czasowe)
· grudzień 6 13:18 UTC (UTC i GMT to aliasy +0000)
· grudzień 6 (środek nocy)
· 13:18 (dziś zakładane)
· 3:39 (zakłada się, że jest to 3:39)
· 3: 39pm (15: 39)
· 2006-12-06 13:18:29 (format ISO 8601)
· 2006-12-6 13:18
· 2006-12-6
· 12-6
· 12/6
· 12/6/6 (6 grudnia 2006 r.)
· już dziś (środek nocy)
· wczoraj (środek nocy)
· już dziś - już teraz
Na koniec istnieje wewnętrzny format Mercurial:
· 1165411109 0 (środa, 6 grudnia 13, 18:29:2006 UTC)
Jest to wewnętrzny format reprezentacji dat. Pierwsza liczba to liczba
sekund od epoki (1970-01-01 00:00 UTC). Drugie to przesunięcie lokalne
strefa czasowa, w sekundach na zachód od UTC (ujemna, jeśli strefa czasowa znajduje się na wschód od UTC).
Polecenie log akceptuje również zakresy dat:
· <DATA - w lub przed określoną datą/godziną
· > DATA - w lub po określonej dacie/godzinie
· DATA do DATA - zakres dat włącznie
· -DNI - w ciągu określonej liczby dni od dnia dzisiejszego
DIFF FORMATY
Domyślnym formatem Mercurial do pokazywania zmian pomiędzy dwiema wersjami pliku jest
kompatybilny z ujednoliconym formatem GNU diff, który może być używany przez łatę GNU i wiele innych
inne standardowe narzędzia.
Chociaż ten standardowy format jest często wystarczający, nie koduje on następujących informacji:
· Status pliku wykonywalnego i inne bity uprawnień
· Skopiuj lub zmień nazwę informacji
· zmiany w plikach binarnych
· tworzenie lub usuwanie pustych plików
Mercurial obsługuje również rozszerzony format różnic z git VCS, który je rozwiązuje
ograniczenia. Format git diff nie jest domyślnie generowany ze względu na kilka szeroko rozpowszechnionych narzędzi
nadal nie rozumiem tego formatu.
Oznacza to, że podczas generowania różnic z repozytorium Mercurial (np hg eksport),
powinieneś zachować ostrożność w przypadku kopiowania plików i zmiany ich nazw oraz innych wspomnianych rzeczy
powyżej, ponieważ przy stosowaniu standardowej różnicy do innego repozytorium ten dodatek
informacje zostaną utracone. Nie ma to wpływu na wewnętrzne operacje Mercurial (takie jak push i pull).
przez to, ponieważ używają wewnętrznego formatu binarnego do komunikowania zmian.
Aby Mercurial tworzył rozszerzony format git diff, użyj opcji --git dostępnej dla
wiele poleceń lub ustaw „git = True” w sekcji [diff] pliku konfiguracyjnego. Ty
nie trzeba ustawiać tej opcji podczas importowania różnic w tym formacie lub używania ich w pliku mq
rozbudowa.
ŚRODOWISKO ZMIENNE
HG Ścieżka do pliku wykonywalnego „hg”, przekazywana automatycznie podczas uruchamiania hooków, rozszerzeń lub
narzędzia zewnętrzne. Jeśli nieustawiony lub pusty, jest to nazwa pliku wykonywalnego hg, jeśli jest zamrożony,
lub plik wykonywalny o nazwie „hg” (z %PATHEXT% [domyślnie COM/EXE/BAT/CMD]
rozszerzenia w systemie Windows) jest przeszukiwane.
HGEDYTOR
To jest nazwa edytora, który będzie uruchamiany podczas zatwierdzania. Zobacz REDAKTOR.
(przestarzałe, użyj pliku konfiguracyjnego)
HGENKODOWANIE
Zastępuje to domyślne ustawienie regionalne wykryte przez Mercurial. To ustawienie jest
służy do konwersji danych, w tym nazw użytkowników, opisów zestawów zmian, nazw znaczników i
gałęzie. To ustawienie można zastąpić opcją wiersza poleceń --encoding.
HGENCODINGMODE
Ustawia to zachowanie Mercurial w zakresie obsługi nieznanych znaków podczas transkodowania
dane wejściowe użytkownika. Wartość domyślna to „ścisła”, co powoduje przerwanie działania Mercurial, jeśli nie jest to możliwe
zamapuj postać. Inne ustawienia obejmują „zamień”, które zastępuje nieznane
znaków i „ignoruj”, co je usuwa. To ustawienie można zastąpić za pomocą opcji
--encodingmode opcja wiersza poleceń.
HGENCODINGNIEjednoznaczne
Ustawia to zachowanie Mercuriala w zakresie obsługi znaków o „niejednoznacznych” szerokościach, np
akcentowane znaki łacińskie czcionkami wschodnioazjatyckimi. Domyślnie zakłada to Mercurial
znaki niejednoznaczne są wąskie, ustaw tę zmienną na „szeroką”, jeśli takie znaki
powodować problemy z formatowaniem.
HGMERGE
Plik wykonywalny używany do rozwiązywania konfliktów scalania. Program zostanie wykonany
z trzema argumentami: plik lokalny, plik zdalny, plik nadrzędny.
(przestarzałe, użyj pliku konfiguracyjnego)
HGRCPAT
Lista plików lub katalogów do wyszukiwania plików konfiguracyjnych. Separator pozycji to
„:” w systemie Unix, „;” w systemie Windows. Jeśli nie ustawiono HGRCPATH, domyślna ścieżka wyszukiwania platformy
Jest używane. Jeśli jest pusty, odczytywany jest tylko plik .hg/hgrc z bieżącego repozytorium.
Dla każdego elementu w HGRCPATH:
· jeśli jest to katalog, dodawane są wszystkie pliki kończące się na .rc
· w przeciwnym razie sam plik zostanie dodany
HGPLAIN
Po ustawieniu wyłącza to wszelkie ustawienia konfiguracyjne, które mogłyby zmienić ustawienia Mercurial
domyślne wyjście. Obejmuje to kodowanie, ustawienia domyślne, tryb szczegółowy, tryb debugowania i tryb cichy
tryb, ślady i lokalizacja. Może to być przydatne podczas pisania skryptów przeciwko
Mercurial w obliczu istniejącej konfiguracji użytkownika.
Równoważne opcje ustawiane za pomocą flag wiersza poleceń lub zmiennych środowiskowych nie są
przesłonięty.
HGPLAINZ WYJĄTKIEM
To jest rozdzielona przecinkami lista funkcji, które należy zachować, gdy włączona jest opcja HGPLAIN.
Obecnie obsługiwane są następujące wartości:
alias
Nie usuwaj aliasów.
I18n
Zachowaj internacjonalizację.
revsettalia
Nie usuwaj aliasów ustawień fabrycznych.
Ustawienie HGPLAINEXCEPT na dowolną wartość (nawet pusty ciąg znaków) włączy tryb zwykły.
HGUSER Jest to ciąg znaków używany jako autor zatwierdzenia. Jeśli nie ustawiono, dostępne wartości
będą rozpatrywane w następującej kolejności:
· HGUSER (przestarzałe)
· pliki konfiguracyjne z HGRCPATH
· interaktywny monit
· NAZWA LOGOWANIA (z @nazwa hosta dołączony)
(przestarzałe, użyj pliku konfiguracyjnego)
E-MAIL Może być używany jako autor zatwierdzenia; zobacz HGUSER.
NAZWA LOGU
Może być używany jako autor zatwierdzenia; zobacz HGUSER.
WIZUALNY Jest to nazwa edytora, którego należy używać podczas zatwierdzania. Zobacz REDAKTOR.
REDAKCJA Czasami Mercurial musi otworzyć plik tekstowy w edytorze, aby użytkownik mógł go zmodyfikować,
na przykład podczas pisania komunikatów zatwierdzeń. Edytor, którego używa, zależy od
patrząc na zmienne środowiskowe HGEDITOR, VISUAL i EDITOR, w tej kolejności.
Wybierany jest pierwszy niepusty. Jeśli wszystkie są puste, edytor domyślnie wybiera
„rozsądny redaktor”.
ŚCIEŻKA PYTONA
Jest to używane przez Python do wyszukiwania zaimportowanych modułów i może wymagać ustawienia
odpowiednio, jeśli ten Mercurial nie jest zainstalowany w całym systemie.
ZA POMOCĄ DODATKOWY ROZWIĄZANIA
Mercurial ma możliwość dodawania nowych funkcji poprzez wykorzystanie rozszerzeń. Rozszerzenia
może dodawać nowe polecenia, dodawać opcje do istniejących poleceń, zmieniać domyślne zachowanie
poleceń lub implementowania haków.
Aby włączyć rozszerzenie „foo”, dostarczane z Mercurialem lub w ścieżce wyszukiwania Pythona,
utwórz dla niego wpis w pliku konfiguracyjnym, taki jak ten:
[rozszerzenia]
foo =
Możesz także podać pełną ścieżkę do rozszerzenia:
[rozszerzenia]
moja cecha = ~/.hgext/myfeature.py
See hg pomoc config aby uzyskać więcej informacji na temat plików konfiguracyjnych.
Rozszerzenia nie są domyślnie ładowane z różnych powodów: mogą przyspieszyć uruchamianie
nad głową; mogą być przeznaczone wyłącznie do zaawansowanego użytku; mogą potencjalnie zapewnić
niebezpieczne zdolności (takie jak pozwolenie na niszczenie lub modyfikowanie historii); może ich nie być
gotowy na najlepszy czas; lub mogą zmienić niektóre typowe zachowania standardowego Mercurial. To jest
w związku z tym do użytkownika należy aktywowanie rozszerzeń w razie potrzeby.
Aby jawnie wyłączyć rozszerzenie włączone w pliku konfiguracyjnym o szerszym zakresie,
dodaj jego ścieżkę za pomocą !:
[rozszerzenia]
# wyłączenie paska rozszerzeń znajdującego się w /path/to/extension/bar.py
bar = !/ścieżka/do/rozszerzenie/bar.py
# to samo, ale nie podano ścieżki dla rozszerzenia baz
baz = !
wyłączone rozszerzenia:
Acl haki do kontrolowania dostępu do repozytorium
czarna skrzynka
rejestruj zdarzenia w repozytorium w czarnej skrzynce w celu debugowania
bugzilla
haki do integracji z modułem śledzenia błędów Bugzilla
cenzor usunąć zawartość pliku w danej wersji
maselnica polecenie umożliwiające wyświetlenie statystyk dotyczących historii repozytorium
pakiety klonów
reklamuj wstępnie wygenerowane pakiety w celu klonowania nasion
kolor pokoloruj dane wyjściowe niektórych poleceń
konwertować
importować wersje z zagranicznych repozytoriów VCS do Mercurial
eol automatycznie zarządzaj znakami nowej linii w plikach repozytorium
rozszerz
polecenie umożliwiające zewnętrznym programom porównywanie wersji
totumfacki
uwierzytelnianie http z faktem
Gpg polecenia do podpisywania i weryfikowania zestawów zmian
hgcia hooki do integracji z usługą powiadomień CIA.vc
hgk przeglądaj repozytorium w sposób graficzny
podświetlić
podświetlanie składni dla hgweb (wymaga Pigments)
histedit
interaktywna edycja historii
keyword
rozwiń słowa kluczowe w śledzonych plikach
duże pliki
śledzić duże pliki binarne
mq zarządzać stosem poprawek
powiadom haki do wysyłania powiadomień e-mail push
pager przeglądaj dane wyjściowe poleceń za pomocą zewnętrznego pagera
patchbomba
polecenie wysyłania zestawów zmian jako (serii) wiadomości e-mail z łatkami
oczyścić polecenie usunięcia nieśledzonych plików z katalogu roboczego
przebazować polecenie przeniesienia zestawów wersji do innego elementu nadrzędnego
rekord polecenia do interaktywnego wybierania zmian do zatwierdzenia/qrefresh
ponownie połączyć odtwarza twarde łącza pomiędzy klonami repozytoriów
systemy
rozszerzaj schematy o skróty do rojów repozytoriów
udział mają wspólną historię między kilkoma katalogami roboczymi
odłożyć na półkę zapisz i przywróć zmiany w katalogu roboczym
rozebrać się usuń zestawy zmian i ich potomków z historii
przeszczep
polecenie przeszczepienia zestawów zmian z innej gałęzi
win32mbcs
pozwalają na użycie ścieżek MBCS z problematycznym kodowaniem
zero conf
odkrywaj i reklamuj repozytoria w sieci lokalnej
OKREŚLANIE FILE ZESTAWY
Mercurial obsługuje funkcjonalny język wyboru zestawu plików.
Podobnie jak inne wzorce plików, ten typ wzorca jest oznaczony przedrostkiem „set:”. Język
obsługuje wiele predykatów, które są łączone operatorami infiksowymi. Nawiasy mogą być
używany do grupowania.
Identyfikatory, takie jak nazwy plików lub wzorce, muszą być ujęte w pojedynczy lub podwójny cudzysłów, jeśli
zawierają znaki poza [.*{}[]?/\_a-zA-Z0-9\x80-\xff] lub jeśli pasują do jednego z
predefiniowanych predykatów. Zwykle dotyczy to wzorców plików innych niż glob i
argumenty dla predykatów.
Znaki specjalne można stosować w identyfikatorach w cudzysłowie, zmieniając je, np. \n is
interpretowane jako znak nowej linii. Aby zapobiec ich interpretacji, ciągi znaków można poprzedzać
w rnp R'...'.
Istnieje jeden operator przedrostkowy:
nie x
Pliki nie w x. Krótka forma jest ! x.
Oto obsługiwane operatory infix:
x i y
Przecięcie plików w x i y. Krótka forma jest x & y.
x or y
Połączenie plików w x i y. Istnieją dwie alternatywne krótkie formy: x | y i x +
y.
x - y
Pliki w x, ale nie w y.
Obsługiwane są następujące predykaty:
dodany()
Plik dodany zgodnie z hg status.
dwójkowy()
Plik wyglądający na binarny (zawiera bajty NUL).
czysty()
Plik czysty wg hg status.
skopiowane()
Plik zarejestrowany jako kopiowany.
usunięte()
Alias dla zaginiony().
kodowanie (nazwa)
Plik można pomyślnie zdekodować przy podanym kodowaniu znaków. Nie może być
przydatne w przypadku kodowania innego niż ASCII i UTF-8.
eol (styl)
Plik zawiera znaki nowej linii danego stylu (dos, unix, mac). Pliki binarne są
wykluczone, pliki z różnymi zakończeniami linii pasują do wielu stylów.
Exec ()
Plik oznaczony jako wykonywalny.
grep(wyrażenie regularne)
Plik zawiera podane wyrażenie regularne.
hgignore()
Plik pasujący do aktywnego wzorca .hgignore.
ignorowane()
Plik ignorowany zgodnie z hg status. Pliki te będą brane pod uwagę tylko wtedy, gdy
ten predykat jest używany.
zaginiony()
Brakujący plik wg hg status.
zmodyfikowane()
Plik zmodyfikowany zgodnie z hg status.
przenośny()
Plik o przenośnej nazwie. (Nie dotyczy to nazw plików z wielkością liter
kolizje.)
REMOVED()
Plik usuwany zgodnie z hg status.
rozwiązany()
Plik oznaczony jako rozwiązany zgodnie z hg rozwiązać -l.
rozmiar (wyrażenie)
Rozmiar pliku odpowiada podanemu wyrażeniu. Przykłady:
· 1k (pliki od 1024 do 2047 bajtów)
· < 20k (pliki mniejsze niż 20480 bajtów)
· >= .5MB (pliki o wielkości co najmniej 524288 bajtów)
· 4k - 1MB (pliki od 4096 bajtów do 1048576 bajtów)
subrepo([wzorzec])
Podrepozytoria, których ścieżki odpowiadają podanemu wzorcowi.
dowiązanie symboliczne()
Plik oznaczony jako dowiązanie symboliczne.
nieznany()
Plik nieznany wg hg status. Pliki te będą brane pod uwagę tylko wtedy, gdy
ten predykat jest używany.
nie rozwiązany()
Plik oznaczony jako nierozwiązany zgodnie z hg rozwiązać -l.
Kilka przykładowych zapytań:
· Pokaż status plików wyglądających na binarne w katalogu roboczym:
hg status -A „zestaw:binarny()”
· Zapomnij o plikach znajdujących się w .hgignore, ale już śledzonych:
hg zapomnij o „set:hgignore() i nie ignorowaj()”
· Znajdź pliki tekstowe zawierające ciąg:
hg pliki „zestaw:grep(magia), a nie binarny()”
· Znajdź pliki C w niestandardowym kodowaniu:
hg „zestaw:**.c i nie koduje („UTF-8”)”
· Przywróć kopie dużych plików binarnych:
hg przywróć „set:copied() i binary() oraz size('>1M')”
· Usuń pliki wymienione w foo.lst, które zawierają literę a lub b:
hg usuń „set: 'listfile:foo.lst' i (**a* lub **b*)”
Zobacz też hg pomoc wzory.
SŁOWNIK
Przodek
Dowolny zestaw zmian, do którego można dotrzeć poprzez nieprzerwany łańcuch nadrzędnych zestawów zmian z pliku a
dany zestaw zmian. Dokładniej, przodków zestawu zmian można zdefiniować za pomocą dwóch
właściwości: rodzic zbioru zmian jest przodkiem, a rodzic przodka jest
przodek. Zobacz też: „Potomek”.
Zakładka
Zakładki są wskaźnikami do pewnych zatwierdzeń, które poruszają się podczas zatwierdzania. Oni są
podobne do tagów w tym sensie, że można używać nazw zakładek wszędzie tam, gdzie
Mercurial oczekuje identyfikatora zestawu zmian, np. with hg aktualizacja. W przeciwieństwie do tagów, zakładki się przesuwają
wraz z zatwierdzeniem.
Zakładki można zmieniać, kopiować i usuwać. Zakładki są lokalne, chyba że takie są
jawnie wypychane lub ściągane między repozytoriami. Wpychanie i ciągnięcie zakładek
umożliwiają współpracę z innymi osobami w oddziale bez tworzenia nazwanego oddziału.
Oddział (Rzeczownik) Podrzędny zestaw zmian utworzony z elementu nadrzędnego, który nie jest głową.
Są one znane jako gałęzie topologiczne, patrz „Gałąź topologiczna”. Jeśli
zostanie nazwana gałąź topologiczna, staje się nazwaną gałęzią. Jeśli gałąź topologiczna jest
nienazwany, staje się gałęzią anonimową. Zobacz „Oddział, anonimowy” i „Oddział,
o imieniu'.
Gałęzie mogą zostać utworzone, gdy zmiany zostaną pobrane z pilota lub przesłane do niego
repozytorium, ponieważ w wyniku tych operacji mogą zostać utworzone nowe głowy. Należy pamiętać, że termin
Branch może być również używany nieformalnie do opisania procesu rozwoju, w którym
pewien rozwój następuje niezależnie od innego rozwoju. Czasami tak jest
można to zrobić jawnie za pomocą nazwanej gałęzi, ale można to również zrobić lokalnie, używając
zakładki lub klony i anonimowe gałęzie.
Przykład: „Oddział eksperymentalny”.
(Czasownik) Akcja polegająca na utworzeniu podrzędnego zestawu zmian, w wyniku której jego rodzic ma
więcej niż jedno dziecko.
Przykład: „Zamierzam otworzyć oddział w X.”
Gałąź, anonimowy
Za każdym razem, gdy tworzony jest nowy podrzędny zestaw zmian z rodzica, który nie jest głową i
nazwa oddziału nie ulega zmianie, tworzony jest nowy oddział anonimowy.
Gałąź, zamknięte
Nazwany oddział, którego wszystkie głowy oddziałów zostały zamknięte.
Gałąź, domyślnym
Gałąź przypisana do zestawu zmian, jeśli wcześniej nie przypisano żadnej nazwy.
Oddział głowa
Patrz „Głowa, gałąź”.
Gałąź, nieaktywny
Jeśli nazwana gałąź nie ma głów topologicznych, uważa się ją za nieaktywną. jako
na przykład gałąź funkcji staje się nieaktywna po połączeniu z gałęzią domyślną
gałąź. ten hg gałęzie polecenie domyślnie pokazuje nieaktywne gałęzie, choć mogą
być ukrytym z hg gałęzie --aktywny.
UWAGA: ta koncepcja jest przestarzała, ponieważ jest zbyt dorozumiana. Oddziały powinny teraz
być jawnie zamknięte przy użyciu hg popełnić --zamknięty oddział kiedy nie są już potrzebne.
Gałąź, o imieniu
Kolekcja zestawów zmian, które mają tę samą nazwę gałęzi. Domyślnie dzieci z
zestaw zmian w nazwanej gałęzi należy do tej samej nazwanej gałęzi. Dziecko może być
wyraźnie przypisany do innego oddziału. Widzieć hg pomoc oddział, hg pomoc gałęzie i
hg popełnić --zamknięty oddział aby uzyskać więcej informacji na temat zarządzania oddziałami.
Nazwane gałęzie można traktować jako rodzaj przestrzeni nazw dzielącej kolekcję
zestawy zmian, które składają się na repozytorium, w zbiór rozłącznych podzbiorów. A
nazwana gałąź niekoniecznie jest gałęzią topologiczną. Jeśli nowy nazwany oddział to
utworzony z głowy innej nazwanej gałęzi lub gałęzi domyślnej, ale nie
dalsze zestawy zmian są dodawane do tej poprzedniej gałęzi, a następnie do tej poprzedniej gałęzi
będzie oddziałem tylko z nazwy.
Oddział typ
Patrz „Końcówka, gałąź”.
Gałąź, topologiczny
Za każdym razem, gdy tworzony jest nowy podrzędny zestaw zmian z rodzica, który nie jest głową, nowy
tworzona jest gałąź topologiczna. Jeśli nazwana zostanie gałąź topologiczna, stanie się ona nazwana
oddział. Jeśli gałąź topologiczna nie zostanie nazwana, staje się ona anonimową gałęzią
bieżący, prawdopodobnie domyślny oddział.
Lista zmian
Zapis zestawów zmian w kolejności, w jakiej zostały dodane do repozytorium.
Obejmuje to szczegółowe informacje, takie jak identyfikator zestawu zmian, autor, komunikat zatwierdzenia, data i lista
zmienionych plików.
Zestaw zmian
Migawka stanu repozytorium użyta do zarejestrowania zmiany.
Zestaw zmian, dziecko
Odwrotność nadrzędnego zestawu zmian: jeśli P jest rodzicem C, to C jest dzieckiem P.
Nie ma ograniczeń co do liczby dzieci, które może mieć zestaw zmian.
Zestaw zmian id
Skrót SHA-1, który jednoznacznie identyfikuje zestaw zmian. Może być reprezentowany jako albo
„długi” ciąg 40 cyfr szesnastkowych lub „krótki” ciąg 12 cyfr szesnastkowych.
Zestaw zmian, łączyć
Zestaw zmian z dwójką rodziców. Dzieje się tak po zatwierdzeniu scalania.
Zestaw zmian, roślina mateczna
Wersja, na której opiera się podrzędny zestaw zmian. W szczególności nadrzędny zestaw zmian
zestawu zmian C jest zbiorem zmian, którego węzeł bezpośrednio poprzedza C w DAG.
Zestawy zmian mają co najwyżej dwóch rodziców.
Koszyk
(Rzeczownik) Katalog roboczy aktualizowany do określonej wersji. To użycie powinno
prawdopodobnie należy tego unikać, jeśli to możliwe, ponieważ zestaw zmian jest znacznie bardziej odpowiedni niż
kasa w tym kontekście.
Przykład: „Korzystam z kasy X”.
(Czasownik) Aktualizacja katalogu roboczego do określonego zestawu zmian. Widzieć hg pomoc aktualizacja.
Przykład: „Zamierzam sprawdzić zestaw zmian X.”
Dziecko changeset
Zobacz „Zestaw zmian, dziecko”.
Zamknij changeset
Patrz „Głowa, zamknięta gałąź”.
Zamknięte oddział
Patrz „Oddział, zamknięty”.
Clone (Rzeczownik) Całkowita lub częściowa kopia repozytorium. Częściowy klon musi znajdować się w pliku
forma rewizji i jej przodkowie.
Przykład: „Czy Twój klon jest aktualny?”
(Czasownik) Proces tworzenia klona przy użyciu hg klonować.
Przykład: „Zamierzam sklonować repozytorium.”
Zamknięte oddział głowa
Patrz „Głowa, zamknięta gałąź”.
Popełnić (Rzeczownik) Synonim zestawu zmian.
Przykład: „Czy błąd w Twoim ostatnim zatwierdzeniu został naprawiony?”
(Czasownik) Czynność zapisywania zmian w repozytorium. Kiedy pliki są zatwierdzane w pliku
katalogu roboczego, Mercurial znajduje różnice pomiędzy zatwierdzonymi plikami i
ich nadrzędny zestaw zmian, tworząc nowy zestaw zmian w repozytorium.
Przykład: „Powinieneś zatwierdzić te zmiany teraz.”
Cset Powszechny skrót terminu zestaw zmian.
DZIEŃ Repozytorium zestawów zmian rozproszonego systemu kontroli wersji (DVCS) może być
opisany jako skierowany graf acykliczny (DAG), składający się z węzłów i krawędzi, gdzie
węzły odpowiadają zestawom zmian, a krawędzie oznaczają relację rodzic -> dziecko. Ten
Wykres można wizualizować za pomocą narzędzi graficznych, takich jak hg log --wykres. w Mercurialu,
DAG jest ograniczone wymogiem, aby dzieci miały co najwyżej dwoje rodziców.
Nieaktualna
Funkcja usunięta z dokumentacji, ale jej usunięcie nie jest zaplanowane.
Domyślnie oddział
Zobacz „Oddział, domyślny”.
potomek
Dowolny zestaw zmian, do którego można dotrzeć poprzez łańcuch podrzędnych zestawów zmian z danego
zestaw zmian. Dokładniej, elementy potomne zestawu zmian można zdefiniować przez dwa
właściwości: dziecko zestawu zmian jest potomkiem, a dziecko potomkiem
jest potomkiem. Zobacz także: „Przodek”.
Diff (Rzeczownik) Różnica między zawartością i atrybutami plików w dwóch
zestawy zmian lub zestaw zmian i bieżący katalog roboczy. Różnica jest
zwykle przedstawiany w standardowej formie zwanej „różnicą” lub „łatką”. „różnica gita”
format jest używany, gdy zmiany obejmują kopie, zmiany nazw lub zmiany w pliku
atrybuty, z których żaden nie może być reprezentowany/obsługiwany przez klasyczne „diff” i „patch”.
Przykład: „Czy widziałeś moją korektę w różniczku?”
(Czasownik) Porównywanie dwóch zestawów zmian to czynność polegająca na utworzeniu różnicy lub łatki.
Przykład: „Jeśli porównasz zestaw zmian X, zobaczysz, co mam na myśli”.
Informator, pracujący
Katalog roboczy reprezentuje stan plików śledzonych przez Mercurial, tj
zostanie zarejestrowany w następnym zatwierdzeniu. Katalog roboczy początkowo odpowiada
migawkę istniejącego zestawu zmian, zwanego elementem nadrzędnym elementu roboczego
informator. Zobacz „Nadrzędny, katalog roboczy”. Stan można modyfikować poprzez zmiany w
pliki wprowadzone ręcznie lub poprzez połączenie. Metadane repozytorium istnieją w pliku
Katalog .hg w katalogu roboczym.
Projekt Zestawy zmian w fazie roboczej nie zostały udostępnione repozytoriam publikacji i
można zatem bezpiecznie zmienić za pomocą rozszerzeń modyfikujących historię. Widzieć hg pomoc fazy.
Eksperymentalny
Funkcja, która może ulec zmianie lub zostać usunięta w późniejszym terminie.
Wykres Zobacz DAG i hg log --wykres.
Głowa Terminu „kierownik” można używać zarówno w odniesieniu do kierownika oddziału, jak i do kierownika składowiska,
w zależności od kontekstu. Aby uzyskać szczegółowe informacje, zobacz „Główny oddział” i „Główny, repozytorium”.
definicje.
Głowy są miejscem, w którym zazwyczaj odbywa się rozwój i są dla nich zwyczajowymi celami
operacje aktualizacji i scalania.
Głowa, oddział
Zestaw zmian bez potomków w tej samej nazwanej gałęzi.
Głowa, zamknięte oddział
Zestaw zmian, który oznacza głowę jako nie interesującą. Zamknięta głowa to nie
już wymieniony przez hg głowice. Oddział uważa się za zamknięty, gdy wszystkie jego głowy są zamknięte
zamknięte i w związku z tym nie znajduje się na liście hg gałęzie.
Zamknięte głowy można ponownie otworzyć, wprowadzając nowy zestaw zmian jako element potomny
zestaw zmian, który oznacza głowę jako zamkniętą.
Głowa, składnica
Głowa topologiczna, która nie została zamknięta.
Głowa, topologiczny
Zestaw zmian bez elementów podrzędnych w repozytorium.
Historia, niezmienny
Po zatwierdzeniu zestawów zmian nie można zmieniać. Rozszerzenia, które wydają się zmieniać
historia faktycznie tworzy nowe zestawy zmian, które zastępują istniejące, a następnie niszczą
stare zestawy zmian. Robienie tego w publicznych repozytoriach może skutkować starymi zestawami zmian
ponownie wprowadzone do repozytorium.
Historia, przepisanie
Zestawy zmian w repozytorium są niezmienne. Jednak rozszerzenia Mercurial mogą
zostać użyte do zmiany repozytorium, zwykle w taki sposób, aby zachować zestaw zmian
zawartość
Niezmienny historia
Zobacz „Historia, niezmienna”.
Łączyć changeset
Zobacz „Zestaw zmian, scalanie”.
Oczywisty
Każdy zestaw zmian ma manifest, czyli listę plików śledzonych przez
zestaw zmian.
Łączyć Używane do łączenia rozbieżnych gałęzi pracy. Po aktualizacji do zestawu zmian
a następnie scalisz inny zestaw zmian, wyświetlisz historię tego ostatniego zestawu zmian
do swojego katalogu roboczego. Po rozwiązaniu (i zaznaczeniu) konfliktów następuje połączenie
może zostać zatwierdzona jako zestaw zmian scalających, łączący dwie gałęzie w DAG.
O imieniu oddział
Zobacz „Oddział o nazwie”.
Null changeset
Pusty zestaw zmian. Jest to stan nadrzędny nowo zainicjowanych repozytoriów
repozytoria bez wyewidencjonowanych wersji. Jest zatem rodzicem głównych zestawów zmian
i efektywnego przodka podczas łączenia niepowiązanych zestawów zmian. Można określić przez
alias „null” lub identyfikator zestawu zmian „000000000000”.
Rodzic Zobacz „Zestaw zmian, rodzic”.
Rodzic changeset
Zobacz „Zestaw zmian, rodzic”.
Rodzic, pracujący katalog
Katalog roboczy nadrzędny odzwierciedla wersję wirtualną, która jest dzieckiem katalogu
zestaw zmian (lub dwa zestawy zmian z niezatwierdzonym połączeniem) pokazany przez hg rodzice, To
zmienia się z hg aktualizacja. Inne polecenia umożliwiające wyświetlenie nadrzędnego katalogu roboczego to
hg streszczenie i hg id. Można określić za pomocą aliasu „.”.
Łata (Rzeczownik) Produkt operacji różnicowania.
Przykład: „Wysłałem ci moją łatkę”.
(Czasownik) Proces wykorzystania pliku łatki do przekształcenia jednego zestawu zmian w inny.
Przykład: „Będziesz musiał załatać tę wersję”.
Faza Stan zestawu zmian śledzący sposób, w jaki zestaw zmian został lub powinien zostać udostępniony. Widzieć
hg pomoc fazy.
Publiczne Zestawy zmian w fazie publicznej zostały udostępnione repozytoriam publikacji i
są zatem uważane za niezmienne. Widzieć hg pomoc fazy.
Ciągnąć Operacja, podczas której w zdalnym repozytorium wprowadzane są zmiany, których nie ma w lokalnym
repozytorium są przenoszone do repozytorium lokalnego. Należy pamiętać, że ta operacja bez
argumenty specjalne aktualizują tylko repozytorium, nie aktualizują plików w
katalog roboczy. Widzieć hg pomoc Ciągnąć.
Naciskać Operacja, podczas której wprowadzane są zmiany w lokalnym repozytorium, które nie znajdują się w zdalnym
repozytorium są wysyłane do zdalnego repozytorium. Pamiętaj, że ta operacja tylko dodaje
zestawy zmian, które zostały zatwierdzone lokalnie w zdalnym repozytorium. Bezstronny
zmiany nie są wysyłane. Widzieć hg pomoc naciskać.
Magazyn
Metadane opisujące wszystkie zarejestrowane stany kolekcji plików. Każdy nagrany
stan jest reprezentowany przez zbiór zmian. Repozytorium zwykle (ale nie zawsze) zostaje znalezione
hg podkatalog katalogu roboczego. Każdy zarejestrowany stan można odtworzyć
poprzez „aktualizację” katalogu roboczego do określonego zestawu zmian.
Magazyn głowa
Zobacz „Głowa, repozytorium”.
Rewizja
Stan repozytorium w pewnym momencie. Wcześniejsze wersje można zaktualizować
do za pomocą hg aktualizacja. Zobacz także „Numer wersji”; Zobacz także „Zestaw zmian”.
Rewizja numer
Ta liczba całkowita jednoznacznie identyfikuje zestaw zmian w określonym repozytorium. To
reprezentuje kolejność, w jakiej zestawy zmian zostały dodane do repozytorium, zaczynając od
numer wersji 0. Należy pamiętać, że numer wersji może być inny w każdym klonie
repozytorium. Aby jednoznacznie zidentyfikować zestawy zmian pomiędzy różnymi klonami, zobacz
„Identyfikator zestawu zmian”.
Revlog Mechanizm przechowywania historii używany przez Mercurial. Jest to forma kodowania delta, w której
sporadyczna pełna rewizja danych, po której następuje delta każdej kolejnej rewizji. To
zawiera dane i indeks wskazujący dane.
Przepisanie historia
Zobacz „Historia, przepisywanie”.
Korzeń Zestaw zmian, którego rodzicem jest wyłącznie zestaw zmian o wartości null. Większość repozytoriów tak ma
tylko jeden główny zestaw zmian.
Tajemnica Zestawów zmian w fazie tajnej nie można udostępniać poprzez wypychanie, ściąganie ani klonowanie. Widzieć hg
pomoc fazy.
etykieta Alternatywna nazwa nadana zestawowi zmian. Tagi można stosować wszędzie tam, gdzie
Mercurial oczekuje identyfikatora zestawu zmian, np. with hg aktualizacja. Utworzenie tagu jest
przechowywane w historii i w ten sposób będą automatycznie udostępniane innym osobom za pomocą funkcji Push
i pociągnij.
Wskazówka Zestaw zmian o najwyższym numerze wersji. Jest to najnowszy zestaw zmian
dodane w repozytorium.
Wskazówka, oddział
Kierownik danego oddziału o najwyższym numerze rewizji. Kiedy nazwa oddziału to
używany jako identyfikator wersji, odnosi się do końcówki odgałęzienia. Zobacz także „Oddział,
głowa'. Należy to zauważyć, ponieważ numery wersji mogą się różnić w różnych repozytorium
klonów, wierzchołki gałęzi mogą być różne w różnych sklonowanych repozytoriach.
Aktualizacja (Rzeczownik) Kolejny synonim zestawu zmian.
Przykład: „Przesłałem aktualizację”.
(Czasownik) Termin ten jest zwykle używany do opisania aktualizacji stanu roboczego
katalog do katalogu określonego zestawu zmian. Widzieć hg pomoc aktualizacja.
Przykład: „Powinieneś zaktualizować”.
Pracujący katalog
Zobacz „Katalog, działa”.
Pracujący katalog roślina mateczna
Zobacz „Nadrzędny, katalog roboczy”.
SKŁADNIA DLA BYSTRY IGNOROWAĆ AKTA
streszczenie
System Mercurial wykorzystuje plik o nazwie .hgignore w katalogu głównym repozytorium do
kontrolować jego zachowanie podczas wyszukiwania plików, których aktualnie nie śledzi.
Opis
Katalog roboczy repozytorium Mercurial często będzie zawierał pliki, które nie powinny
być śledzone przez Mercurial. Należą do nich pliki kopii zapasowych utworzone przez redaktorów i produkty do kompilacji
utworzone przez kompilatory. Pliki te można zignorować, umieszczając je w pliku a .hgignore plik w
katalog główny katalogu roboczego. The .hgignore plik należy utworzyć ręcznie. To jest
zazwyczaj podlegają kontroli wersji, dzięki czemu ustawienia zostaną rozprzestrzenione na inne
repozytoria z funkcją push i pull.
Nieśledzony plik jest ignorowany, jeśli jego ścieżka jest względna w stosunku do katalogu głównego repozytorium lub dowolna
ścieżka prefiksu tej ścieżki jest dopasowywana do dowolnego wzorca w .hgignore.
Załóżmy na przykład, że mamy nieśledzony plik, plik.c, w a/b/plik.c w naszym repozytorium.
Mercurial zignoruje plik.c jeśli jakiś wzór .hgignore zapałki a/b/plik.c, / b or a.
Ponadto plik konfiguracyjny Mercurial może odwoływać się do zestawu dla użytkownika lub globalnego
ignorować pliki. Zobacz ignorować klucz konfiguracyjny na [UI] odcinek hg pomoc config dla
szczegółowe informacje na temat konfigurowania tych plików.
Aby kontrolować obsługę plików, którymi Mercurial zarządza, wiele poleceń obsługuje funkcję -I i
-X opcje; Widzieć hg pomoc i hg pomoc wzory dla szczegółów.
.hgignore nie ma wpływu na pliki, które są już śledzone, nawet jeśli pojawiają się w
.hgignore. Nieśledzony plik X można jawnie dodać za pomocą hg Dodaj X, nawet gdyby X tak było
wykluczone przez wzorzec w .hgignore.
Składnia
Plik ignorowanych to zwykły plik tekstowy składający się z listy wzorców, po jednym wzorcu na każdy
linia. Puste linie są pomijane. The # znak jest traktowany jako znak komentarza, a
\ znak jest traktowany jako znak ucieczki.
Mercurial obsługuje kilka składni wzorców. Domyślną używaną składnią jest styl Pythona/Perla
wyrażenia regularne.
Aby zmienić używaną składnię, użyj wiersza o następującej postaci:
składnia: NAZWA
gdzie IMIĘ jest jednym z następujących:
regexp
Wyrażenie regularne, składnia Pythona/Perla.
kula
Kula w stylu muszli.
Wybrana składnia pozostaje obowiązująca podczas analizowania wszystkich następujących po sobie wzorców, aż do pojawienia się kolejnego
wybrano składnię.
Ani wzorce globów, ani wyrażeń regularnych nie są zakorzenione. Wzorzec składni globowej formularza *.C będzie
dopasowuje plik kończący się na .c w dowolnym katalogu oraz wzór wyrażenia regularnego formularza \.c$ zrobi
ten sam. Aby wykorzenić wzorzec wyrażenia regularnego, zacznij go od ^.
Podkatalogi mogą mieć własne ustawienia .hgignore poprzez dodanie
subinclude:ścieżka/do/podkatalogu/.hgignore do korzenia .hgignore. Zobaczyć hg pomoc wzory dla
szczegóły dotyczące podobejmować: i zawierać:.
Uwaga Wzory określone w innych niż .hgignore są zawsze zakorzenione. Proszę zobaczyć hg pomoc
wzory dla szczegółów.
Przykład
Oto przykładowy plik ignorowania.
# użyj składni globalnej.
składnia: glob
*.elc
*.pyc
*~
# przełącz na składnię wyrażenia regularnego.
składnia: wyrażenie regularne
^\.szt/
KONFIGUROWANIE HGWEB
Wewnętrzny serwer sieciowy Mercurial, hgweb, może obsługiwać pojedyncze repozytorium lub drzewo
repozytoria. W drugim przypadku ścieżki repozytorium i opcje globalne można zdefiniować za pomocą
dedykowany plik konfiguracyjny wspólny dla hg służyć, hgweb.wsgi, hgweb.cgi i hgweb.fcgi.
Ten plik używa tej samej składni, co inne pliki konfiguracyjne Mercurial, ale rozpoznaje tylko
następujące sekcje:
· sieć
· ścieżki
· zbiory
Połączenia sieć opcje są dokładnie opisane w hg pomoc config.
Połączenia ścieżki sekcja odwzorowuje ścieżki URL na ścieżki repozytoriów w systemie plików. hgweb będzie
nie ujawniaj bezpośrednio systemu plików - można publikować tylko i wyłącznie repozytoria Mercurial
zgodnie z konfiguracją.
Lewa strona to ścieżka w adresie URL. Zauważ, że hgweb rezerwuje podścieżki, takie jak obrót silnika or
filet, spróbuj użyć różnych nazw zagnieżdżonych repozytoriów, aby uniknąć mylących efektów.
Prawa strona to ścieżka w systemie plików. Jeśli określona ścieżka kończy się na * or **
system plików będzie przeszukiwany rekurencyjnie w poszukiwaniu repozytoriów poniżej tego punktu. Z * it
nie będzie wracać do znalezionych repozytoriów (z wyjątkiem .hg/patches). Z ** to będzie
przeszukaj także katalogi robocze repozytoriów i ewentualnie znajdź podrepozytoria.
W tym przykładzie:
[ścieżki]
/projects/a = /srv/tmprepos/a
/projects/b = c:/repos/b
/ = /srv/repo/*
/user/bob = /home/bob/repos/**
· Pierwsze dwa wpisy powodują wyświetlenie dwóch repozytoriów w różnych katalogach
ten sam katalog w interfejsie internetowym
· Trzeci wpis opublikuje każde znalezione repozytorium Mercurial /srv/repozytoria/, Dla
przykład repozytorium /srv/repos/quux/ pojawi się jako http://server/quux/
· Czwarty wpis opublikuje oba http://server/user/bob/quux/ i
http://server/user/bob/quux/testsubrepo/
Połączenia kolekcje sekcja jest przestarzała i została zastąpiona przez ścieżki.
Używać i wspólny Argumenty
Adresy URL w każdym repozytorium mają postać /{polecenie}[/{argumenty}] gdzie {Komenda}
reprezentuje nazwę polecenia lub procedury obsługi i {argumenty} reprezentuje dowolną liczbę
dodatkowe parametry adresu URL do tego polecenia.
Z serwerem WWW jest powiązany styl domyślny. Style są mapowane na kolekcję nazwaną
szablony. Każdy szablon służy do renderowania określonego fragmentu danych, takiego jak zestaw zmian
lub różnic.
Styl bieżącego żądania można zastąpić na dwa sposoby. Po pierwsze, jeśli {Komenda}
zawiera łącznik (-), tekst przed łącznikiem określa styl. Na przykład,
/atom-log wyrenderuje log moduł obsługi poleceń z atom styl. Drugi sposób ustawienia
styl jest z styl Argument ciągu zapytania. Na przykład, /log?style=atom,
preferowany jest parametr adresu URL z łącznikami.
Nie wszystkie szablony są dostępne dla wszystkich stylów. Próba użycia stylu, który tego nie robi
zdefiniowanie wszystkich szablonów może spowodować błąd podczas renderowania strony.
Wiele poleceń wymaga a {rewizja} Parametr adresu URL. Definiuje zestaw zmian, na którym można operować.
Jest to powszechnie określane jako krótki, 12-cyfrowy skrót szesnastkowy oznaczający pełne 40
znakowy unikalny identyfikator wersji. Jednak dowolna wartość opisana przez hg pomoc rewizje
zazwyczaj działa.
Polecenia i Używać
Dostępne są następujące polecenia internetowe i ich adresy URL:
/annotate/{wersja}/{ścieżka}
Pokaż informacje o zestawie zmian dla każdej linii w pliku.
Połączenia plikadnotacja szablon jest renderowany.
/archiwum/{wersja}.{format}[/{ścieżka}]
Uzyskaj archiwum zawartości repozytorium.
Zawartość i typ archiwum określa parametr ścieżki URL. format jest
rozszerzenie pliku typu archiwum, które ma zostać wygenerowane. np zamek błyskawiczny or tar.bz2. Nie wszystkie archiwalne
typy mogą być dozwolone przez konfigurację serwera.
Opcjonalne ścieżka Parametr adresu URL kontroluje zawartość, która ma zostać uwzględniona w archiwum. Jeśli zostanie pominięty,
każdy plik w określonej wersji jest obecny w archiwum. Jeśli uwzględnione, tylko
określony plik lub zawartość określonego katalogu zostanie uwzględniona w archiwum.
Dla tego modułu obsługi nie jest używany żaden szablon. Generowana jest surowa, binarna treść.
/zakładki
Pokaż informacje o zakładkach.
Żadne argumenty nie są akceptowane.
Połączenia bookmarks szablon jest renderowany.
/gałęzie
Pokaż informacje o oddziałach.
Na wyjściu znajdują się wszystkie znane gałęzie, nawet gałęzie zamknięte.
Żadne argumenty nie są akceptowane.
Połączenia gałęzie szablon jest renderowany.
/changelog[/{wersja}]
Pokaż informacje o wielu zestawach zmian.
Jeśli opcjonalne rewizja Brak argumentu adresu URL, informacja o rozpoczęciu wszystkich zestawów zmian
at typ zostanie wyrenderowany. Jeśli rewizja argument jest obecny, zostaną pokazane zestawy zmian
począwszy od określonej wersji.
If rewizja jest nieobecny, obrót silnika Można zdefiniować argument ciągu zapytania. Spowoduje to wykonanie a
wyszukaj zestawy zmian.
Argument za obrót silnika może to być pojedyncza wersja, zestaw wersji lub dosłowne słowo kluczowe do
wyszukaj w danych zestawu zmian (odpowiednik hg log -k).
Połączenia liczba obrotów Argument ciągu zapytania definiuje maksymalną liczbę zestawów zmian do renderowania.
W przypadku innych niż wyszukiwania, changelog szablon zostanie wyrenderowany.
/changeset[/{wersja}]
Pokaż informacje o pojedynczym zestawie zmian.
Argument ścieżki adresu URL jest wyświetlanym identyfikatorem zestawu zmian. Widzieć hg pomoc rewizje dla
możliwa wartość. Jeśli nie zdefiniowano, typ zostanie wyświetlony zestaw zmian.
Połączenia changeset szablon jest renderowany. Zawartość zmianytag, zmieńzakładkę,
odnośnik do pliku, pliknolink, i można do tego wykorzystać wiele szablonów związanych z różnicami
wygenerować wynik.
/comparison/{wersja}/{ścieżka}
Pokaż porównanie starej i nowej wersji pliku na podstawie zmian dokonanych w pliku
konkretna rewizja.
Jest to podobne do diff treser. Jednak ten formularz zawiera podział lub side-by-side
diff zamiast ujednoliconego porównania.
Połączenia kontekst Argumentu ciągu zapytania można użyć do kontrolowania linii kontekstu w pliku różnicowym.
Połączenia porównanie plików szablon jest renderowany.
/diff/{wersja}/{ścieżka}
Pokaż, jak plik zmienił się w konkretnym zatwierdzeniu.
Połączenia plikiff szablon jest renderowany.
Ten moduł obsługi jest zarejestrowany zarówno pod /różnica i /filediff ścieżki /różnica stosuje się
nowoczesny kod.
/plik/{wersja}[/{ścieżka}]
Wyświetla informacje o katalogu lub pliku w repozytorium.
Informacje o ścieżka podany jako parametr adresu URL zostanie wyrenderowany.
If ścieżka jest katalogiem, zostaną wyświetlone informacje o wpisach w tym katalogu.
Ta forma jest równoznaczna z manifestować treser.
If ścieżka jest plikiem, informacja o tym pliku zostanie wyświetlona poprzez wersja pliku
szablon.
If ścieżka nie jest zdefiniowany, zostanie wyświetlona informacja o katalogu głównym.
/diff/{wersja}/{ścieżka}
Pokaż, jak plik zmienił się w konkretnym zatwierdzeniu.
Połączenia plikiff szablon jest renderowany.
Ten moduł obsługi jest zarejestrowany zarówno pod /różnica i /filediff ścieżki /różnica stosuje się
nowoczesny kod.
/filelog/{wersja}/{ścieżka}
Wyświetla informacje o historii pliku w repozytorium.
Połączenia liczba obrotów Można zdefiniować argument ciągu zapytania w celu kontrolowania maksymalnej liczby wpisów
pokazywać.
Połączenia dziennik plików szablon zostanie wyrenderowany.
/wykres[/{wersja}]
Wyświetl informacje o topologii graficznej repozytorium.
Informacje renderowane przez tę procedurę obsługi mogą zostać użyte do tworzenia wizualnych reprezentacji
topologia repozytorium.
Połączenia rewizja Parametr adresu URL kontroluje początkowy zestaw zmian.
Połączenia liczba obrotów Argument ciągu zapytania może definiować liczbę zestawów zmian w celu wyświetlenia informacji
dla.
Ten moduł obsługi wyrenderuje plik wykres szablon.
/Temat pomocy}]
Renderuj dokumentację pomocy.
To polecenie sieciowe jest z grubsza równoważne z hg pomoc. Jeśli aktualny jest zdefiniowany ten temat pomocy
zostanie wyrenderowany. Jeśli nie, zostanie wyświetlony indeks dostępnych tematów pomocy.
Połączenia pomoc szablon zostanie wyświetlony, gdy poprosisz o pomoc w danym temacie. tematy pomocy będzie
renderowane dla indeksu tematów pomocy.
/log[/{wersja}[/{ścieżka}]]
Pokaż historię repozytorium lub pliku.
Dla adresów URL formularza /log/{wersja}, lista zestawów zmian rozpoczynająca się od określonego
wyświetlany jest identyfikator zestawu zmian. Jeśli {rewizja} nie jest zdefiniowany, wartością domyślną jest typ. Ten formularz
jest równoważne z changelog treser.
Dla adresów URL formularza /log/{wersja}/{plik}, będzie to historia konkretnego pliku
pokazane. Ta forma jest równoznaczna z dziennik plików treser.
/manifest[/{wersja}[/{ścieżka}]]
Pokaż informacje o katalogu.
Jeśli argumenty ścieżki URL zostaną pominięte, informacja o katalogu głównym pliku typ
zostanie wyświetlony zestaw zmian.
Ponieważ ta procedura obsługi może wyświetlać tylko informacje o katalogach, zaleca się jej użycie
dotychczasowy filet handler, ponieważ może obsługiwać zarówno katalogi, jak i pliki.
Połączenia manifestować szablon zostanie wyrenderowany dla tego modułu obsługi.
/changeset[/{wersja}]
Pokaż informacje o pojedynczym zestawie zmian.
Argument ścieżki adresu URL jest wyświetlanym identyfikatorem zestawu zmian. Widzieć hg pomoc rewizje dla
możliwa wartość. Jeśli nie zdefiniowano, typ zostanie wyświetlony zestaw zmian.
Połączenia changeset szablon jest renderowany. Zawartość zmianytag, zmieńzakładkę,
odnośnik do pliku, pliknolink, i można do tego wykorzystać wiele szablonów związanych z różnicami
wygenerować wynik.
/krótki dziennik
Pokaż podstawowe informacje o zestawie zestawów zmian.
Akceptuje te same parametry co changelog treser. Jedyna różnica polega na tym, że
krótki dziennik szablon zostanie wyrenderowany zamiast changelog szablon.
/streszczenie
Pokaż podsumowanie stanu repozytorium.
Przechwytywane są przez to informacje o najnowszych zestawach zmian, zakładkach, znacznikach i gałęziach
treser.
Połączenia streszczenie szablon jest renderowany.
/tagi
Pokaż informacje o tagach.
Żadne argumenty nie są akceptowane.
Połączenia tagi szablon jest renderowany.
TECHNICZNE Realizacja TEMATY
wiązki
kontener do wymiany danych repozytorium
grupy zmian
reprezentacja danych revlog
revlogi
mechanizm przechowywania wersji
MERGE TOOLS
Do łączenia plików Mercurial używa narzędzi do łączenia.
Narzędzie scalania łączy dwie różne wersje pliku w scalony plik. Narzędzia scalania są
biorąc pod uwagę dwa pliki i największego wspólnego przodka obu wersji plików, więc mogą
określić zmiany wprowadzone w obu gałęziach.
Narzędzia scalania służą do obu celów hg rozwiązać, hg łączyć, hg aktualizacja, hg wycofać się i w kilku
rozszerzenia.
Zwykle narzędzie do scalania próbuje automatycznie pogodzić pliki, łącząc je wszystkie
nienakładających się zmian, które wystąpiły oddzielnie w dwóch różnych ewolucjach
ten sam początkowy plik podstawowy. Co więcej, niektóre interaktywne programy do scalania ułatwiają to
ręcznie rozwiąż konflikty scalania, w sposób graficzny lub wstawiając je
znaczniki konfliktu. Mercurial nie zawiera żadnych interaktywnych programów do łączenia, ale opiera się na nich
zewnętrzne narzędzia do tego.
Dostępny łączyć narzędzia
Zewnętrzne narzędzia scalania i ich właściwości konfiguruje się w konfiguracji narzędzi scalania
sekcja - patrz hgrc(5) - ale często można je nazwać po prostu plikiem wykonywalnym.
Narzędzie do łączenia jest ogólnie przydatne, jeśli jego plik wykonywalny można znaleźć w systemie i jeśli tak jest
może obsłużyć połączenie. Plik wykonywalny zostanie znaleziony, jeśli jest to plik wykonywalny bezwzględny lub względny
ścieżka lub nazwa aplikacji w ścieżce wyszukiwania pliku wykonywalnego. Zakłada się, że narzędzie
być w stanie obsłużyć łączenie, jeśli obsługuje dowiązania symboliczne, jeśli plik jest dowiązaniem symbolicznym, jeśli to możliwe
obsługiwać pliki binarne, jeśli plik jest binarny i jeśli dostępny jest GUI, jeśli narzędzie tego wymaga
graficzny interfejs użytkownika.
Istnieje kilka wewnętrznych narzędzi do scalania, których można użyć. Wewnętrzne narzędzia scalania to:
:wysypisko
Tworzy trzy wersje plików do połączenia, zawierające zawartość lokalną,
inne i podstawowe. Pliki te można następnie wykorzystać do ręcznego przeprowadzenia scalania. Jeśli
nazwa pliku, który ma zostać scalony a.txt, pliki te zostaną odpowiednio nazwane
a.txt.local, a.txt.inny i a.txt.base i zostaną umieszczeni w tym samym
katalog jako a.txt.
:ponieść porażkę
Zamiast próbować scalić pliki, które zostały zmodyfikowane w obu gałęziach, zaznacza
je jako nierozwiązane. Aby rozwiązać te konflikty, należy użyć polecenia Resolve.
:lokalny
Używa lokalnej wersji plików jako wersji scalonej.
:łączyć
Używa wewnętrznego, nieinteraktywnego prostego algorytmu scalania do łączenia plików. To będzie
zakończy się niepowodzeniem, jeśli wystąpią jakiekolwiek konflikty i pozostawi znaczniki w częściowo scalonym pliku.
Znaczniki będą miały dwie sekcje, po jednej dla każdej strony połączenia.
:merge-local
Podobnie jak :merge, ale rozwiązuj wszystkie konflikty w sposób nieinteraktywny na korzyść lokalnego
zmiany.
:scal inne
Podobnie jak :merge, ale rozwiązuj wszystkie konflikty w sposób nieinteraktywny na korzyść drugiego
zmiany.
:scal 3
Używa wewnętrznego, nieinteraktywnego prostego algorytmu scalania do łączenia plików. To będzie
zakończy się niepowodzeniem, jeśli wystąpią jakiekolwiek konflikty i pozostawi znaczniki w częściowo scalonym pliku.
Znacznik będzie miał trzy sekcje, po jednej z każdej strony połączenia i jedną dla
zawartość podstawowa.
:Inny
Używa innej wersji plików jako wersji scalonej.
:podpowiedź
Pyta użytkownika, którą wersję lokalną czy inną zachować jako połączoną
wersja.
:tagmerge
Używa wewnętrznego algorytmu scalania tagów (eksperymentalnie).
:unia
Używa wewnętrznego, nieinteraktywnego prostego algorytmu scalania do łączenia plików. To będzie
w przypadku regionów objętych konfliktem używaj zarówno lewej, jak i prawej strony. Nie wstawiono żadnych znaczników.
Narzędzia wewnętrzne są zawsze dostępne i nie wymagają GUI, ale domyślnie nie będą
obsługiwać dowiązania symboliczne lub pliki binarne.
Wybór a łączyć narzędzie
Mercurial korzysta z następujących zasad przy podejmowaniu decyzji, którego narzędzia scalania użyć:
1. Jeśli określono narzędzie z opcją --tool do łączenia lub rozwiązywania, zostanie ono użyte.
Jeśli jest to nazwa narzędzia w konfiguracji merge-tools, jego konfiguracja jest taka
używany. W przeciwnym razie określone narzędzie musi być wykonywalne przez powłokę.
2. Jeśli HGMERGE zmienna środowiskowa jest obecna, jej wartość jest używana i musi być
wykonywalny przez powłokę.
3. Jeśli nazwa pliku, który ma zostać scalony, odpowiada któremukolwiek ze wzorców w pliku
sekcja konfiguracji wzorców łączenia, pierwsze użyteczne narzędzie łączenia odpowiadające a
używany jest pasujący wzór. Tutaj możliwości binarne narzędzia scalającego nie są
uważane.
4. Jeśli ui.merge jest ustawione, zostanie ono rozpatrzone w następnej kolejności. Jeśli wartość nie jest nazwą a
skonfigurowanego narzędzia, używana jest określona wartość, która musi być wykonywalna przez powłokę.
W przeciwnym razie nazwane narzędzie zostanie użyte, jeśli będzie użyteczne.
5. Jeśli w sekcji konfiguracji narzędzi do łączenia znajdują się jakieś przydatne narzędzia do łączenia, to jedno
o najwyższym priorytecie.
6. Jeśli program o nazwie hgmerge można znaleźć w systemie, jest używany - ale przejdzie
domyślnie nie można go używać w przypadku dowiązań symbolicznych i plików binarnych.
7. Jeśli plik do scalania nie jest binarny i nie jest dowiązaniem symbolicznym, to wewnętrzny :łączyć is
używany.
8. Scalanie pliku nie powiodło się i należy je rozwiązać przed zatwierdzeniem.
Uwaga Po wybraniu programu do łączenia Mercurial domyślnie podejmie próbę połączenia
plików, używając najpierw prostego algorytmu scalania. Tylko jeśli to się nie uda z powodu
sprzeczne zmiany Mercurial faktycznie wykona program scalania. Czy
użyj najpierw prostego algorytmu scalania, można to kontrolować za pomocą ustawienia wstępnego scalania
narzędzie scalania. Funkcja Premerge jest domyślnie włączona, chyba że plik jest binarny lub a
dowiązanie symboliczne.
Zobacz sekcje dotyczące narzędzi do łączenia i interfejsu użytkownika hgrc(5) aby uzyskać szczegółowe informacje na temat konfiguracji scalania
narzędzia.
OKREŚLANIE WIELOKROTNOŚĆ REWIZJE
Jeżeli Mercurial zaakceptuje więcej niż jedną wersję, mogą one zostać określone indywidualnie lub
podany jako topologicznie ciągły zakres, oddzielony znakiem „:”.
Składnia zapisu zakresu jest następująca: [BEGIN]:[END], gdzie BEGIN i END oznaczają wersję
identyfikatory. Zarówno BEGIN, jak i END są opcjonalne. Jeśli BEGIN nie jest określony, domyślnie jest to
numer wersji 0. Jeśli END nie jest określony, domyślnie jest to końcówka. Zakres „:” w ten sposób
oznacza „wszystkie wersje”.
Jeśli BEGIN jest większe niż END, poprawki są traktowane w odwrotnej kolejności.
Zakres pełni funkcję zamkniętego przedziału. Oznacza to, że zakres 3:5 daje 3, 4 i 5.
Podobnie zakres 9:6 daje 9, 8, 7 i 6.
FILE IMIĘ WZORY
Mercurial akceptuje kilka zapisów do identyfikacji jednego lub większej liczby plików jednocześnie.
Domyślnie Mercurial traktuje nazwy plików jako rozszerzone wzorce globów w stylu powłoki.
Alternatywne zapisy wzorców muszą być wyraźnie określone.
Uwaga Wzory określone w .hgignore nie są zrootowane. Proszę zobaczyć hg pomoc hgignore dla
detale.
Aby użyć zwykłej nazwy ścieżki bez dopasowywania wzorców, zacznij od ścieżka:. Te ścieżki
nazwy muszą całkowicie pasować, zaczynając od bieżącego katalogu głównego repozytorium.
Aby użyć rozszerzonej glob, rozpocznij nazwę od glob:. Globy są zakorzenione w prądzie
informator; kula taka jak *.C dopasuje tylko pliki w bieżącym katalogu kończącym się na
.c.
Obsługiwane rozszerzenia składni glob to ** aby dopasować dowolny ciąg znaków poprzez separatory ścieżek i
{a, b} oznaczać „a lub b”.
Aby użyć wyrażenia regularnego Perla/Pythona, nazwę należy rozpocząć od re:. Dopasowanie wzorca wyrażeń regularnych
jest zakotwiczony w katalogu głównym repozytorium.
Aby odczytać wzorce nazw z pliku, użyj plik listy: or plik listy0:. Ten ostatni oczekuje wartości null
rozdzielane wzorce, podczas gdy ten pierwszy oczekuje wysuwu wiersza. Każdy ciąg znaków odczytany z pliku jest
sam w sobie traktowany jako wzór pliku.
Aby odczytać zestaw wzorców z pliku, użyj zawierać: or podobejmować:. zawierać: wykorzystam wszystko
wzorce z danego pliku i traktować je tak, jakby były przekazywane ręcznie.
podobejmować: zastosuje wzorce tylko do plików znajdujących się w subinclude
katalog pliku. Widzieć hg pomoc hgignore aby uzyskać szczegółowe informacje na temat formatu tych plików.
Wszystkie wzory z wyjątkiem glob: określone w wierszu poleceń (nie dla -I or -X opcje), może
dopasuj także do katalogów: pliki w dopasowanych katalogach są traktowane jako dopasowane.
Proste przykłady:
ścieżka:foo/bar pasek nazw w katalogu o nazwie foo w katalogu głównym
repozytorium
ścieżka:ścieżka:nazwa pliku lub katalogu o nazwie „ścieżka:nazwa”
Przykłady globusów:
glob:*.c dowolna nazwa kończąca się na „.c” w bieżącym katalogu
*.c dowolna nazwa kończąca się na „.c” w bieżącym katalogu
**.c dowolna nazwa kończąca się na „.c” w dowolnym podkatalogu pliku
bieżący katalog, w tym sam.
foo/*.c dowolna nazwa kończąca się na „.c” w katalogu foo
foo/**.c dowolna nazwa kończąca się na „.c” w dowolnym podkatalogu foo
włączając siebie.
Przykłady wyrażeń regularnych:
re:.*\.c$ dowolna nazwa kończąca się na „.c” w dowolnym miejscu repozytorium
Przykłady plików:
listfile:list.txt czyta listę z list.txt z jednym wzorcem pliku w linii
listfile0:list.txt czyta listę z list.txt z ogranicznikami bajtów zerowych
Zobacz też hg pomoc zestawy plików.
Uwzględnij przykłady:
include:path/to/mypatternfile odczytuje wzorce, które mają zostać zastosowane do wszystkich ścieżek
subinclude:path/to/subignorefile odczytuje wzorce specjalnie dla ścieżek w pliku
podkatalog
PRACA Z FAZY
Co jest fazy?
Fazy to system śledzenia, które zestawy zmian zostały lub powinny zostać udostępnione. Ten
pomaga zapobiegać typowym błędom podczas modyfikowania historii (na przykład za pomocą mq lub rebase
rozszerzenia).
Każdy zestaw zmian w repozytorium znajduje się w jednej z następujących faz:
· public: zestaw zmian jest widoczny na serwerze publicznym
· wersja robocza: zestaw zmian nie został jeszcze opublikowany
· sekret: zestawu zmian nie należy wypychać, wyciągać ani klonować
Fazy te są uporządkowane (publiczne < wersja robocza < tajne) i żaden zestaw zmian nie może znajdować się w niższym
fazie niż jej przodkowie. Na przykład, jeśli zestaw zmian jest publiczny, są nim wszyscy jego przodkowie
także publiczne. Wreszcie fazy zestawu zmian należy zmieniać wyłącznie w stronę fazy publicznej.
W jaki sposób jest fazy zarządzany?
W przeważającej części fazy powinny działać przejrzyście. Domyślnie zestaw zmian jest tworzony w
fazie roboczej i przechodzi do fazy publicznej, gdy zostanie przesunięty do kolejnej
magazyn.
Gdy zestawy zmian staną się publiczne, rozszerzenia takie jak mq i rebase przestaną działać
je, aby zapobiec tworzeniu się duplikatów zestawów zmian. Fazami można także manipulować ręcznie
z hg faza polecenie, jeśli zajdzie taka potrzeba. Widzieć hg pomoc -v faza dla przykładów.
Aby domyślnie uczynić swoje zatwierdzenia tajnymi, umieść to w pliku konfiguracyjnym:
[fazy]
nowe zatwierdzenie = sekret
Fazy i serwery
Zwykle wszystkie serwery są wydawniczy domyślnie. To znaczy:
- wszystkie wyciągnięte lub sklonowane zestawy zmian wersji roboczej pojawiają się w fazie
publiczny na kliencie
- wszystkie przesłane zestawy zmian w wersji roboczej są widoczne w obu przypadkach jako publiczne
klient i serwer
- tajne zestawy zmian nie są wypychane, wyciągane ani klonowane
Uwaga Pobranie wersji roboczej zestawu zmian z serwera publikującego nie oznacza go jako publicznego
po stronie serwera ze względu na charakter ściągania tylko do odczytu.
Czasami pożądane może być wypychanie i pobieranie zestawów zmian w fazie roboczej w celu udostępnienia
niedokończona praca. Można to zrobić, ustawiając repozytorium tak, aby wyłączało publikowanie w jego repozytorium
plik konfiguracyjny:
[fazy]
opublikować = fałsz
See hg pomoc config aby uzyskać więcej informacji na temat plików konfiguracyjnych.
Uwaga Serwery, na których działają starsze wersje Mercurial, są traktowane jako serwery publikujące.
Uwaga Zestawy zmian w fazie tajnej nie są wymieniane z serwerem. Dotyczy to ich
treść: nazwy plików, zawartość plików i metadane zestawu zmian. Ze względów technicznych,
można przekazać identyfikator (np. d825e4025e39) tajnego zestawu zmian
serwer.
Przykłady
· lista zestawów zmian w fazie roboczej lub tajnej:
hg log -r „niepubliczne()”
· zmień wszystkie tajne zestawy zmian na wersję roboczą:
hg faza --draft „secret()”
· wymuś przeniesienie bieżącego zestawu zmian i elementów potomnych z publicznego do wersji roboczej:
hg faza --siła --draft .
· pokaż listę wersji i fazy zestawu zmian:
hg log --template "{rev} {faza}\n"
· resynchronizować wersje robocze zestawów zmian względem zdalnego repozytorium:
hg faza -fd "wychodzące(URL)"
See hg pomoc faza aby uzyskać więcej informacji na temat ręcznego manipulowania fazami.
OKREŚLANIE SINGLE REWIZJE
Mercurial obsługuje kilka sposobów określania indywidualnych wersji.
Zwykła liczba całkowita jest traktowana jako numer wersji. Ujemne liczby całkowite są traktowane jako
kolejne przesunięcia od końcówki, gdzie -1 oznacza końcówkę, -2 oznacza poprzednią wersję
do końcówki i tak dalej.
40-cyfrowy ciąg szesnastkowy jest traktowany jako unikalny identyfikator wersji.
Ciąg szesnastkowy o długości mniejszej niż 40 znaków jest traktowany jako unikalna wersja
identyfikator i jest określany jako identyfikator skrócony. Tylko identyfikator w formie krótkiej
ważny, jeśli jest przedrostkiem dokładnie jednego identyfikatora o pełnej długości.
Każdy inny ciąg znaków jest traktowany jako zakładka, znacznik lub nazwa gałęzi. Zakładka jest rzeczą ruchomą
wskaźnik do rewizji. Znacznik to trwała nazwa powiązana z rewizją. Nazwa oddziału
oznacza najbardziej otwartą główkę gałęzi tej gałęzi - lub jeśli wszystkie są zamknięte,
najbardziej zamknięta główka gałęzi. Nazwy zakładek, znaczników i gałęzi nie mogą zawierać rozszerzenia
":" postać.
Zastrzeżona nazwa „tip” zawsze identyfikuje najnowszą wersję.
Zastrzeżona nazwa „null” wskazuje wersję zerową. To jest rewizja pustego
repozytorium i rodzicem wersji 0.
Zastrzeżona nazwa „.” wskazuje nadrzędny katalog roboczy. Jeśli nie ma katalogu roboczego
zaznaczone, jest to równoznaczne z wartością null. Jeśli trwa niezatwierdzone scalanie, „.” jest
rewizja pierwszego rodzica.
OKREŚLANIE PRZEGLĄD ZESTAWY
Mercurial obsługuje funkcjonalny język służący do wybierania zestawu wersji.
Język obsługuje wiele predykatów, które są łączone operatorami infiksowymi.
Do grupowania można używać nawiasów.
Identyfikatory, takie jak nazwy oddziałów, mogą wymagać cytowania w pojedynczym lub podwójnym cudzysłowie, jeśli tak jest
zawierać znaki takie jak - lub jeśli pasują do jednego z predykatów.
Znaki specjalne można stosować w identyfikatorach w cudzysłowie, zmieniając je, np. \n is
interpretowane jako znak nowej linii. Aby zapobiec ich interpretacji, ciągi znaków można poprzedzać
w rnp R'...'.
Istnieje jeden operator przedrostkowy:
nie x
Zestawy zmian nie w x. Krótka forma jest ! x.
Oto obsługiwane operatory infix:
x::y
Zakres DAG, oznaczający wszystkie zestawy zmian, które są potomkami x i przodkami y,
łącznie z samymi x i y. Jeśli pierwszy punkt końcowy zostanie pominięty, jest to równoważne
do przodkowie (y), jeśli drugi zostanie pominięty, jest to równoważne potomkowie(x).
Alternatywna składnia to x..y.
x: y
Wszystkie zestawy zmian z numerami wersji od x do y, oba włącznie. Albo
punkt końcowy można pominąć, domyślnie wynosi 0 i przechyla się.
x i y
Przecięcie zbiorów zmian w x i y. Krótka forma jest x & y.
x or y
Suma zbiorów zmian w x i y. Istnieją dwie alternatywne krótkie formy: x | y
i x + y.
x - y
Zestawy zmian w x, ale nie w y.
x^n
N-ty rodzic x, n == 0, 1 lub 2. Dla n == 0, x; dla n == 1, pierwszy rodzic
każdego zestawu zmian w x; dla n == 2, drugi rodzic zestawu zmian w x.
x~n
n-ty pierwszy przodek x; x~0 jest x; x~3 is x^^^.
Istnieje jeden operator postfiksowy:
x^
Równoważny x^1, pierwszy rodzic każdego zestawu zmian w x.
Obsługiwane są następujące predykaty:
dodaje (wzór)
Zestawy zmian, które dodają wzorzec dopasowywania plików.
Wzór bez wyraźnego rodzaju glob: oczekuje się, że będzie w stosunku do
bieżący katalog i dopasuj go do pliku lub katalogu.
Wszystko()
Wszystkie zestawy zmian, takie same jak 0: wskazówka.
przodek(*zestaw zmian)
Największy wspólny przodek zestawów zmian.
Akceptuje 0 lub więcej zestawów zmian. Zwróci pustą listę, jeśli nie zostaną przekazane żadne argumenty.
Największym wspólnym przodkiem pojedynczego zestawu zmian jest ten zestaw zmian.
przodkowie (zestaw)
Zestawy zmian, które są przodkami zestawu zmian w zestawie.
autor(ciąg)
Alias dla użytkownik(ciąg).
przepoławiać (ciąg)
Zestawy zmian zaznaczone w określonym statusie dwudzielności:
· dobry, zły, pominąć: csety wyraźnie oznaczone jako dobre/złe/pomiń
· towary, złe : custawia topologicznie dobry/zły
· zasięg : czbiory biorące udział w bisekcji
· przycięte : zestawy, które są dobre, złe lub pominięte
· niesprawdzone : csets, których los jest jeszcze nieznany
· ignorowane : csets ignorowane ze względu na topologię DAG
· aktualne : zestaw cset aktualnie dzielony na pół
zakładka([nazwa])
Nazwana zakładka lub wszystkie zakładki.
If Nazwa zaczynać z re:, pozostała część nazwy jest traktowana jako zwykła
wyrażenie. Aby dopasować zakładkę, która faktycznie zaczyna się od re:, użyj przedrostka
dosłowny:.
gałąź (ciąg or set)
Wszystkie zestawy zmian należące do danej gałęzi lub gałęzi danej gałęzi
zestawy zmian.
If ciąg zaczynać z re:, pozostała część nazwy jest traktowana jako zwykła
wyrażenie. Aby dopasować gałąź, która faktycznie zaczyna się od re:, użyj przedrostka
dosłowny:.
punkt rozgałęzienia()
Zestawy zmian z więcej niż jednym dzieckiem.
zderzył się()
Zmienne zestawy zmian oznaczone jako następcy publicznych zestawów zmian.
Mogą to być tylko niepubliczne i nieprzestarzałe zestawy zmian zderzyłem.
pakiet()
Zestawy zmian w pakiecie.
Pakiet musi być określony opcją -R.
dzieci (zestaw)
Podrzędne zestawy zmian zestawów zmian w zestawie.
Zamknięte()
Zestaw zmian jest zamknięty.
zawiera (wzór)
Manifest wersji zawiera wzorzec dopasowania pliku (ale może go nie modyfikować).
See hg pomoc wzory aby uzyskać informacje na temat wzorców plików.
Wzór bez wyraźnego rodzaju glob: oczekuje się, że będzie w stosunku do
bieżący katalog i dopasuj do pliku dokładnie dla wydajności.
przekonwertowany([id])
Zestawy zmian przekonwertowane z danego identyfikatora w starym repozytorium, jeśli istnieje, lub
wszystkie skonwertowane zestawy zmian, jeśli nie określono żadnego identyfikatora.
data (interwał)
Zestawy zmian w przedziale, patrz hg pomoc daty.
opis(ciąg)
Wyszukaj wiadomość zatwierdzenia dla ciągu. W dopasowaniu nie ma znaczenia wielkość liter.
potomkowie (zestaw)
Zestawy zmian, które są potomkami zestawów zmian w zestawie.
miejsce docelowe([zestaw])
Zestawy zmian utworzone w wyniku operacji przeszczepu, przeszczepu lub zmiany bazy, z rozszerzeniem
biorąc pod uwagę wersje określone jako źródło. Pominięcie zestawu opcjonalnego jest równoznaczne z
przekazując wszystko().
rozbieżny()
Końcowi następcy zestawów zmian z alternatywnym zestawem końcowych następców.
projekt()
Zestaw zmian w fazie roboczej.
wymarły()
Tylko przestarzałe zestawy zmian z przestarzałymi potomkami.
dodatkowy (etykieta, [wartość])
Zestawy zmian z podaną etykietą w dodatkowych metadanych, z podaną opcją
wartość.
If wartość zaczynać z re:, pozostała część wartości jest traktowana jako zwykła
wyrażenie. Aby dopasować wartość, która faktycznie zaczyna się od re:, użyj przedrostka
dosłowny:.
plik (wzór)
Zestawy zmian wpływające na pliki dopasowane według wzorca.
Aby uzyskać szybszy, ale mniej dokładny wynik, rozważ użycie dziennik plików() zamiast.
Ten predykat używa glob: jako domyślny rodzaj wzoru.
dziennik plików (wzorzec)
Zestawy zmian połączone z określonym logiem plików.
Ze względu na wydajność odwiedza tylko wersje wymienione w dzienniku plików na poziomie pliku,
zamiast filtrować wszystkie zestawy zmian (znacznie szybciej, ale nie obejmuje
usuwa lub powiela zmiany). Aby uzyskać wolniejszy i dokładniejszy wynik, użyj plik().
Wzór bez wyraźnego rodzaju glob: oczekuje się, że będzie w stosunku do
bieżący katalog i dopasuj do pliku dokładnie dla wydajności.
Jeśli jakiś linkrev wskaże wersje przefiltrowane przez bieżącą ponowną opinię, będziemy działać
wokół niego, aby zwrócić niefiltrowaną wartość.
pierwszy (zestaw, [N])
Alias dla limit().
podążaj za ([wzorzec])
Alias dla ::. (przodkowie pierwszego rodzica katalogu roboczego). Jeśli wzór
jest określony, śledzone są historie plików pasujących do danego wzorca, włączając
egzemplarzy.
grep(wyrażenie regularne)
Jak słowo kluczowe (ciąg) ale akceptuje wyrażenie regularne. Używać grep(r'...') aby zapewnić specjalną ucieczkę
znaki są obsługiwane prawidłowo. w odróżnieniu słowo kluczowe (ciąg), mecz jest
rozróżniana jest wielkość liter.
głowa()
Changeset to nazwany szef oddziału.
głowice (zestaw)
Członkowie zestawu bez dzieci w zestawie.
ukryty()
Ukryte zestawy zmian.
identyfikator (ciąg)
Wersja niejednoznacznie określona przez podany przedrostek w postaci ciągu szesnastkowego.
słowo kluczowe (ciąg)
Wyszukaj wiadomość zatwierdzenia, nazwę użytkownika i nazwy zmienionych plików w poszukiwaniu ciągu. Mecz
nie jest rozróżniana wielkość liter.
ostatni (zestaw, [N])
Ostatnich n elementów zestawu, domyślnie 1.
limit(zestaw[, N[, zrównoważyć]])
Pierwszych n elementów zbioru, domyślnie 1, zaczynając od przesunięcia.
dopasowanie (wersja [, pole])
Zestawy zmian, w których dany zestaw pól odpowiada zestawowi pól w wybranym
rewizja lub zestaw.
Aby dopasować więcej niż jedno pole, przekaż listę pól do dopasowania oddzielonych spacjami
(na przykład autor opis).
Poprawne pola to większość zwykłych pól wersji i niektóre pola specjalne.
Regularne pola rewizji to opis, autor, oddział, dane, pliki, faza,
rodzice, podpaństwo, użytkownik i diff, Należy pamiętać, że autor i użytkownik są synonimami. diff
odnosi się do treści rewizji. Dwie wersje pasujące do ich diff będzie również
dopasuj ich pliki.
Pola specjalne to streszczenie i metadanych: streszczenie pasuje do pierwszej linii
opis. metadanych jest równoznaczne z dopasowaniem opis użytkownik dane (tzn. to
pasuje do głównych pól metadanych).
metadanych jest polem domyślnym używanym, gdy nie określono żadnych pól. Możesz
dopasowuj więcej niż jedno pole na raz.
maks. (zestaw)
Zestaw zmian z najwyższym numerem wersji w zestawie.
łączyć()
Changeset to scalony zestaw zmian.
min (zestaw)
Zestaw zmian z najniższym numerem wersji w zestawie.
modyfikuje (wzór)
Zestawy zmian modyfikujące pliki dopasowane według wzorca.
Wzór bez wyraźnego rodzaju glob: oczekuje się, że będzie w stosunku do
bieżący katalog i dopasuj go do pliku lub katalogu.
nazwany (przestrzeń nazw)
Zestawy zmian w danej przestrzeni nazw.
If przestrzeń nazw zaczynać z re:, pozostała część ciągu jest traktowana jako zwykła
wyrażenie. Aby dopasować przestrzeń nazw, która faktycznie zaczyna się od re:, użyj przedrostka
dosłowny:.
przestarzały()
Zmienny zestaw zmian z nowszą wersją.
tylko (zestaw, [ustawić])
Zestawy zmian będące przodkami pierwszego zestawu, które nie są przodkami żadnego innego
głowę w repozytorium. Jeśli określono drugi zestaw, wynikiem będą przodkowie zestawu
pierwszy zestaw, który nie jest przodkiem drugiego zestawu (tj. :: - :: ).
pochodzenie([zestaw])
Zestawy zmian określone jako źródło przeszczepów, przeszczepów lub rebaseów
który stworzył dane wersje. Pominięcie zestawu opcjonalnego jest równoznaczne z zaliczeniem
Wszystko(). Jeśli zestaw zmian utworzony w wyniku tych operacji sam jest określony jako źródło
w przypadku jednej z tych operacji jest to tylko źródłowy zestaw zmian dla pierwszej operacji
wybrany.
wychodzące([ścieżka])
Nie znaleziono zestawów zmian w określonym repozytorium docelowym lub w domyślnym trybie push
Lokalizacja.
p1([zestaw])
Pierwszy rodzic zestawów zmian w zestawie lub katalog roboczy.
p2([zestaw])
Drugi rodzic zestawów zmian w zestawie lub katalog roboczy.
rodzice([zestaw])
Zbiór wszystkich elementów nadrzędnych dla wszystkich zestawów zmian w zestawie lub katalog roboczy.
obecny (zestaw)
Pusty zestaw, jeśli nie znaleziono żadnej wersji w zestawie; w przeciwnym razie wszystkie wersje w zestawie.
Jeśli w lokalnym repozytorium nie ma żadnej z określonych wersji, zapytanie brzmi
normalnie przerwane. Ale ten predykat pozwala na kontynuację zapytania nawet w takim
przypadki.
publiczny()
Zestaw zmian w fazie publicznej.
zdalny([id [,ścieżka]])
Wersja lokalna odpowiadająca podanemu identyfikatorowi w zdalnym repozytorium, jeżeli
obecny. Tutaj '.' identyfikator jest synonimem bieżącego oddziału lokalnego.
usuwa (wzór)
Zestawy zmian, które usuwają pliki pasujące do wzorca.
Wzór bez wyraźnego rodzaju glob: oczekuje się, że będzie w stosunku do
bieżący katalog i dopasuj go do pliku lub katalogu.
obr(liczba)
Wersja o podanym identyfikatorze numerycznym.
odwrotny (zestaw)
Odwrotna kolejność zestawu.
korzenie (zestaw)
Zestawy zmian w zestawie bez nadrzędnego zestawu zmian w zestawie.
sekret()
Zestaw zmian w fazie tajnej.
sortuj(zestaw[, [-]klucz...])
Sortowanie ustawione według klawiszy. Domyślny porządek sortowania jest rosnący. Określ klucz jako -klawisz do
sortuj w kolejności malejącej.
Klucze mogą być:
· obrót silnika dla numeru wersji,
· oddział dla nazwy oddziału,
· desc dla komunikatu zatwierdzenia (opis),
· użytkownik dla nazwy użytkownika (autor może być używany jako alias),
· dane dla daty zatwierdzenia
subrepo([wzorzec])
Zestawy zmian, które dodają, modyfikują lub usuwają dane subrepo. Jeśli nie ma wzorca subrepo
nazwane, zwracane są wszelkie zmiany subrepo.
Nazwa znacznika])
Określony znacznik według nazwy lub wszystkie oznaczone wersje, jeśli nie podano nazwy.
If Nazwa zaczynać z re:, pozostała część nazwy jest traktowana jako zwykła
wyrażenie. Aby dopasować tag, który faktycznie zaczyna się od re:, użyj przedrostka dosłowny:.
nietrwały()
Nieprzestarzałe zestawy zmian z przestarzałymi przodkami.
użytkownik(ciąg)
Nazwa użytkownika zawiera ciąg. W dopasowaniu nie ma znaczenia wielkość liter.
If ciąg zaczynać z re:, pozostała część ciągu jest traktowana jako zwykła
wyrażenie. Aby dopasować użytkownika, który faktycznie zawiera re:, użyj przedrostka dosłowny:.
Nowe predykaty (znane jako „aliasy”) można zdefiniować, używając dowolnej kombinacji istniejących
predykaty lub inne aliasy. Definicja aliasu wygląda następująco:
=
revsettalia sekcja pliku konfiguracyjnego Mercurial. Argumenty formy $1,
$2itp. są zastępowane z aliasu do definicji.
Na przykład,
[powroty]
h = głowy()
d($1) = sortowanie($1, data)
rs(1$, 2$) = odwróć(sortowanie(1$, 2$))
definiuje trzy aliasy, h, d, rs. rs(0:wskazówka, autor) jest dokładnie równoważne
odwrotne(sortowanie(0:wskazówka, autor)).
Operator wrostkowy ## może łączyć ciągi i identyfikatory w jeden ciąg. Na przykład:
[powroty]
problem($1) = grep(r'\bissue[ :]?' ## $1 ## r'\b|\bbug\(' ## $1 ## r'\)')
problem(1234) odpowiada grep(r'\bissue[ :]?1234\b|\bbug\(1234\)') w tym przypadku. Ten
pasuje do wszystkich „problemu 1234”, „problemu:1234”, „problemu 1234” i „pluskwa(1234) ”.
Wszystkie inne operatory przedrostków, infiksów i postfiksów mają niższy priorytet niż ##, Na przykład, $1
## ~ $ 2 2 odpowiada ($ 1 ## 2 USD) ~ 2.
Odpowiedniki wiersza poleceń dla hg log:
-f -> ::.
-dx -> data (x)
-kx -> słowo kluczowe (x)
-m -> scal()
-ux -> użytkownik (x)
-bx -> gałąź (x)
-P x -> !::x
-lx -> limit(wyrażenie, x)
Kilka przykładowych zapytań:
· Zestawy zmian w gałęzi domyślnej:
hg log -r "oddział (domyślny)"
· Zestawy zmian w gałęzi domyślnej od tagu 1.5 (z wyłączeniem połączeń):
hg log -r "branch (domyślnie) i 1.5:: i nie merge()"
· Otwarte głowice oddziałów:
hg log -r „head() i niezamknięte()”
· Zestawy zmian pomiędzy tagami 1.3 i 1.5 wspominające o „błędzie”, który ma wpływ hgext/*:
hg log -r "1.3::1.5 i słowo kluczowe (błąd) i plik('hgext/*')"
· Zestawy zmian wprowadzone w maju 2008, posortowane według użytkowników:
hg log -r "sort(data('maj 2008'), użytkownik)"
· Zestawy zmian wspominające „błąd” lub „problem”, które nie występują w oznaczonej wersji:
hg log -r "(słowo kluczowe (błąd) lub słowo kluczowe (problem)), a nie przodkowie (tag ())"
ZA POMOCĄ BYSTRY OD SKRYPTY ROLNICZE AUTOMATYZACJA
Maszyny (w przeciwieństwie do ludzi) często spożywają rtęć. Ten temat pomocy
opisuje niektóre kwestie związane z łączeniem maszyn z Mercurialem.
Wybór an Interfejs
Maszyny mają do wyboru kilka metod łączenia się z Mercurial. Obejmują one:
· Wykonywanie hg wygląda tak
· Odpytywanie serwera HTTP
· Wywołanie do serwera dowodzenia
Wykonanie hg procesy są bardzo podobne do interakcji człowieka z rtęcią w powłoce.
Powinien być już Ci znany.
hg służyć może zostać użyty do uruchomienia serwera. Domyślnie spowoduje to uruchomienie serwera HTTP „hgweb”.
Ten serwer HTTP obsługuje dane wyjściowe do odczytu maszynowego, takie jak JSON. Więcej informacji znajdziesz w artykule hg
pomoc hgweb.
hg służyć może także uruchomić „serwer poleceń”. Klienci mogą łączyć się z tym serwerem i wystawiać dane
Mercurial dowodzi specjalnym protokołem. Aby uzyskać więcej informacji na temat serwera poleceń,
w tym łącza do bibliotek klienckich, zobacz https://mercurial.selenic.com/wiki/CommandServer.
hg służyć interfejsy oparte na interfejsach (hgweb i serwery poleceń) mają przewagę nad prostymi
hg wywołania procesów, ponieważ są prawdopodobnie bardziej wydajne. Dzieje się tak dlatego, że istnieje
znaczny narzut związany z uruchamianiem nowych procesów Pythona.
Wskazówka Jeśli chcesz wywołać kilka hg procesy w krótkim czasie i/lub wydajność jest
dla Ciebie ważne, zdecydowanie zaleca się korzystanie z interfejsu serwerowego.
Środowisko Zmienne
Jak udokumentowano w hg pomoc środowisko, różne zmienne środowiskowe wpływają na
działanie Mercuriala. Poniższe informacje są szczególnie istotne w przypadku urządzeń zużywających energię
Bystry:
HGPLAIN
Jeśli nie jest ustawiony, na moc wyjściową Mercurial mogą mieć wpływ ustawienia konfiguracyjne, np
wpływ na jego kodowanie, tryb szczegółowy, lokalizację itp.
Zdecydowanie zaleca się, aby maszyny ustawiały tę zmienną podczas wywoływania hg
procesów.
HGENKODOWANIE
Jeśli nie zostanie ustawione, ustawienia regionalne używane przez Mercurial zostaną wykryte ze środowiska. Jeśli
określone ustawienia regionalne nie obsługują wyświetlania niektórych znaków, Mercurial może to zrobić
renderuj te sekwencje znaków niepoprawnie (często używając „?” jako symbolu zastępczego
dla nieprawidłowych znaków w bieżących ustawieniach regionalnych).
Dobrą praktyką, którą należy zagwarantować, jest jawne ustawienie tej zmiennej środowiskowej
spójne wyniki. „utf-8” to dobry wybór w środowiskach typu UNIX.
HGRCPAT
Jeśli nie jest ustawiony, Mercurial odziedziczy opcje konfiguracyjne z plików konfiguracyjnych za pomocą
proces opisany w hg pomoc config. Obejmuje to dziedziczenie użytkownika lub całego systemu
pliki konfiguracyjne.
Gdy pożądana jest maksymalna kontrola nad konfiguracją Mercurial, wartość
HGRCPAT można ustawić na jawny plik ze znanymi dobrymi konfiguracjami. W rzadkich przypadkach
wartość można ustawić na pusty plik lub urządzenie zerowe (często / dev / null) omijać
ładowanie dowolnych plików konfiguracyjnych użytkownika lub systemu. Należy pamiętać, że te podejścia mogą mieć
niezamierzone konsekwencje, ponieważ pliki konfiguracyjne użytkownika i systemu często definiują różne rzeczy
jak nazwa użytkownika i rozszerzenia, które mogą być wymagane do połączenia z plikiem
magazyn.
Trawiący Command Wydajność
Często zdarza się, że maszyny muszą analizować dane wyjściowe poleceń Mercurial pod kątem odpowiednich informacji
dane. W tej sekcji opisano różne techniki wykonywania tej czynności.
Rozbiór gramatyczny zdania Surowy Command Wydajność
Prawdopodobnie najprostszym i najskuteczniejszym rozwiązaniem wykorzystania danych wyjściowych poleceń jest po prostu
odwołać się hg polecenia tak, jakbyś był użytkownikiem i analizuj ich dane wyjściowe.
Dane wyjściowe wielu poleceń można łatwo przeanalizować za pomocą narzędzi takich jak grep, sed, Awk.
Potencjalną wadą analizowania wyników poleceń jest to, że dane wyjściowe poleceń mogą się zmieniać
kiedy Mercurial zostanie zmodernizowany. Podczas gdy Mercurial generalnie dąży do silnego odwrócenia się
kompatybilność, dane wyjściowe poleceń czasami się zmieniają. Posiadanie testów dla Twojego automatu
interakcje z hg polecenia są ogólnie zalecane, ale są jeszcze ważniejsze, gdy
zaangażowane jest parsowanie wyników surowych poleceń.
Korzystanie z Szablony do Control Wydajność
Wiele hg polecenia obsługują szablonowe dane wyjściowe za pośrednictwem -T/--szablon argument. Więcej informacji znajdziesz w artykule
hg pomoc Szablony.
Szablony są przydatne do jawnego kontrolowania wyników, dzięki czemu otrzymujesz dokładnie te dane
chcesz sformatować tak, jak chcesz. Na przykład, log -T {węzeł}\n może być używany do drukowania a
Rozdzielana znakami nowej linii lista węzłów zestawu zmian zamiast dostosowanego do człowieka wyniku zawierającego
autorzy, daty, opisy itp.
Wskazówka Jeśli analizowanie nieprzetworzonych wyników poleceń jest zbyt skomplikowane, rozważ użycie szablonów
Twoje życie będzie łatwiejsze.
Połączenia -T/--szablon Argument pozwala na określenie predefiniowanych stylów. Statki Mercurial z
style do odczytu maszynowego json i xml, które zapewniają odpowiednio dane wyjściowe w formacie JSON i XML.
Są one przydatne do tworzenia wyników, które można odczytać maszynowo w niezmienionej postaci.
Ważny
Połączenia json i xml style są uważane za eksperymentalne. Chociaż mogą być atrakcyjne
do wykorzystania w celu łatwego uzyskania danych wyjściowych do odczytu maszynowego, ich zachowanie może się zmienić
kolejne wersje.
Style te mogą również dawać nieoczekiwane rezultaty w przypadku niektórych
kodowania. Mercurial traktuje takie rzeczy jak nazwy plików jako serię bajtów i
normalizowanie niektórych sekwencji bajtów do formatu JSON lub XML z określonymi ustawieniami kodowania
może wywołać niespodzianki.
Command serwer Wydajność
Jeśli używasz serwera poleceń do interakcji z Mercurialem, prawdopodobnie używasz istniejącego
biblioteka/API, która wyodrębnia szczegóły implementacji serwera poleceń. Jeśli tak, to
warstwa interfejsu może przeprowadzić analizę za Ciebie, oszczędzając Ci pracy związanej z jej implementacją
siebie.
Wydajność Gadatliwość
Polecenia często mają różną szczegółowość wyników, nawet jeśli używane są style do odczytu maszynowego
używany (np -T json). Dodawanie -v/--gadatliwy i --odpluskwić do argumentów polecenia can
zwiększyć ilość danych ujawnianych przez Mercurial.
Alternatywnym sposobem uzyskania potrzebnych danych jest jawne określenie szablonu.
Inne tematy
resetuje
Zestawy wersji to funkcjonalny język zapytań służący do wybierania zestawu wersji.
Pomyśl o tym jak o SQL dla repozytoriów Mercurial. Revsets są przydatne do wykonywania zapytań
repozytoria konkretnych danych.
See hg pomoc resetuje więcej.
udział rozbudowa
Połączenia udział Rozszerzenie zapewnia funkcjonalność udostępniania danych z repozytorium
kilka egzemplarzy roboczych. Może nawet automatycznie „łączyć” pamięć w sposób logiczny
powiązane repozytoria podczas klonowania.
Konfigurowanie udział rozszerzenie może prowadzić do znacznego wykorzystania zasobów
redukcji, szczególnie w obszarze miejsca na dysku i sieci. Jest to szczególnie prawdziwe
dla środowisk ciągłej integracji (CI).
See hg pomoc -e udział więcej.
PODREPOZYTORIA
Podrepozytoria umożliwiają zagnieżdżanie zewnętrznych repozytoriów lub projektów w nadrzędnym Mercurialu
repozytorium i sprawia, że polecenia działają na nich jako na grupie.
Mercurial obsługuje obecnie podrepozytoria Mercurial, Git i Subversion.
Subrepozytoria składają się z trzech komponentów:
1. Zagnieżdżone kasy repozytorium. Mogą pojawić się w dowolnym miejscu w nadrzędnym katalogu roboczym.
2. Zagnieżdżone odniesienia do repozytoriów. Są one zdefiniowane w .hgsub, który należy umieścić w
katalog główny katalogu roboczego i powiedz, skąd pochodzą pobieranie z podrepozytorium.
Podrepozytoria Mercurial są odwoływane w następujący sposób:
ścieżka/do/zagnieżdżona = https://example.com/nested/repo/ścieżka
Obsługiwane są także subrepozy Git i Subversion:
ścieżka/do/nested = [git]git://example.com/nested/repo/path
ścieżka/do/zagnieżdżona = [svn]https://example.com/nested/trunk/ścieżka
gdzie ścieżka/do/zagnieżdżona to lokalizacja kasy względem nadrzędnego korzenia Mercurial,
i https://example.com/nested/repo/path to ścieżka do repozytorium źródłowego. Źródło może
odwołuje się także do ścieżki systemu plików.
Należy pamiętać, że .hgsub nie istnieje domyślnie w repozytoriach Mercurial, musisz to zrobić
utwórz go i dodaj do repozytorium nadrzędnego przed użyciem podrepozytoriów.
3. Stany zagnieżdżonych repozytoriów. Są one zdefiniowane w .hgpodstan, który jest umieszczony w katalogu głównym
katalogu roboczego i przechwytuje wszelkie informacje wymagane do przywrócenia pliku
podrepozytoria do stanu, w jakim zostały zatwierdzone w zestawie zmian repozytorium nadrzędnego.
Mercurial automatycznie rejestruje stany zagnieżdżonych repozytoriów podczas zatwierdzania w pliku
repozytorium nadrzędne.
Note
Połączenia .hgpodstan pliku nie należy edytować ręcznie.
Dodawanie a Podrepozytorium
If .hgsub nie istnieje, utwórz go i dodaj do repozytorium nadrzędnego. Klonuj lub kasuj
projekty zewnętrzne, w których chcesz, aby znajdowały się w repozytorium nadrzędnym. Edytować .hgsub i
dodaj wpis do podrepozytorium zgodnie z powyższym opisem. W tym momencie podrepozytorium jest
śledzone, a następne zatwierdzenie zarejestruje jego stan w .hgpodstan i przywiąż go do
zatwierdzony zestaw zmian.
Synchronizacja a Podrepozytorium
Subrepo nie śledzą automatycznie najnowszego zestawu zmian swoich źródeł. Zamiast tego oni
są aktualizowane do zestawu zmian odpowiadającego zestawowi zmian zaznaczonemu w pliku
zestaw zmian najwyższego poziomu. Dzięki temu programiści zawsze otrzymują spójny zestaw kompatybilnego kodu
i biblioteki podczas ich aktualizacji.
Dlatego aktualizacja subrepo jest procesem ręcznym. Po prostu sprawdź docelowe subrepo w
żądaną wersję, przetestuj w repozytorium najwyższego poziomu, a następnie zatwierdź w repozytorium nadrzędnym
zapisz nową kombinację.
Usuwanie a Podrepozytorium
Aby usunąć podrepozytorium z repozytorium nadrzędnego, usuń jego odniesienie z .hgsub,
następnie usuń jego pliki.
Wzajemne oddziaływanie w rtęciowy Polecenia
Dodaj add nie powtarza się w subreposach, chyba że określono -S/--subrepos. Jeśli jednak
podasz pełną ścieżkę pliku w subrepo, zostanie on dodany nawet bez
Określono -S/--subrepo. Podrepozytoria Subversion są obecnie ciche
ignorowane.
Dodaj usuń
addremove nie powraca do subrepo, chyba że określono -S/--subrepos.
Jeśli jednak określisz pełną ścieżkę katalogu w subrepo, addremove to zrobi
zostać na nim wykonane nawet bez określenia -S/--subrepos. Git i Subversion
podrepozytoria wypiszą ostrzeżenie i będą kontynuować.
archiwum
archiwum nie powtarza się w podrepozytoriach, chyba że określono -S/--subrepos.
jak cat obecnie obsługuje tylko dokładne dopasowania plików w subrepozycjach. Obalenie
podrepozytoria są obecnie ignorowane.
popełnić commit tworzy spójną migawkę stanu całego projektu i jego
podrepozytoria. Jeśli jakiekolwiek podrepozytoria zostały zmodyfikowane, Mercurial przerwie działanie.
Zamiast tego można zmusić Mercurial do zatwierdzania wszystkich zmodyfikowanych podrepozytoriów poprzez określenie
-S/--subrepos lub ustawienie „ui.commitsubrepos=True” w pliku konfiguracyjnym (zobacz hg
pomoc config). Gdy nie ma już żadnych zmodyfikowanych podrepozytoriów, następuje rejestracja
ich stan i ostatecznie zatwierdza go w repozytorium nadrzędnym. Adres --adremove
opcja honoruje również opcję -S/--subrepos. Jednak Git i Subversion
podrepozytoria wypiszą ostrzeżenie i przerwają.
diff diff nie powtarza się w subrepozycjach, chyba że określono -S/--subrepos. Zmiany są
wyświetlane jak zwykle na elementach podrepozytoriów. Podrepozytoria Subversion to
obecnie milcząco ignorowane.
pliki pliki nie wracają do subrepo, chyba że określono -S/--subrepos. Jednakże,
jeśli określisz pełną ścieżkę pliku lub katalogu w subrepo, tak będzie
wyświetlane nawet bez określenia -S/--subrepos. Git i Subversion
podrepozytoria są obecnie dyskretnie ignorowane.
zapomnieć zapomnij obsługuje obecnie tylko dokładne dopasowania plików w podrepozycjach. Git i Subversion
podrepozytoria są obecnie dyskretnie ignorowane.
przychodzące
przychodzące nie powtarzają się w subrepozycjach, chyba że określono -S/--subrepos. Gita i
Podrepozytoria Subversion są obecnie dyskretnie ignorowane.
towarzyski
wychodzące nie powtarza się w subrepozycjach, chyba że określono -S/--subrepos. Gita i
Podrepozytoria Subversion są obecnie dyskretnie ignorowane.
Ciągnąć pull nie jest rekurencyjne, ponieważ nie jest jasne, co należy wyciągnąć przed uruchomieniem hg aktualizacja
. Wyświetlanie i pobieranie wszystkich zmian w podrepozytoriach, do których odwołuje się element nadrzędny
Zestawy zmian ściągnięte z repozytorium są w najlepszym przypadku drogie, niemożliwe w Subversion
walizka.
naciskać Mercurial automatycznie wypchnie wszystkie podrepozytoria jako pierwsze, gdy będzie to element nadrzędny
repozytorium jest wypychane. Zapewnia to dostępność nowych zmian w podrepozytorium
gdy odwołują się do nich repozytoria najwyższego poziomu. Push nie jest rozwiązaniem dla Subversion
podrepozytoria.
status status nie powraca do podrepozytoriów, chyba że określono -S/--subrepos.
Zmiany w podrepozytorium są wyświetlane jako zwykłe zmiany Mercurial na stronie
elementy podrepozytorium. Podrepozytoria Subversion są obecnie dyskretnie ignorowane.
usunąć Remove nie wykonuje operacji w podrepozytoriach, chyba że określono -S/--subrepos.
Jeśli jednak określisz ścieżkę pliku lub katalogu w podrepo, zostanie ona usunięta
nawet bez -S/--subrepo. Obecnie istnieją podrepozytoria Git i Subversion
cicho ignorowane.
aktualizacja update przywraca subrepo w stanie, w jakim zostały pierwotnie zatwierdzone w miejscu docelowym
zestaw zmian. Jeśli zarejestrowany zestaw zmian nie jest dostępny w bieżącym podrepozytorium,
Mercurial pobierze go jako pierwszy przed aktualizacją. Oznacza to, że aktualizacja może
wymagają dostępu do sieci podczas korzystania z podrepozytoriów.
Przypominanie Podrepozytoria Źródła
Lokalizacja źródła podrepozytorium może ulec zmianie w trakcie trwania projektu, co spowoduje unieważnienie referencji
przechowywane w historii repozytorium nadrzędnego. Aby rozwiązać ten problem, można zdefiniować reguły przepisywania w
repozytorium nadrzędne hgrc pliku lub w konfiguracji Mercurial. Zobacz [podścieżki] sekcja w
hgrc(5) po więcej szczegółów.
SZABLON ZASTOSOWANIE
Mercurial umożliwia dostosowywanie wyników poleceń za pomocą szablonów. Możesz albo
przekazać szablon lub wybrać istniejący styl szablonu z wiersza poleceń za pomocą przycisku
--szablon opcja.
Możesz dostosować dane wyjściowe dla dowolnego polecenia przypominającego dziennik: log, wychodzące, przychodzące, wskazówka,
rodzice i głowy.
Niektóre wbudowane style są dostarczane w pakiecie Mercurial. Można je wyświetlić za pomocą hg log
--szablon podstęp. Przykładowe użycie:
$ hg log -r1.0::1.1 --dziennik zmian szablonu
Szablon to fragment tekstu ze znacznikami wywołującymi rozwinięcie zmiennych:
$ hg log -r1 --template "{węzeł}\n"
b56ce7b07c52de7d5fd79fb89701ea538af65746
Ciągi w nawiasach klamrowych nazywane są słowami kluczowymi. Dostępność słów kluczowych zależy od
dokładny kontekst szablonu. Te słowa kluczowe są zwykle dostępne do szablonowania a
polecenie podobne do dziennika:
aktywna zakładka
Strunowy. Aktywna zakładka, jeśli jest powiązana ze zbiorem zmian
autor Strunowy. Niezmodyfikowany autor zestawu zmian.
przepoławiać Strunowy. Stan bisekcji zestawu zmian.
bookmarks
Lista ciągów. Wszelkie zakładki powiązane z zestawem zmian. Ustawia także „aktywny”,
nazwa aktywnej zakładki.
oddział Strunowy. Nazwa gałęzi, w której zatwierdzono zestaw zmian.
zmiany od ostatniego tagu
Liczba całkowita. Wszyscy przodkowie, których nie ma w najnowszym tagu.
dzieci
Lista ciągów. Dzieci zestawu zmian.
dane Informacje o dacie. Data zatwierdzenia zestawu zmian.
desc Strunowy. Tekst opisu zestawu zmian.
różnica stat
Strunowy. Statystyki zmian w formacie: „zmodyfikowane pliki:
+dodano/-usunięto linie”
extras Lista słowników z kluczami i wartościami pola „dodatki” tego zestawu zmian.
plik_dodaje
Lista ciągów. Pliki dodane przez ten zestaw zmian.
kopie_plików
Lista ciągów. Pliki skopiowane w tym zestawie zmian wraz z ich źródłami.
przełącznik_kopii_pliku
Lista ciągów. Podobnie jak „kopie_pliku”, ale wyświetlane tylko wtedy, gdy przełącznik --copied jest ustawiony
ustawiony.
plik_dels
Lista ciągów. Pliki usunięte przez ten zestaw zmian.
mod_pliku
Lista ciągów. Pliki zmodyfikowane przez ten zestaw zmian.
pliki Lista ciągów. Wszystkie pliki zmodyfikowane, dodane lub usunięte przez ten zestaw zmian.
węzeł graficzny
Strunowy. Znak reprezentujący węzeł zestawu zmian na wykresie wersji ASCII
najnowszytag
Lista ciągów. Globalne tagi najnowszego globalnie otagowanego przodka
ten zestaw zmian.
najnowsza odległość tagu
Liczba całkowita. Najdłuższa ścieżka do najnowszego tagu.
przestrzenie nazw
Dyktatura list. Nazwy dołączone do tego zestawu zmian według przestrzeni nazw.
węzeł Strunowy. Skrót identyfikacyjny zestawu zmian w postaci ciągu 40 cyfr szesnastkowych.
węzeł p1 Strunowy. Skrót identyfikacyjny pierwszego elementu nadrzędnego zestawu zmian, jako 40 cyfr
ciąg szesnastkowy. Jeśli zestaw zmian nie ma rodziców, wszystkie cyfry mają wartość 0.
p1wr Liczba całkowita. Lokalny numer wersji repozytorium pierwszego elementu nadrzędnego zestawu zmian, lub
-1, jeśli zestaw zmian nie ma rodziców.
węzeł p2 Strunowy. Skrót identyfikacyjny drugiego elementu nadrzędnego zestawu zmian, jako 40 cyfr
ciąg szesnastkowy. Jeśli zestaw zmian nie ma drugiego rodzica, wszystkie cyfry mają wartość 0.
p2wr Liczba całkowita. Lokalny numer wersji repozytorium drugiego elementu nadrzędnego zestawu zmian, lub
-1, jeśli zestaw zmian nie ma drugiego rodzica.
rodzice
Lista ciągów. Elementy nadrzędne zestawu zmian w formacie „rev:node”. Jeśli
zestaw zmian ma tylko jednego „naturalnego” rodzica (poprzednia wersja) nic takiego nie jest
pokazane.
faza Strunowy. Nazwa fazy zestawu zmian.
fazaidx
Liczba całkowita. Indeks fazy zestawu zmian.
obrót silnika Liczba całkowita. Numer wersji zestawu zmian lokalnego repozytorium.
podrepozytoria
Lista ciągów. Zaktualizowano podrepozytoria w zestawie zmian.
tagi Lista ciągów. Wszelkie tagi powiązane z zestawem zmian.
Słowo kluczowe „data” nie generuje wyników czytelnych dla człowieka. Jeśli chcesz użyć daty w
swoje dane wyjściowe, możesz użyć filtra, aby je przetworzyć. Filtry to funkcje, które zwracają a
ciąg znaków na podstawie zmiennej wejściowej. Pamiętaj, aby najpierw użyć filtra stringify
zastosowanie filtru wejściowego typu string do zmiennej wejściowej przypominającej listę. Możesz także użyć łańcucha
filtry, aby uzyskać pożądany wynik:
$ hg wskazówka --template "{data|isodate}\n"
2008-08-21 18:22 +0000
Lista filtrów:
dodatki
Dowolny tekst. Dodaj XHTML” " przed końcem każdej linii z wyjątkiem ostatniej.
wiek Data. Zwraca czytelną dla człowieka różnicę daty/godziny pomiędzy podaną datą/godziną a
bieżąca data/godzina.
nazwa podstawowa
Dowolny tekst. Traktuje tekst jako ścieżkę i zwraca ostatni składnik ścieżki
po podzieleniu przez separator ścieżki (ignorując separatory końcowe). Na przykład,
„foo/bar/baz” staje się „baz”, a „foo/bar//” staje się „bar”.
liczyć Lista lub tekst. Zwraca długość jako liczbę całkowitą.
domena Dowolny tekst. Znajduje pierwszy ciąg znaków, który wygląda jak adres e-mail, i wyodrębnia go
tylko komponent domeny. Przykład: Użytkownik <[email chroniony]> staje się example.com.
E-mail Dowolny tekst. Wyodrębnia pierwszy ciąg znaków, który wygląda jak adres e-mail. Przykład: Użytkownik
<[email chroniony]> staje się [email chroniony].
użytkownik poczty elektronicznej
Dowolny tekst. Zwraca część adresu e-mail użytkownika.
uciec Dowolny tekst. Zastępuje znaki specjalne XML/XHTML „&”, „<” i „>” znakami XML
jednostki i odfiltrowuje znaki NUL.
wypełnić68 Dowolny tekst. Zawija tekst tak, aby zmieścił się w 68 kolumnach.
wypełnić76 Dowolny tekst. Zawija tekst tak, aby zmieścił się w 76 kolumnach.
Pierwsza linia
Dowolny tekst. Zwraca pierwszą linię tekstu.
hex Dowolny tekst. Konwertuj binarny identyfikator węzła Mercurial na jego długi kod szesnastkowy
reprezentacja.
hgdate Data. Zwraca datę jako parę liczb: „1157407993 25200” (sygnał czasowy Unix,
przesunięcie strefy czasowej).
izodat
Data. Zwraca datę w formacie ISO 8601: „2009-08-18 13:00 +0200”.
izodatasek
Data. Zwraca datę w formacie ISO 8601, łącznie z sekundami: „2009-08-18 13:00:13
+0200”. Zobacz także filtr rfc3339date.
niższy Dowolny tekst. Konwertuje tekst na małe litery.
niepusty
Dowolny tekst. Zwraca „(brak)”, jeśli ciąg znaków jest pusty.
zaciemniać
Dowolny tekst. Zwraca tekst wejściowy renderowany jako sekwencja jednostek XML.
osoba Dowolny tekst. Zwraca nazwę przed adresem e-mail, interpretując ją zgodnie z RFC
5322.
powrót
Dowolny tekst. Ucieka od wszystkich znaków „specjalnych” z wyjątkiem @. Ukośniki do przodu są pomijane
dwa razy, aby zapobiec przedwczesnemu wycofaniu ich przez serwery internetowe. Na przykład „@foo
bar/baz” zmienia się na „@foo%20bar%252Fbaz”.
RFC3339data
Data. Zwraca datę przy użyciu internetowego formatu daty określonego w RFC 3339:
"2009-08-18T13:00:13+02:00".
RFC822data
Data. Zwraca datę w tym samym formacie, co w nagłówkach wiadomości e-mail: „Wt, 18 sierpnia 2009 r.
13:00:13 +0200".
krótki Hash zestawu zmian. Zwraca krótką formę skrótu zestawu zmian, tj. liczbę 12 w formacie szesnastkowym
ciąg cyfr.
skrót
Dowolny tekst. Przysmaki XNUMX jako stan bisekcji i zwraca pojedynczy znak
reprezentujący status (G: dobry, B: zły, S: pominięty, U: nieprzetestowany, I: zignorowany).
Zwraca pojedynczą spację jeśli XNUMX nie jest prawidłowym statusem bisekcji.
krótka randka
Data. Zwraca datę typu „2006-09-18”.
linie podziału
Dowolny tekst. Podziel tekst na listę linii.
zwęzić
Dowolny typ. Zamienia wartość na tekst, konwertując wartości na tekst i
łącząc je.
stripdir
Traktuj tekst jako ścieżkę i usuń poziom katalogu, jeśli to możliwe. Na przykład „foo”
a „foo/bar” staje się „foo”.
tabinent
Dowolny tekst. Zwraca tekst z każdą niepustą linią z wyjątkiem pierwszej
ze znakiem tabulacji.
górny Dowolny tekst. Konwertuje tekst na wielkie litery.
urlescape
Dowolny tekst. Ucieka od wszystkich „specjalnych” znaków. Na przykład „foo bar” staje się
„foo%20bar”.
użytkownik Dowolny tekst. Zwraca krótką reprezentację nazwy użytkownika lub adresu e-mail.
Należy pamiętać, że filtr to nic innego jak wywołanie funkcji, tj wyrażenie|filtr jest równoważne
do filtr (wyrażenie).
Oprócz filtrów istnieje kilka podstawowych wbudowanych funkcji:
data(data[, fmt])
Sformatuj datę. Widzieć hg pomoc daty do formatowania ciągów. Wartość domyślna to data uniksowa
formacie obejmującym strefę czasową: „Poniedziałek 04 września 15:13:13 2006 0700”.
diff([uwzględnijwzorzec [, wyklucz wzór]])
Pokaż różnicę, opcjonalnie określając pliki do uwzględnienia lub wykluczenia.
wypełnienie(tekst[, szerokość[, początkowy identyfikator [, zawieszony]]])
Wypełnij wiele akapitów opcjonalnymi wcięciami. Zobacz filtr „wypełnij”.
dostać (dyktowanie, klawisz)
Pobierz atrybut/klucz z obiektu. Niektóre słowa kluczowe są typami złożonymi. Ta funkcja
pozwala uzyskać wartość atrybutu dla tych typów.
jeśli (wyrażenie, Następnie[, w przeciwnym razie])
Warunkowo wykonaj na podstawie wyniku wyrażenia.
jeśli zawiera (szukaj, rzecz, Następnie[, w przeciwnym razie])
Warunkowo wykonaj w zależności od tego, czy element „szukaj” znajduje się w „rzeczy”.
ifeq(wyrażenie1, wyrażenie2, Następnie[, w przeciwnym razie])
Warunkowo wykonaj na podstawie tego, czy 2 elementy są równoważne.
wcięcie (tekst, wcięcia [, Pierwsza linia])
Wcina wszystkie niepuste linie znakami podanymi w ciągu indentchars. Jakiś
opcjonalny trzeci parametr zastąpi wcięcie pierwszego wiersza tylko wtedy, gdy
prezent.
dołącz do (listy, wrzesień)
Połącz elementy na liście za pomocą ogranicznika.
etykieta(etykieta, wyraż)
Zastosuj etykietę do wygenerowanej treści. Treść z zastosowaną etykietą może spowodować
dodatkowa obróbka końcowa, taka jak automatyczna koloryzacja.
najnowszytag([wzór])
Tagi globalne pasujące do podanego wzorca w najnowszym tagu globalnym
przodek tego zestawu zmian.
data lokalna(data[, zz])
Konwertuje datę na określoną strefę czasową. Wartość domyślna to data lokalna.
podkładka (tekst, szerokość[, fillchar=' „[, prawo = fałsz]])
Tekst dodany ze znakiem wypełniającym.
revset(zapytanie [, formatargi...])
Wykonaj zapytanie o zestaw wersji. Widzieć hg pomoc reset.
rstdoc(tekst, styl)
Sformatuj ReStructuredText.
najkrótszy (węzeł, mindługość=4)
Uzyskaj najkrótszą reprezentację węzła.
zaczyna się od (wzorzec, tekst)
Zwraca wartość z argumentu „tekst”, jeśli zaczyna się od treści z
argument „wzorowy”.
pasek(tekst[, znaki])
Usuń znaki z ciągu. Domyślnie usuwa wszystkie początkowe i końcowe znaki
Biała przestrzeń.
pod(wzór, zastąpienie, wyrażenie)
Wykonaj podstawienie tekstu za pomocą wyrażeń regularnych.
słowo (liczba, tekst[, separator])
Zwróć n-te słowo z ciągu.
Ponadto dla każdego wyrażenia zwracającego listę istnieje operator listy:
wyrażenie % "{szablon}"
Jak widać na powyższym przykładzie, {szablon} jest interpretowany jako szablon. Aby temu zapobiec
interpretowany, możesz użyć znaku ucieczki \{ lub surowy prefiks ciągu, R'...'.
Niektóre przykładowe szablony wiersza poleceń:
· Formatuj listy, np. pliki:
$ hg log -r 0 --template "pliki:\n{pliki% '{plik}\n'}"
· Dołącz do listy plików za pomocą znaku „,”:
$ hg log -r 0 --template "files: {join(files, ', ')}\n"
· Zmodyfikuj każdą linię opisu zatwierdzenia:
$ hg log --template "{splitlines(desc) % '**** {line}\n'}"
· Formatuj datę:
$ hg log -r 0 --template "{data(data, '%Y')}\n"
· Wyświetlana data w formacie UTC:
$ hg log -r 0 --template "{localdate(data, 'UTC')|data}\n"
· Wyprowadź opis ustawiony na szerokość wypełnienia 30:
$ hg log -r 0 --template "{fill(desc, 30)}"
· Użyj warunku, aby przetestować domyślną gałąź:
$ hg log -r 0 --template "{ifeq(branch, 'default', 'w głównej gałęzi',
'na oddziale {branch}')}\n"
· Dołącz nową linię, jeśli nie jest pusta:
$ hg tip --template "{if(author, '{author}\n')}"
· Oznacz wydruk do użycia z rozszerzeniem koloru:
$ hg log -r 0 --template "{label('changeset.{phase}', węzeł|krótki)}\n"
· Odwróć filtr pierwszej linii, tj. wszystko oprócz pierwszej linii:
$ hg log -r 0 --template "{sub(r'^.*\n?\n?', '', desc)}\n"
· Wyświetl zawartość pola „dodatkowe”, po jednym w wierszu:
$ hg log -r 0 --template "{dołącz(dodatki, '\n')}\n"
· Zaznacz aktywną zakładkę znakiem „*”:
$ hg log --template "{zakładki% '{zakładka}{ifeq(zakładka, aktywna, '*')} '}\n"
· Znajdź tag kandydata do poprzedniego wydania, odległość i zmiany od czasu tagu:
$ hg log -r . --template "{latesttag('re:^.*-rc$') % '{tag}, {zmiany}, {odległość}'}\n"
· Oznacz kopię roboczą nadrzędną znakiem „@”:
$ hg log --template "{ifcontains(rev, revset('.'), '@')}\n"
· Pokaż szczegóły wersji nadrzędnych:
$ hg log --template "{revset('parents(%d)', rev) % '{desc|pierwsza linia}\n'}"
· Pokaż tylko opisy zatwierdzeń rozpoczynające się od „szablon”:
$ hg log --template "{startswith('template', Firstline(desc))}\n"
· Wydrukuj pierwsze słowo w każdym wierszu komunikatu zatwierdzenia:
$ hg log --template "{word(0, desc)}\n"
URL ŚCIEŻKI
Prawidłowe adresy URL mają postać:
lokalny/system plików/ścieżka[#wersja]
plik://local/system plików/ścieżka[#wersja]
http://[user[:pass]@]host[:port]/[path][#revision]
https://[user[:pass]@]host[:port]/[path][#revision]
ssh://[użytkownik@]host[:port]/[ścieżka][#wersja]
Ścieżki w lokalnym systemie plików mogą wskazywać na repozytoria Mercurial lub na pakiet
pliki (utworzone przez hg zapakować or hg przychodzące --pakiet). Zobacz też hg pomoc ścieżki.
Opcjonalny identyfikator po # wskazuje konkretną gałąź, znacznik lub zestaw zmian do użycia
ze zdalnego repozytorium. Zobacz też hg pomoc rewizje.
Niektóre funkcje, takie jak przesyłanie do adresów URL http:// i https:// są możliwe tylko wtedy, gdy
funkcja jest jawnie włączona na zdalnym serwerze Mercurial.
Należy pamiętać, że bezpieczeństwo adresów URL HTTPS zależy od prawidłowej konfiguracji web.cacerts.
Kilka uwag na temat używania SSH z Mercurialem:
· SSH wymaga dostępnego konta Shell na komputerze docelowym i kopii hg in
ścieżka zdalna lub określona jako Remotecmd.
· Domyślnie ścieżka jest względna względem katalogu domowego zdalnego użytkownika. Użyj dodatkowego ukośnika w
początek ścieżki, aby określić ścieżkę bezwzględną:
ssh://example.com//tmp/repository
· Mercurial nie używa własnej kompresji poprzez SSH; właściwą rzeczą do zrobienia jest konfiguracja
to w twoim ~ / .ssh / config, np .:
Host *.mylocalnenetwork.example.com
Kompresja nr
Gospodarz *
Kompresja tak
Alternatywnie określ „ssh -C” jako polecenie ssh w pliku konfiguracyjnym lub za pomocą
opcję wiersza poleceń --ssh.
Wszystkie te adresy URL mogą być przechowywane w pliku konfiguracyjnym z aliasami ścieżek w sekcji
[ścieżki] sekcja taka jak poniżej:
[ścieżki]
alias1 = adres URL1
alias2 = adres URL2
...
Następnie możesz użyć aliasu dla dowolnego polecenia korzystającego z adresu URL (na przykład hg Ciągnąć alias1
będzie traktowany jako hg Ciągnąć URL1).
Dwa aliasy ścieżek są wyjątkowe, ponieważ są używane jako domyślne, jeśli nie podasz pliku
Adres URL polecenia:
domyślna:
Kiedy tworzysz repozytorium za pomocą hg clone, polecenie clone zapisuje lokalizację
repozytorium źródłowe jako „domyślną” ścieżkę nowego repozytorium. To jest następnie wykorzystywane
gdy pominiesz ścieżkę w poleceniach typu push i pull (w tym poleceniach przychodzących i
towarzyski).
domyślne-push:
Polecenie push będzie szukać ścieżki o nazwie „default-push” i preferować ją
„domyślny”, jeśli oba są zdefiniowane.
ROZSZERZENIA
Ta sekcja zawiera pomoc dotyczącą rozszerzeń dystrybuowanych razem z Mercurial.
Pomoc dla pozostałych rozszerzeń dostępna jest w systemie pomocy.
Acl
haki do kontrolowania dostępu do repozytorium
Ten hak umożliwia zezwolenie lub odmowę dostępu do zapisu do danych gałęzi i ścieżek pliku a
repozytorium podczas odbierania przychodzących zestawów zmian poprzez pretxnchangegroup i pretxncommit.
Autoryzacja jest dopasowywana na podstawie lokalnej nazwy użytkownika w systemie, w którym znajduje się hak
działa, a nie osoba zatwierdzająca oryginalny zestaw zmian (ponieważ ten ostatni to tylko
informacyjny).
Haczyka ACL najlepiej używać w połączeniu z ograniczoną skorupą, taką jak hgsh, zapobiegającą
uwierzytelnianie użytkowników przed robieniem czegokolwiek innego niż pchanie lub ciągnięcie. Hak nie
bezpieczny w użyciu, jeśli użytkownicy mają interaktywny dostęp do powłoki, ponieważ mogą następnie wyłączyć hak. Ani
czy jest bezpiecznie jeśli zdalni użytkownicy dzielą konto, bo wtedy nie ma jak rozróżnić
Im.
Kolejność sprawdzania dostępu jest następująca:
1. Lista odmów dla oddziałów (sekcja acl.deny.branches)
2. Lista dozwolonych oddziałów (sekcja acl.allow.branches)
3. Lista zabronionych ścieżek (sekcja odmowa acl)
4. Lista dozwolonych ścieżek (sekcja acl.zezw)
Sekcje zezwolenia i odmowy przyjmują pary klucz-wartość.
Oddziałowy Wejdź Control
Użyj acl.deny.branches i acl.allow.branches sekcje, aby mieć dostęp oparty na oddziałach
kontrola. Klucze w tych sekcjach mogą być:
· nazwa oddziału, lub
· gwiazdka pasująca do dowolnej gałęzi;
Odpowiednie wartości mogą być następujące:
· lista oddzielona przecinkami zawierająca użytkowników i grupy, lub
· gwiazdka, aby dopasować kogokolwiek;
Możesz dodać znak „!” przedrostek do nazwy użytkownika lub grupy, aby odwrócić sens dopasowania.
Oparte na ścieżce Wejdź Control
Użyj odmowa acl i acl.zezw sekcje, aby mieć kontrolę dostępu opartą na ścieżkach. Klucze w nich
sekcje akceptują wzór poddrzewa (domyślnie ze składnią glob). Odpowiednie
wartości mają tę samą składnię, co pozostałe sekcje powyżej.
Grupy
Nazwy grup muszą być poprzedzone an @ symbol. Określenie nazwy grupy ma ten sam efekt
jako określenie wszystkich użytkowników w tej grupie.
Możesz zdefiniować członków grupy w pliku grupy zbiorcze Sekcja. Jeśli nazwa grupy nie jest zdefiniowana
tam, a Mercurial działa w systemie uniksowym, zostanie pobrana lista użytkowników
z systemu operacyjnego. W przeciwnym razie zostanie zgłoszony wyjątek.
Przykład systemu
[haki]
# Użyj tego, jeśli chcesz sprawdzić ograniczenia dostępu w czasie zatwierdzania
pretxncommit.acl = python:hgext.acl.hook
# Użyj tego, jeśli chcesz sprawdzić ograniczenia dostępu dla pull, push,
# zapakuj i podawaj.
pretxnchangegroup.acl = python:hgext.acl.hook
[acl]
# Zezwalaj lub odmawiaj dostępu do przychodzących zmian tylko wtedy, gdy ich źródłem jest
# wymienione tutaj, pozwól im przejść w przeciwnym razie. Źródło „służy” wszystkim
# dostęp zdalny (http lub ssh), „push”, „pull” lub „bundle”, gdy plik
# powiązane polecenia są uruchamiane lokalnie.
# Domyślnie: serwuj
źródła = służyć
[acl.deny.branches]
# Wszystkim odmawia się dostępu do zamrożonej gałęzi:
zamrożona gałąź = *
# Zły użytkownik zostaje odrzucony we wszystkich oddziałach:
* = zły użytkownik
[acl.allow.branches]
# Na gałęzi-a może przebywać kilku użytkowników:
gałąź-a = użytkownik-1, użytkownik-2, użytkownik-3
# Tylko jeden użytkownik może korzystać z gałęzi-b:
gałąź-b = użytkownik-1
# Superużytkownik może korzystać z dowolnej gałęzi:
* = superużytkownik
# Każdy może korzystać z gałęzi do testów:
gałąź-dla-testów = *
[odmowa akl.]
# Ta lista jest sprawdzana jako pierwsza. Jeśli zostanie znalezione dopasowanie, acl.allow nie zostanie znalezione
# sprawdzony. Wszyscy użytkownicy otrzymają dostęp, jeśli nie ma acl.deny.
# Format obu list: wzór globalny = użytkownik, ..., @grupa, ...
# Aby dopasować wszystkich, użyj gwiazdki dla użytkownika:
# mój/glob/wzorzec = *
# użytkownik6 nie będzie miał prawa zapisu do żadnego pliku:
** = użytkownik6
# Grupa „hg-denied” nie będzie miała prawa zapisu do żadnego pliku:
** = @hg-odmowa
# Pomimo tego nikt nie będzie mógł zmienić pliku „DONT-TOUCH-THIS.txt”.
# każdy może zmieniać wszystkie inne pliki. Zobacz poniżej.
src/main/resources/DONT-TOUCH-THIS.txt = *
[acl.allow]
# jeśli acl.allow nie jest obecny, domyślnie dopuszczeni są wszyscy użytkownicy
# pusty acl.allow = brak dostępu dla użytkowników
# Użytkownik „doc_writer” ma prawo zapisu do dowolnego pliku w „docs”
# teczka:
docs/** = dokument_pisarz
# Użytkownik „jack” i grupa „projektanci” mają prawo zapisu do dowolnego pliku
# w folderze „images”:
obrazy/** = jack, @projektanci
# Wszyscy (z wyjątkiem "user6" i "@hg-denied" - zobacz acl.deny powyżej)
# będzie miał prawo zapisu do dowolnego pliku w folderze „zasoby”.
# (z wyjątkiem 1 pliku. Zobacz acl.deny):
src/main/zasoby/** = *
.hgtags = inżynier wydania
Przykłady za pomocą dotychczasowy ! prefiks
Załóżmy, że istnieje gałąź, do której tylko dany użytkownik (lub grupa) powinien mieć możliwość wypchnięcia, i
nie chcesz ograniczać dostępu do żadnej innej gałęzi, która może zostać utworzona.
„!” prefiks pozwala uniemożliwić komukolwiek z wyjątkiem danego użytkownika lub grupy wypychanie
zestawy zmian w danej gałęzi lub ścieżce.
W poniższych przykładach: 1) Odmówimy dostępu do gałęzi „pierścień” komukolwiek poza użytkownikiem
„gollum” 2) Odmów dostępu do gałęzi „jezioro” nikomu poza członkami grupy „Hobbit” 3)
Odmów dostępu do pliku każdemu oprócz użytkownika „gollum”
[acl.allow.branches]
# Pusty
[acl.deny.branches]
# 1) tylko „gollum” może zatwierdzić gałąź „ring”;
# 'gollum' i każdy inny może nadal zaangażować się w dowolną inną gałąź.
pierścień = !gollum
# 2) tylko członkowie grupy „hobbit” mogą angażować się w gałąź „jezioro”;
# członkowie „hobbita” i wszyscy inni mogą nadal angażować się w dowolną inną gałąź.
jezioro = !@hobbit
# Możesz także odmówić dostępu na podstawie ścieżek plików:
[acl.allow]
# Pusty
[odmowa akl.]
# 3) tylko 'gollum' może zmienić poniższy plik;
# 'gollum' i każdy inny może nadal zmieniać dowolny inny plik.
/misty/góry/jaskinia/pierścień = !gollum
czarna skrzynka
rejestruj zdarzenia w repozytorium w czarnej skrzynce w celu debugowania
Rejestruje informacje o zdarzeniach w pliku .hg/blackbox.log, co ułatwia debugowanie i diagnozowanie problemów. The
rejestrowane zdarzenia można skonfigurować za pomocą klucza konfiguracyjnego blackbox.track. Przykłady:
[czarna skrzynka]
utwór = *
[czarna skrzynka]
track = polecenie, zakończenie polecenia, wyjątek polecenia, exthook, pythonhook
[czarna skrzynka]
utwór = przychodzący
[czarna skrzynka]
# ogranicz rozmiar pliku dziennika
maksymalny rozmiar = 1.5 MB
# obróć do N plików dziennika, gdy bieżący stanie się zbyt duży
maksymalna liczba plików = 3
Polecenia
czarna skrzynka
wyświetl ostatnie zdarzenia w repozytorium:
hg czarna skrzynka [OPCJA]...
przeglądaj ostatnie zdarzenia w repozytorium
Opcje:
-ja,--limit
liczba zdarzeń do pokazania (domyślnie: 10)
bugzilla
haki do integracji z modułem śledzenia błędów Bugzilla
To rozszerzenie hooka dodaje komentarze na temat błędów w Bugzilli, gdy zestawy zmian odnoszą się do błędów
według identyfikatora Bugzilla. Komentarz jest formatowany przy użyciu mechanizmu szablonów Mercurial.
Odniesienia do błędów mogą opcjonalnie zawierać aktualizację Bugzilli dotyczącą godzin spędzonych
pracuje nad błędem. Błędy można również oznaczyć jako naprawione.
Dostępne są trzy podstawowe tryby dostępu do Bugzilli:
1. Dostęp poprzez interfejs Bugzilla XMLRPC. Wymaga Bugzilli 3.4 lub nowszej.
2. Sprawdź dane poprzez interfejs Bugzilla XMLRPC i prześlij informację o błędzie pocztą elektroniczną na adres
Interfejs poczty e-mail Bugzilli. Wymaga Bugzilli 3.4 lub nowszej.
3. Zapis bezpośrednio do bazy danych Bugzilla. Dotyczy to tylko instalacji Bugzilli korzystających z MySQL
utrzymany. Wymaga Pythona MySQLdb.
Zapis bezpośrednio do bazy danych jest podatny na zmiany schematu i opiera się na a
Skrypt Bugzilla contrib do wysyłania e-maili z powiadomieniami o zmianach błędów. Ten skrypt działa jako
użytkownik uruchamiający Mercurial musi zostać uruchomiony na hoście, na którym zainstalowana jest Bugzilla, oraz
wymaga pozwolenia na odczyt szczegółów konfiguracji Bugzilli i niezbędnego użytkownika MySQL
i hasło, aby mieć pełne prawa dostępu do bazy danych Bugzilla. Z tych powodów to
tryb dostępu jest obecnie uważany za przestarzały i nie będzie aktualizowany w nowej Bugzilli
wersje w przyszłości. W tym trybie dostępu obsługiwane jest wyłącznie dodawanie komentarzy.
Dostęp poprzez XMLRPC wymaga podania nazwy użytkownika i hasła Bugzilli w pliku
konfiguracja. Komentarze są dodawane pod tą nazwą użytkownika. Ponieważ konfiguracja musi być
czytelne dla wszystkich użytkowników Mercurial, zaleca się, aby uprawnienia tego użytkownika były takie same
ograniczone w Bugzilli do minimum niezbędnego do dodawania komentarzy. Naprawiono błędy oznaczania
wymaga Bugzilli 4.0 i nowszych.
Dostęp przez XMLRPC/e-mail wykorzystuje XMLRPC do wysyłania zapytań do Bugzilli, ale wysyła e-mail do Bugzilli
interfejs e-mail do przesyłania komentarzy do błędów. Adres Od: w wiadomości e-mail jest ustawiony na
adres e-mail użytkownika Mercurial, więc komentarz wydaje się pochodzić od Mercurial
użytkownik. W przypadku, gdy adres e-mail użytkownika Mercurial nie zostanie rozpoznany przez Bugzilla jako adres e-mail
Użytkownik Bugzilli, adres e-mail powiązany z nazwą użytkownika Bugzilli używaną do logowania się do Bugzilli
jest używany zamiast tego jako źródło komentarza. Oznaczanie naprawionych błędów działa na wszystkich obsługiwanych
Wersje Bugzilli.
Elementy konfiguracji wspólne dla wszystkich trybów dostępu:
wersja bugzilli
Typ dostępu, który ma być używany. Uznane wartości to:
xmlrpc
Interfejs Bugzilli XMLRPC.
xmlrpc+e-mail
Bugzilla XMLRPC i interfejsy e-mail.
3.0
Dostęp do MySQL, Bugzilla 3.0 i nowsze wersje.
2.18
Dostęp do MySQL, Bugzilla 2.18 i nowsze, ale bez wersji 3.0.
2.16
Dostęp do MySQL, Bugzilla 2.16 i nowsze, ale bez wersji 2.18.
bugzilla.regexp
Wyrażenie regularne pasujące do identyfikatorów błędów dla aktualizacji w komunikacie zatwierdzenia zestawu zmian. To
musi zawierać jedną grupę nazwaną „()”. zawierający identyfikatory błędów oddzielone znakami
znaki niecyfrowe. Może również zawierać nazwaną grupę z
liczba zmiennoprzecinkowa określająca godziny przepracowane nad błędem. Jeśli nie ma nazwanych grup
jest obecny, zakłada się, że pierwsza grupa „()” zawiera identyfikatory błędów, a czas pracy
nie są aktualizowane. Domyślne wyrażenie pasuje Bug 1234, Bug no. 1234, Bug numer
1234, Błędy 1234,5678, Bug 1234 i 5678 i ich odmiany, po których następuje an
liczba godzin poprzedzona przez h or godzinnp godzin 1.5. W dopasowywaniu nie jest uwzględniana wielkość liter.
bugzilla.fixregexp
Naprawiono wyrażenie regularne pasujące do identyfikatorów błędów do oznaczania w komunikacie zatwierdzenia zestawu zmian.
Musi zawierać grupę nazwaną „()”. ` zawierające dotychczasowy pluskwa Identyfikatory rozdzielony by
niecyfrowy postacie. It może również zawierać a o imieniu grupa `` z
liczba zmiennoprzecinkowa określająca godziny przepracowane nad błędem. Jeśli nie ma nazwanych grup
jest obecny, zakłada się, że pierwsza grupa „()” zawiera identyfikatory błędów, a czas pracy
nie są aktualizowane. Domyślne wyrażenie pasuje Fixes 1234, Fixes pluskwa 1234, Fixes błędy
1234,5678, Fixes 1234 i 5678 i ich odmiany, po których następuje liczba godzin
poprzedzone przez h or godzinnp godzin 1.5. W dopasowywaniu nie jest uwzględniana wielkość liter.
bugzilla.fixstatus
Naprawiono status, na który należy ustawić błąd podczas zaznaczania. Domyślny ZDECYDOWANI.
rozwiązanie bugzilla.fix
Naprawiono rozdzielczość ustawiania błędu podczas zaznaczania. Domyślny STAŁA.
bugzilla.style
Plik stylu używany podczas formatowania komentarzy.
bugzilla.szablon
Szablon używany podczas formatowania komentarzy. Zastępuje styl, jeśli jest określony. Ponadto
do zwykłych słów kluczowych Mercurial rozszerzenie określa:
{błąd}
Identyfikator błędu Bugzilli.
{źródło}
Pełna nazwa ścieżki do repozytorium Mercurial.
{webroot}
Usunięto nazwę ścieżki repozytorium Mercurial.
{hgweb}
Podstawowy adres URL do przeglądania repozytoriów Mercurial.
Domyślnie changeset {węzeł|krótki} in repo {źródło} odnosi do pluskwa
{błąd}.\ndetails:\n\t{desc|tabindent}
bugzilla.strip
Liczba znaków separatora ścieżki do usunięcia z przodu Mercurial
ścieżka repozytorium ({źródło} w szablonach) do wyprodukowania {webroot}. Na przykład
repozytorium z {źródło} /var/local/mój-projekt z paskiem 2 daje wartość dla
{webroot} of mój projekt. Domyślnie 0.
web.baseurl
Podstawowy adres URL do przeglądania repozytoriów Mercurial. Odniesienia z szablonów jako {hgweb}.
Elementy konfiguracji wspólne dla trybów dostępu XMLRPC+e-mail i MySQL:
bugzilla.usermap
Ścieżka pliku zawierającego adres e-mail osoby zatwierdzającej Mercurial na mapowania e-maili użytkowników Bugzilli.
Jeśli określono, plik powinien zawierać jedno mapowanie w każdym wierszu:
committer = użytkownik Bugzilli
Zobacz też [mapa użytkownika]
Połączenia [mapa użytkownika] sekcja służy do określenia mapowania wiadomości e-mail osoby odpowiedzialnej za Mercurial na Bugzillę
e-mail użytkownika. Zobacz też bugzilla.usermap. Zawiera wpisy formularza committer = Bugzilla
użytkownik.
Konfiguracja trybu dostępu XMLRPC:
bugzilla.bzurl
Podstawowy adres URL instalacji Bugzilli. Domyślny http://localhost/bugzilla.
bugzilla.user
Nazwa użytkownika używana do logowania się do Bugzilli poprzez XMLRPC. Domyślny błędy.
bugzilla.hasło
Hasło do logowania w Bugzilli.
Tryb dostępu XMLRPC+e-mail wykorzystuje elementy konfiguracji trybu dostępu XMLRPC, a także:
bugzilla.bzemail
Adres e-mail Bugzilli.
Ponadto należy skonfigurować ustawienia poczty e-mail Mercurial. Zobacz dokumentację w
hgrc(5), sekcje [e-mail] i [smtp].
Konfiguracja trybu dostępu MySQL:
bugzilla.host
Nazwa hosta serwera MySQL przechowującego bazę danych Bugzilla. Domyślny localhost.
bugzilla.db
Nazwa bazy danych Bugzilla w MySQL. Domyślny błędy.
bugzilla.user
Nazwa użytkownika używana do uzyskiwania dostępu do serwera MySQL. Domyślny błędy.
bugzilla.hasło
Hasło umożliwiające dostęp do serwera MySQL.
bugzilla.timeout
Limit czasu połączenia z bazą danych (sekundy). Domyślny 5.
bugzilla.bzuser
Zastępcza nazwa użytkownika Bugzilli, pod którą można nagrywać komentarze, jeśli osoba zatwierdzająca zestaw zmian nie może
zostać znalezionym użytkownikiem Bugzilli.
bugzilla.bzdir
Katalog instalacyjny Bugzilli. Domyślnie używane powiadomienie. Domyślny /var/www/html/bugzilla.
bugzilla.notify
Polecenie do uruchomienia, aby Bugzilla wysyłała e-maile z powiadomieniami o zmianach błędów.
Zamienniki z mapy z 3 kluczami, bzdir, id (identyfikator błędu) i użytkownik (komisarz Bugzilla
e-mail). Wartość domyślna zależy od wersji; od wersji 2.18 jest to „cd %(bzdir)s && perl -T
contrib/sendbugmail.pl %(id) s % (użytkownik) ”.
Aktywacja rozszerzenia:
[rozszerzenia]
bugzilla =
[haki]
# uruchamiaj hak Bugzilli przy każdej pobranej lub wepchniętej tutaj zmianie
incoming.bugzilla = python:hgext.bugzilla.hook
Przykładowe konfiguracje:
Przykładowa konfiguracja XMLRPC. Używa to Bugzilli pod adresem http://my-project.org/bugzilla,
logując się jako użytkownik [email chroniony] z hasłem Wtyczka. Używa się go z
zbiór repozytoriów Mercurial w /var/local/hg/repos/, z interfejsem internetowym pod adresem
http://my-project.org/hg.
[bugzilla]
bzurl=http://my-project.org/bugzilla
użytkownik=[email chroniony]
hasło = wtyczka
wersja=xmlrpc
szablon=Zestaw zmian {węzeł|short} w {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{desc}\n
pasek = 5
[sieć]
bazowy=http://my-project.org/hg
Przykładowa konfiguracja XMLRPC+e-mail. Używa to Bugzilli pod adresem
http://my-project.org/bugzilla, logując się jako użytkownik [email chroniony] z hasłem
Wtyczka. Jest używany z kolekcją repozytoriów Mercurial w /var/local/hg/repos/,
z interfejsem internetowym pod adresem http://my-project.org/hg. Komentarze dotyczące błędów są wysyłane do Bugzilli
adres e-mail [email chroniony].
[bugzilla]
bzurl=http://my-project.org/bugzilla
użytkownik=[email chroniony]
hasło = wtyczka
wersja=xmlrpc+e-mail
bzemail=[email chroniony]
szablon=Zestaw zmian {węzeł|short} w {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{desc}\n
pasek = 5
[sieć]
bazowy=http://my-project.org/hg
[mapa użytkownika]
[email chroniony]=[email chroniony]
Przykładowa konfiguracja MySQL. Ma to lokalną instalację Bugzilli 3.2
/opt/bugzilla-3.2. Baza danych MySQL jest włączona localhost, nazwa bazy danych Bugzilla to błędy
a dostęp do MySQL można uzyskać za pomocą nazwy użytkownika MySQL błędy password XYZZY. Używa się go z
zbiór repozytoriów Mercurial w /var/local/hg/repos/, z interfejsem internetowym pod adresem
http://my-project.org/hg.
[bugzilla]
host=lokalny host
hasło=XYZZY
wersja=3.0
bzuser=[email chroniony]
bzdir=/opt/bugzilla-3.2
szablon=Zestaw zmian {węzeł|short} w {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{desc}\n
pasek = 5
[sieć]
bazowy=http://my-project.org/hg
[mapa użytkownika]
[email chroniony]=[email chroniony]
Wszystkie powyższe dodają komentarz do rejestru błędów Bugzilli w formularzu:
Zestaw zmian 3b16791d6642 w nazwie repozytorium.
http://my-project.org/hg/repository-name/rev/3b16791d6642
Komentarz zatwierdzenia zestawu zmian. Błąd 1234.
cenzor
usunąć zawartość pliku w danej wersji
Polecenie censor nakazuje Mercurialowi usunięcie całej zawartości pliku w danej wersji
bez aktualizowanie dotychczasowy changeset haszysz. Dzięki temu istniejąca historia pozostaje aktualna
uniemożliwiając przyszłym klonom/pociągom otrzymywanie usuniętych danych.
Typowe zastosowania cenzora wynikają z bezpieczeństwa lub wymogów prawnych, w tym:
* Hasła, klucze prywatne, materiały kryptograficzne
* Licencjonowane dane/kod/biblioteki, dla których licencja wygasła
* Dane osobowe lub inne dane prywatne
Ocenzurowane węzły mogą przerwać typowe działanie Mercurial, gdy tylko potrzebne są wycięte dane
zostać zmaterializowanym. Niektóre polecenia, np hg jak/hg przywrócić, po prostu nie powiedzie się, gdy zostaniesz o to poproszony
produkować cenzurowane dane. Inni, jak hg zweryfikować i hg aktualizacja, musi umieć tolerować
cenzurowane dane, aby mogły nadal funkcjonować w znaczący sposób. Takie polecenia tylko tolerujemy
cenzurowane wersje plików, jeśli pozwala na to opcja konfiguracyjna „censor.policy=ignore”.
Polecenia
cenzor
hg cenzor -r WER. [-t TEKST] [PLIK]
Opcje:
-R,--obrót silnika
plik cenzora z określonej wersji
-T,--nagrobek
dane nagrobka zastępczego
chgserver
rozszerzenie serwera dowodzenia dla cHg (EKSPERYMENTALNE)
'S' kanał (odczyt/zapis)
propaguj żądanie ui.system() do klienta
„załącznik” komenda
załącz stdio klienta przekazane przez sendmsg()
„chdir” komenda
zmień bieżący katalog
„getpager” komenda
sprawdza, czy pager jest włączony i który pager powinien zostać wykonany
„setenv” komenda
całkowicie zastąpić os.environ
„WYJDŹ” sygnał
załaduj ponownie pliki konfiguracyjne
dzieci
polecenie wyświetlania podrzędnych zestawów zmian (przestarzałe)
To rozszerzenie jest przestarzałe. Powinieneś użyć hg log -r „dzieci (REV)” zamiast.
Polecenia
dzieci
pokaż dzieci danej lub roboczej wersji katalogu:
hg dzieci [-r REV] [PLIK]
Wydrukuj elementy potomne wersji katalogu roboczego. Jeśli wersja zostanie podana za pośrednictwem
-r/--rev, zostaną wydrukowane elementy podrzędne tej wersji. Jeśli podano argument pliku,
wersja, w której plik był ostatnio zmieniany (po wersji katalogu roboczego lub
argument do --rev, jeśli został podany) jest drukowany.
Proszę używać hg log zamiast:
hg dzieci => hg log -r 'dzieci()'
hg dzieci -r REV => hg log -r 'dzieci(REV)'
See hg pomoc log i hg pomoc revsets.children.
Opcje:
-R,--obrót silnika
pokaż elementy podrzędne określonej wersji
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
maselnica
polecenie umożliwiające wyświetlenie statystyk dotyczących historii repozytorium
Polecenia
maselnica
histogram zmian w repozytorium:
hg churn [-d DATA] [-r WER.] [--aliases PLIK] [PLIK]
To polecenie wyświetli histogram przedstawiający liczbę zmienionych linii lub
rewizje, pogrupowane według podanego szablonu. Domyślny szablon zostanie zgrupowany
zmiany przez autora. Do grupowania wyników według daty można użyć opcji --dateformat
zamiast.
Statystyki opierają się na liczbie zmienionych linii lub alternatywnie na liczbie
pasujące wersje, jeśli określono opcję --changesets.
Przykłady:
# wyświetl liczbę zmienionych linii dla każdego zatwierdzającego
hg churn -t "{autor|email}"
# wyświetl wykres dziennej aktywności
hg churn -f "%H" -s -c
# wyświetlaj aktywność programistów według miesiąca
hg churn -f "%Y-%m" -s -c
# wyświetla liczbę linii zmienianych co roku
hg churn -f "%Y" -s
Możliwe jest mapowanie alternatywnych adresów e-mail na adres główny poprzez udostępnienie pliku
używając następującego formatu:
=
Taki plik można określić opcją --aliases, w przeciwnym razie będzie to plik .hgchurn
szukać w katalogu głównym katalogu roboczego. Aliasy zostaną oddzielone od skrajnego prawego „=".
Opcje:
-R,--obrót silnika
współczynnik zliczania dla określonej wersji lub resetu
-D,--Data
współczynnik zliczania poprawek zgodnych ze specyfikacją daty
-T,--stary szablon
szablon do grupowania zestawów zmian (przestarzałe)
-T,--szablon
szablon do grupowania zestawów zmian (domyślnie: {author|email})
-F,--format daty
format zgodny ze strftime do grupowania według daty
-C, --zestawy zmian
współczynnik zliczania według liczby zestawów zmian
-tak, --sortować
sortuj według klucza (domyślnie: sortuj według liczby)
--różnica
wyświetlaj oddzielnie dodane/usunięte linie
--skróty
plik z aliasami e-mail
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
pakiety klonów
reklamuj wstępnie wygenerowane pakiety w celu klonowania nasion
„clonebundles” to rozszerzenie po stronie serwera używane do reklamowania istnienia
wstępnie wygenerowane, hostowane zewnętrznie pliki pakietów dla klientów klonujących, aby umożliwić klonowanie
może być szybszy, bardziej niezawodny i wymagać mniej zasobów na serwerze.
Klonowanie może być operacją intensywnie obciążającą procesor i operacje we/wy na serwerach. Tradycyjnie serwer w
w odpowiedzi na żądanie klienta dotyczące klonowania, dynamicznie generuje pakiet zawierający plik
całą zawartość repozytorium i wysyła ją do klienta. Na serwerze nie ma buforowania
a serwer będzie musiał w odpowiedzi redundantnie generować ten sam pakiet wychodzący
każde żądanie klonowania. W przypadku serwerów z dużymi repozytoriami lub dużą liczbą klonów plik
ładowanie z klonów może sprawić, że skalowanie serwera będzie trudne i kosztowne.
To rozszerzenie zapewnia operatorom serwerów możliwość odciążenia potencjalnie kosztownego
klonuj ładowanie do usługi zewnętrznej. Oto jak to działa.
1. Operator serwera ustanawia mechanizm udostępniania plików pakunkowych na platformie a
usługę hostingową, z której klienci Mercurial mogą je pobrać.
2. Dodawany jest plik manifestu zawierający listę dostępnych adresów URL pakietów i niektórych opcjonalnych metadanych
repozytorium Mercurial na serwerze.
3. Klient inicjuje klonowanie na serwerze obsługującym pakiety klonów.
4. Klient widzi, że serwer ogłasza pakiety klonów i pobiera manifest
wyświetla listę dostępnych pakietów.
5. Klient filtruje i sortuje dostępne pakiety w oparciu o to, co obsługuje i
woli.
6. Klient pobiera i stosuje dostępny pakiet z adresu URL podanego na serwerze.
7. Klient ponownie łączy się z pierwotnym serwerem i wykonuje czynności równoważne hg Ciągnąć do
pobierz wszystkie dane repozytorium, których nie ma w pakiecie. (Repozytorium mogło zostać zaktualizowane
pomiędzy utworzeniem pakietu a uruchomieniem klonowania przez klienta.)
Zamiast generować przez serwer pełne pakiety repozytorium dla każdego żądania klonowania, to
generuje raz pełne pakiety, które są następnie ponownie wykorzystywane do ładowania nowych klonów. The
serwer może nadal przesyłać dane w czasie klonowania. To jednak tylko dane, które były
dodane/zmienione od czasu utworzenia pakietu. W przypadku dużych, ustalonych repozytoriów może to być możliwe
zmniejsz obciążenie serwera dla klonów do mniej niż 1% oryginału.
Do działania to rozszerzenie wymaga następujących operatorów serwerów:
· Generowanie plików pakietów zawartości repozytorium (zwykle okresowo, np. raz na
dzień).
· Serwer plików, do którego klienci mają dostęp sieciowy i z którym Python wie, jak rozmawiać
za pośrednictwem normalnego narzędzia do obsługi adresów URL (zwykle jest to serwer HTTP).
· Proces synchronizacji manifestu pakietów z dostępnymi plikami pakietów.
Ściśle mówiąc, korzystanie ze statycznego serwera hostującego pliki nie jest wymagane: operator serwera
mógłby skorzystać z usługi dynamicznej do pobierania danych pakietu. Jednak statyczny hosting plików
usługi są proste i skalowalne i powinny wystarczyć na większość potrzeb.
Pliki pakietów można generować za pomocą hg zapakować Komenda. Typowo hg zapakować --wszystko is
używany do tworzenia pakietu całego repozytorium.
hg debugcreatestreamclonebundle można wykorzystać do produkcji specjalnego Streaming klonować zapakować.
Są to pliki pakietów, których tworzenie i używanie jest niezwykle wydajne (czytaj: szybkie).
Są jednak większe niż tradycyjne formaty pakietów i wymagają wsparcia ze strony klientów
dokładny zestaw formatów magazynów danych repozytorium używanych przez repozytorium, które je utworzyło.
Zazwyczaj nowszy serwer może obsługiwać dane kompatybilne ze starszymi klientami. Jednakże,
Streaming klonować wiązki nie mają tej gwarancji. serwer operatorzy potrzeba do be świadomy że
nowsza Wersje of rtęciowy może produkować Streaming klonować wiązki niezgodny w starszych
rtęciowy wersje.
Operator serwera jest odpowiedzialny za utworzenie pliku .hg/clonebundles.manifest plik zawierający
lista dostępnych plików pakietów odpowiednich do wysiewu klonów. Jeśli ten plik nie
istnieje, repozytorium nie będzie ogłaszać istnienia pakietów klonowania, gdy klienci
połączyć.
Plik manifestu zawiera listę wpisów rozdzielanych znakami nowej linii ( ).
Każda linia w tym pliku definiuje dostępny pakiet. Linie mają format:
[ = [ = ]]
Oznacza to, że adres URL, po którym następuje opcjonalna, rozdzielana spacjami lista opisująca pary klucz=wartość
dodatkowe właściwości tego pakietu. Zarówno klucze, jak i wartości są zakodowane w formacie URI.
Klucze pisane WIELKIMI LITERAMI są zastrzeżone do użytku firmy Mercurial i zostały zdefiniowane poniżej. Wszystko
Podczas instalacji w witrynie można używać klawiszy innych niż wielkie litery. Przykładowe zastosowanie właściwości niestandardowych
jest użyć centrum danych atrybut określający, w którym centrum danych przechowywany jest plik.
Klienci mogliby wówczas preferować serwer w centrum danych położonym najbliżej nich.
Obecnie zdefiniowane są następujące klucze zastrzeżone:
SPECYFIKACJA ZESTAWU
Ciąg „specyfikacja pakietu” opisujący typ pakietu.
Są to wartości łańcuchowe akceptowane przez argument „--type”. hg zapakować.
Wartości są analizowane w trybie ścisłym, co oznacza, że muszą należeć do typu
" - ". Więcej informacji znajdziesz w mercurial.exchange.parsebundlespec().
detale.
hg pakiet debugowania --spec można użyć do wydrukowania ciągu specyfikacji pakietu dla a
plik pakietu. Dane wyjściowe tego polecenia można dosłownie wykorzystać jako wartość
SPECYFIKACJA ZESTAWU (już uciekł).
Klienci automatycznie odfiltrują specyfikacje, które są nieznane lub
nieobsługiwane, więc nie będą próbować pobrać czegoś, co prawdopodobnie nie będzie miało zastosowania.
Rzeczywista wartość nie ma wpływu na zachowanie klienta poza filtrowaniem: klienci to zrobią
nadal wąchaj typ pakietu w nagłówku pobranych plików.
Zastosowanie of to klucz is wysoko Zalecana, ponieważ pozwala klientom łatwo pominąć
nieobsługiwane pakiety. Jeśli ten klucz nie jest zdefiniowany, może spróbować zastosować stary klient
pakiet, którego nie da się przeczytać.
WYMAGA
Określa, czy do połączenia z adresem URL wymagane jest wskazanie nazwy serwera (SNI). SNI pozwala
serwerów do używania wielu certyfikatów na tym samym adresie IP. Jest to dość powszechne w sieciach CDN
i inni dostawcy usług hostingowych. Starsze wersje Pythona nie obsługują SNI. Definiowanie
ten atrybut umożliwia klientom ze starszymi wersjami języka Python filtrowanie tego wpisu
bez wystąpienia nieprzejrzystej awarii protokołu SSL w momencie połączenia.
Jeśli tak zdefiniowano, ważne jest reklamowanie zastępczego adresu URL lub klientów innych niż SNI
działające stare wydania Pythona mogą nie umożliwiać klonowania za pomocą pakietów klonów
zakład.
Wartość powinna być „prawda”.
Manifesty mogą zawierać wiele wpisów. Zakładając, że metadane są zdefiniowane, klienci będą filtrować
wpisy z manifestu, których nie obsługują. Pozostałe wpisy są opcjonalne
posortowane według preferencji klienta (eksperymentalny.clonebundleprefers opcja konfiguracji). Klient
następnie próbuje pobrać pakiet pod pierwszym adresem URL z pozostałej listy.
Błędy jeśli chodzi o komunikację i motywację ściąganie a zapakować będzie nie dotychczasowy cały klonować operacja: klientów do nie
automatycznie spadać z powrotem do a tradycyjny klon. Powodem tego jest to, że jeśli serwer jest
używając pakietów klonów, prawdopodobnie robi to, ponieważ ta funkcja jest niezbędna, aby mu pomóc
skala. Innymi słowy, zakłada się, że ładunek klonów zostanie przeniesiony na inny
service i że serwer Mercurial nie jest odpowiedzialny za obsługę tego klonowanego obciążenia. Jeśli
że w innych usługach występują problemy i klienci zaczną masowo wracać do oryginału
Mercurial, dodane obciążenie klonami może przeciążyć serwer z powodu nieoczekiwanego obciążenia
i skutecznie przełącz go w tryb offline. Brak sytuacji, w której klienci automatycznie wracają do klonowania
z oryginalnego serwera łagodzi ten scenariusz.
Ponieważ nie ma automatycznego przywracania serwera Mercurial w przypadku awarii hostingu pakietu
ważne jest, aby operatorzy serwerów postrzegali usługę hostingu pakietu jako usługę
rozbudowa serwera Mercurial w zakresie umów dostępności i poziomu usług:
jeśli usługa hostingu pakietu przestanie działać, przestanie działać możliwość klonowania klientów. Notatka:
klienci zobaczą komunikat informujący ich, jak ominąć funkcję pakietów klonowania, gdy a
następuje awaria. Dlatego operatorzy serwerów powinni przygotować się na to, że niektórzy ludzie będą ich przestrzegać
instrukcje w przypadku wystąpienia awarii, zwiększając w ten sposób obciążenie oryginalnego Mercuriala
serwer w przypadku awarii usługi hostingu pakietu.
kolor
pokoloruj dane wyjściowe niektórych poleceń
Rozszerzenie color koloruje dane wyjściowe kilku poleceń Mercurial. Na przykład
Polecenie diff pokazuje dodatki na zielono, a usunięcia na czerwono, natomiast polecenie status pokazuje
zmodyfikowane pliki w kolorze magenta. Wiele innych poleceń ma analogiczne kolory. Jest to możliwe
dostosuj te kolory.
Dodawanie efektów
Oprócz koloru dostępne są także inne efekty, takie jak pogrubienie i podkreślenie tekstu. Przez
domyślnie baza danych terminfo używana jest do wyszukiwania kodów terminali używanych do zmiany koloru i
efekt. Jeśli terminfo nie jest dostępne, efekty są renderowane za pomocą ECMA-48 SGR
funkcja kontrolna (inaczej kody ucieczki ANSI).
Dostępne efekty w trybie terminfo to „miganie”, „pogrubienie”, „przyciemnienie”, „odwrotność”, „niewidoczność”,
„kursywa”, „wyróżnienie” i „podkreślenie”; w trybie ECMA-48 dostępne są opcje: „pogrubienie”, „odwrotność”,
„kursywa” i „podkreślenie”. Sposób renderowania każdego z nich zależy od emulatora terminala. Niektóre
mogą nie być dostępne dla danego typu terminala i zostaną po cichu zignorowane.
Etykiety
Tekst otrzymuje efekty kolorystyczne w zależności od posiadanych etykiet. Wiele domyślnych Mercurial
polecenia emitują oznaczony tekst. Możesz także zdefiniować własne etykiety w szablonach za pomocą
funkcja etykiety, patrz hg pomoc Szablony. Pojedyncza część tekstu może mieć więcej niż jeden
etykieta. W takim przypadku efekty przypisane ostatniej etykiecie zastępują wszelkie inne efekty. Ten
zawiera specjalny efekt „brak”, który anuluje inne efekty.
Etykiety są zwykle niewidoczne. Aby zobaczyć te etykiety i ich pozycję w
tekst, użyj opcji globalnej --color=debug. Ten sam tekst zakotwiczenia może być powiązany z
wiele etykiet, np
[log.changeset changeset.secret|changeset: 22611:6f0a53c8f587]
Poniżej przedstawiono domyślne efekty niektórych domyślnych etykiet. Domyślne efekty mogą być
zastąpione z pliku konfiguracyjnego:
[kolor]
status.modified = niebieskie, pogrubione podkreślenie, czerwone_tło
status.added = zielone pogrubienie
status.removed = czerwony pogrubiony blue_background
status.deleted = pogrubione podkreślenie w kolorze cyjanowym
status.unknown = pogrubione podkreślenie w kolorze magenty
status.ignored = czarne pogrubienie
# 'none' wyłącza wszystkie efekty
status.clean = brak
status.copied = brak
qseries.applied = niebieskie, pogrubione podkreślenie
qseries.unapplied = czarne pogrubienie
qseries.missing = czerwone pogrubienie
diff.diffline = pogrubienie
diff.extended = cyjan pogrubiony
diff.file_a = czerwone pogrubienie
diff.file_b = zielone pogrubienie
diff.hunk = magenta
diff.deleted = czerwony
diff.inserted = zielony
diff.changed = biały
diff.tab =
diff.trailingwhitespace = pogrubienie czerwone_tło
# Puste, więc dziedziczy styl otaczającej etykiety
zestaw zmian.public =
zestaw zmian.draft =
zestaw zmian.sekret =
rozwiązanie.unresolved = czerwone pogrubienie
rozwiązanie.resolved = zielone pogrubienie
bookmarks.active = zielony
gałęzie.aktywne = brak
gałęzie.zamknięte = czarne pogrubienie
gałęzie.prąd = zielony
gałęzie.inactive = brak
tagi.normal = zielony
tags.local = czarne pogrubienie
rebase.rebased = niebieski
rebase.remaining = czerwone pogrubienie
półka.wiek = cyjan
shelve.newest = zielone pogrubienie
shelve.name = niebieskie pogrubienie
histedit.remaining = czerwone pogrubienie
Zamówienia Indywidualne zabarwienie
Ponieważ dostępnych jest tylko osiem standardowych kolorów, moduł ten umożliwia zdefiniowanie nazw kolorów
dla innych kolorowych gniazd, które mogą być dostępne dla twojego typu terminala, zakładając, że terminfo
tryb. Na przykład:
kolor.jasnoniebieski = 12
kolor.różowy = 207
kolor.pomarańczowy = 202
aby ustawić „jasnoniebieski” na gnieździe kolorów 12 (przydatne w przypadku 16 kolorowych terminali, które mają jaśniejsze
kolory zdefiniowane w górnych ośmiu) oraz „różowy” i „pomarańczowy” do kolorów w 256-kolorowym xtermie
domyślna kostka koloru. Te zdefiniowane kolory można następnie wykorzystać jako dowolne z wcześniej zdefiniowanych
osiem, łącznie z dodaniem „_background”, aby ustawić tło na ten kolor.
Tryby pracy
Domyślnie rozszerzenie kolorów będzie używać trybu ANSI (lub trybu win32 w systemie Windows), jeśli tak jest
wykrywa terminal. Aby zastąpić tryb automatyczny (na przykład włączyć tryb terminfo), ustaw opcję
następująca opcja konfiguracji:
[kolor]
tryb = terminfo
Każda wartość inna niż „ansi”, „win32”, „terminfo” lub „auto” spowoduje wyłączenie kolorów.
Należy pamiętać, że w niektórych systemach tryb terminfo może powodować problemy podczas używania koloru z rozszerzeniem
rozszerzenie pagera i mniej -R. less z opcją -R wyświetli tylko kolor ECMA-48
kody, a tryb terminfo może czasami emitować kody, których less nie rozumie. Możesz
obejść ten problem, używając trybu ansi (lub trybu automatycznego) lub używając less -r (co spowoduje
przepuszczać wszystkie kody sterujące terminala, a nie tylko kody sterujące kolorem).
W niektórych systemach (takich jak MSYS w Windows) terminal może obsługiwać inny tryb kolorów
niż pager (aktywowany poprzez rozszerzenie „pager”). Istnieje możliwość zdefiniowania oddzielnych
tryby w zależności od tego czy pager jest aktywny:
[kolor]
tryb = automatyczny
tryb pagera = ansi
If tryb pagera nie jest zdefiniowany, tryb będzie użyty.
Polecenia
konwertować
importować wersje z zagranicznych repozytoriów VCS do Mercurial
Polecenia
konwertować
skonwertuj zagraniczne repozytorium SCM na repozytorium Mercurial.:
hg konwertuj [OPCJA]... ŹRÓDŁO [CEL [ZMIANA]]
Akceptowane formaty źródłowe [identyfikatory]:
· Rtęć [hg]
· CVS [cvs]
· Darki [darki]
· git [git]
· Subwersja [svn]
· Monotonia [mtn]
· GNU Arch [gnuarch]
· Bazar [bzr]
· Siła [p4]
Akceptowane formaty docelowe [identyfikatory]:
· Rtęć [hg]
· Subversion [svn] (historia na gałęziach nie jest zachowywana)
Jeśli nie zostanie podana żadna wersja, wszystkie wersje zostaną przekonwertowane. W przeciwnym razie przekonwertuj tylko will
import aż do nazwanej wersji (podanej w formacie zrozumiałym dla źródła).
Jeśli nie określono nazwy katalogu docelowego, domyślnie jest to nazwa bazowa źródła
w -hg dołączony. Jeśli repozytorium docelowe nie istnieje, zostanie utworzone.
Domyślnie wszystkie źródła oprócz Mercurial będą używać opcji --branchsort. Zastosowania rtęci
--sourcesort, aby zachować oryginalną kolejność numerów wersji. Tryby sortowania mają następujące cechy
efekty:
--sortowanie oddziałów
jeśli to możliwe, przekonwertuj wersję nadrzędną na podrzędną, co oznacza, że gałęzie są
zwykle konwertowane jeden po drugim. Generuje bardziej kompaktowe repozytoria.
--sortowanie według daty
sortuj wersje według daty. Skonwertowane repozytoria mają dobrze wyglądające dzienniki zmian, ale takie są
często o rząd wielkości większe niż te same generowane przez --branchsort.
--sortowanie źródeł
staraj się zachować kolejność wersji źródłowych, obsługiwaną tylko przez źródła Mercurial.
--zamknij sortowanie
staraj się przenosić zamknięte wersje jak najbliżej gałęzi nadrzędnych
wspierane przez źródła Mercurial.
If PRZEGLĄD nie zostanie podany, zostanie umieszczony w domyślnej lokalizacji (/.hg/shamap by
domyślny). The PRZEGLĄD to prosty plik tekstowy, który odwzorowuje każdy identyfikator zatwierdzenia źródła na plik
identyfikator docelowy dla tej wersji, na przykład:
Jeśli plik nie istnieje, zostanie utworzony automatycznie. Jest aktualizowany przy każdym kopiowanym zatwierdzeniu,
so hg konwertować można przerwać i można je uruchamiać wielokrotnie w celu skopiowania nowych zatwierdzeń.
Mapa autora to prosty plik tekstowy, który odwzorowuje każdego autora zatwierdzenia źródłowego na miejsce docelowe
autor popełnić. Jest to przydatne w przypadku źródłowych SCM, które używają loginów Unix do identyfikacji autorów (np.:
CV). Jedna linia na mapowanie autora, a format linii to:
autor źródłowy = autor docelowy
Puste linie i linie zaczynające się od a # są ignorowane.
Mapa plików to plik umożliwiający filtrowanie i ponowne mapowanie plików i katalogów. Każdy
linia może zawierać jedną z następujących dyrektyw:
Dołącz ścieżkę/do/pliku lub katalogu
wyklucz ścieżkę/do/pliku lub katalogu
zmień nazwę ścieżka/do/ścieżka źródłowa/do/miejsce docelowe
Linie komentarzy zaczynają się od #. Określona ścieżka jest zgodna, jeśli jest równa pełnej nazwie względnej
pliku lub jednego z jego katalogów nadrzędnych. The zawierać or wykluczać dyrektywa z
obowiązuje najdłuższa pasująca ścieżka, więc kolejność linii nie ma znaczenia.
Połączenia zawierać dyrektywa powoduje, że plik lub wszystkie pliki w katalogu zostaną uwzględnione w pliku
repozytorium docelowe. Wartość domyślna, jeśli nie ma zawierać oświadczenia ma obejmować
wszystko. Jeśli znajdują się jakiekolwiek zawierać oświadczenia, nic więcej nie jest uwzględnione. The wykluczać
dyrektywa powoduje pominięcie plików lub katalogów. The przemianować dyrektywa zmienia nazwę pliku
lub katalog, jeśli jest konwertowany. Aby zmienić nazwę podkatalogu na katalog główny pliku
repozytorium, użyj . jako ścieżkę, na którą należy zmienić nazwę.
--pełny upewni się, że przekonwertowane zestawy zmian zawierają dokładnie właściwe pliki z rozszerzeniem
właściwa treść. Dokona pełnej konwersji wszystkich plików, a nie tylko tych, które je posiadają
zmieniony. Pliki, które są już poprawne, nie zostaną zmienione. Można to wykorzystać do zastosowania
mapa plików zmienia się podczas konwersji przyrostowej. Ta funkcja jest obecnie obsługiwana tylko dla
Mercurial i Subversion.
Mapa splotów to plik, który umożliwia wstawienie syntetycznej historii, pozwalając na określenie
rodzice rewizji. Jest to przydatne, jeśli chcesz np. połączyć Subversion dwa
rodziców, albo połączyć ze sobą dwie rozłączne serie historii. Każdy wpis zawiera klucz,
po której następuje spacja i jedna lub dwie wartości oddzielone przecinkami:
klucz rodzic1, rodzic2
Kluczem jest identyfikator wersji w systemie kontroli wersji źródła, którym powinni być rodzice
zmodyfikowany (ten sam format co klucz w .hg/shamap). Wartości są identyfikatorami wersji (w formacie
źródłowy lub docelowy system kontroli wersji), które powinny być używane jako nowe elementy nadrzędne
dla tego węzła. Na przykład, jeśli połączyłeś „release-1.0” z „trunk”, powinieneś to zrobić
określ wersję na „trunk” jako pierwszego rodzica i tę na „release-1.0”
oddział jako drugi.
Mapa oddziałów to plik, który umożliwia zmianę nazwy oddziału podczas jego wprowadzania
z dowolnego zewnętrznego repozytorium. Umożliwia to użycie w połączeniu z mapą splotów
dla potężnej kombinacji, która pomoże naprawić nawet najbardziej źle zarządzane repozytoria i
zamień je w ładnie zorganizowane repozytoria Mercurial. Mapa oddziałów zawiera linie
formularz:
oryginalna_nazwa_oddziału nowa nazwa_oddziału
gdzie „oryginalna_nazwa_branży” to nazwa gałęzi w repozytorium źródłowym, oraz
„nazwa_nowej_branży” to nazwa gałęzi będącej repozytorium docelowym. Brak białych znaków
jest dozwolone w nazwach oddziałów. Można tego użyć do (na przykład) przeniesienia kodu w jednym
repozytorium z „domyślnego” do nazwanej gałęzi.
rtęciowy Źródło
Źródło Mercurial rozpoznaje następujące opcje konfiguracji, które można ustawić
wiersz poleceń z --konfig:
konwertuj.hg.ignoreerrors
ignoruj błędy integralności podczas czytania. Użyj go, aby naprawić repozytoria Mercurial
brakujące rejestry obrotów, poprzez konwersję z i na Mercurial. Wartość domyślna to Fałsz.
konwertuj.hg.saverev
przechowuj oryginalny identyfikator wersji w zestawie zmian (wymusza zmianę identyfikatorów docelowych). To zajmuje
argument boolowski i domyślnie ma wartość False.
konwertuj.hg.startrev
określ początkową wersję Mercurial. Wartość domyślna to 0.
konwersja.hg.revs
revset określający wersje źródłowe do konwersji.
CVS Źródło
Źródło CVS użyje piaskownicy (tj. pobranej kopii) z CVS, aby wskazać początek
punkt tego, co zostanie przekonwertowane. Nie jest potrzebny bezpośredni dostęp do plików repozytorium,
chyba że repozytorium jest :lokalny:. Do konwersji używany jest katalog najwyższego poziomu w
piaskownicy, aby znaleźć repozytorium CVS, a następnie używa poleceń CVS rlog, aby znaleźć pliki
konwertować. Oznacza to, że jeśli nie podano mapy plików, wszystkie pliki znajdują się w katalogu początkowym
zostanie przekonwertowany i że jakakolwiek reorganizacja katalogów w piaskownicy CVS będzie ignorowana.
Można używać następujących opcji --konfig:
konwertuj.cvsps.cache
Ustaw na False, aby wyłączyć zdalne buforowanie dzienników na potrzeby testowania i debugowania.
Wartość domyślna to Prawda.
konwertuj.cvsps.fuzz
Określ maksymalny czas (w sekundach) dozwolony pomiędzy zatwierdzeniami
identyczny komunikat użytkownika i dziennika w jednym zestawie zmian. Kiedy bardzo duże pliki były
zaewidencjonowany jako część zestawu zmian, wartość domyślna może nie być wystarczająco długa. The
wartość domyślna to 60.
konwertuj.cvsps.mergeto
Określ wyrażenie regularne, do którego dopasowywane są komunikaty dziennika zatwierdzeń. Jeśli mecz
nastąpi, wówczas proces konwersji wstawi fikcyjną wersję łączącą gałąź
w którym ten komunikat dziennika pojawia się w gałęzi wskazanej w wyrażeniu regularnym. Domyślnie jest
{{mergetobranch ([-\w]+)}}
konwertuj.cvsps.mergefrom
Określ wyrażenie regularne, do którego dopasowywane są komunikaty dziennika zatwierdzeń. Jeśli mecz
nastąpi, wówczas proces konwersji doda najnowszą wersję w gałęzi
wskazany w wyrażeniu regularnym jako drugi rodzic zestawu zmian. Domyślnie jest
{{mergefrombranch ([-\w]+)}}
konwersja.localtimezone
użyj czasu lokalnego (określonego przez zmienną środowiskową TZ) dla zestawu zmian
data/godzina. Wartość domyślna to Fałsz (użyj czasu UTC).
hooks.cvslog
Określ funkcję Pythona, która ma zostać wywołana na końcu gromadzenia dziennika CVS. The
funkcja otrzymuje listę wpisów dziennika i może je modyfikować
na miejscu lub dodaj je lub usuń.
hooks.cvschangesets
Określ funkcję Pythona, która ma zostać wywołana po obliczeniu zestawów zmian z pliku
Dziennik CVS. Funkcja otrzymuje listę z wpisami zestawu zmian i może ją modyfikować
zestawy zmian na miejscu lub dodaj je lub usuń.
Dodatkowe polecenie Mercurial „debugcvsps” umożliwia wbudowanemu scalaniu kodu zestawu zmian
uruchomić bez wykonywania konwersji. Jego parametry i dane wyjściowe są podobne do cvsps
2.1. Więcej szczegółów znajdziesz w pomocy dotyczącej polecenia.
Przewrót Źródło
Źródło Subversion wykrywa klasyczne układy pnia/gałęzi/znaczników. Domyślnie dostarczony
svn://repo/ścieżka/ źródłowy adres URL jest konwertowany jako pojedyncza gałąź. Jeśli svn://repo/ścieżka/trunk
istnieje, zastępuje domyślną gałąź. Jeśli svn://repo/path/branches istnieje, jest
podkatalogi są wymienione jako możliwe gałęzie. Jeśli svn://repo/ścieżka/tags istnieje, jest
szukał tagów odnoszących się do przekonwertowanych gałęzi. Domyślny tułów, gałęzie i tagi wartości
można zastąpić następującymi opcjami. Ustaw je na ścieżki względem źródłowego adresu URL lub
pozostaw je puste, aby wyłączyć automatyczne wykrywanie.
Za pomocą można ustawić następujące opcje --konfig:
konwertuj.svn.branches
określ katalog zawierający gałęzie. Wartość domyślna to gałęzie.
konwertuj.svn.tags
określ katalog zawierający znaczniki. Wartość domyślna to tagi.
konwertuj.svn.trunk
podaj nazwę gałęzi głównej. Wartość domyślna to tułów.
konwersja.localtimezone
użyj czasu lokalnego (określonego przez zmienną środowiskową TZ) dla zestawu zmian
data/godzina. Wartość domyślna to Fałsz (użyj czasu UTC).
Historię źródła można odzyskać, zaczynając od określonej wersji, zamiast być
integralnie przekształcone. Obsługiwane są tylko konwersje z jedną gałęzią.
konwertuj.svn.startrev
określ początkowy numer wersji Subversion. Wartość domyślna to 0.
git Źródło
Importer Git konwertuje zatwierdzenia ze wszystkich osiągalnych gałęzi (ref w refs/heads) i
piloty (ref. w refs/piloty) do Mercurial. Gałęzie są konwertowane na zakładki za pomocą
o tej samej nazwie, z pozbawionymi wiodących „refs/heads”. Podmoduły Git są konwertowane do Git
subrepo w Mercurial.
Za pomocą można ustawić następujące opcje --konfig:
konwertuj.git.podobieństwo
określ, w jaki sposób podobne pliki zmodyfikowane w zatwierdzeniu muszą być importowane jako zmiany nazw lub
kopii, jako procent pomiędzy 0 (niepełnosprawni) i 100 (pliki muszą być identyczne). Dla
przykład, 90 oznacza, że para usuwania/dodawania zostanie zaimportowana jako zmiana nazwy, jeśli jest ich więcej niż
90% pliku nie zostało zmienione. Wartość domyślna to 50.
konwertuj.git.findcopiesharder
podczas wykrywania kopii spójrz na wszystkie pliki w kopii roboczej, a nie tylko
zmienione. Jest to bardzo kosztowne w przypadku dużych projektów i jest skuteczne tylko wtedy, gdy
konwertuj.git.podobieństwo jest większa niż 0. Wartość domyślna to Fałsz.
konwertuj.git.remoteprefix
zdalne referencje są konwertowane jako zakładki za pomocą konwertuj.git.remoteprefix jako przedrostek
następnie /. Wartość domyślna to „zdalna”.
konwertuj.git.skipsubmodules
nie konwertuje plików .gitmodules poziomu głównego ani plików ze wskazaniem trybu 160000
podmoduł. Wartość domyślna to Fałsz.
Perforce Źródło
Importer Perforce (P4) może otrzymać ścieżkę do składu p4 lub specyfikację klienta jako
źródło. Konwertuje wszystkie pliki w źródle do płaskiego repozytorium Mercurial, ignorując
etykiety, gałęzie i integracje. Pamiętaj, że gdy zostanie podana ścieżka do magazynu, zwykle jest to możliwe
powinien określić katalog docelowy, ponieważ w przeciwnym razie cel może zostać nazwany ...-hg.
Za pomocą można ustawić następujące opcje --konfig:
konwertuj.kodowanie.p4
określ kodowanie, które ma zostać użyte podczas dekodowania standardowego wyjścia polecenia Perforce
narzędzie liniowe. Wartość domyślna to domyślne kodowanie systemowe.
konwertuj.p4.startrev
określ początkową wersję Perforce (numer listy zmian Perforce).
rtęciowy Cel
Miejsce docelowe Mercurial rozpozna podrepozytoria Mercurial w miejscu docelowym
katalog i automatycznie zaktualizuj plik .hgsubstate, jeśli jest to miejsce docelowe
podrepozytoria zawierają plik / /.hg/shamap plik. Konwersja repozytorium za pomocą
podrepozytoria wymaga konwersji pojedynczego repozytorium na raz, od dołu do góry.
Przykład pokazujący jak skonwertować repozytorium z podrepozytoriami:
# więc konwertowanie zna typ, gdy widzi niepuste miejsce docelowe
$ hg inicj. przeliczone
$ hg konwertuj oryg/sub1 konwertuj/sub1
$ hg konwertuj oryg/sub2 konwertuj/sub2
$ hg przekonwertuj oryg przekonwertowano
Obsługiwane są następujące opcje:
konwertuj.hg.clonebranches
wysyłaj gałęzie źródłowe w oddzielnych klonach. Wartość domyślna to Fałsz.
konwertuj.hg.tagsbranch
nazwa gałęzi dla wersji znaczników, domyślnie domyślnym.
konwertuj.hg.usebranchnames
zachowaj nazwy oddziałów. Wartość domyślna to Prawda.
konwertuj.hg.nazwaźródła
rejestruje dany ciąg jako dodatkową wartość „convert_source” przy każdym dokonanym zatwierdzeniu
repozytorium docelowego. Wartość domyślna to Brak.
Wszystkie kategorie Kierunki
Wszystkie typy miejsc docelowych akceptują następujące opcje:
konwertuj.skiptags
nie konwertuje tagów z repozytorium źródłowego do repozytorium docelowego. Wartość domyślna to
Fałszywy.
Opcje:
--autorski
nazwa pliku mapowania nazwy użytkownika (przestarzałe) (zamiast tego użyj --authormap)
-tak,--rodzaj źródła
typ repozytorium źródłowego
-D,--typ docelowy
typ repozytorium docelowego
-R,--obrót silnika
importuj do wersji źródłowej REV
-DO,--autormapa
zmapuj nazwy użytkowników przy użyciu tego pliku
--mapa plików
przemapuj nazwy plików, używając zawartości pliku
--pełny zastosuj zmiany w mapie plików, ponownie konwertując wszystkie pliki
--mapa splotu
spleść zsyntetyzowaną historię w odpowiednie miejsce
--mapa gałęzi
zmieniać nazwy oddziałów podczas konwersji
--sortowanie oddziałów
spróbuj posortować zestawy zmian według gałęzi
--sortowanie według daty
spróbuj posortować zestawy zmian według daty
--sortowanie źródeł
zachowaj kolejność zestawów zmian źródłowych
--zamknij sortowanie
spróbuj zmienić kolejność zamkniętych wersji
Opcja zaznaczona [+] może być określona wielokrotnie
eol
automatycznie zarządzaj znakami nowej linii w plikach repozytorium
To rozszerzenie pozwala zarządzać typem zakończeń linii (CRLF lub LF), które są używane
repozytorium oraz w lokalnym katalogu roboczym. W ten sposób możesz uzyskać zakończenia linii CRLF
w systemie Windows i LF w systemie Unix/Mac, umożliwiając w ten sposób każdemu korzystanie z natywnych zakończeń linii systemu operacyjnego.
Rozszerzenie odczytuje swoją konfigurację z pliku wersjonowanego .hgeol plik konfiguracyjny znaleziony w
katalog główny katalogu roboczego. The .hgeol plik ma tę samą składnię, co wszystkie inne
Pliki konfiguracyjne Mercuriala. Wykorzystuje dwie sekcje, [wzory] i [magazyn].
Połączenia [wzory] sekcja określa, w jaki sposób zakończenia linii powinny być konwertowane pomiędzy elementami roboczymi
katalog i repozytorium. Format jest określony przez wzorzec pliku. Pierwszy mecz
jest używany, więc najpierw umieść bardziej szczegółowe wzorce. Dostępne zakończenia linii to LF, CRLF,
BIN.
Pliki o zadeklarowanym formacie CRLF or LF są zawsze wyewidencjonowane i przechowywane w
repozytorium w tym formacie i pliki zadeklarowane jako binarne (BIN) pozostają bez zmian.
Dodatkowo, rodzimy to alias do sprawdzania domyślnego zakończenia linii platformy:
LF w systemie Unix (w tym Mac OS X) i CRLF w systemie Windows. Zauważ to BIN (nie rób nic zgodnie z linią
zakończenia) jest domyślnym zachowaniem Mercurial; jest to potrzebne tylko wtedy, gdy chcesz zastąpić a
później bardziej ogólny wzór.
Opcjonalne [magazyn] sekcja określa zakończenia linii używane w przypadku plików przechowywanych w
repozytorium. Posiada jedno ustawienie, rodzimy, który określa zakończenia linii magazynowych
dla plików zadeklarowanych jako rodzimy [wzory] Sekcja. Można to ustawić LF or CRLF,
wartość domyślna to LF. Oznacza to na przykład, że w systemie Windows pliki skonfigurowane jako rodzimy (CRLF
domyślnie) zostanie przekonwertowany na LF podczas przechowywania w repozytorium. Pliki zadeklarowane jako LF,
CRLFlub BIN [wzory] Sekcje są zawsze przechowywane w repozytorium w niezmienionej postaci.
Wersja przykładowa .hgeol file:
[wzory]
**.py = natywny
**.vcproj = CRLF
**.txt = natywny
Plik Makefile = LF
**.jpg = KOSZ
[magazyn]
natywny = LF
Uwaga Reguły będą obowiązywać w pierwszej kolejności, gdy pliki zostaną dotknięte w katalogu roboczym, np. przez
aktualizacja do wartości null i powrót do końcówki, aby dotknąć wszystkich plików.
Rozszerzenie wykorzystuje opcję opcjonalną [eol] sekcja przeczytana zarówno z normalnego Mercuriala
pliki konfiguracyjne i .hgeol plik, przy czym ten drugi zastępuje pierwszy. Możesz
użyj tej sekcji, aby kontrolować ogólne zachowanie. Istnieją trzy ustawienia:
· eol.native (domyślna os.linesep) można ustawić na LF or CRLF aby zastąpić ustawienie domyślne
interpretacja rodzimy do kasy. Można tego używać z hg archiwum na Unixie, powiedzmy, do
wygeneruj archiwum, w którym pliki mają zakończenia linii dla systemu Windows.
· eol.only-spójny (domyślnie True) można ustawić na False, aby dokonać konwersji rozszerzenia
pliki z niespójnymi EOLami. Niespójny oznacza, że istnieje jedno i drugie CRLF i LF teraźniejszość
w pliku. Takich plików zazwyczaj się nie dotyka, zakładając, że tak jest
celowo mieszane EOL.
· eol.fix-trailing-newline (domyślnie False) można ustawić na True, aby zapewnić konwersję
pliki kończą się znakiem EOL (albo \n or \ R \ n zgodnie ze skonfigurowanymi wzorcami).
Rozszerzenie zapewnia sprytnykod: i sprytny dekod: filtry takie jak przestarzałe
rozszerzenie win32text tak. Oznacza to, że możesz wyłączyć win32text i włączyć eol i
Twoje filtry będą nadal działać. Potrzebujesz tych filtrów tylko do czasu, aż przygotujesz plik
.hgeol plik.
Połączenia win32text.zabroń* haki dostarczane przez rozszerzenie win32text zostały ujednolicone w formacie a
pojedynczy hak o nazwie eol.checkheadshook. Hak będzie wyszukiwał oczekiwane zakończenia linii
dotychczasowy .hgeol plik, co oznacza, że musisz przeprowadzić migrację do pliku .hgeol najpierw plik przed użyciem
hak. eol.checkheadshook sprawdza tylko głowy, zostaną przesunięte pośrednie nieprawidłowe wersje.
Aby całkowicie ich zabronić, użyj opcji eol.checkallhook hak. Haczyki te najlepiej sprawdzają się jako
grupa pretxnchange haczyki.
See hg pomoc wzory aby uzyskać więcej informacji na temat używanych wzorców globu.
rozszerz
polecenie umożliwiające zewnętrznym programom porównywanie wersji
Rozszerzenie extdiff Mercurial pozwala na wykorzystanie zewnętrznych programów do porównywania wersji,
lub wersja z katalogiem roboczym. Zewnętrzne programy różnicowe wywoływane są za pomocą a
konfigurowalny zestaw opcji i dwa argumenty nieopcyjne: ścieżki do katalogów zawierających
migawki plików do porównania.
Rozszerzenie extdiff umożliwia także konfigurowanie nowych poleceń diff, więc nie jest to potrzebne
pisać hg rozszerz -p kdiff3 zawsze.
[rozszerz]
# dodaj nowe polecenie uruchamiające GNU diff(1) w trybie „różnicy kontekstowej”.
cdiff = gdiff -Nprc5
## lub stary sposób:
#cmd.cdiff = gdiff
#opts.cdiff = -Nprc5
# dodaj nowe polecenie o nazwie meld, uruchamia meld (nie trzeba podawać nazwy dwa razy). Jeśli
# plik wykonywalny meld jest niedostępny, narzędzie meld w [merge-tools]
# zostanie użyte, jeśli jest dostępne
połączenie =
# dodaj nowe polecenie o nazwie vimdiff, uruchamia gvimdiff z wtyczką DirDiff
# (Widzieć http://www.vim.org/scripts/script.php?script_id=102) Nie
# Angielski użytkownik, pamiętaj o wpisaniu „let g:DirDiffDynamicDiffText = 1” w
# Twój plik .vimrc
vimdiff = gvim -f "+następny" \
"+wykonaj 'DirDiff' fnameescape(argumentacja(0)) fnameescape(argumentacja(1))"
Argumenty narzędzia mogą zawierać zmienne rozwijane w czasie wykonywania:
$parent1, $plabel1 - nazwa pliku, etykieta opisowa pierwszego rodzica
$child, $clabel - nazwa pliku, etykieta opisowa wersji podrzędnej
$parent2, $plabel2 - nazwa pliku, etykieta opisowa drugiego rodzica
$root - katalog główny repozytorium
$parent jest aliasem dla $parent1.
Rozszerzenie extdiff będzie szukać różnic w sekcjach [diff-tools] i [merge-tools]
argumenty narzędzia, jeśli żaden nie jest określony w [extdiff].
[rozszerz]
kdiff3 =
[narzędzia różnicowe]
kdiff3.diffargs=--L1 '$plabel1' --L2 '$klabel' $rodzic $dziecko
Możesz użyć -I/-X i listy nazw plików lub katalogów jak zwykle hg diff Komenda. Plik
extdiff tworzy migawki tylko potrzebnych plików, więc uruchomienie zewnętrznego diff
program będzie faktycznie dość szybki (przynajmniej szybszy niż konieczność porównywania całego
drzewo).
Polecenia
rozszerz
użyj zewnętrznego programu do porównania repozytorium (lub wybranych plików):
hg extdiff [OPCJA]... [PLIK]...
Pokaż różnice pomiędzy wersjami określonych plików, używając zewnętrznego programu. The
domyślnym używanym programem jest diff, z domyślnymi opcjami „-Npru”.
Aby wybrać inny program, użyj opcji -p/--program. Program zostanie przekazany
nazwy dwóch katalogów do porównania. Aby przekazać dodatkowe opcje do programu należy użyć
-o/--opcja. Zostaną one przekazane przed nazwami katalogów do porównania.
Jeśli podane są dwa argumenty wersji, pokazane zostaną zmiany pomiędzy tymi wersjami. Jeśli
określona jest tylko jedna wersja, następnie ta wersja jest porównywana z katalogiem roboczym,
i jeśli nie określono żadnych wersji, pliki katalogu roboczego są porównywane z jego plikami
rodzic.
Opcje:
-P,--program
uruchomić program porównawczy
-o,--opcja
przekazać opcję do programu porównawczego
-R,--obrót silnika
rewizja
-C,--zmiana
zmiana dokonana poprzez rewizję
--łata
porównaj poprawki dla dwóch wersji
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
totumfacki
uwierzytelnianie http z faktem
To rozszerzenie umożliwia totumfacki(4) obiekt na Planie 9 z platform Bell Labs do
podać informacje uwierzytelniające dla dostępu HTTP. Wpisy konfiguracyjne określone w pliku
auth oraz informacje uwierzytelniające podane w adresie URL repozytorium
w pełni obsługiwane. Jeżeli nie określono przedrostka, przyjęta zostanie wartość „*”.
Domyślnie klucze są określone jako:
proto=przejdź usługę=hg przedrostek= użytkownik= !hasło=
Jeśli rozszerzenie factotum nie będzie w stanie odczytać wymaganego klucza, zostanie on o niego poproszony
interaktywnie.
Dostępna jest sekcja konfiguracji umożliwiająca dostosowanie zachowania środowiska wykonawczego. Domyślnie te
wpisy to:
[totumfacki]
plik wykonywalny = /bin/auth/factotum
punkt montowania = /mnt/fakt
usługa = hg
Wpis wykonywalny definiuje pełną ścieżkę do pliku binarnego factotum. Wpis punktu montowania
definiuje ścieżkę do usługi plików factotum. Na koniec wpis usługi kontroluje
nazwa usługi używana podczas odczytywania kluczy.
sprowadzać
ściąganie, aktualizowanie i łączenie w jednym poleceniu (przestarzałe)
Polecenia
sprowadzać
pobierz zmiany ze zdalnego repozytorium, w razie potrzeby scal nowe zmiany.:
hg fetch [ŹRÓDŁO]
Spowoduje to znalezienie wszystkich zmian z repozytorium pod określoną ścieżką lub adresem URL i dodanie ich do
lokalne repozytorium.
Jeśli pobrane zmiany dodadzą nową głowicę gałęzi, głowica zostanie automatycznie scalona, a plik
wynik połączenia został zatwierdzony. W przeciwnym razie katalog roboczy zostanie zaktualizowany w celu uwzględnienia
nowe zmiany.
Kiedy potrzebne jest scalanie, katalog roboczy jest najpierw aktualizowany do nowo ściągniętego katalogu
zmiany. Zmiany lokalne są następnie scalane w pobrane zmiany. Aby zmienić kolejność scalania,
użyj --switch-parent.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Zwraca 0 w przypadku powodzenia.
Opcje:
-R,--obrót silnika
konkretną wersję, którą chcesz pobrać
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
--force-editor
edytuj wiadomość zatwierdzenia (przestarzałe)
--przełącz-rodzica
zmień rodziców podczas łączenia
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
Gpg
polecenia do podpisywania i weryfikowania zestawów zmian
Polecenia
sigcheck
sprawdź wszystkie podpisy, które mogą znajdować się w przypadku konkretnej wersji:
hg sigcheck WER
sprawdź wszystkie podpisy, jakie mogą znajdować się w przypadku danej wersji
znak
dodaj podpis dla aktualnej lub danej wersji:
znak hg [OPCJA]... [WSTECZ]...
Jeśli nie podano żadnej wersji, używany jest katalog nadrzędny lub wskazówka, jeśli nie
wersja jest sprawdzona.
Połączenia gpg.cmd config można wykorzystać do określenia polecenia do uruchomienia. Domyślnym kluczem może być
określony z klucz gpg.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Opcje:
-ja, --lokalny
ustaw podpis lokalnie
-F, --siła
znak, nawet jeśli plik sig zostanie zmodyfikowany
--bez zobowiązań
nie zatwierdzaj pliku sigfile po podpisaniu
-k,--klucz
identyfikator klucza, za pomocą którego można się podpisać
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
sigs
lista podpisanych zestawów zmian:
hg sygnalizuje
lista podpisanych zestawów zmian
wykreslog
polecenie przeglądania wykresów wersji z powłoki (przestarzałe)
Funkcjonalność tego rozszerzenia została uwzględniona w rdzeniu Mercurial od wersji 2.3.
Proszę używać hg log -G ... zamiast.
To rozszerzenie dodaje opcję --graph do poleceń przychodzących, wychodzących i dziennika. Kiedy to
opcji, pokazana jest także reprezentacja ASCII wykresu wersji.
Polecenia
głóg
pokaż historię wersji wraz z wykresem wersji ASCII:
hg glog [OPCJA]... [PLIK]
Wydrukuj historię wersji wraz z wykresem wersji narysowanym znakami ASCII.
Węzły wydrukowane jako znak @ są rodzicami katalogu roboczego.
To jest pseudonim hg log -G.
Opcje:
-F, --śledzić
śledź historię zestawu zmian lub historię plików w kopiach i zmianach nazw
--follow-first
podążaj tylko za pierwszym rodzicem zestawów zmian scalających (przestarzałe)
-D,--Data
pokaż wersje pasujące do specyfikacji daty
-DO, --kopie
pokaż skopiowane pliki
-k,--słowo kluczowe
wykonaj wyszukiwanie bez uwzględniania wielkości liter dla danego tekstu
-R,--obrót silnika
pokaż określoną wersję lub zmianę ustawień
--REMOVED
uwzględnij wersje, w których pliki zostały usunięte
-M, --tylko-scala
pokaż tylko połączenia (przestarzałe)
-ty,--użytkownik
poprawki wprowadzone przez użytkownika
--tylko-oddział
pokaż tylko zestawy zmian w podanej nazwanej gałęzi (przestarzałe)
-B,--Oddział
pokaż zestawy zmian w podanej nazwanej gałęzi
-P,--suszona śliwka
nie wyświetlaj wersji ani żadnego z jej przodków
-P, --łata
pokaż poprawkę
-G, --git
użyj rozszerzonego formatu różnic git
-ja,--limit
limit liczby wyświetlanych zmian
-M, --no-scalania
nie pokazuj połączeń
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
-G, --wykres
pokaż wersję DAG
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
hgcia
hooki do integracji z usługą powiadomień CIA.vc
Ma to być uruchamiane jako grupa zmian lub hak przychodzący. Aby to skonfigurować, ustaw
następujące opcje w hgrc:
[cia]
# Twoja zarejestrowana nazwa użytkownika CIA
użytkownik = foo
# nazwa projektu w CIA
projekt = foo
# moduł (podprojekt) (opcjonalnie)
#moduł = foo
# Dołącz różnicę do komunikatu dziennika (opcjonalnie)
#diffstat = Fałsz
# Szablon do użycia w komunikatach dziennika (opcjonalnie)
#template = {desc}\n{baseurl}{webroot}/rev/{node}-- {diffstat}
# Styl do użycia (opcjonalnie)
#styl = foo
# Adres URL usługi powiadamiania CIA (opcjonalnie)
# Możesz użyć mailto: adresów URL do wysyłania e-mailem, np
# mailto:[email chroniony]
# Jeśli to zrobisz, pamiętaj o ustawieniu email.from.
#adres = http://cia.vc/
# wydrukuj wiadomość zamiast ją wysyłać (opcjonalnie)
#test = Fałsz
# liczba ukośników do usunięcia ze ścieżek adresów URL
#pasek = 0
[haki]
# jeden z tych:
changegroup.cia = python:hgcia.hook
#incoming.cia = python:hgcia.hook
[sieć]
# Jeśli chcesz hiperłącza (opcjonalnie)
bazowy = http://server/path/to/repo
hgk
przeglądaj repozytorium w sposób graficzny
Rozszerzenie hgk umożliwia przeglądanie historii repozytorium w sposób graficzny. To
wymaga Tcl/Tk w wersji 8.4 lub nowszej. (Tcl/Tk nie jest dystrybuowany wraz z firmą Mercurial.)
hgk składa się z dwóch części: skryptu Tcl, który wyświetla i wysyła zapytania
informacje oraz rozszerzenie Mercurial o nazwie hgk.py, które udostępnia haki dla hgk
zdobyć informację. hgk można znaleźć w katalogu contrib, a rozszerzenie jest dostarczane
w repozytorium hgext i musi być włączone.
Połączenia hg widok polecenie uruchomi skrypt hgk Tcl. Aby to polecenie zadziałało, musi być hgk
na Twojej ścieżce wyszukiwania. Alternatywnie możesz określić ścieżkę do hgk w swojej konfiguracji
file:
[hgk]
ścieżka = /lokalizacja/z/hgk
hgk może wykorzystać rozszerzenie extdiff do wizualizacji wersji. Zakładając, że miałeś
już skonfigurowane polecenie extdiff vdiff, po prostu dodaj:
[hgk]
vdiff=vdiff
Menu kontekstowe wersji będzie teraz wyświetlać dodatkowe wpisy umożliwiające uruchomienie vdiff po najechaniu kursorem i
wybrane rewizje.
Polecenia
widok
uruchom interaktywną przeglądarkę historii:
hg widok [-l LIMIT] [ZMIEN ZAKRES]
uruchom interaktywną przeglądarkę historii
Opcje:
-ja,--limit
limit liczby wyświetlanych zmian
podświetlić
podświetlanie składni dla hgweb (wymaga Pigments)
Zależy to od biblioteki podświetlania składni Pygments: http://pygments.org/
Istnieją następujące opcje konfiguracji:
[sieć]
styl_pygments = (default: colorful)
pliki podświetlenia = (domyślnie: rozmiar('<5M'))
nazwa_plikupodświetleniatylkodopasowania = (domyślnie Fałsz)
podświetl tylko dopasowaną nazwę pliku podświetli pliki tylko wtedy, gdy można zidentyfikować ich typ
ich nazwa pliku. Jeśli ta opcja nie jest włączona (ustawienie domyślne), Pygments będzie bardzo się starał
zidentyfikuj typ pliku na podstawie zawartości i dowolnego dopasowania (nawet dopasowania z niskim poziomem pewności
wynik) zostaną wykorzystane.
histedit
interaktywna edycja historii
Po zainstalowaniu tego rozszerzenia Mercurial zyskuje jedno nowe polecenie: histedit. Użycie jest takie
następująco, zakładając następującą historię:
@ 3[wskazówka] 7c2fd3b9020c 2009 04:27 -18 durin04
| Dodaj deltę
|
o 2 030b686bedc4 2009-04-27 18:04 -0500 w czasie 42
| Dodaj gammę
|
o 1 c561b4e977df 2009-04-27 18:04 -0500 w czasie 42
| Dodaj wersję beta
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 w czasie 42
Dodaj alfa
Jeśli miałbyś uciekać hg histedit c561b4e977df, zobaczysz otwarty następujący plik w swoim
redaktor:
wybierz c561b4e977df Dodaj wersję beta
wybierz 030b686bedc4 Dodaj gamma
wybierz 7c2fd3b9020c Dodaj deltę
# Edytuj historię między c561b4e977df i 7c2fd3b9020c
#
# Zatwierdzenia są wymienione od najmniejszego do najnowszego
#
# Polecenia:
# p, wybierz = użyj zatwierdzenia
# e, edit = użyj zatwierdzenia, ale zatrzymaj się, aby zmienić
# f, złóż = użyj zatwierdzenia, ale połącz to z powyższym
# r, roll = jak złożenie, ale odrzuć opis tego zatwierdzenia
# d, drop = usuń zatwierdzenie z historii
# m, mess = edytuj wiadomość zatwierdzenia bez zmiany treści zatwierdzenia
#
W tym pliku linie zaczynające się od # są ignorowane. Dla każdego musisz określić regułę
rewizja w Twojej historii. Na przykład, jeśli miałeś zamiar dodać gamma przed wersją beta, a następnie
chciałeś dodać deltę w tej samej wersji co wersja beta, zreorganizowałbyś plik, aby wyglądał
lubię to:
wybierz 030b686bedc4 Dodaj gamma
wybierz c561b4e977df Dodaj wersję beta
złóż 7c2fd3b9020c Dodaj deltę
# Edytuj historię między c561b4e977df i 7c2fd3b9020c
#
# Zatwierdzenia są wymienione od najmniejszego do najnowszego
#
# Polecenia:
# p, wybierz = użyj zatwierdzenia
# e, edit = użyj zatwierdzenia, ale zatrzymaj się, aby zmienić
# f, złóż = użyj zatwierdzenia, ale połącz to z powyższym
# r, roll = jak złożenie, ale odrzuć opis tego zatwierdzenia
# d, drop = usuń zatwierdzenie z historii
# m, mess = edytuj wiadomość zatwierdzenia bez zmiany treści zatwierdzenia
#
W tym momencie zamykasz edytor i histedit zaczyna działać. Kiedy określisz zagiąć
Operacja, histedit otworzy edytor, gdy złoży te wersje razem, oferując
masz szansę wyczyścić komunikat zatwierdzenia:
Dodaj wersję beta
***
Dodaj deltę
Edytuj wiadomość zatwierdzenia według własnych upodobań, a następnie zamknij edytor. Dla tego przykładu, niech
załóżmy, że komunikat zatwierdzenia został zmieniony na Dodaj beta i delta. Po uruchomieniu histedit
i miał szansę usunąć wszelkie potrzebne stare lub tymczasowe poprawki, jak wygląda historia
lubię to:
@ 2[wskazówka] 989b4d060121 2009 04:27 -18 durin04
| Dodaj beta i deltę.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 w czasie 42
| Dodaj gammę
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 w czasie 42
Dodaj alfa
Należy pamiętać, że histedit robi nie usuń wszelkie wersje (nawet własne tymczasowe) do czasu późniejszego
zakończył wszystkie operacje edycyjne, więc prawdopodobnie wykona kilka pasków
operacji, kiedy już to nastąpi. W powyższym przykładzie konieczne było dwukrotne uruchomienie paska. Pasek może być
powolny w zależności od różnych czynników, więc być może będziesz musiał uzbroić się w trochę cierpliwości. Możesz
wybierz zachowanie oryginalnych wersji, przekazując --trzymać flag.
Połączenia edit operacja przeniesie Cię z powrotem do wiersza poleceń, umożliwiając edycję plików
swobodnie, a nawet używać hg rekord aby zatwierdzić niektóre zmiany jako osobne zatwierdzenie. Kiedy jesteś
zostanie wykonane, wszelkie pozostałe niezatwierdzone zmiany również zostaną zatwierdzone. Kiedy skończysz, biegnij hg
histedit --kontyntynuj aby zakończyć ten krok. Zostaniesz poproszony o nową wiadomość o zatwierdzeniu, ale
domyślny komunikat zatwierdzenia będzie oryginalnym komunikatem dla pliku edit rewizja wyd.
Połączenia wiadomość operacja da ci szansę skorygowania komunikatu zatwierdzenia bez wprowadzania zmian
zawartości. To skrót do zrobienia edit zaraz po nim następuje hg histedit
--kontynuuj`.
If histedit napotyka konflikt podczas przenoszenia wersji (podczas obsługi wybierać or zagiąć),
zatrzyma się w podobny sposób edit z tą różnicą, że nie wyświetli monitu o a
zatwierdź wiadomość po zakończeniu. Jeśli w tym momencie zdecydujesz, że nie podoba Ci się ilość pracy
będzie zmienić historię, lub że popełniłeś błąd, możesz użyć hg histedit --anulować
porzucić nowe zmiany, które wprowadziłeś i powrócić do stanu sprzed próby
edytować swoją historię.
Jeśli sklonujemy powyższe repozytorium przykładów z histeditem i dodamy cztery kolejne zmiany, takie jak
mamy następującą historię:
@ 6[wskazówka] 038383181893 2009 04:27 -18 stefan
| Dodaj tetę
|
o 5 140988835471 2009-04-27 18:04 -0500 stefan
| Dodaj eta
|
o 4 122930637314 2009-04-27 18:04 -0500 stefan
| Dodaj zetę
|
o 3 836302820282 2009-04-27 18:04 -0500 stefan
| Dodaj epsilon
|
o 2 989b4d060121 2009-04-27 18:04 -0500 w ciągu 42
| Dodaj beta i deltę.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 w czasie 42
| Dodaj gammę
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 w czasie 42
Dodaj alfa
Jeśli biegniesz hg histedit --towarzyski na klonie to jest to samo, co bieganie hg histedit
836302820282. Jeśli potrzebujesz zaplanować wypchnięcie do repozytorium, którego Mercurial nie wykrywa
być powiązany z repozytorium źródłowym, możesz dodać plik --siła opcja.
Config
Linie reguł Histedit są domyślnie obcinane do 80 znaków. Możesz to dostosować
zachowanie poprzez ustawienie innej długości w pliku konfiguracyjnym:
[hisedit]
linelen = 120 # Obetnij linie reguł po 120 znakach
hg histedit próbuje automatycznie wybrać odpowiednią wersję podstawową do użycia. Do
zmień używaną wersję podstawową, zdefiniuj revset w pliku konfiguracyjnym:
[hisedit]
defaultrev = tylko(.) i wersja robocza()
Domyślnie każda edytowana wersja musi być obecna w poleceniach histedit. Usuwać
wersja, z której musisz skorzystać upuszczać operacja. Możesz skonfigurować upuszczanie tak, aby było ukryte
brakujące zatwierdzenia, dodając:
[hisedit]
dropmissing = Prawda
Polecenia
histedit
interaktywnie edytuj historię zestawu zmian:
hg histedit [OPCJE] ([Przodkowie] | --wychodzące [URL])
To polecenie umożliwia edycję liniowej serii zestawów zmian (aż do pliku roboczego włącznie).
katalog, który powinien być czysty). Możesz:
· wybierać aby [ponownie] zamówić zestaw zmian
· upuszczać aby pominąć zestaw zmian
· bałagan aby zmienić treść komunikatu zatwierdzenia zestawu zmian
· zagiąć aby połączyć go z poprzednim zestawem zmian
· rolka jak złożenie, ale odrzucając opis tego zatwierdzenia
· edit aby edytować ten zestaw zmian
Istnieje wiele sposobów wyboru głównego zestawu zmian:
· Określ bezpośrednio Przodka
· Użyj --outgoing -- będzie to pierwszy liniowy zestaw zmian nieuwzględniony w miejscu docelowym.
(Patrz hg pomoc konfiguracja.default-push)
· W przeciwnym razie wartość z opcji konfiguracyjnej „histedit.defaultrev” jest używana jako reset do
wybierz wersję bazową, jeśli nie określono Przodka. Pierwsza wersja zwrócona przez
używany jest reset. Domyślnie wybierana jest edytowalna historia, która jest unikalna dla
pochodzenie katalogu roboczego.
Jeśli użyjesz --outgoing, polecenie to zostanie przerwane, jeśli istnieją niejednoznaczne wersje wychodzące.
Na przykład, jeśli istnieje wiele gałęzi zawierających wersje wychodzące.
Użyj „min(outgoing() i ::.)” lub podobnej specyfikacji revset zamiast --outgoing to
określ dokładnie edycję wersji docelowej w tak niejednoznacznej sytuacji. Widzieć hg pomoc resetuje dla
szczegółowe informacje na temat wybierania wersji.
Przykłady:
· Wprowadzono szereg zmian. Wersja 3 nie jest już potrzebna.
Rozpocznij edycję historii od wersji 3:
hg histedit -r 3
Otworzy się edytor zawierający listę wersji z określonymi konkretnymi działaniami:
pick 5339bf82f0ca 3 Zworgle foobara
wybierz 8ef592ce7cc4 4 Zadziw zerloga
pick 0a9639fcda9d 5 Zmień cromulację
Dodatkowe informacje o możliwych działaniach, jakie należy podjąć, pojawiają się poniżej listy
poprawki.
Aby usunąć wersję 3 z historii, należy wykonać jej działanie (na początku odpowiedniego pliku
line) zmienia się na „drop”:
drop 5339bf82f0ca 3 Zworgle foobar
wybierz 8ef592ce7cc4 4 Zadziw zerloga
pick 0a9639fcda9d 5 Zmień cromulację
· Wprowadzono szereg zmian. Należy zamienić wersje 2 i 4.
Rozpocznij edycję historii od wersji 2:
hg histedit -r 2
Otworzy się edytor zawierający listę wersji z określonymi konkretnymi działaniami:
wybierz 252a1af424ad 2 Blorb a morgwazzle
pick 5339bf82f0ca 3 Zworgle foobara
wybierz 8ef592ce7cc4 4 Zadziw zerloga
Aby zamienić wersję 2 i 4, w edytorze zamieniane są ich linie:
wybierz 8ef592ce7cc4 4 Zadziw zerloga
pick 5339bf82f0ca 3 Zworgle foobara
wybierz 252a1af424ad 2 Blorb a morgwazzle
Zwraca 0 w przypadku powodzenia, 1 jeśli wymagana jest interwencja użytkownika (nie tylko w przypadku celowej „edycji”
dowodzenia, ale także do rozwiązywania nieoczekiwanych konfliktów).
Opcje:
--polecenia
przeczytaj historię zmian z określonego pliku
-C, --kontyntynuj
kontynuować edycję, która już trwa
--edytuj-plan
edytuj listę pozostałych działań
-k, --trzymać
nie usuwaj starych węzłów po zakończeniu edycji
--anulować
przerwać trwającą edycję
-o, --towarzyski
Nie znaleziono zestawów zmian w miejscu docelowym
-F, --siła
wymuszanie ruchu wychodzącego nawet w przypadku niepowiązanych repozytoriów
-R,--obrót silnika
pierwsza wersja do edycji
Opcja zaznaczona [+] może być określona wielokrotnie
keyword
rozwiń słowa kluczowe w śledzonych plikach
To rozszerzenie rozwija podobne do RCS/CVS lub samodzielnie dostosowywane $Keywords$ w śledzonych plikach tekstowych
wybrane przez Twoją konfigurację.
Słowa kluczowe są rozwijane jedynie w lokalnych repozytoriach i nie są przechowywane w historii zmian. The
mechanizm można traktować jako udogodnienie dla bieżącego użytkownika lub dla archiwum
d
Słowa kluczowe rozwijają się do danych zestawu zmian odnoszących się do ostatniej zmiany w stosunku do
katalog roboczy nadrzędny każdego pliku.
Konfigurację przeprowadza się w sekcjach [keyword], [keywordset] i [keywordmaps] pliku hgrc
akta.
Przykład:
[słowo kluczowe]
# rozwiń słowa kluczowe w każdym pliku Pythona z wyjątkiem tych pasujących do „x*”
**.py =
x* = ignoruj
[zestaw słów kluczowych]
# wolisz svn niż domyślne mapy słów kluczowych podobne do CVS
svn = Prawda
Uwaga Im bardziej szczegółowe są wzorce nazw plików, tym mniej tracisz prędkość w trybie ogromnym
repozytoria.
Do [keywordmaps] mapowania szablonów oraz demonstracji rozszerzania i przebiegu kontrolnego hg kwdemo.
See hg pomoc Szablony aby wyświetlić listę dostępnych szablonów i filtrów.
Dostępne są trzy dodatkowe filtry szablonów dat:
nieaktualna
"2006/09/18 15:13:13"
svnutcdate
"2006-09-18 15:13:13Z"
swnisodat
„2006-09-18 08:13:13 -700 (poniedziałek, 18 września 2006)”
Domyślne mapowania szablonów (widok za pomocą hg kwdemo -d) można zastąpić dostosowanymi
słowa kluczowe i szablony. Znowu biegnij hg kwdemo do kontrolowania wyników konfiguracji
zmiany.
Przed zmianą/wyłączeniem aktywnych słów kluczowych należy uruchomić hg kwshrink aby uniknąć przechowywania
rozszerzone słowa kluczowe w historii zmian.
Aby wymusić rozbudowę po włączeniu lub zmianie konfiguracji, uruchom hg kwrozwiń.
Rozszerzenia obejmujące więcej niż jedną linię i rozszerzenia przyrostowe, takie jak $Log$ CVS, są
Nieobsługiwany. Mapa szablonów słów kluczowych „Log = {desc}” rozwija się do pierwszej linii pliku
opis zestawu zmian.
Polecenia
kwdemo
print konfiguracja [keywordmaps] i przykład rozszerzenia:
hg kwdemo [-d] [-f PLIK RC] [MAPA SZABLONÓW]...
Pokaż aktualne, niestandardowe lub domyślne mapy szablonów słów kluczowych i ich rozwinięcia.
Rozszerz bieżącą konfigurację, określając mapy jako argumenty i używając -f/--rcfile to
pobierz zewnętrzny plik hgrc.
Użyj opcji -d/--default, aby wyłączyć bieżącą konfigurację.
See hg pomoc Szablony aby uzyskać informacje na temat szablonów i filtrów.
Opcje:
-D, --domyślny
pokaż domyślne mapy szablonów słów kluczowych
-F,--plik rc
czytaj mapy z pliku rc
kwrozwiń
rozwiń słowa kluczowe w katalogu roboczym:
hg kwexpand [OPCJA]... [PLIK]...
Uruchom po (ponownym) włączeniu rozwijania słów kluczowych.
kwexpand odmawia uruchomienia, jeśli podane pliki zawierają lokalne zmiany.
Opcje:
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
pliki kw
pokaż pliki skonfigurowane do rozwijania słów kluczowych:
hg kwfiles [OPCJA]... [PLIK]...
Lista plików w katalogu roboczym pasujących do konfiguracji [słowo kluczowe].
wzorce.
Przydatne, aby zapobiec niezamierzonemu rozwinięciu słów kluczowych i przyspieszyć wykonanie poprzez włączenie
tylko pliki, które są rzeczywistymi kandydatami do rozszerzenia.
See hg pomoc keyword o tym, jak konstruować wzorce zarówno włączania, jak i wykluczania
akta.
W przypadku -A/--all i -v/--verbose kody używane do pokazania statusu plików to:
K = kandydat na ekspansję słów kluczowych
k = kandydat na rozszerzenie słowa kluczowego (nie śledzony)
Ja = ignorowane
i = ignorowane (nie śledzone)
Opcje:
-DO, --wszystko
pokaż flagi stanu słów kluczowych wszystkich plików
-ja, --ignorować
pokaż pliki wyłączone z ekspansji
-ty, --nieznany
pokazuj tylko nieznane (nie śledzone) pliki
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
kwshrink
przywróć rozwinięte słowa kluczowe w katalogu roboczym:
hg kwshrink [OPCJA]... [PLIK]...
Należy uruchomić przed zmianą/wyłączeniem aktywnych słów kluczowych.
kwshrink odmawia uruchomienia, jeśli podane pliki zawierają lokalne zmiany.
Opcje:
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
duże pliki
śledzić duże pliki binarne
Duże pliki binarne zwykle nie dają się bardzo skompresować, niezbyt łatwo różnicować i wcale
możliwe do połączenia. Takie pliki nie są efektywnie obsługiwane przez format przechowywania Mercurial (revlog),
który opiera się na skompresowanych deltach binarnych; regularne przechowywanie dużych plików binarnych
Pliki Mercurial marnują przepustowość i miejsce na dysku oraz zwiększają wykorzystanie pamięci Mercurial.
Rozszerzenie Largefile rozwiązuje te problemy, dodając scentralizowany serwer klient-serwer
warstwa na wierzchu Mercurial: duże pliki znajdują się w pliku centralny sklep poza siecią
gdzieś i pobierasz tylko potrzebne wersje, kiedy ich potrzebujesz.
Largefiles działa poprzez utrzymywanie „pliku stałego” w .hglf/ dla każdego dużego pliku. The
standins są małe (41 bajtów: skrót SHA-1 plus znak nowej linii) i są śledzone przez Mercurial.
Wersje dużych plików są identyfikowane poprzez skrót SHA-1 ich zawartości, która jest zapisana
do stojącego. Largefiles używa tego identyfikatora wersji do pobierania/umieszczania wersji dużych plików z/do
sklep centralny. Oszczędza to zarówno miejsce na dysku, jak i przepustowość, ponieważ nie jest to konieczne
odzyskać wszystkie historyczne wersje dużych plików podczas klonowania lub pobierania.
Aby rozpocząć nowe repozytorium lub dodać nowe duże pliki binarne, po prostu dodaj --large do pliku hg Dodaj
Komenda. Na przykład:
$ dd if=/dev/urandom of=randomdata count=2000
$ hg add --duże dane losowe
$ hg commit -m „dodaj losowe dane jako duży plik”
Kiedy wypchniesz zestaw zmian, który dodaje/modyfikuje duże pliki do zdalnego repozytorium, jego
wraz z nim zostaną przesłane wersje dużych plików. Należy pamiętać, że zdalny Mercurial musi
aby to zadziałało, należy także włączyć rozszerzenie dużych plików.
Kiedy pobierasz zestaw zmian wpływający na duże pliki ze zdalnego repozytorium, plik Largefiles
ponieważ zestaw zmian nie będzie domyślnie usuwany. Jednak po aktualizacji do takiego
wersji, wszelkie duże pliki potrzebne tej wersji są pobierane i buforowane (jeśli mają
nigdy wcześniej nie pobrane). Jednym ze sposobów wyciągania dużych plików podczas przeciągania jest użycie
--update, który zaktualizuje twoją kopię roboczą do najnowszej ściągniętej wersji (a tym samym
pobieranie nowych dużych plików).
Jeśli chcesz pobrać duże pliki, których nie potrzebujesz jeszcze do aktualizacji, możesz użyć metody pull with
dotychczasowy --lfrew opcja lub hg lpociągnij dowództwo.
Jeśli wiesz, że pobierasz z lokalizacji innej niż domyślna i chcesz pobrać wszystkie pliki
duże pliki, które odpowiadają jednocześnie nowym zestawom zmian, możesz je pobrać
--lfrew „wyciągnięty()”.
Jeśli chcesz się tylko upewnić, że będziesz mieć duże pliki potrzebne do scalania lub zmiany bazy
z nowymi głowami, które ciągniesz, to możesz ciągnąć --lfrew „głowa (pociągnięta ())” flaga
aby zapobiegawczo pobrać wszelkie duże pliki, które są nowe w wyciąganych głowicach.
Pamiętaj, że do aktualizacji posiadanych zestawów zmian może być teraz wymagany dostęp do sieci
nie aktualizowane wcześniej. Charakter rozszerzenia dużych plików oznacza, że aktualizacja jest
nie ma już gwarancji, że będzie to operacja wyłącznie lokalna.
Jeśli masz już duże pliki śledzone przez Mercurial bez rozszerzenia Largefiles, ty
będzie musiał przekonwertować repozytorium, aby móc korzystać z dużych plików. Zrobione
z hg Konwertuj polecenie:
$ hg lfconvert --rozmiar 10 starerepo nowerepo
W repozytoriach, które już zawierają duże pliki, każdy nowy plik większy niż 10MB będzie
automatycznie dodany jako duży plik. Aby zmienić ten próg, ustaw dużepliki.minrozmiar in
plik konfiguracyjny Mercurial do minimalnego rozmiaru w megabajtach, aby można go było śledzić jako duży plik, lub
użyj opcji --lfsize do polecenia add (również w megabajtach):
[duże pliki]
minimalny rozmiar = 2
$ hg dodaj --lfsize 2
Połączenia duże pliki.wzorce config pozwala określić listę wzorców nazw plików
(Patrz hg pomoc wzory), które należy zawsze śledzić jako duże pliki:
[duże pliki]
wzory =
* .jpg
re:.*\.(png|bmp)$
biblioteka.zip
treść/dźwięk/*
Pliki pasujące do jednego z tych wzorców zostaną dodane jako duże pliki, niezależnie od ich
rozmiar.
Połączenia dużepliki.minrozmiar i duże pliki.wzorce opcje konfiguracyjne zostaną zignorowane dla każdego
repozytoria, które nie zawierają już dużego pliku. Aby dodać pierwszy duży plik do pliku
repozytorium, musisz to wyraźnie zrobić, przekazując flagę --large do repozytorium hg Dodaj dowództwo.
Polecenia
Konwertuj
przekonwertuj normalne repozytorium na repozytorium dużych plików:
hg lfconvert ŹRÓDŁO DOCELOWE [PLIK ...]
Konwertuj repozytorium SOURCE na nowe repozytorium DEST, identyczne z SOURCE, z tą różnicą, że
niektóre pliki zostaną przekonwertowane jako duże pliki: w szczególności każdy plik pasujący do dowolnego
WZÓR or którego rozmiar przekracza minimalny próg rozmiaru, jest konwertowany jako duży plik. The
rozmiar używany do określenia, czy plik ma być śledzony jako duży plik, to rozmiar pliku
pierwsza wersja pliku. Minimalny rozmiar można określić za pomocą opcji --size lub in
konfiguracja jako dużepliki.rozmiar.
Po uruchomieniu tego polecenia musisz się upewnić, że w dowolnym miejscu włączona jest obsługa dużych plików
zamierzasz wypchnąć nowe repozytorium.
Użyj --to-normal, aby przekonwertować duże pliki z powrotem na normalne pliki; następnie DEST
repozytorium może być w ogóle używane bez dużych plików.
Opcje:
-tak,--rozmiar
minimalny rozmiar (MB) plików, które mają być konwertowane na duże pliki
--Do normalności
przekonwertuj repozytorium dużych plików na normalne repozytorium
lpociągnij
pobierz duże pliki dla określonych wersji z określonego źródła:
hg lfpull -r WER... [-e CMD] [--remotecmd CMD] [ŹRÓDŁO]
Ściągnij duże pliki, do których odwołują się lokalne zestawy zmian, ale brakuje ich lokalnie, ciągnąc
ze zdalnego repozytorium do lokalnej pamięci podręcznej.
Jeżeli pominięto SOURCE, użyta zostanie ścieżka domyślna. Widzieć hg pomoc urls więcej
informacje.
Kilka przykładów:
· ściągnij duże pliki dla wszystkich głów oddziałów:
hg lfpull -r "głowa() i niezamknięta()"
· ściągnij duże pliki z domyślnej gałęzi:
hg lfpull -r "oddział (domyślnie)"
Opcje:
-R,--obrót silnika
pobierz duże pliki dla tych wersji
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
mq
zarządzać stosem poprawek
To rozszerzenie umożliwia pracę ze stosem poprawek w repozytorium Mercurial. Zarządza
dwa stosy poprawek - wszystkie znane poprawki i zastosowane poprawki (podzbiór znanych poprawek).
Znane łatki są reprezentowane jako pliki łat w katalogu .hg/patches. Zastosowane łaty
są zarówno plikami poprawek, jak i zestawami zmian.
Typowe zadania (użyj hg pomoc komenda po więcej szczegółów):
utwórz nową łatkę qnową
zaimportuj istniejącą poprawkę qimport
wydrukuj serię poprawek qseries
wydrukuj zastosowane poprawki qapplied
dodaj znaną łatkę do zastosowanego stosu qpush
usuń łatkę z zastosowanego stosu qpop
odśwież zawartość najczęściej zastosowanej łatki qrefresh
Domyślnie mq automatycznie użyje łatek git, gdy będzie to wymagane, aby uniknąć utraty trybu pliku
zmiany, kopiowanie rekordów, tworzenie lub usuwanie plików binarnych lub pustych plików. To zachowanie
można skonfigurować za pomocą:
[mXNUMX]
git = auto/zachowaj/tak/nie
Jeśli ustawione na „keep”, mq będzie przestrzegać konfiguracji sekcji [diff], zachowując istniejącą
poprawki git po qrefresh. Jeśli ustawione na „tak” lub „nie”, mq zastąpi sekcję [diff].
i zawsze generuj git lub zwykłe łatki, w drugim przypadku możliwa utrata danych.
Może być pożądane, aby zestawy zmian mq były przechowywane w fazie tajnej (patrz hg pomoc fazy),
które można włączyć za pomocą następującego ustawienia:
[mXNUMX]
sekret = prawda
Domyślnie będziesz zarządzać kolejką poprawek o nazwie „łatki”. Możesz stworzyć inne,
niezależne kolejki poprawek z hg kolejka dowództwo.
Jeśli katalog roboczy zawiera niezatwierdzone pliki, qpush, qpop i qgoto przerywają
natychmiast. Jeśli zostanie użyte -f/--force, zmiany zostaną odrzucone. Ustawienie:
[mXNUMX]
keepchanges = Prawda
spraw, aby zachowywały się tak, jakby przekazano --keep-changes, a nie powodujące konfliktu zmiany lokalne to zrobią
być tolerowane i zachowywane. Jeśli są niekompatybilne opcje, takie jak -f/--force lub --exact
przeszedł, to ustawienie jest ignorowane.
To rozszerzenie służyło do udostępniania polecenia usuwania. To polecenie jest teraz obecne w pasku
rozbudowa.
Polecenia
qzastosowany
wydrukuj już zastosowane poprawki:
hg qzastosowany [-1] [-s] [PATCH]
Zwraca 0 w przypadku powodzenia.
Opcje:
-1, --ostatni
pokaż tylko poprzednio zastosowaną poprawkę
-tak, --streszczenie
wydrukuj pierwszą linię nagłówka łatki
qklon
sklonuj jednocześnie repozytorium główne i repozytorium poprawek:
hg qclone [OPCJA]... ŹRÓDŁO [CEL]
Jeśli źródło jest lokalne, do miejsca docelowego nie zostaną zastosowane żadne poprawki. Jeśli źródło jest zdalne, to
polecenie nie może sprawdzić, czy w źródle zastosowano łatki, więc nie może zagwarantować, że łatki zostaną zastosowane
nie są stosowane w miejscu docelowym. Jeśli sklonujesz zdalne repozytorium, upewnij się wcześniej, że tak zostało
nie zastosowano żadnych poprawek.
Repozytorium poprawek źródłowych jest przeszukiwane w Domyślnie /.hg/patches. Użyj -str Do
zmienić.
Katalog poprawek musi być zagnieżdżonym repozytorium Mercurial, tak jak zostałoby utworzone przez hg startowych
--mkw.
Zwróć 0 w przypadku powodzenia.
Opcje:
--ciągnąć użyj protokołu pull do kopiowania metadanych
-Ty, --brak aktualizacji
nie aktualizuj nowych katalogów roboczych
--nieskompresowany
użyj nieskompresowanego transferu (szybkiego przez LAN)
-P,--łatki
lokalizacja repozytorium poprawek źródłowych
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
qzatwierdź
zatwierdzić zmiany w repozytorium kolejek (przestarzałe):
hg qcommit [OPCJA]... [PLIK]...
To polecenie jest przestarzałe; używać hg popełnić --mkw zamiast.
Opcje:
-DO, --Dodaj usuń
oznacz nowe/brakujące pliki jako dodane/usunięte przed zatwierdzeniem
--zamknięty oddział
oznaczyć główkę gałęzi jako zamkniętą
--poprawiać
zmień rodzica katalogu roboczego
-tak, --sekret
użyj tajnej fazy do zatwierdzenia
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-ja, --interaktywny
użyj trybu interaktywnego
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
-S, --podrepozytoria
wracaj do podrepozytoriów
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: qci
qusuń
usuń łatki z kolejki:
hg qdelete [-k] [POPRAWKA]...
Nie wolno naklejać łatek, wymagany jest co najmniej jeden łatka. Dokładna poprawka
należy podać identyfikatory. Opcja -k/--keep powoduje, że pliki łatek są zachowywane w łatce
katalogiem.
Aby zakończyć zarządzanie łatką i przenieść ją do trwałej historii, użyj opcji hg qzakończ dowództwo.
Opcje:
-k, --trzymać
zachowaj plik poprawki
-R,--obrót silnika
przestań zarządzać wersją (przestarzałe)
Opcja zaznaczona [+] może być określona wielokrotnie
aliasy: qremove qrm
qdiff
diff aktualnej łatki i kolejnych modyfikacji:
hg qdiff [OPCJA]... [PLIK]...
Pokazuje różnicę zawierającą bieżącą łatkę oraz wszelkie wprowadzone zmiany
w katalogu roboczym od ostatniego odświeżenia (pokazując w ten sposób, co będzie robić bieżąca łatka
stać się po qrefresh).
Zastosowanie hg diff jeśli chcesz tylko zobaczyć zmiany wprowadzone od ostatniego qrefresh, lub hg eksport
wskazówka jeśli chcesz zobaczyć zmiany wprowadzone przez bieżącą łatkę bez uwzględnienia wprowadzonych zmian
od qrefresh.
Zwraca 0 w przypadku powodzenia.
Opcje:
-za, --tekst
traktuj wszystkie pliki jako tekst
-G, --git
użyj rozszerzonego formatu różnic git
--nodaty
pomijaj daty w nagłówkach różnic
--noprzedrostek
pomijaj przedrostki a/ i b/ w nazwach plików
-P, --pokaż-funkcję
pokaż, w której funkcji znajduje się każda zmiana
--odwrócić
wygeneruj różnicę, która cofa zmiany
-w, --ignoruj całą przestrzeń
ignoruj białe znaki podczas porównywania linii
-B, --ignoruj-zmianę-spacji
zignoruj zmiany w ilości spacji
-B, --ignoruj puste linie
ignoruj zmiany, których wiersze są puste
-Ty,--ujednolicony
liczba wierszy kontekstu do pokazania
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
--źródło
generuje różnice w stosunku do podkatalogu
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
qzakończ
przenieś zastosowane poprawki do historii repozytorium:
hg qfinish [-a] [REV]...
Kończy określone wersje (odpowiadające zastosowanym poprawkom), przenosząc je z
mq do regularnej historii repozytorium.
Akceptuje zakres wersji lub opcję -a/--applied. Jeśli określono --applied, all
zastosowane wersje mq są usuwane z kontroli mq. W przeciwnym razie podane poprawki muszą być
u podstawy stosu nałożonych plastrów.
Może to być szczególnie przydatne, jeśli zmiany zostały zastosowane w repozytorium nadrzędnym,
lub jeśli masz zamiar przekazać zmiany do wyższego szczebla.
Zwraca 0 w przypadku powodzenia.
Opcje:
-za, --stosowany
zakończ wszystkie zastosowane zestawy zmian
qkrotnie
złóż nazwane łatki do bieżącej łatki:
hg qfold [-e] [-k] [-m TEKST] [-l PLIK] POPRAWKA...
Nie wolno jeszcze nakładać łatek. Każdy patch będzie sukcesywnie nanoszony na bieżący
poprawkę w podanej kolejności. Jeśli wszystkie łatki zostaną pomyślnie zastosowane, bieżąca łatka zostanie zainstalowana
odświeżone nową łatką zbiorczą, a złożone łatki zostaną usunięte. Z
-k/--keep, złożone pliki łatek nie zostaną później usunięte.
Nagłówek każdej złożonej łatki zostanie połączony z nagłówkiem bieżącego łaty,
oddzielone linią * * *.
Zwraca 0 w przypadku powodzenia.
Opcje:
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-k, --trzymać
zachowaj złożone pliki poprawek
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
qgoto
wypychaj lub wyskakuj łaty, aż nazwana łatka znajdzie się na szczycie stosu:
hg qgoto [OPCJA]... PATCH
Zwraca 0 w przypadku powodzenia.
Opcje:
--zachowaj zmiany
tolerować niesprzecznych zmian lokalnych
-F, --siła
nadpisz wszelkie zmiany lokalne
--bez kopii zapasowej
nie zapisuj kopii zapasowych plików
qguard
ustaw lub wydrukuj osłony dla łatki:
hg qguard [-l] [-n] [ŁATKA] [-- [+OCHRONA]... [-OCHRONA]...]
Strażnicy kontrolują, czy łatka może zostać wypchnięta. Łatka bez strażników jest zawsze wypychana. A
łatka z dodatnią osłoną („+foo”) jest wypychana tylko wtedy, gdy hg qselect polecenie ma
aktywowałem to. Łatka z osłoną negatywną („-foo”) nigdy nie jest wypychana, jeśli hg qselect
polecenie aktywowało to.
Bez argumentów wypisz aktualnie aktywnych strażników. Za pomocą argumentów postaw strażników
nazwana łatka.
Uwaga Określenie osłon ujemnych wymaga teraz znaku „--”.
Aby ustawić strażników na innej łatce:
hg qguard inna.łatka -- +2.6.17 -stabilna
Zwraca 0 w przypadku powodzenia.
Opcje:
-ja, --lista
wypisz wszystkie łatki i osłony
-N, --nic
zrzuć wszystkich strażników
qnagłówek
wydrukuj nagłówek najwyższej lub określonej łatki:
hg qheader [PATCH]
Zwraca 0 w przypadku powodzenia.
qimport
zaimportuj łatkę lub istniejący zestaw zmian:
hg qimport [-e] [-n NAZWA] [-f] [-g] [-P] [-r REW]... [PLIK]...
Plaster dołącza się do serii po ostatnim nałożeniu plastra. Jeśli nie ma żadnych poprawek
została zastosowana, qimport dołącza łatkę do serii.
Łatka będzie miała taką samą nazwę jak jej plik źródłowy, chyba że nadasz jej nową nazwę
-n/--nazwa.
Możesz zarejestrować istniejącą łatkę w katalogu łatek za pomocą flagi -e/--existing.
Opcja -f/--force powoduje nadpisanie istniejącej łatki o tej samej nazwie.
Istniejący zestaw zmian można umieścić pod kontrolą mq za pomocą -r/--rev (np. qimport --rev.
-n patch umieści bieżącą wersję pod kontrolą mq). Z -g/--git, poprawki
zaimportowane za pomocą --rev użyje formatu git diff. Więcej informacji można znaleźć w temacie pomocy dotyczącej różnic
dlaczego jest to ważne dla zachowania zmiany nazwy/kopiowania informacji i zmian uprawnień.
Zastosowanie hg qzakończ aby usunąć zestawy zmian z kontroli mq.
Aby zaimportować łatkę ze standardowego wejścia, podaj - jako plik łatki. Podczas importowania z
standardowego wejścia, należy określić nazwę poprawki za pomocą flagi --name.
Aby zaimportować istniejącą poprawkę podczas zmiany jej nazwy:
hg qimport -e istniejąca-łatka -n nowa-nazwa
Zwraca 0, jeśli import się powiódł.
Opcje:
-mi, --istniejący
importuj plik w katalogu łatek
-N,--Nazwa
nazwa pliku poprawki
-F, --siła
Nadpisz istniejące pliki
-R,--obrót silnika
umieść istniejące wersje pod kontrolą mq
-G, --git
użyj rozszerzonego formatu różnic git
-P, --naciskać
qpush po zaimportowaniu
Opcja zaznaczona [+] może być określona wielokrotnie
qinit
zainicjuj nowe repozytorium kolejek (przestarzałe):
hg qinit [-c]
Repozytorium kolejek jest domyślnie niewersjonowane. Jeśli podano -c/--create-repo, qinit
utworzy osobne zagnieżdżone repozytorium poprawek (qinit -c można również uruchomić później, aby
przekonwertować niewersjonowane repozytorium poprawek na wersjonowane). Możesz użyć qcommit do
zatwierdzić zmiany w tym repozytorium kolejek.
To polecenie jest przestarzałe. Bez -c jest to sugerowane przez inne odpowiednie polecenia. Z -c,
posługiwać się hg startowych --mkw zamiast.
Opcje:
-C, --utwórz-repo
utwórz repozytorium kolejek
qnowy
utwórz nową łatkę:
hg qnew [-e] [-m TEKST] [-l PLIK] POPRAWKA [PLIK]...
qnew tworzy nową łatkę na aktualnie zastosowanej łatce (jeśli istnieje). Łatka będzie
zainicjowany wszystkimi zaległymi zmianami w katalogu roboczym. Możesz także użyć
-I/--include, -X/--exclude i/lub lista plików po nazwie poprawki, które mają zostać dodane tylko
zmiany w plikach pasujących do nowej łatki, resztę pozostawiając jako niezatwierdzone modyfikacje.
-u/--user i -d/--date można użyć do ustawienia odpowiednio (podanego) użytkownika i daty.
-U/--currentuser i -D/--currentdate ustawiają użytkownika na bieżącego użytkownika, a datę na bieżącą datę.
-e/--edit, -m/--message lub -l/--logfile ustawia nagłówek łatki oraz zatwierdzenie
wiadomość. Jeśli nie określono żadnego, nagłówek jest pusty, a komunikat zatwierdzenia ma postać „[mq]:
SKRAWEK'.
Użyj opcji -g/--git, aby zachować łatkę w rozszerzonym formacie git. Przeczytaj różnice
temat pomocy, aby uzyskać więcej informacji o tym, dlaczego jest to ważne dla zachowania zmian uprawnień
i skopiuj/zmień nazwę informacji.
Zwraca 0 w przypadku pomyślnego utworzenia nowej poprawki.
Opcje:
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-F, --siła
importuj niezatwierdzone zmiany (przestarzałe)
-G, --git
użyj rozszerzonego formatu różnic git
-Ty, --aktualny użytkownik
dodaj „Od: "łatać
-ty,--użytkownik
dodaj „Od: "łatać
-D, --bieżąca data
dodaj „Data: "łatać
-D,--Data
dodaj „Data: "łatać
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
Opcja zaznaczona [+] może być określona wielokrotnie
następny
wydrukuj nazwę następnej łatki, którą można wypchnąć:
hg qnastępny [-s]
Zwraca 0 w przypadku powodzenia.
Opcje:
-tak, --streszczenie
wydrukuj pierwszą linię nagłówka łatki
pop
zdejmij bieżącą łatkę ze stosu:
hg qpop [-a] [-f] [PATCH | INDEKS]
Bez argumentu wyskakuje z góry stosu łatek. Jeśli zostanie podana nazwa poprawki, zostanie zachowana
wyskakiwanie łat, aż nazwana łatka znajdzie się na szczycie stosu.
Domyślnie przerwij, jeśli katalog roboczy zawiera niezatwierdzone zmiany. Z
--keep-changes, przerwij tylko wtedy, gdy niezatwierdzone pliki nakładają się na załatane pliki. Z
-f/--force, wykonaj kopię zapasową i odrzuć zmiany wprowadzone w takich plikach.
Zwróć 0 w przypadku powodzenia.
Opcje:
-za, --wszystko
wywal wszystkie łatki
-N,--Nazwa
nazwa kolejki do wyświetlenia (przestarzałe)
--zachowaj zmiany
tolerować niesprzecznych zmian lokalnych
-F, --siła
zapomnij o wszelkich lokalnych zmianach w poprawionych plikach
--bez kopii zapasowej
nie zapisuj kopii zapasowych plików
qpoprzednie
wydrukuj nazwę poprzednio zastosowanej poprawki:
hg qprev [-s]
Zwraca 0 w przypadku powodzenia.
Opcje:
-tak, --streszczenie
wydrukuj pierwszą linię nagłówka łatki
pchnij
włóż następną łatkę na stos:
hg qpush [-f] [-l] [-a] [--move] [PATCH | INDEKS]
Domyślnie przerwij, jeśli katalog roboczy zawiera niezatwierdzone zmiany. Z
--keep-changes, przerwij tylko wtedy, gdy niezatwierdzone pliki nakładają się na załatane pliki. Z
-f/--force, wykonaj kopię zapasową i załataj niezatwierdzone zmiany.
Zwróć 0 w przypadku powodzenia.
Opcje:
--zachowaj zmiany
tolerować niesprzecznych zmian lokalnych
-F, --siła
zastosować oprócz zmian lokalnych
-mi, --dokładny
zastosuj poprawkę docelową do zarejestrowanego elementu nadrzędnego
-ja, --lista
wypisz nazwę poprawki w tekście zatwierdzenia
-za, --wszystko
zastosuj wszystkie poprawki
-M, --łączyć
scalić z innej kolejki (przestarzałe)
-N,--Nazwa
nazwa kolejki scalającej (przestarzałe)
--ruszaj się zmień kolejność serii łatek i zastosuj tylko łatkę
--bez kopii zapasowej
nie zapisuj kopii zapasowych plików
kolejka
zarządzaj wieloma kolejkami poprawek:
hg qqueue [OPCJA] [KOLEJKA]
Obsługuje przełączanie pomiędzy różnymi kolejkami poprawek, a także tworzenie nowych kolejek poprawek
i usuwanie istniejących.
Pominięcie nazwy kolejki lub podanie -l/--list spowoduje wyświetlenie zarejestrowanych kolejek - według
domyślnie rejestrowana jest „normalna” kolejka poprawek. Aktualnie aktywna kolejka będzie
oznaczone jako „(aktywne)”. Określenie --active spowoduje wydrukowanie tylko nazwy aktywnej kolejki.
Aby utworzyć nową kolejkę, użyj -c/--create. Kolejka jest automatycznie aktywowana, z wyjątkiem
w przypadku, gdy w pliku znajdują się zastosowane łatki z aktualnie aktywnej kolejki
magazyn. Wtedy kolejka zostanie tylko utworzona i przełączenie nie powiedzie się.
Aby usunąć istniejącą kolejkę, użyj --delete. Nie można usunąć aktualnie aktywnej kolejki.
Zwraca 0 w przypadku powodzenia.
Opcje:
-ja, --lista
lista wszystkich dostępnych kolejek
--aktywny
wydrukuj nazwę aktywnej kolejki
-C, --Stwórz
utwórz nową kolejkę
--Przemianować
zmień nazwę aktywnej kolejki
--kasować
usuń odniesienie do kolejki
--oczyścić
usuń kolejkę i usuń katalog łatek
qodśwież
zaktualizuj bieżącą łatkę:
hg qrefresh [-I] [-X] [-e] [-m TEKST] [-l PLIK] [-s] [PLIK]...
Jeżeli zostaną udostępnione jakieś wzorce plików, odświeżona łatka będzie zawierała jedynie modyfikacje
pasujące do tych wzorców; pozostałe modyfikacje pozostaną w fazie roboczej
katalogiem.
Jeśli podano opcję -s/--short, pliki aktualnie zawarte w łatce zostaną właśnie odświeżone
jak dopasowane pliki i pozostaną w łatce.
Jeśli określono -e/--edit, Mercurial uruchomi skonfigurowany edytor, w którym możesz wprowadzić a
wiadomość. W przypadku niepowodzenia qrefresh, kopię zapasową wiadomości znajdziesz w
.hg/ostatnia wiadomość.txt.
hg dodaj/usuń/skopiuj/zmień nazwę działa jak zwykle, chociaż możesz chcieć użyć poprawek w stylu git
(-g/--git lub [diff] git=1), aby śledzić kopie i zmieniać nazwy. Więcej informacji można znaleźć w temacie pomocy dotyczącej różnic
informacje o formacie git diff.
Zwraca 0 w przypadku powodzenia.
Opcje:
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-G, --git
użyj rozszerzonego formatu różnic git
-tak, --niski
odśwież tylko pliki już zawarte w łatce i określone pliki
-Ty, --aktualny użytkownik
dodaj/zaktualizuj pole autora w łatce z bieżącym użytkownikiem
-ty,--użytkownik
dodaj/zaktualizuj pole autora w patchu dla danego użytkownika
-D, --bieżąca data
dodaj/zaktualizuj pole daty w łatce z bieżącą datą
-D,--Data
dodaj/zaktualizuj pole daty w patchu z podaną datą
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
Opcja zaznaczona [+] może być określona wielokrotnie
qzmień nazwę
zmień nazwę poprawki:
hg qzmień nazwę PATCH1 [PATCH2]
Z jednym argumentem zmienia nazwę bieżącej poprawki na PATCH1. Z dwoma argumentami zmienia nazwę
PATCH1 do PATCH2.
Zwraca 0 w przypadku powodzenia.
aliasy: qmv
qprzywróć
przywróć stan kolejki zapisany w wersji (przestarzałe):
hg qrestore [-d] [-u] WER
To polecenie jest przestarzałe, użyj hg przebazować zamiast.
Opcje:
-D, --kasować
usuń zapisz wpis
-ty, --aktualizacja
zaktualizuj katalog roboczy kolejki
qzapisz
zapisz bieżący stan kolejki (przestarzałe):
hg qzapisz [-m TEKST] [-l PLIK] [-c] [-n NAZWA] [-e] [-f]
To polecenie jest przestarzałe, użyj hg przebazować zamiast.
Opcje:
-C, --Kopiuj
skopiuj katalog poprawek
-N,--Nazwa
skopiuj nazwę katalogu
-mi, --pusty
wyczyść plik stanu kolejki
-F, --siła
wymuszenie kopiowania
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
qselect
ustaw lub wydrukuj strzeżone poprawki do wypchnięcia:
hg qwybierz [OPCJA]... [STRAŻNIK]...
Użyj hg qguard polecenie, aby ustawić lub wydrukować osłony na łacie, a następnie użyj qselect, aby przekazać mq
jakich strażników użyć. Łatka zostanie wypchnięta, jeśli nie ma żadnych strażników ani żadnych pozytywnych strażników
pasuje do aktualnie wybranego strażnika, ale nie zostanie przesunięty, jeśli pasuje jakikolwiek strażnik negatywny
obecny strażnik. Na przykład:
qguard foo.patch -- -stable (ochrona ujemna)
qguard bar.patch +stabilny (pozytywna osłona)
qwybierz stabilny
Aktywuje to „stabilną” osłonę. mq pominie foo.patch (ponieważ ma plik negatywny
mecz), ale naciśnij bar.patch (ponieważ ma pozytywne dopasowanie).
Bez argumentów wypisuje aktualnie aktywnych strażników. Z jednym argumentem ustawia wartość aktywną
strzec.
Użyj opcji -n/--none, aby dezaktywować osłony (inne argumenty nie są potrzebne). Kiedy nie ma strażników
aktywne, poprawki z osłonami dodatnimi są pomijane, a poprawki z osłonami ujemnymi
popchnięty.
qselect może zmienić strażników na zastosowanych łatach. Nie wyświetla strzeżonych poprawek
domyślny. Użyj --pop, aby wrócić do ostatnio zastosowanej łatki, która nie jest strzeżona. Używać
--reapply (co oznacza --pop), aby później powrócić do bieżącej łatki, ale pomiń
strzeżone pola.
Użyj -s/--series, aby wydrukować listę wszystkich strażników w pliku serii (bez innych argumentów
potrzebne). Użyj opcji -v, aby uzyskać więcej informacji.
Zwraca 0 w przypadku powodzenia.
Opcje:
-N, --nic
wyłącz wszystkich strażników
-tak, --seria
lista wszystkich strażników w pliku serii
--Muzyka pop przejdź do przed pierwszą strzeżoną zastosowaną łatką
-- ponownie zastosuj
pop, a następnie ponownie zastosuj łatki
seria q
wydrukuj cały plik serii:
hg qseries [-ms]
Zwraca 0 w przypadku powodzenia.
Opcje:
-M, --zaginiony
drukuj łatki nie w serii
-tak, --streszczenie
wydrukuj pierwszą linię nagłówka łatki
qgóra
wydrukuj nazwę bieżącej łatki:
hg qtop [-s]
Zwraca 0 w przypadku powodzenia.
Opcje:
-tak, --streszczenie
wydrukuj pierwszą linię nagłówka łatki
qunastosowane
wydrukuj poprawki, które nie zostały jeszcze zastosowane:
hg qunaapplied [-1] [-s] [PATCH]
Zwraca 0 w przypadku powodzenia.
Opcje:
-1, --pierwszy
pokaż tylko pierwszą łatkę
-tak, --streszczenie
wydrukuj pierwszą linię nagłówka łatki
powiadom
haki do wysyłania powiadomień e-mail push
To rozszerzenie implementuje haki do wysyłania powiadomień e-mail, gdy wysyłane są zestawy zmian
lub otrzymane przez lokalne repozytorium.
Najpierw włącz rozszerzenie, jak wyjaśniono w hg pomoc rozszerzeniai zarejestruj hak
chcę biegać. przychodzące i grupa zmian hooki są uruchamiane po otrzymaniu zestawów zmian, natomiast
towarzyski hooki służą do zestawów zmian wysyłanych do innego repozytorium:
[haki]
# jeden e-mail dla każdego przychodzącego zestawu zmian
incoming.notify = python:hgext.notify.hook
# jeden e-mail dla wszystkich przychodzących zestawów zmian
changegroup.notify = python:hgext.notify.hook
# jeden e-mail dla wszystkich wychodzących zestawów zmian
outgoing.notify = python:hgext.notify.hook
To rejestruje haki. Aby włączyć powiadomienia, należy przypisać abonentów
repozytoria. The [subskrybenci] sekcja mapuje wiele repozytoriów dla danego odbiorcy. The
[reposubskrypcje] sekcja mapuje wielu odbiorców do jednego repozytorium:
[subskrybenci]
# klucz to adres e-mail subskrybenta, wartość to lista wzorców repo oddzielonych przecinkami
użytkownik@host = wzór
[reposubskrypcje]
# klucz to wzór repo, wartość to lista e-maili subskrybentów oddzielonych przecinkami
wzór = użytkownik@host
A wzorzec jest kula dopasowanie ścieżki bezwzględnej do repozytorium, opcjonalnie w połączeniu z a
wyrażenie resetu. Wyrażenie Revset, jeśli jest obecne, jest oddzielone od globu hashem.
Przykład:
[reposubskrypcje]
*/widgets#branch(release) = [email chroniony]
To wysyła do [email chroniony] za każdym razem, gdy nastąpi zmiana na zwolnić oddział wyzwala a
powiadomienie w dowolnym repozytorium kończącym się na widgety.
W celu objęcia ich bezpośrednim zarządzaniem przez użytkowników, [subskrybenci] i [reposubskrypcje] działy
można umieścić w osobnym hgrc plik i włączony przez odniesienie:
[notyfikować]
config = /ścieżka/do/pliku subskrypcji
Powiadomienia nie będą wysyłane do godz powiadom.test wartość jest ustawiona na Fałszywy; patrz poniżej.
Treść powiadomień można dostosować za pomocą następujących wpisów konfiguracyjnych:
powiadom.test
If Prawdziwy, wypisz wiadomości na standardowe wyjście zamiast je wysyłać. Wartość domyślna: prawda.
powiadomić.źródła
Lista oddzielonych spacjami źródeł zmian. Powiadomienia są aktywowane tylko wtedy, gdy a
źródło zestawu zmian znajduje się na tej liście. Źródła mogą być:
służyć
zestawy zmian otrzymane przez http lub ssh
Ciągnąć
zestawy zmian otrzymane przez hg Ciągnąć
rozpakować
zestawy zmian otrzymane przez hg rozpakować
naciskać
zestawy zmian wysłane lub odebrane za pośrednictwem hg naciskać
zapakować
zestawy zmian wysłane przez hg rozpakować
Wartość domyślna: serwuj.
powiadomić.pasek
Liczba wiodących ukośników do usunięcia ze ścieżek adresów URL. Domyślnie powiadomienia
repozytoria referencyjne z ich ścieżką bezwzględną. powiadomić.pasek pozwala je obrócić
na ścieżki względne. Na przykład, powiadomić.strip=3 zmieni /długi/ścieżka/repozytorium
najnowszych składnica. Wartość domyślna: 0.
powiadomienie.domena
Domyślna domena e-mail dla nadawcy lub odbiorców bez wyraźnej domeny.
powiadom.styl
Plik stylu używany podczas formatowania wiadomości e-mail.
szablon.powiadomienia
Szablon do wykorzystania podczas formatowania wiadomości e-mail.
powiadomić.przychodzące
Szablon do użycia, gdy jest uruchamiany jako hak przychodzący, przesłanianie szablon.powiadomienia.
powiadamiaj.wychodzące
Szablon do użycia, gdy jest uruchamiany jako hak wychodzący, przesłanianie szablon.powiadomienia.
powiadomić.zmianę grupy
Szablon do użycia podczas działania jako hak grupy zmian, przesłanianie szablon.powiadomienia.
powiadomić.maxdiff
Maksymalna liczba linii różnicowych, które można uwzględnić w wiadomości e-mail z powiadomieniem. Ustaw na 0, aby wyłączyć
różnicę lub -1, aby uwzględnić całość. Wartość domyślna: 300.
powiadomić.maxsubject
Maksymalna liczba znaków w temacie wiadomości e-mail. Wartość domyślna: 67.
powiadomić.diffstat
Ustaw na True, aby uwzględnić diffstat przed zawartością różnicową. Wartość domyślna: prawda.
powiadomić.scalić
Jeśli ma wartość True, wyślij powiadomienia o scalaniu zestawów zmian. Wartość domyślna: prawda.
powiadomić.mbox
Jeśli ustawione, zamiast wysyłać, dodawaj wiadomości e-mail do tego pliku mbox. Wartość domyślna: Brak.
powiadom.odautora
Jeśli jest ustawione, użyj osoby zatwierdzającej pierwszy zestaw zmian w grupie zmian dla „Od”
pole wiadomości e-mail z powiadomieniem. Jeśli nie ustawiono, zabierz użytkownika z repozytorium wypychającego.
Wartość domyślna: Fałsz.
Jeśli ta opcja jest ustawiona, do dostosowania powiadomień będą również używane następujące wpisy:
E-mail z
E-mail Cena Od adres, którego należy użyć, jeśli nie można go znaleźć w wygenerowanej treści wiadomości e-mail.
web.baseurl
Adres URL repozytorium głównego, który można połączyć ze ścieżkami repozytorium podczas tworzenia odniesień. Widzieć
również powiadomić.pasek.
pager
przeglądaj dane wyjściowe poleceń za pomocą zewnętrznego pagera
Aby ustawić pager, który ma być używany, ustaw zmienną aplikacji:
[pager]
pager = mniej -FRX
Jeśli nie ustawiono żadnego pagera, rozszerzenia pagera używają zmiennej środowiskowej $PAGER. Jeśli żadne
pager.pager ani $PAGER nie są ustawione, żaden pager nie jest używany.
Możesz wyłączyć pager dla niektórych poleceń, dodając je do listy pager.ignore:
[pager]
ignorować = wersja, pomoc, aktualizacja
Możesz także włączyć pager tylko dla niektórych poleceń, używając pager.attend. Poniżej znajduje się
domyślna lista poleceń do stronicowania:
[pager]
uczestniczyć = adnotacja, kot, różnicowanie, eksport, glog, log, qdiff
Ustawienie pager.attend na pustą wartość spowoduje stronicowanie wszystkich poleceń.
Jeśli pager.attend jest obecny, pager.ignore zostanie zignorowany.
Na koniec możesz włączać i wyłączać stronicowanie dla poszczególnych poleceń za pomocą
brać udział- opcja. To ustawienie ma pierwszeństwo przed istniejącymi opcjami obecności i ignorowania
opcje i wartości domyślne:
[pager]
uczęszczać-kot = fałsz
Aby zignorować polecenia globalne, takie jak hg wersja or hg pomoc, musisz je określić w pliku
plik konfiguracyjny użytkownika.
Aby kontrolować, czy pager jest w ogóle używany do pojedynczego polecenia, możesz użyć
--pager= :
- użyj w razie potrzeby: `auto`.
- wymagaj pagera: „tak” lub „włącz”.
- wyłącz pager: `nie` lub `off` (dowolna nierozpoznana wartość
też zadziała).
patchbomba
polecenie wysyłania zestawów zmian jako (serii) wiadomości e-mail z łatkami
Seria rozpoczyna się wprowadzeniem „[PATCH 0 of N]”, które opisuje serię
jako całość.
Każdy e-mail z łatką ma wiersz tematu „[PATCH M z N]…”, w którym pierwszym wierszem jest „
opis zestawu zmian jako tekst tematu. Wiadomość zawiera dwie lub trzy części treści:
· Opis zestawu zmian.
· [Opcjonalnie] Wynik uruchomienia diffstat na łatce.
· Sama poprawka, wygenerowana przez hg eksport.
Każda wiadomość odnosi się do pierwszej z serii za pomocą opcji W odpowiedzi i Referencji
nagłówki, więc będą pojawiać się jako sekwencja w wiadomościach z wątkami i czytnikach grup dyskusyjnych, a także w poczcie
archiwa.
Aby skonfigurować inne ustawienia domyślne, dodaj taką sekcję do pliku konfiguracyjnego:
[e-mail]
od = Moje imię
do = odbiorca1, odbiorca2, ...
cc = cc1, cc2, ...
bcc = bcc1, bcc2, ...
odpowiedź na = adres1, adres2, ...
Zastosowanie [bomba łatkowa] jako nazwę sekcji konfiguracji, jeśli chcesz zastąpić plik global [e-mail]
ustawienia adresu.
Następnie możesz użyć hg E-mail polecenie wysłania serii zestawów zmian w formie bomby poprawkowej.
Możesz także skonfigurować opcję metody w sekcji e-mail, aby była to sendmail
kompatybilny mailer lub wypełnij sekcję [smtp], aby rozszerzenie patchbomb mogło
automatycznie wysyłaj bomby łatające bezpośrednio z linii poleceń. Zobacz [email] i [smtp]
sekcje w hgrc(5) szczegóły.
Domyślnie hg E-mail poprosi o Do or CC nagłówek, jeśli nie podasz go przez
konfiguracji lub wiersza poleceń. Możesz to zmienić, aby nigdy nie wyświetlać monitów, konfigurując
pusta wartość:
[e-mail]
cc =
Możesz kontrolować domyślne dołączanie wiadomości wprowadzającej za pomocą patchbomb.intro
opcja konfiguracji. Konfiguracja jest zawsze nadpisywana flagami wiersza poleceń, takimi jak
--intro i --desc:
[bomba łatkowa]
intro=auto # dołącz wiadomość wprowadzającą, jeśli jest więcej niż 1 łatka (domyślnie)
intro=nigdy # nigdy nie dołączaj wiadomości wprowadzającej
intro=always # zawsze dołączaj wiadomość wprowadzającą
Możesz ustawić Patchbomb tak, aby zawsze pytał o potwierdzenie, ustawiając patchbomb.potwierdź do prawdy.
Polecenia
wyślij zestawy zmian e-mailem:
hg e-mail [OPCJA]... [DEST]...
Domyślnie różnice są wysyłane w formacie wygenerowanym przez hg eksport, po jednym na wiadomość. The
seria rozpoczyna się wprowadzeniem „[PATCH 0 of N]”, które opisuje serię jako całość.
Każdy e-mail z łatką ma wiersz tematu „[PATCH M z N]…”, w którym pierwszym wierszem jest „
opis zestawu zmian jako tekst tematu. Wiadomość składa się z dwóch lub trzech części.
Po pierwsze, opis zestawu zmian.
Z opcją -d/--diffstat, jeśli zainstalowany jest program diffstat, wynik działania
diffstat na łatce jest wstawiony.
Wreszcie sama łatka, wygenerowana przez hg eksport.
Dzięki opcjom -d/--diffstat lub --confirm zostanie wyświetlone ostateczne podsumowanie
wszystkie wiadomości i poprosił o potwierdzenie przed wysłaniem wiadomości.
Domyślnie poprawka jest dołączona jako tekst do treści wiadomości e-mail, co ułatwia jej przeglądanie. Używając
Opcja -a/--attach zamiast tego utworzy załącznik do łatki. Z -i/--inline an
zostanie utworzony załącznik wbudowany. Możesz dołączyć łatkę jako tekst w treści wiadomości e-mail
i jako zwykły lub wbudowany załącznik, łącząc -a/--attach lub -i/--inline z
opcję --body.
W przypadku opcji -o/--outgoing będą generowane wiadomości e-mail dotyczące poprawek, których nie znaleziono w miejscu docelowym
repozytorium (lub tylko te, które są przodkami określonych wersji, jeśli takie są
pod warunkiem, że)
W przypadku opcji -b/--bundle zestawy zmian są wybierane tak jak w przypadku opcji --outgoing, ale pojedynczy e-mail zawiera
binarny pakiet Mercurial zostanie wysłany jako załącznik. Użyj patchbomb.typ pakietu
config, aby kontrolować typ pakietu, tak jak w przypadku hg zapakować --rodzaj.
Za pomocą opcji -m/--mbox zamiast przeglądać każdą wiadomość patchbomb na pagerze lub wysyłać plik
wiadomości bezpośrednio, utworzy plik skrzynki pocztowej UNIX z wiadomościami e-mail z poprawkami. Ta skrzynka pocztowa
plik można wyświetlić za pomocą dowolnego programu pocztowego obsługującego pliki mbox UNIX.
W przypadku opcji -n/--test wszystkie kroki zostaną wykonane, ale poczta nie zostanie wysłana. Zostaniesz poproszony o
adres odbiorcy wiadomości e-mail, temat i wiadomość wprowadzającą opisującą poprawki
twojej patchbomby. Następnie, gdy wszystko zostanie wykonane, zostaną wyświetlone komunikaty typu patchbomb. Jeśli PAGER
zmienna środowiskowa jest ustawiona, twój pager zostanie uruchomiony raz dla każdej wiadomości patchbomb,
abyś mógł sprawdzić, czy wszystko jest w porządku.
Jeśli wysłanie wiadomości e-mail nie powiedzie się, kopię zapasową wiadomości wprowadzającej do serii znajdziesz w
.hg/last-email.txt.
Domyślne zachowanie tego polecenia można dostosować poprzez konfigurację. (Widzieć hg pomoc
patchbomba dla szczegółów)
Przykłady:
hg email -r 3000 # wyślij tylko łatkę 3000
hg email -r 3000 -r 3001 # wyślij poprawki 3000 i 3001
hg email -r 3000:3005 # wyślij poprawki od 3000 do 3005
hg email 3000 # wyślij łatkę 3000 (przestarzałe)
hg email -o # wyślij wszystkie łatki, które nie są domyślne
hg email -o DEST # wyślij wszystkie poprawki spoza DEST
hg email -o -r 3000 # wyślij wszystkich przodków 3000 nie domyślnie
hg email -o -r 3000 DEST # wyślij wszystkich przodków 3000 spoza DEST
hg email -b # wyślij pakiet wszystkich poprawek, które nie są domyślne
hg email -b DEST # wyślij pakiet wszystkich poprawek spoza DEST
hg email -b -r 3000 # pakiet wszystkich przodków 3000 nie jest domyślny
hg email -b -r 3000 DEST # pakiet wszystkich przodków 3000 spoza DEST
hg email -o -m mbox && # wygeneruj plik mbox...
mutt -R -f mbox # ... i wyświetl go za pomocą mutt
hg email -o -m mbox && # wygeneruj plik mbox...
formail -s sendmail \ # ... i użyj formail do wysłania z mbox
-bm -t < mbox # ... używając sendmaila
Przed użyciem tego polecenia musisz włączyć pocztę e-mail w swoim hgrc. Zobacz [e-mail]
sekcja w hgrc(5) szczegóły.
Opcje:
-G, --git
użyj rozszerzonego formatu różnic git
--zwykły
pomiń nagłówek łatki hg
-o, --towarzyski
wyślij zmiany, których nie znaleziono w repozytorium docelowym
-B, --pakiet
wyślij zmiany spoza celu jako pakiet binarny
--nazwa pakietu
nazwa pliku załącznika paczki (domyślnie: paczka)
-R,--obrót silnika
poprawkę do wysłania
--siła
uruchamiaj nawet wtedy, gdy zdalne repozytorium nie jest powiązane (z -b/--bundle)
--baza
podstawowy zestaw zmian do określenia zamiast miejsca docelowego (z -b/--bundle)
--wstęp
wyślij wiadomość e-mail z wprowadzeniem dla pojedynczej poprawki
--ciało wysyłaj poprawki jako tekst wiadomości wbudowanej (domyślnie)
-za, --przytwierdzać
wysyłaj poprawki jako załączniki
-ja, --w linii
wysyłaj poprawki jako załączniki wbudowane
--bcc
adresy e-mail niewidomych odbiorców kopii
-C,--cc
adresy e-mail odbiorców kopii
--potwierdzać
poproś o potwierdzenie przed wysłaniem
-D, --różnica
dodaj wyjście diffstat do wiadomości
--Data
użyj podanej daty jako daty wysłania
--opis
użyj podanego pliku jako opisu serii
-F,--z
adres e-mail nadawcy
-N, --test
wydrukować wiadomości, które zostaną wysłane
-M,--mbox
zapisuj wiadomości do pliku mbox zamiast je wysyłać
--odpowiedzieć do
Adresy e-mail, na które należy przesyłać odpowiedzi
-tak,--Przedmiot
temat pierwszej wiadomości (intro lub pojedyncza łatka)
--w odpowiedzi na
identyfikator wiadomości, na którą należy odpowiedzieć
--flaga
flagi do dodania w przedrostkach tematów
-T,--do
adresy e-mail odbiorców
-mi,--ssz
określ polecenie ssh, którego chcesz użyć
--zdalnie
określ polecenie hg, które ma zostać uruchomione po stronie zdalnej
--niepewny
nie weryfikuj certyfikatu serwera (ignorując konfigurację web.cacerts)
Opcja zaznaczona [+] może być określona wielokrotnie
oczyścić
polecenie usunięcia nieśledzonych plików z katalogu roboczego
Polecenia
oczyścić
usuwa pliki nie śledzone przez Mercurial:
hg oczyszczenie [OPCJA]... [DIR]...
Usuń pliki nieznane firmie Mercurial. Jest to przydatne do testowania zmian lokalnych i niezatwierdzonych
w skądinąd czystym drzewie źródłowym.
Oznacza to, że czyszczenie domyślnie usunie następujące elementy:
· Nieznane pliki: pliki oznaczone „?” przez hg status
· Puste katalogi: w rzeczywistości Mercurial ignoruje katalogi, chyba że zawierają one pliki
zarządzanie kontrolą źródła
Ale to pozostanie nietknięte:
· Zmodyfikowane i niezmodyfikowane śledzone pliki
· Ignorowane pliki (chyba że określono --all)
· Nowe pliki dodane do repozytorium (wraz z hg Dodaj)
Opcje --files i --dirs mogą zostać użyte do bezpośredniego usunięcia wyłącznie plików
katalogi lub jedno i drugie. Jeśli nie zostanie podana żadna z opcji, obie zostaną usunięte.
Jeśli w wierszu poleceń podano katalogi, dostępne są tylko pliki w tych katalogach
uważane.
Zachowaj ostrożność przy czyszczeniu, ponieważ możesz nieodwracalnie usunąć niektóre pliki, do których zapomniałeś dodać
repozytorium. Jeśli chcesz tylko wydrukować listę plików, którą zrobiłby ten program
usuń, użyj opcji --print.
Opcje:
-za, --przerwanie w przypadku błędu
przerwać, jeśli wystąpi błąd
--wszystko usuń także ignorowane pliki
--reż usuń puste katalogi
--pliki
wyczyść pliki
-P, --wydrukować
drukuj nazwy plików zamiast je usuwać
-0, --drukuj0
zakończ nazwy plików wartością NUL, do użycia z xargs (implikuje -p/--print)
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
pseudonimy: czysty
przebazować
polecenie przeniesienia zestawów wersji do innego elementu nadrzędnego
To rozszerzenie umożliwia zmianę bazy zestawów zmian w istniejącym repozytorium Mercurial.
Więcej informacji: https://mercurial-scm.org/wiki/RebaseExtension
Polecenia
przebazować
przenieś zestaw zmian (i potomków) do innej gałęzi:
hg rebase [-s REV | -b WER] [-d WER] [OPCJA]
Rebase wykorzystuje wielokrotne łączenie w celu przeszczepienia zestawów zmian z jednej części historii (źródła)
na inny (miejsce docelowe). Może to być przydatne do linearyzacji miejscowy zmiany względne
do głównego drzewa rozwoju.
Opublikowane zatwierdzenia nie mogą zostać ponownie oparte (patrz hg pomoc fazy). Aby skopiować zatwierdzenia, zobacz hg pomoc
zaszczepić.
Jeśli nie określisz docelowego zestawu zmian (-d/--dest), rebase używa bieżącej gałęzi
wskazówka jako miejsce docelowe. (Docelowy zestaw zmian nie jest modyfikowany przez zmianę bazy, ale nowy
zestawy zmian są dodawane jako jego potomkowie.)
Oto sposoby wybierania zestawów zmian:
1. Jawnie wybierz je za pomocą --obrót silnika.
2. Używać --źródło aby wybrać główny zestaw zmian i uwzględnić wszystkie jego potomki.
3. Używać --baza aby wybrać zestaw zmian; rebase znajdzie przodków i ich potomków
które nie są jednocześnie przodkami celu podróży.
4. Jeżeli nie określisz żadnego z --obrót silnika, źródłolub --baza, użyje rebase --baza . as
powyżej.
Rebase zniszczy oryginalne zestawy zmian, chyba że użyjesz --trzymać. Przeniesie także Twoje
zakładek (nawet jeśli tak).
Niektóre zestawy zmian mogą zostać usunięte, jeśli nie wnoszą zmian (np. połączenie z
oddział docelowy).
w odróżnieniu łączyć, rebase nic nie zrobi, jeśli jesteś na końcu gałęzi nazwanej z
dwie głowy. Będziesz musiał wyraźnie określić źródło i/lub miejsce docelowe.
Jeśli zmiana bazy zostanie przerwana w celu ręcznego rozwiązania konfliktu, można ją kontynuować
--continue/-c lub przerwane za pomocą --abort/-a.
Przykłady:
· przesuń "lokalne zmiany" (bieżące zatwierdzenie z powrotem do punktu rozgałęzienia) do bieżącej końcówki rozgałęzienia
po pociągnięciu:
hg baza
· przenieś pojedynczy zestaw zmian do gałęzi stabilnej:
hg rebase -r 5f493448 -d stabilny
· połącz zatwierdzenie i wszystkie jego potomki z inną częścią historii:
hg rebase --source c0c3 --dest 4cf9
· przenieś wszystko z gałęzi zaznaczonej zakładką na gałąź domyślną:
hg rebase --base moja cecha --docelowa wartość domyślna
· zwiń sekwencję zmian w jedno zatwierdzenie:
hg rebase --collapse -r 1520:1525 -d .
· przenieść nazwany oddział, zachowując jego nazwę:
hg rebase -r "gałąź(cechaX)" -d 1.3 --zachowaj gałęzie
Zwraca 0 w przypadku powodzenia, 1, jeśli nie ma nic do zmiany bazy lub istnieją nierozwiązane konflikty.
Opcje:
-tak,--źródło
przeprowadź zmianę bazy określonego zestawu zmian i elementów potomnych
-B,--baza
przebuduj wszystko od punktu rozgałęzienia określonego zestawu zmian
-R,--obrót silnika
ponownie bazować na tych wersjach
-D,--cel
bazuj na określonym zestawie zmian
--zawalić się
zwiń ponownie oparte zestawy zmian
-M,--wiadomość
użyj tekstu jako komunikatu zatwierdzenia zwinięcia
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia zwinięcia z pliku
-k, --trzymać
zachowaj oryginalne zestawy zmian
--utrzymuj gałęzie
zachowaj oryginalne nazwy oddziałów
-D, --odłączyć
(WYCOFANE)
-ja, --interaktywny
(WYCOFANE)
-T,--narzędzie
określ narzędzie scalania
-C, --kontyntynuj
kontynuować przerwaną bazę
-za, --anulować
przerwać przerwaną bazę
--styl
wyświetlaj przy użyciu szablonu pliku mapy (przestarzałe)
-T,--szablon
wyświetlacz z szablonem
Opcja zaznaczona [+] może być określona wielokrotnie
rekord
polecenia do interaktywnego wybierania zmian do zatwierdzenia/qrefresh
Polecenia
qnagraj
interaktywnie nagraj nową łatkę:
hg qrecord [OPCJA]... PATCH [PLIK]...
See hg pomoc qnowy & hg pomoc rekord aby uzyskać więcej informacji i zastosowań.
rekord
interaktywnie wybierz zmiany do zatwierdzenia:
hg record [OPCJA]... [PLIK]...
W przypadku pominięcia listy plików wszystkie zmiany zgłaszane przez hg status będą kandydatami
nagranie.
See hg pomoc daty aby wyświetlić listę formatów ważnych dla -d/--date.
Zostaniesz zapytany, czy rejestrować zmiany w każdym zmodyfikowanym pliku i w plikach
z wieloma zmianami, dla każdej zmiany do wykorzystania. Dla każdego zapytania podane są następujące odpowiedzi
może:
y - zapisz tę zmianę
n - pomiń tę zmianę
e - edytuj tę zmianę ręcznie
s - pomiń pozostałe zmiany w tym pliku
f - zapisz pozostałe zmiany w tym pliku
d - gotowe, pomiń pozostałe zmiany i pliki
a - zapisz wszystkie zmiany we wszystkich pozostałych plikach
q - wyjdź, nie nagrywaj żadnych zmian
? - wyświetl pomoc
To polecenie nie jest dostępne podczas zatwierdzania scalania.
Opcje:
-DO, --Dodaj usuń
oznacz nowe/brakujące pliki jako dodane/usunięte przed zatwierdzeniem
--zamknięty oddział
oznaczyć główkę gałęzi jako zamkniętą
--poprawiać
zmień rodzica katalogu roboczego
-tak, --sekret
użyj tajnej fazy do zatwierdzenia
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
-M,--wiadomość
użyj tekstu jako wiadomości zatwierdzenia
-ja,--plik dziennika
przeczytaj wiadomość zatwierdzenia z pliku
-D,--Data
zapisz określoną datę jako datę zatwierdzenia
-ty,--użytkownik
zarejestruj określonego użytkownika jako osobę zatwierdzającą
-S, --podrepozytoria
wracaj do podrepozytoriów
-w, --ignoruj całą przestrzeń
ignoruj białe znaki podczas porównywania linii
-B, --ignoruj-zmianę-spacji
zignoruj zmiany w ilości spacji
-B, --ignoruj puste linie
ignoruj zmiany, których wiersze są puste
Opcja zaznaczona [+] może być określona wielokrotnie
ponownie połączyć
odtwarza twarde łącza pomiędzy klonami repozytoriów
Polecenia
ponownie połączyć
odtworzyć twarde łącza między dwoma repozytoriami:
hg ponowne połączenie [POCHODZENIE]
Kiedy repozytoria są klonowane lokalnie, ich pliki danych zostaną połączone na stałe, tak aby mogły
używaj tylko przestrzeni jednego repozytorium.
Niestety, kolejne pobrania do któregokolwiek repozytorium spowodują uszkodzenie dowiązań twardych do dowolnych plików
dotknięty nowymi zestawami zmian, nawet jeśli oba repozytoria ostatecznie pobiorą te same zmiany.
Podobnie przekazanie --rev do „hg clone” nie spowoduje użycia żadnych twardych dowiązań, powracając do a
pełna kopia repozytorium źródłowego.
To polecenie umożliwia odtworzenie tych dowiązań stałych i odzyskanie zmarnowanego miejsca.
To repozytorium zostanie ponownie połączone, aby współdzielić przestrzeń z ORIGIN, która musi znajdować się na tym samym
dysk lokalny. Jeśli pominięto ORIGIN, szuka „domyślnego ponownego połączenia”, a następnie „domyślnego” w [ścieżkach].
Nie próbuj wykonywać żadnych operacji odczytu tego repozytorium, gdy polecenie jest uruchomione. (Obydwa
repozytoria zostaną zablokowane przed zapisem.)
systemy
rozszerzaj schematy o skróty do rojów repozytoriów
To rozszerzenie umożliwia określenie skrótów dla nadrzędnych adresów URL z dużą liczbą repozytoriów
działać jak schemat, na przykład:
[schematy]
py = http://code.python.org/hg/
Następnie możesz go używać w następujący sposób:
hg klon py://trunk/
Dodatkowo istnieje wsparcie dla niektórych bardziej złożonych schematów, używanych na przykład przez Google
Kod:
[schematy]
gcode = http://{1}.googlecode.com/hg/
Składnia została zaczerpnięta z szablonów Mercurial i masz nieograniczoną liczbę zmiennych,
zaczynając od 1 {} i kontynuując 2 {}, 3 {} i tak dalej. Te zmienne otrzymają
części podanego adresu URL, podzielone według /. Wszystko, co nie zostało określone jako {część} zostanie właśnie dodany
do adresu URL.
Dla wygody rozszerzenie domyślnie dodaje następujące schematy:
[schematy]
py = http://hg.python.org/
bb = https://bitbucket.org/
bb+ssh = ssh://[email chroniony]/
gcode = https://{1}.googlecode.com/hg/
piec = https://{1}.kilnhg.com/Repo/
Możesz zastąpić predefiniowany schemat, definiując nowy schemat o tej samej nazwie.
udział
mają wspólną historię między kilkoma katalogami roboczymi
automatycznie Połączone Magazynowanie dla Klony
Gdy to rozszerzenie jest aktywne, hg klonować można skonfigurować tak, aby automatycznie udostępniał/pulował
przechowywanie w wielu klonach. Ten tryb skutecznie konwertuje hg klonować do hg klonować + hg
udział. Zaletą korzystania z tego trybu jest automatyczne zarządzanie ścieżkami sklepowymi i
inteligentne łączenie powiązanych repozytoriów.
Poniższy dzielić. opcje konfiguracji wpływają na tę funkcję:
udostępnij.pulę
Ścieżka systemu plików, w którym będą przechowywane dane współdzielonego repozytorium. Kiedy zdefiniowano, hg klonować
automatycznie użyje pamięci współdzielonego repozytorium zamiast tworzyć w nim sklep
każdy klon.
udostępnianie.nazewnictwo puli
Jak nazywają się katalogi w udostępnij.pulę są konstruowane.
„tożsamość” oznacza, że nazwa pochodzi od pierwszego zestawu zmian w repozytorium. W
w tym trybie różne piloty współdzielą pamięć, jeśli ich główny/początkowy zestaw zmian jest taki
identyczny. W tym trybie lokalne repozytorium współdzielone jest zbiorem wszystkich
napotkane zdalne repozytoria.
„zdalny” oznacza, że nazwa pochodzi od ścieżki lub adresu URL repozytorium źródłowego. W
w tym trybie pamięć jest udostępniana tylko wtedy, gdy ścieżka lub adres URL żądany w pliku hg klonować
polecenie pasuje dokładnie do repozytorium, które zostało wcześniej sklonowane.
Domyślnym trybem nazewnictwa jest „tożsamość”.
Polecenia
udział
utwórz nowe wspólne repozytorium:
hg udział [-U] [-B] ŹRÓDŁO [CEL]
Zainicjuj nowe repozytorium i katalog roboczy, który udostępnia swoją historię (i opcjonalnie
zakładek) z innym repozytorium.
Uwaga, użycie wycofywania lub rozszerzeń, które niszczą/modyfikują historię (mq, rebase itp.) może
powodować znaczne zamieszanie w przypadku współdzielonych klonów. W szczególności, jeśli dwa są wspólne
oba klony są aktualizowane do tego samego zestawu zmian, a jeden z nich to niszczy
zestawu zmian z wycofaniem, drugi klon nagle przestanie działać: wszystkie operacje
zakończy się niepowodzeniem z komunikatem „przerwij: katalog roboczy ma nieznanego rodzica”. Jedyny znany
obejście polega na użyciu debugsetparents na uszkodzonym klonie w celu zresetowania go do zestawu zmian
to nadal istnieje.
Opcje:
-Ty, --brak aktualizacji
nie twórz katalogu roboczego
-B, --zakładki
udostępniaj także zakładki
cofnij udostępnianie
przekonwertuj udostępnione repozytorium na normalne:
hg nie udostępniaj
Skopiuj dane sklepu do repozytorium i usuń dane udostępnionej ścieżki.
odłożyć na półkę
zapisz i przywróć zmiany w katalogu roboczym
Polecenie „hg shelve” zapisuje zmiany wprowadzone w katalogu roboczym i przywraca je
zmiany, resetując katalog roboczy do czystego stanu.
Później polecenie „hg unshelve” przywraca zmiany zapisane przez „hg shelve”. Zmiany mogą
zostać przywrócony nawet po aktualizacji do innego elementu nadrzędnego, w takim przypadku połączenie Mercurial
maszyny rozwiążą wszelkie konflikty, jeśli to konieczne.
Jednocześnie możesz mieć więcej niż jedną odłożoną resztę; każda odłożona zmiana ma
odrębna nazwa. Szczegóły znajdziesz w pomocy dla "hg shelve".
Polecenia
odłożyć na półkę
zapisz i odłóż zmiany z katalogu roboczego:
hg półka [OPCJA]... [PLIK]...
Półka przyjmuje pliki, które „hg status” zgłasza jako niezaczyszczone, zapisuje modyfikacje w pliku a
package (zmiana odłożona na półkę) i przywraca pliki do stanu roboczego
katalog stanie się czysty.
Aby przywrócić te zmiany do katalogu roboczego, użyj „hg unshelve”; to zadziała
nawet jeśli przełączysz się na inne zatwierdzenie.
Jeśli nie określono żadnych plików, „hg shelve” zapisuje wszystkie nieczyste pliki. Jeśli określone pliki lub
katalogi mają nazwy, tylko zmiany w tych plikach są odkładane.
Każda odłożona zmiana ma nazwę, która ułatwia jej późniejsze odnalezienie. Nazwa półki
zmień domyślne na oparte na aktywnej zakładce lub jeśli nie ma aktywnej zakładki,
aktualnie nazwana gałąź. Aby określić inną nazwę, użyj --Nazwa.
Aby wyświetlić listę istniejących odłożonych zmian, użyj przycisku --lista opcja. Za każdą odłożoną zmianę
spowoduje to wydrukowanie jego nazwy, wieku i opisu; używać --łata or --statystyka by uzyskać więcej szczegółów.
Aby usunąć określone odłożone na półkę zmiany, użyj --kasować. Aby usunąć wszystkie odłożone zmiany, użyj
--sprzątać.
Opcje:
-DO, --Dodaj usuń
oznaczaj nowe/brakujące pliki jako dodane/usunięte przed odłożeniem na półkę
-ty, --nieznany
przechowuj nieznane pliki na półce
--sprzątać
usuń wszystkie odłożone zmiany
--Data
półka z określoną datą zatwierdzenia
-D, --kasować
usuń nazwane odłożone zmiany
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
-ja, --lista
lista aktualnych półek
-M,--wiadomość
użyj tekstu jako wiadomości na półce
-N,--Nazwa
użyj podanej nazwy dla zatwierdzenia odłożonego
-P, --łata
pokaż poprawkę
-ja, --interaktywny
tryb interaktywny, działa tylko podczas tworzenia półki
--statystyka wygeneruj podsumowanie zmian w stylu diffstat
-i,--włączać
zawierać nazwy pasujące do podanych wzorców
-X,--wykluczać
wyklucz nazwy pasujące do podanych wzorców
Opcja zaznaczona [+] może być określona wielokrotnie
odłożyć na półkę
przywróć odłożoną zmianę w katalogu roboczym:
hg odłóż na półkę [PÓŁKA]
To polecenie akceptuje opcjonalną nazwę odłożonej zmiany do przywrócenia. Jeśli nie zostanie podany żaden,
wykorzystywana jest ostatnia odłożona zmiana.
Jeśli odłożona zmiana zostanie pomyślnie zastosowana, pakiet zawierający odłożone zmiany
zostaje przeniesiony do lokalizacji kopii zapasowej (.hg/shelve-backup).
Ponieważ możesz przywrócić odłożoną zmianę na podstawie dowolnego zatwierdzenia, jest to możliwe
unshelving spowoduje konflikt między twoimi zmianami a zatwierdzeniami, którymi jesteś
wyjmowanie z półki. Jeśli tak się stanie, musisz rozwiązać konflikt, a następnie użyć --kontyntynuj do
dokończ operację wyjmowania z półki. (Pakiet nie zostanie przeniesiony, dopóki nie zakończy się pomyślnie
uzupełnij półkę.)
(Alternatywnie możesz użyć --anulować porzucić półkę, która powoduje konflikt. Ten
cofa nieodłożone zmiany i pozostawia pakiet na miejscu.)
Po pomyślnym usunięciu odłożonych zmian są przechowywane w katalogu kopii zapasowej. Tylko
przechowywanych jest N najnowszych kopii zapasowych. N ma wartość domyślną 10, ale można ją zastąpić za pomocą
półka.maxbackups opcja konfiguracji.
Znacznik czasu w sekundach służy do określenia kolejności tworzenia kopii zapasowych. Więcej niż maksymalne kopie zapasowe kopie zapasowe są
zachowane, jeśli ten sam znacznik czasu uniemożliwia ustalenie ich dokładnej kolejności, ze względów bezpieczeństwa.
Opcje:
-za, --anulować
przerwać niekompletną operację wyjmowania z półki
-C, --kontyntynuj
kontynuować niekompletną operację wyjmowania z półki
-k, --trzymać
przechowywać na półce po wyjęciu z półki
-T,--narzędzie
określ narzędzie scalania
--Data
ustaw datę tymczasowych zatwierdzeń (przestarzałe)
rozebrać się
usuń zestawy zmian i ich potomków z historii
To rozszerzenie umożliwia usunięcie zestawów zmian i wszystkich ich elementów potomnych z pliku
magazyn. Szczegóły znajdziesz w pomocy polecenia.
Polecenia
rozebrać się
usuń zestawy zmian i wszystkich ich potomków z repozytorium:
hg pasek [-k] [-f] [-B zakładka] [-r] WER...
Polecenie strip usuwa określone zestawy zmian i wszystkich ich potomków. Jeśli
katalog roboczy zawiera niezatwierdzone zmiany, operacja zostanie przerwana, chyba że zostanie podany --force
flaga jest podana, w takim przypadku zmiany zostaną odrzucone.
Jeśli plik nadrzędny katalogu roboczego zostanie usunięty, katalog roboczy również to zrobi
zostanie automatycznie zaktualizowany do najnowszego dostępnego przodka pozbawionego elementu nadrzędnego
po zakończeniu operacji.
Wszelkie usunięte zestawy zmian są przechowywane w .hg/strip-backup jako pakiet (patrz hg pomoc zapakować i
hg pomoc rozpakować). Można je przywrócić biegając hg rozpakować .hg/strip-backup/PAKIET,
gdzie BUNDLE jest plikiem pakietu utworzonym przez pasek. Należy pamiętać, że lokalne numery wersji
będzie zasadniczo inny po przywróceniu.
Użyj opcji --no-backup, aby odrzucić pakiet kopii zapasowej po zakończeniu operacji.
Strip nie jest operacją polegającą na przepisywaniu historii i można jej używać w publicznych zestawach zmian
faza. Ale jeśli usunięte zestawy zmian zostały przesłane do zdalnego repozytorium, tak się stanie
prawdopodobnie pociągnij je ponownie.
Zwróć 0 w przypadku powodzenia.
Opcje:
-R,--obrót silnika
usuń określoną wersję (opcjonalnie, można określić wersje bez tej opcji)
-F, --siła
wymuś usunięcie zestawów zmian, odrzuć niezatwierdzone zmiany (bez kopii zapasowej)
--bez kopii zapasowej
brak kopii zapasowych
--brak kopii zapasowej
brak kopii zapasowych (WYCOFANE)
-n zignorowane (przestarzałe)
-k, --trzymać
nie modyfikuj katalogu roboczego podczas usuwania
-B,--zakładka
usuń obroty osiągalne tylko z danej zakładki
Opcja zaznaczona [+] może być określona wielokrotnie
przeszczep
polecenie przeszczepienia zestawów zmian z innej gałęzi
To rozszerzenie umożliwia przeszczepienie zmian do innej wersji nadrzędnej, prawdopodobnie w
inne repozytorium. Przeszczep odbywa się za pomocą plastrów „diff”.
Przeszczepione poprawki są zapisywane w pliku .hg/transplant/transplants jako mapa ze zbioru zmian
hash do swojego skrótu w repozytorium źródłowym.
Polecenia
przeszczep
przeszczep zestawy zmian z innej gałęzi:
hg przeszczep [-s REPO] [-b ODDZIAŁ [-a]] [-p REV] [-m REV] [REV]...
Wybrane zestawy zmian zostaną zastosowane w bieżącym katalogu roboczym z dziennikiem
oryginalnego zestawu zmian. Zestawy zmian zostaną skopiowane i dlatego pojawią się dwukrotnie w pliku
historia z różnymi tożsamościami.
Rozważ użycie polecenia przeszczep, jeśli wszystko znajduje się w tym samym repozytorium - zostanie użyte
łączy się i zwykle daje lepszy wynik. Użyj rozszerzenia rebase, jeśli zestawy zmian
są niepublikowane i chcesz je przenieść, zamiast kopiować.
Jeśli określono --log, do komunikatów dziennika będzie dołączony komentarz w postaci:
(przeszczepiony z CHANGESETHASH)
Możesz przepisać komunikat dziennika zmian za pomocą opcji --filter. Jego argumentem będzie
wywoływany z bieżącym komunikatem dziennika zmian o wartości 1 USD i łatką o wartości 2 USD.
--source/-s określa inne repozytorium, które będzie używane do wybierania zestawów zmian, tak jakby to było
chwilowo został ściągnięty. Jeśli określono --branch/-b, te wersje zostaną użyte jako
przy podejmowaniu decyzji, które zestawy zmian należy przeszczepić, tak jakby miały to tylko te poprawki
został pociągnięty. Jeśli określono --all/-a, wszystkie wersje aż do nagłówków określonych w
--gałąź zostanie przeszczepiona.
Przykład:
· przeszczep wszystkie zmiany do wersji REV na wierzch aktualnej wersji:
hg przeszczep --oddział REV --all
Opcjonalnie możesz oznaczyć wybrane przeszczepione zestawy zmian jako scalone zestawy zmian. Nie będziesz
zostaniesz poproszony o przeszczepienie przodków połączonego przeszczepu i będziesz mógł się połączyć
ich potomków, zamiast je przesadzać.
Zestawy zmian scalających można przeszczepiać bezpośrednio, określając odpowiedni nadrzędny zestaw zmian według
powołanie hg przeszczep --rodzic.
Jeśli nie zostaną dostarczone żadne połączenia ani poprawki, hg przeszczep rozpocznie interaktywny zestaw zmian
browser.
Jeśli aplikacja zestawu zmian nie powiedzie się, możesz ręcznie naprawić połączenie, a następnie wznowić je tam, gdzie to konieczne
zakończyć dzwoniąc hg przeszczep --kontynuuj/-c.
Opcje:
-tak,--źródło
zestawy zmian przeszczepu z REPO
-B,--Oddział
użyj tego źródłowego zestawu zmian jako head
-za, --wszystko
ściągnij wszystkie zestawy zmian do wersji --branch
-P,--suszona śliwka
pomiń REV
-M,--łączyć
połączyć się w REV
--rodzic
rodzic do wyboru podczas przesadzania scalania
-mi, --edytować
wywołaj edytor w wiadomościach zatwierdzeń
--Dziennik dołącz informacje o przeszczepie do wiadomości dziennika
-C, --kontyntynuj
kontynuować ostatnią sesję przeszczepu po naprawieniu konfliktów
--filtr
filtruj zestawy zmian za pomocą polecenia
Opcja zaznaczona [+] może być określona wielokrotnie
win32mbcs
pozwalają na użycie ścieżek MBCS z problematycznym kodowaniem
Niektóre kodowania MBCS nie nadają się do niektórych operacji na ścieżkach (np. dzielenie ścieżki, wielkość liter).
konwersja itp.) z zakodowanymi bajtami. Nazywamy takie kodowanie (tj. shift_jis i
big5) jako „problematyczne kodowanie”. Tego rozszerzenia można użyć do rozwiązania problemu z nimi
kodowania, zawijając niektóre funkcje w celu konwersji na ciąg znaków Unicode przed operacją na ścieżce.
To rozszerzenie jest przydatne w przypadku:
· Użytkownicy japońskiego systemu Windows korzystający z kodowania shift_jis.
· Chińscy użytkownicy systemu Windows korzystający z kodowania Big5.
· Wszyscy użytkownicy korzystający z repozytorium z jednym z problematycznych kodowań, w którym wielkość liter nie jest uwzględniana
system plików.
To rozszerzenie nie jest potrzebne w przypadku:
· Każdy użytkownik, który używa w ścieżce wyłącznie znaków ASCII.
· Każdy użytkownik, który nie używa żadnego problematycznego kodowania.
Pamiętaj, że istnieją pewne ograniczenia w korzystaniu z tego rozszerzenia:
· Powinieneś używać pojedynczego kodowania w jednym repozytorium.
· Jeśli ścieżka repozytorium kończy się na 0x5c, nie można odczytać pliku .hg/hgrc.
· win32mbcs nie jest kompatybilny z rozszerzeniem fixutf8.
Domyślnie win32mbcs używa encoding.encoding ustalonego przez Mercurial. Możesz określić
kodowanie według opcji konfiguracyjnej:
[win32mbcs]
kodowanie = sjis
Jest to przydatne dla użytkowników, którzy chcą zatwierdzić komunikat dziennika w formacie UTF-8.
tekst win32
wykonaj automatyczną konwersję nowej linii (przestarzałe)
Wycofanie: rozszerzenie win32text wymaga skonfigurowania rozszerzenia przez każdego użytkownika
wielokrotnie dla każdego klonu, ponieważ konfiguracja nie jest kopiowana podczas klonowania.
W związku z tym dokonaliśmy eol jako alternatywa. The eol używa wersji kontrolowanej
plik do konfiguracji, dzięki czemu każdy klon będzie korzystał z właściwych ustawień z
początek.
Aby wykonać automatyczną konwersję nowej linii, użyj:
[rozszerzenia]
win32text =
[kodować]
** = sprytny kod:
# lub ** = macencode:
[rozszyfrować]
** = sprytny dekod:
# lub ** = macdecode:
Jeśli nie dokonujesz konwersji, aby upewnić się, że przypadkowo nie popełnisz CRLF/CR:
[haki]
pretxncommit.crlf = python:hgext.win32text.forbidcrlf
# lub pretxncommit.cr = python:hgext.win32text.forbidcr
Aby wykonać tę samą kontrolę na serwerze, aby zapobiec wypychaniu lub ściąganiu CRLF/CR:
[haki]
pretxnchangegroup.crlf = python:hgext.win32text.forbidcrlf
# lub pretxnchangegroup.cr = python:hgext.win32text.forbidcr
zero conf
odkrywaj i reklamuj repozytoria w sieci lokalnej
Rozszerzenie Zeroconf będzie się reklamować hg służyć instancje przez DNS-SD, aby tak było
odkryte za pomocą hg ścieżki polecenie bez znajomości adresu serwera.
Aby umożliwić innym osobom odkrywanie Twojego repozytorium za pomocą run hg służyć w swoim repozytorium:
$ test CD
$ hg służyć
Możesz odkryć repozytoria obsługujące Zeroconf, uruchamiając hg ścieżki:
$ hg ścieżki
zc-test = http://example.com:8000/test
Użyj hg online, korzystając z usług onworks.net
