gbp-dch - מקוון בענן

תָכְנִית:

שֵׁם

gbp-dch - צור את יומן השינויים של דביאן מהודעות git commit

תַקצִיר

ליש"ט dch [ --גִרְסָה ] [ - עזרה ] [ --מִלוּלִי ] [ --color=[אוטומטי|מופעל|כבוי] ] [ --צֶבַע-
תכנית=סכמת צבעים ] [ --debian-branch=שם הסניף ] [ --debian-tag=פורמט תג ] [
---upstream-branch=שם הסניף ] [ --upstream-tag=פורמט תג ] [ --התעלם-ענף ] [
--תמונת מצב | --לְשַׁחְרֵר ] [ --אוטומטי | --מאז=להתחייב ] [ --גרסה חדשה=גרסה ] [ --bpo
| --nmu | --qa | --קְבוּצָה ] [ --הפצה=שם ] [ --הפצת כוח ] [
--דחיפות=רָמָה ] [ --[לא-]מלא ] [ --[לא-]מטא ] [ --meta-close=bug-close-tags ] [
--meta-close-bugnum=bug-number-format ] [ --מספר-תמונה=ביטוי ] [ --תְעוּדַת זֶהוּת-
אורך=מספר ] [ --git-log=git-log-options ] [ --[no-]git-author ] [ --[לא-]תחזוקה מרובה ]
[ --[לא-]מיזוג מרובה-מאינט ] [ --spawn-editor=[תמיד|תצלום|מהדורה] ] [ --לְבַצֵעַ-
msg=msg-format ] [ --לְבַצֵעַ ] [ --התאמה אישית=קובץ התאמה אישית ] [נתיב1 נתיב2]

תיאור

ליש"ט dch קורא הודעות git commit ומייצר ממנו את יומן השינויים של דביאן. אם לא
ניתנים טיעונים, ליש"ט dch מתחיל מגרסת חבילת Debian המתויגת האחרונה ועד ל-
הקצה הנוכחי של הסניף הנוכחי. אם התפלגות הקטע העליון ב
debian/changelog is לא פורסם, ערכי יומן השינויים יוכנסו לסעיף זה.
אחרת, ייווצר קטע חדש.

If --אוטומטי נתון ליש"ט dch, מנסה לנחש את המחויב האחרון של Git שתועד ב-changelog
- זה עובד רק במצב תמונת מצב. אחרת, --מאז ניתן להשתמש כדי לספר ליש"ט dch at
באיזו נקודה זה צריך להתחיל בהיסטוריית Git.

ניתן להשתמש בארגומנטים הנוספים של הנתיב כדי להגביל את נתיבי המאגר ליש"ט dch נראה
בְּ. הגדרה נתיב ל דביאן/ היא בחירה טובה אם במעלה הזרם משתמש ב-Git ובכל אריזות דביאן
השינויים מוגבלים ל דביאן/ subdir. במקרים מתוחכמים יותר (כמו
backports), אתה יכול להשתמש --git-log כדי להגביל עוד יותר את ערכי יומן השינויים שנוצרו,
למשל באמצעות --git-log="--מחבר=פו בָּר".

אפשרויות

--גִרְסָה
גרסת הדפסה של התוכנית, כלומר גרסה של חבילת git-buildpackage

-v

--מִלוּלִי
ביצוע מפורט

-h

- עזרה הדפס עזרה וצא

--color=[אוטומטי|מופעל|כבוי]
האם להשתמש בפלט צבעוני.

--סכמת צבעים=סכמת צבעים
צבעים לשימוש בפלט (כאשר צבע מופעל). הפורמט של COLOR_SCHEME הוא
' : : : '. ערכים מספריים ושמות צבעים מתקבלים,
שדות ריקים מרמזים על צבע ברירת המחדל. לדוגמה, --git-color-scheme='cyan:34::'
יציג הודעות ניפוי באגים בציאן, הודעות מידע בכחול והודעות אחרות ב
ברירת מחדל (כלומר הודעות אזהרה ושגיאה באדום).

--debian-branch=שם הסניף
הסניף במאגר Git שבו חבילת Debian מפותחת, ברירת מחדל
is אב.

---upstream-branch=שם הסניף
סניף לקביעת הגרסה במעלה הזרם. ברירת המחדל היא בְּמַעֲלֶה הַזֶרֶם.

