vcsh - Online w chmurze

PROGRAM:

IMIĘ

vcsh - System kontroli wersji dla $HOME - wiele repozytoriów Git w $HOME

STRESZCZENIE

vcsh [Opcje] komenda

vcsh klon [-ur oddział] url [repo]

vcsh usunąć repo

vcsh wchodzić repo

vcsh zasięg [-g] odrzutowiec komenda

vcsh pomoc

vcsh startowych repo

vcsh podstęp

vcsh śledzone przez listę [repo]

vcsh lista nieśledzona [-a] [-r] [repo]

vcsh Ciągnąć

vcsh naciskać

vcsh przemianować repo nowe imie

vcsh biegać repo powłoka komenda

vcsh stan [repo]

vcsh uaktualnienie repo

vcsh wersja

vcsh który podciąg

vcsh napisz-gitignore repo

vcsh repo odrzutowiec komenda

vcsh repo

OPIS

vcsh pozwala mieć kilka odrzutowiec(1) repozytoria, wszystkie utrzymujące działające drzewa
w $HOME bez przeszkadzania sobie nawzajem. To z kolei oznacza, że ​​możesz mieć jedno repozytorium
na zestaw konfiguracyjny (zsh, vim, ssh itp.), wybierając i wybierając konfiguracje, których chcesz użyć
która maszyna.

vcsh używa techniki zwanej fałszywymi repozytoriami Git, utrzymywanie $GIT_DIR w
inny katalog z $GIT_WORK_TREE na co się wskazuje $ HOME.

W tej konfiguracji nie jest potrzebne użycie dowiązań symbolicznych, co zapewnia czystszą konfigurację.

vcsh został zaprojektowany z mr(1), więc możesz chcieć zainstalować go razem z vcsh. To
powiedziawszy, możesz z łatwością korzystać vcsh bez mr Jeśli wolisz.

Przykładowa konfiguracja dla vcsh oraz mr można znaleźć w
https://github.com/RichiH/vcsh_mr_template i używany z vcsh klonować
https://github.com/RichiH/vcsh_mr_template mr.

Pamiętaj, że zawsze możesz użyć ścieżki zamiast nazwy repo. To jest potrzebne
obsługuje poprawnie skrypty mr i inne i nie stanowi problemu dla użytkownika interaktywnego.

OPCJE

-c Źródło filet przed innymi plikami konfiguracyjnymi

-d Włącz tryb debugowania

-v Włącz tryb szczegółowy

POLECENIA

clone Klonuj istniejące repozytorium.

Jeśli chcesz sklonować pakiet repozytoriów, zajrzyj do pliku przeszedł na emeryturę po klonowaniu
hak.

Możesz także użyć jednego repozytorium git z kilkoma gałęziami. Użyj -b opcja
aby określić oddział w czasie klonowania, ustawieniem domyślnym jest mistrz.

zatwierdzenie Zatwierdzenie we wszystkich repozytoriach

Usuń istniejące repozytorium.

wprowadź Wejdź do repozytorium; rodzą się nowe $POWŁOKA.

foreach
Wykonaj polecenie git dla każdego repozytorium vcsh.

-g: Wykonaj w kontekście ogólnym.

pomoc Wyświetl pomoc.

init Zainicjuj puste repozytorium.

list Lista wszystkich lokalnych repozytoriów vcsh.

śledzone przez listę
Lista wszystkich plików śledzonych przez vcsh.

Jeśli chcesz wyświetlić listę plików śledzonych przez określone repozytorium, po prostu dołącz rozszerzenie
nazwa repozytorium na końcu.

lista śledzona przez
Lista plików śledzonych przez repozytorium.

To jest starsze polecenie; powinieneś użyć śledzone przez listę zamiast.

lista nieśledzona
Lista wszystkich plików NIE śledzonych przez vcsh.

-a: Pokaż wszystkie pliki. Domyślnie odrzutowiec ls-pliki --wyklucz-standard nazywa się.

-r: Tryb rekurencyjny. Domyślnie lista plików jest płytka i zatrzymuje się w katalogu
poziomach, tam gdzie to możliwe.

