gbp-dch — online w chmurze

PROGRAM:

IMIĘ

gbp-dch - Generuj dziennik zmian Debiana z wiadomości git commit

STRESZCZENIE

gbp rozdz [ --wersja ] [ --help ] [ --gadatliwy ] [ --kolor=[auto|włącz|wyłącz] ] [ --kolor-
schemat=SCHEMAT_KOLORÓW ] [ --debian-gałąź=Nazwa filii ] [ --debian-tag=format tagu ] [
--gałąź nadrzędna =Nazwa filii ] [ --tag-upstream=format tagu ] [ --ignoruj-gałąź ] [
--migawka | --uwolnienie ] [ --automatyczny | --od=posłuszeństwo ] [ --nowa-wersja=wersja ] [ --bpo
| --nmu | --q | --zespół ] [ --dystrybucja=Nazwa ] [ --rozkład-siły ] [
--pilność=poziom ] [ --[nie-]pełne ] [ --[nie-]meta ] [ --meta-closes=znaczniki zamykania błędów ] [
--meta-closes-bugnum=format-numeru-błędu ] [ --numer-migawki=wyrażenie ] [ --NS-
długość=numer ] [ --git-log=opcje-git-log ] [ --[no-]git-autor ] [ --[nie-]wielokonserwacja ]
[ --[nie-]multimaint-merge ] [ --spawn-editor=[zawsze|migawka|wydanie] ] [ --popełniać-
wiadomość=format wiadomości ] [ --popełniać ] [ --dostosowania=plik-dostosowania ] [ścieżka1 ścieżka2]

OPIS

gbp rozdz odczytuje komunikaty git commit i generuje z nich dziennik zmian Debiana. Jeśli nie
podane są argumenty, gbp rozdz zaczyna się od ostatniej oznaczonej wersji pakietu Debiana aż do
aktualna końcówka aktualnej gałęzi. Jeśli rozkład najwyższej sekcji w
debian/list zmian is NIEWYDANY, wpisy dziennika zmian zostaną wstawione do tej sekcji.
W przeciwnym razie zostanie utworzona nowa sekcja.

If --automatyczny jest podawany gbp rozdz, próbuje odgadnąć ostatnie zatwierdzenie Git udokumentowane w dzienniku zmian
- działa to tylko w trybie migawki. Inaczej, --odkąd może być użyty do powiedzenia gbp rozdz at
od którego punktu ma się zaczynać w historii Git.

Dodatkowe argumenty ścieżki mogą być użyte do ograniczenia ścieżek repozytorium gbp rozdz wygląd
w. Ustawienie ścieżka do debian/ to dobry wybór, jeśli autorzy używają Gita i wszystkich pakietów Debiana
zmiany są ograniczone do debian/ podreż. W bardziej wyrafinowanych przypadkach (takich jak
backporty), możesz użyć --git-log aby dodatkowo ograniczyć generowane wpisy w dzienniku zmian,
np. używając --git-log="--autor=Foo Bar".

OPCJE

--wersja
Wersja do wydruku programu, czyli wersja pakietu git-buildpackage

-v

--gadatliwy
Pełne wykonanie

-h

--help Wydrukuj pomoc i wyjdź

--kolor=[auto|włącz|wyłącz]
Czy używać kolorowego wyjścia.

--kolor-schemat=SCHEMAT_KOLORÓW
Kolory do użycia na wyjściu (gdy kolor jest włączony). Format COLOR_SCHEME to
' : : : „. Akceptowane są wartości liczbowe i nazwy kolorów,
puste pola oznaczają domyślny kolor. Na przykład, --git-kolor-schemat='cyjan:34::'
pokaże komunikaty debugowania na niebiesko, komunikaty informacyjne na niebiesko, a inne komunikaty na
domyślne (tj. ostrzeżenia i komunikaty o błędach na czerwono).

--debian-gałąź=Nazwa filii
Gałąź w repozytorium Git, na której jest rozwijany pakiet Debiana, domyślna
is mistrz.

--gałąź nadrzędna =Nazwa filii
Rozgałęzienie, aby określić wersję nadrzędną. Wartość domyślna to pod prąd.