--git-upstream-tag=TAG-FORMAT
השתמש בפורמט תג זה כאשר אתה מחפש תגים של גרסאות במעלה הזרם, ברירת המחדל היא
במעלה הזרם/%(גרסה)s.

--התעלם-ענף
אל תבדוק אם הסניף הנוכחי תואם debian-branch.

--debian-tag=פורמט תג
פורמט התג בשימוש, בעת תיוג גרסאות דביאן, ברירת המחדל היא debian/%(version)s

--מאז=להתחייב
התחל לקרוא הודעות commit ב להתחייב.

--אוטומטי, -a
נחשו את ההתחייבות האחרונה שתועדה ביומן השינויים מהבאנר של תמונת המצב (או מ-
התג האחרון אם לא קיים באנר של תמונת מצב).

--[לא-]מטא
נתח מטא תגיות כמו נסגר:, תודה: ו Gbp-Dch:. ראה META TAGS למטה.

--meta-closes=באג-סגור-תגיות
אילו מטא תגיות לחפש כדי ליצור ערכי יומן שינויים לסגירת באגים. ברירת המחדל
הוא 'Closes|LP' כדי לתמוך בדביאן וב-Launchpad.

--meta-closes-bugnum=באג-מספר-פורמט
באיזה ביטוי רגולרי יש להשתמש כדי לנתח את מספר הבאג. ברירת המחדל היא
'(?:bug|issue)?\#?\s?\d+'. הערה: הביטוי הרגולרי אמור לדכא את כל חלקי הבאג
מספרים שאינם רצויים באמצעות "(?:)", ראה מדריך Python regex לפרטים.

דוגמא: --meta-closes-bugnum="(?:bug)?\s*ex-\d+" יתאים לכל הדברים הבאים:

התאמת טקסט אפשרית? תוֹצָאָה
------------ ------ ------
באג EX-12345 Y EX-12345
ex-01273 Y ex-01273
באג ex-1ab Y ex-1
EX--12345 N

--[לא-]מלא
כלול את הודעת ההתחייבות המלאה בפלט יומן השינויים.

--תצלום, -S
צור ערך שחרור של תמונת מצב. זה מוסיף מספר שחרור של תמונת מצב ואזהרה
באנר לערך יומן השינויים. מספר גרסת הגרסה מוגדל אוטומטית
עם כל מהדורת תמונת מצב חדשה כדי למנוע שדרוג לאחור של חבילות במהלך תמונת מצב
בדיקה.

--מספר-תמונה=ביטוי
ביטוי Python שמקבל eval()ed למספר תמונת המצב החדש.

--לְשַׁחְרֵר, -R
הסר את כל הבאנרים לשחרור תמונת מצב וסיומת גרסאות, הגדר את הנוכחי
הפצה ל לא יציב, ופתח את יומן השינויים לצורך התאמה סופית.

--גרסה חדשה=גרסה, -N גרסה
הוסף קטע יומן שינויים חדש עם גרסה גרסה חדשה. ביחד עם --תמונת מצב, ה
מספר תמונת מצב יצורף ל גרסה חדשה.

--קְבוּצָה צור ערך יומן שינויים בהעלאת צוות.

--bpo הגדל את מספר המהדורה של Debian עבור העלאה ליציאות אחוריות, והוסף יציאת אחורי
העלה תגובה ביומן שינויים.

--nmu הגדל את מספר ההפצה של דביאן עבור העלאה שאינה מתוכננת.

--qa הגדל את מספר ההפצה של Debian עבור העלאת צוות QA של Debian, והוסף QA
העלה תגובה ביומן שינויים.

--הפצה=שם
הגדר את שדה ההפצה ל שם.

--הפצת כוח
כפה את ההתפלגות שצוינה עם --הפצה לשימוש, גם אם לא
להתאים לרשימת ההפצות הידועות.

--דחיפות=רָמָה
הגדר את שדה הדחיפות ל רָמָה.

--git-log=git-log-options
אפשרויות שהועברו מילה במילה ל git-log(1).

--id-length=N
לכלול N הספרות של מזהה ה-commit ברישום יומן השינויים. ברירת המחדל היא לא לכלול
כל מזהי התחייבות בכלל.

--ignore-regex=regex
התעלם מהתאמת שורות התחייבות regex בעת יצירת יומן השינויים.