$repo: Wyświetla listę plików, które nie są śledzone przez to konkretne repozytorium.

pull Wyciągnij ze wszystkich pilotów vcsh.

push Naciśnij do wszystkich pilotów vcsh.

zmień nazwę Zmień nazwę repozytorium.

uruchom Uruchom polecenie za pomocą $GIT_DIR oraz $GIT_WORK_TREE ustawić. Pozwala na uruchomienie dowolnego
polecenia bez żadnych ograniczeń. Używaj ostrożnie.

Należy pamiętać, że istnieje nieco magiczna funkcja uruchamiania. Zamiast repo it
akceptuje ścieżka, również. Zakłada się, że wszystko, co ma w sobie ukośnik, jest a
ścieżka. vcsh biegać będzie wtedy działać w tym katalogu zamiast w normalnym katalogu
wygenerowany na podstawie nazwy repozytorium. Jest to potrzebne, aby wesprzeć pana i innych
skrypty są prawidłowe i nie stanowią problemu dla użytkownika interaktywnego.

status Wyświetla statusy wszystkich/jednego repozytorium vcsh.

uaktualnienie
Zaktualizuj repozytorium do aktualnie zalecanych ustawień.

wersja
Wydrukuj informacje o wersji.

który podciąg
Znajdź podciąg w nazwie dowolnego śledzonego pliku.

napisz-gitignore
Napisz .gitignore.d/repo przez odrzutowiec ls-pliki.

repo polecenie git
Skrót do uruchomienia vcsh na repozytorium. Przygotuje odrzutowiec do komenda.

repo Skrót do uruchomienia vcsh wchodzić .

ŚRODOWISKO

Jak już wspomniano, vcsh ustawi $GIT_DIR oraz $GIT_WORK_TREE do odpowiednich wartości dla
fałszywe, gołe repozytoria Git.

CONFIG

Istnieje kilka sposobów włączania poszczególnych pokręteł vcsh. W kolejności rosnącej
pierwszeństwo, są to:

· ZMIENNA=foo vcsh

·

· <$XDG_CONFIG_HOME/vcsh/config>

· vcsh -c

Należy pamiętać, że te pliki pochodzą ze źródła. Wszelkie polecenia zostaną wykonane w pliku
kontekst twojej powłoki.

Ciekawe pokrętła, które można obrócić:

$VCSH_GITATTRIBUTY
Może być Żadenlub dowolną inną wartość.

Żaden nie będzie przechowywać atrybutów Git w specjalnej lokalizacji.

Jeśli zostanie ustawiona inna wartość, pliki gitattributes specyficzne dla repo zostaną zachowane.

Domyślnie do Żaden.

$VCSH_GITIGNORE
Może być dokładny, Żadenlub rekurencyjne.

dokładny zapełni specyficzny dla repo plik ignorowania wszystkimi nazwami plików i katalogów
który odrzutowiec ls-pliki zwraca.

Żaden nie zapisze żadnego pliku ignorowania.

rekurencyjne przejdzie rekurencyjnie przez wszystkie katalogi dodatkowo do
powyżej.

Domyślnie do dokładny.

$VCSH_VCSH_WORKTREE
Może być bezwzględnylub względny.

bezwzględny ustawi ścieżkę bezwzględną; domyślnie $ HOME.

względny ustawi ścieżkę względem $GIT_DIR.

Domyślnie do bezwzględny.

Mniej interesujące pokrętła, które można obrócić:

$VCSH_DEBUG
Wejdź w tryb debugowania.

$XDG_CONFIG_HOME
Jak określono w „Specyfikacji katalogu podstawowego XDG”, patrz
http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html

Domyślnie jest to <$HOME/.config>.

$VCSH_REPO_D
Katalog, z którego odczytywane i przechowywane są repozytoria.

Domyślnie <$XDG_CONFIG_HOME/vcsh/repo.d>.

$VCSH_HOOK_D
Katalog, z którego odczytywane są hooki.

Domyślnie jest to <$XDG_CONFIG_HOME/vcsh/hooks-enabled>.