--git-upstream-tag=FORMAT TAGU
używaj tego formatu tagów, gdy szukasz tagów nadrzędnych wersji, domyślnym jest
upstream/%(wersja)s.

--ignoruj-gałąź
Nie sprawdzaj, czy aktualny oddział pasuje gałąź-debian.

--debian-tag=format tagu
używany format tagów, podczas tagowania wersji Debiana domyślnym jest debian/%(wersja)s

--od=zobowiązać się
Zacznij czytać komunikaty o zatwierdzeniu o zobowiązać się.

--automatyczny, -a
Zgadnij ostatnie zatwierdzenie udokumentowane w changelogu z banera migawki (lub z
ostatni tag, jeśli nie istnieje baner migawki).

--[nie-]meta
Przeanalizuj metatagi, takie jak Zamyka:, Dzięki: i GB-Dch:. Zobacz META TAGI poniżej.

--meta-zamyka=błędy-zamknij-tagi
Jakich metatagów szukać, aby generować wpisy dziennika zmian zamykające błędy. Domyślny
to 'Closes|LP' w celu obsługi Debiana i Launchpada.

--meta-zamyka-bugnum=format-numeru-błędu
Jakie wyrażenie regularne powinno zostać użyte do przeanalizowania numeru błędu. Wartość domyślna to
'(?:błąd|problem)?\#?\s?\d+'. Uwaga: wyrażenie regularne powinno pomijać wszystkie części błędu
liczby, które nie są pożądane przy użyciu "(?:)", zobacz podręcznik Pythona regex, aby uzyskać szczegółowe informacje.

Przykład: --meta-zamyka-bugnum=„(?:bug)?\s*ex-\d+” odpowiadałoby wszystkim następującym:

Możliwe dopasowanie tekstu? Wynik
------------ ------ ------
błąd EX-12345 Y EX-12345
ex-01273 Y ex-01273
błąd ex-1ab Y ex-1
EX--12345 N

--[nie-]pełne
Dołącz pełny komunikat zatwierdzenia do danych wyjściowych dziennika zmian.

--migawka, -S
Utwórz wpis wersji migawki. Dodaje to numer wersji migawki i ostrzeżenie
baner do wpisu dziennika zmian. Numer wersji wydania jest automatycznie zwiększany
z każdym nowym wydaniem migawki, aby uniknąć zmiany wersji pakietów podczas migawki
testowanie.

--numer-migawki=wyrażenie
Wyrażenie Pythona, które jest eval()ed do nowego numeru zrzutu.

--uwolnienie, -R
Usuń wszelkie banery wersji migawki i sufiksy wersji, ustaw bieżącą
dystrybucja do nietrwałyi otwórz dziennik zmian, aby dokonać ostatecznych poprawek.

--nowa-wersja=wersja, -N wersja
Dodaj nową sekcję dziennika zmian z wersją Nowa wersja. Razem z --migawkaThe
numer migawki zostanie dołączony do Nowa wersja.

--zespół Utwórz wpis w dzienniku zmian przesyłania zespołu.

--bpo Zwiększ numer wydania Debiana dla przesyłania do backportów i dodaj backport
prześlij komentarz do dziennika zmian.

--nmu Zwiększ numer wydania Debiana w przypadku przesyłania bez opieki.

--q Zwiększ numer wydania Debiana dla przesłanego zespołu Debian QA Team i dodaj QA
prześlij komentarz do dziennika zmian.

--dystrybucja=Nazwa
Ustaw pole dystrybucji na Nazwa.

--rozkład-siły
Wymuś rozkład określony za pomocą --dystrybucja do użycia, nawet jeśli nie
dopasuj listę znanych dystrybucji.

--pilność=poziom
Ustaw pole pilności na poziom.

--git-log=opcje-git-log
Opcje przekazane dosłownie do git-log(1).

--id-długość=N
Zawierać N cyfry identyfikatora zatwierdzenia we wpisie dziennika zmian. Domyślnie nie należy uwzględniać
wszystkie identyfikatory zatwierdzenia.