--git-מחבר
השתמש ב-user.name ו-user.email from git-config(1) עבור טריילר יומן שינויים.

--[לא-]מיזוג מרובה-מאינט
מיזוג התחייבויות על ידי מתחזק.

--spawn-editor=[תמיד|תמונה|שחרור]
האם להוליד עורך: תמיד, בעת ביצוע צילומי מצב או בעת ביצוע שחרור.

--commit-msg=msg-format
השתמש במחרוזת פורמט זו עבור הודעת ה-commit בעת ביצוע ה-commit שנוצר
קובץ יומן שינויים (מתי --לְבַצֵעַ נתון). ברירת המחדל היא עדכון changelog ל
%(גרסה)s לשחרר

--לְבַצֵעַ
בצע את יומן השינויים שנוצר.

--התאמה אישית=קובץ התאמה אישית
טען קוד Python מ קובץ התאמה אישית. כרגע, הדבר השימושי היחיד הוא
הקוד יכול לעשות הוא להגדיר פונקציה מותאמת אישית format_changelog_entry()‎.

סנאפצ'וט MODE

מצב תמונת מצב יכול לשמש למחזורי בדיקה והתקנה מהירים ללא צורך לדאוג
מספרי גרסאות או ערכי יומן שינויים.

כשמשתמש --תמונת מצב or -S, ליש"ט dch משתמש בכותרת פסאודו ביומן השינויים של דביאן ל
זכור את ה-git commit האחרון שעבורו הוסיף ערך Changelog. זה גם מגדיר מספר גרסה
מסתיים ב ~ .ליש"ט. זה מגדיל באופן אוטומטי את תמונת המצב
מספר על הפניות עוקבות של ליש"ט dch -S כך שלתמונות מאוחרות יותר יש אוטומטית
מספר גרסה גבוה יותר. כדי לצאת ממצב תמונת מצב, הפעל ליש"ט dch עם --לְשַׁחְרֵר אוֹפְּצִיָה.
פעולה זו מסירה את הכותרת הפסאודו ומבטלת את מספר הגרסה כך שהגרסה שפורסמה
יש מספר גרסה גבוה יותר מאשר התמונות.

META תגיות

בנוסף לאפשרויות לעיל, העיצוב של הודעת ה-commit ב debian/changelog
ניתן לשנות על ידי תגים מיוחדים (הנקראים Meta Tags) הניתנים בהודעת git commit. מטא
ניתן להפעיל את עיבוד התגים באמצעות --מטא אוֹפְּצִיָה. התגים חייבים להתחיל בהתחלה
העמודה של הודעת התחייבות אך יכולה להופיע בכל שורה. הם מהצורה תג שם:
ערך. מטא תגים חוקיים הם:

Gbp-Dch: פעולה
הפעולות הנתמכות הן: להתעלם אשר יתעלם מהתחייבות זו בעת היצירה
debian/changelog, קצר אשר ישתמש רק בתיאור (השורה הראשונה) של ה
הודעת commit בעת יצירת ערך יומן השינויים (שימושי כאשר --מלא נתון),
ו מלא אשר ישתמש בהודעת ה-commit המלאה בעת יצירת הערך של Changelog
(שימושי מתי --מלא לא ניתן).

נוסף על Gbp-Dch, ההוצאה משימוש Git-Dch עדיין נתמך.

תודה: msg
הוסף הודעת תודה לאחר הודעת ההתחייבות.

נסגר: מספר באג
ציין ב debian/changelog שהבאג נסגר על ידי commit זה. ראה את
--מטא-סגור כיצד להרחיב את זה עבור עוקבים אחרים.

הודעת ה-git commit הבאה:

מטא תגיות מסמכים

אז לא צריך לעיין במדריך

Gbp-Dch: קצר
נסגר: #636088
תודה: רפאל הרצוג על ההצעה

תוצאות בזה debian/changelog כְּנִיסָה:

* מטא תגיות מסמכים.
תודה לרפאל הרצוג על ההצעה (נסגר: #636088)

תְצוּרָה קבצים

כמה gbp.conf קבצים מנותחים כדי להגדיר ברירת מחדל עבור הארגומנטים של שורת הפקודה לעיל.
ראה gbp.conf(5)> דף אדם לפרטים.

השתמש ב-gbp-dch באינטרנט באמצעות שירותי onworks.net