$VCSH_BASE
Katalog, w którym są wyewidencjonowane repozytoria.

Domyślnie do $ HOME.

HOOK SYSTEM

vcsh zapewnia system haków. Skrypty hooków muszą być wykonywalne i powinny zostać umieszczone w pliku
<$XDG_CONFIG_HOME/vcsh/hooks-available>. Stamtąd można je miękko połączyć
<$XDG_CONFIG_HOME/vcsh/hooks-enabled>; vcsh wykona tylko haki, które są w tym
katalogiem.

Haczyki mają prosty format. przed uruchomieniem zostanie uruchomiony przed uruchomieniem czegokolwiek. Jeśli chcesz
masz więcej niż jeden skrypt dla określonego haka, po prostu dołącz dowolny ciąg znaków, aby zamówić
ich. System przed uruchomieniem, , itp. jest sugerowane; inne opcje
byłby przed biegiem-10 Lub . Kropka po nazwie haka jest opcjonalna.

Jeśli chcesz utworzyć haki dla konkretnego vcsh repozytorium, po prostu dołącz na początku plik
nazwa repozytorium, po której następuje kropka, np . W przeciwnym razie obowiązują te same zasady co
powyżej mają zastosowanie. Kropka pomiędzy nazwą repozytorium a haczykiem jest jednak obowiązkowa.

Dostępne haczyki to przed klonem, po klonowaniu, przeszedł na emeryturę po klonowaniu, przed poleceniem, po komendzie,
wstęp, po wprowadzeniu, wstępne, po inicjacji, wstępne pociągnięcie, po pociągnięciu, przed naciśnięciem, po naciśnięciu,
przed uruchomieniem, po biegu, przed aktualizacją, po aktualizacji. Jeśli potrzebujesz więcej, vcsh jest banalne
patch, ale prosimy o powiadomienie źródła, abyśmy mogli je wysłać domyślnie.

WAGI SYSTEM

vcsh zapewnia również system nakładek. Podobnie jak w przypadku haków, zalecane lokalizacje to:
<$XDG_CONFIG_HOME/vcsh/overlays-available> i <$XDG_CONFIG_HOME/vcsh/overlays-enabled>.

Nakładki podlegają tym samym zasadom, co haczyki i możesz nadpisać wszystko
Funkcje. Podobnie jak w przypadku haków, możesz używać nakładek globalnych lub specyficznych dla repozytorium, używając
albo <$VCSH_OVERLAY_D/$VCSH_COMMAND> albo <$VCSH_OVERLAY_D/$VCSH_REPO_NAME.$VCSH_COMMAND>.

Pamiętaj, że nic nie stoi na przeszkodzie, aby np. nadpisać status() in
<$VCSH_OVERLAY_D/zatwierdzenie>. Ponieważ nakładki zostaną pozyskane i zastąpisz je dowolnie
funkcji, wszystkie funkcje mogą przestać działać, a nawet możesz utracić dane.

Zostałeś ostrzeżony.

SZCZEGÓŁOWE JAK ROLNICZE DALEJ CZYTANIE

Strony podręcznika są często krótkie i czasami bezużyteczne, jeśli chodzi o czerpanie z nich najlepszych praktyk. Podczas
autor starał się tego uniknąć w tym przypadku, strony podręcznika nie mogą opisywać szczegółowych instrukcji.

Do tego oprogramowania dołączony jest także plik o nazwie . Zawiera różne podejścia do
konfigurowanie i używanie vcsh. Możesz wyświetlić plik jako zwykły tekst lub wyrenderować go
różne inne formaty za pośrednictwem Markdown.

W systemach opartych na Debianie plik ten można znaleźć w .

BEZPIECZEŃSTWO UWAGI

vcsh umożliwia wykonywanie dowolnych poleceń za pośrednictwem vcsh biegać. Na przykład dodanie a sudo(8)
reguła dla vcsh byłoby całkiem głupie.

Dodatkowo vcsh pobierze, czyli wykona, wszystkie pliki wymienione w CONFIG. Możesz umieścić dowolne
i wszystkie polecenia do tych plików konfiguracyjnych i zostaną one wykonane.

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