--ignoruj-wyrażenie regularne=regex
Ignoruj ​​pasujące wiersze zatwierdzenia regex podczas generowania dziennika zmian.

--git-autor
Użyj nazwy użytkownika i adresu e-mail użytkownika z git-config(1) dla przyczepy dziennika zmian.

--[nie-]multimaint-merge
Scal zatwierdzenia przez opiekuna.

--spawn-edytor=[zawsze|migawka|wydanie]
Czy spawnować edytor: zawsze, podczas robienia migawek, czy podczas robienia wydania.

--wiadomość-zatwierdzenia=format wiadomości
użyj tego ciągu formatu dla komunikatu zatwierdzenia podczas zatwierdzania wygenerowanego
plik dziennika zmian (kiedy --popełniać jest podawany). Wartość domyślna to Aktualizacja changelog dla
%(wersja)s zwolnić

--popełniać
Zatwierdź wygenerowany dziennik zmian.

--dostosowania=plik-dostosowania
Załaduj kod Pythona z plik-dostosowania. W tej chwili jedyną użyteczną rzeczą jest
kod, który można zrobić, to zdefiniować niestandardową funkcję format_changelog_entry().

MIGAWKA TRYB

Tryb migawki może być używany do szybkiego testowania i instalowania cykli bez obaw
numery wersji lub wpisy dziennika zmian.

Podczas używania --migawka or -S, gbp rozdz używa pseudonagłówka w dzienniku zmian Debiana, aby
pamiętaj, że ostatnie zatwierdzenie git dodało wpis do dziennika zmian. Ustawia również numer wersji
kończąc na ~ .gbp. Automatycznie zwiększa migawkę
numer na kolejnych wezwaniach gbp rozdz -S aby później migawki automatycznie miały
wyższy numer wersji. Aby wyjść z trybu migawki, wywołaj gbp rozdz z --uwolnienie opcja.
Usuwa to pseudonagłówek i rozwiązuje numer wersji, więc wydana wersja
ma wyższy numer wersji niż migawki.

META TAGI

Oprócz powyższych opcji formatowanie komunikatu zatwierdzenia w debian/list zmian
mogą być modyfikowane przez specjalne znaczniki (nazywane metatagami) podane w komunikacie git commit. Meta
Przetwarzanie tagów można aktywować za pomocą --meta opcja. Tagi muszą zaczynać się od pierwszego
kolumna komunikatu o zatwierdzeniu, ale może pojawić się w dowolnym wierszu. Mają formę Nazwa znacznika:
wartość. Prawidłowe metatagi to:

GB-Dch: akcja
Obsługiwane działania to: ignorować który zignoruje to zatwierdzenie podczas generowania
debian/list zmian, Short który użyje tylko opisu (pierwsza linia)
komunikat commit podczas generowania wpisu dziennika zmian (przydatne, gdy --pełny jest podawany),
i pełny który użyje pełnego komunikatu zatwierdzenia podczas generowania wpisu dziennika zmian
(przydatne, gdy --pełny nie jest podany).

Oprócz GB-Dch, przestarzały Git-Dch jest nadal obsługiwany.

Dzięki: msg
Dodaj wiadomość z podziękowaniem po komunikacie zatwierdzenia.

Zamyka: numer błędu
Wskaż w debian/list zmian że błąd został zamknięty przez to zatwierdzenie. Zobacz
--meta-zamknięcia jak rozszerzyć to o inne bugtrackery.

Poniższy komunikat o zatwierdzeniu git:

Metatagi dokumentu

więc nie trzeba zaglądać do instrukcji

Gbp-Dch: krótki
Zamyka: #636088
Dzięki: Raphaël Hertzog za sugestię

Wyniki w tym debian/list zmian wejście:

* Metatagi dokumentu.
Podziękowania dla Raphaëla Hertzog za sugestię (Zamyka: #636088)

KONFIGURACJA AKTA

Kilka gbp.konf pliki są analizowane w celu ustawienia wartości domyślnych dla powyższych argumentów wiersza poleceń.
Zobacz gbp.konf(5)> strona podręcznika, aby uzyskać szczegółowe informacje.

Korzystaj z gbp-dch online za pomocą usług onworks.net