stg - מקוון בענן

תָכְנִית:

שֵׁם

stg - נהל ערימות של תיקונים באמצעות מעקב התוכן של Git

תַקצִיר

stg [--גרסה | --עֶזרָה]
stg [--עֶזרָה | --עֶזרָה]
stg [אפשרויות פקודה] [ARGS]

תיאור

StGit (Stacked Git) היא אפליקציה המספקת דרך נוחה לתחזק א תיקון
לערום על גבי סניף Git:

· המחויבים העליונים (האחרונים ביותר) של סניף מקבלים שמות. התחייבות בשם כזו היא
נקרא א תיקון.

· לאחר ביצוע שינויים בעץ העבודה, ניתן לשלב את השינויים בקובץ קיים
תיקון; זה נקרא מרענן. אתה יכול לרענן כל תיקון, לא רק את העליון.

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

· אתה יכול בקלות השבה מחדש ערימת התיקון שלך על גבי כל commit אחר של Git. (ה בסיס של
ערימת תיקון היא ה-Git commit העדכנית ביותר שאינה תיקון StGit.) לדוגמה, אם
התחלת לעשות טלאים על גבי סניף של מישהו אחר, והאדם הזה מפרסם
סניף מעודכן, אתה יכול לקחת את כל התיקונים שלך ולהחיל אותם על גבי המעודכנים
ענף.

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

· ערימת התיקון היא רק כמה מטא נתונים נוספים המחוברים ל-Git commits רגילים, אז אתה
יכול להמשיך להשתמש ברוב כלי Git יחד עם StGit.

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

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

ענף פיתוח
גם אם אין לך "Upstream" לשלוח אליהם טלאים, אתה יכול להשתמש ב-StGit כאמצעי נוח
דרך לשנות את ההיסטוריה האחרונה של סניף Git. למשל, במקום הראשון
ביצוע שינוי A, ואז שנה B, ולאחר מכן A2 לתקן A כי זה לא היה לגמרי
נכון, אתה יכול לשלב את התיקון ישירות לתוך A. דרך עבודה זו מביאה א
היסטוריית Git קריאה הרבה יותר מאשר אם היית מנציח כל צעד שגוי שעשית
הדרך שלך לפתרון הנכון.

פקודות עניין בזרימת עבודה זו הן למשל uncommit, שבהן ניתן להשתמש כדי להזיז את
בסיס ערימת תיקונים כלפי מטה - כלומר, הפוך את התחייבויות Git לטלאי StGit לאחר מעשה
- ולהתחייב, הפוך שלה.
לקבלת מידע נוסף, ראה מה היא הדרכה[1].

מפרט טלאים
פקודות StGit רבות לוקחות הפניות לתיקוני StGit כארגומנטים. טלאים בערימה
מזוהים בשמות קצרים, שכל אחד מהם חייב להיות ייחודי בערימה.

טלאים בסניף הנוכחי נקראים פשוט בשמם. חלק מהפקודות מאפשרות
עליך לציין תיקון בענף אחר של המאגר; זה נעשה על ידי קידומת של
שם תיקון עם שם הסניף ונקודתיים (לדוגמה otherbranch:thatpatch).

מפרט מתחייב
כמה פקודות StGit לוקחות commits של Git כארגומנטים. StGit מקבל את כל ביטויי ההתחייבות
ש-Git עושה; ובנוסף, שם תיקון (אופציונלי עם קידומת של שם סניף ו-a
נקודתיים) מותר בהקשר זה. מותר גם לשנות את ה-Git הרגילים ^ ו-~; לְמָשָׁל,
abranch:apatch~2 הוא הסבא והסבתא של ה-commit שהוא התיקון apatch בסניף
ענף.

במקום שם תיקון, אתה יכול לומר {base} כדי להתייחס לבסיס המחסנית (ההתחייבות רק
מתחת לתיקון התחתון ביותר); אז, abranch:{base} הוא הבסיס של הערימה בענף
ענף.

אם אתה צריך להעביר הפניה נתונה של StGit לפקודת Git, stg-id(1) ימיר אותו ל
מזהה התחייבות של Git עבורך.

אפשרויות

דגלי האופציות הגנריות הבאות זמינות. אפשרויות נוספות זמינות עבור
(ותועדה עם) פקודות המשנה השונות.

--גִרְסָה
מדפיס את גרסת StGit, כמו גם גרסת רכיבים אחרים שבהם נעשה שימוש, כגון Git ו
פייתון

- עזרה
מדפיס את התקציר ורשימה של כל פקודות המשנה. אם ניתנת פקודת משנה StGit,
מדפיס את תקציר הפקודה הזו.

STGIT פקודות

אנו מחלקים פקודות StGit בקבוצות נושאיות, לפי סוג האובייקט העיקרי שהם
ליצור או לשנות.

להלן תיאור קצר של כל פקודה. תיאור מפורט יותר זמין ב
דפי פקודות בודדים. לדפי ה-man האלה יש שמות סטג- (1).

Repository פקודות
stg-clone(1)
צור שיבוט מקומי של מאגר מרוחק

stg-id(1)
הדפס את ערך ה-git hash של הפניה ל-StGit

לערום (ענף) פקודות
stg-branch(1)
פעולות סניף: החלפה, רשימה, יצירה, שינוי שם, מחיקה, ...

stg-clean(1)
מחק את הטלאים הריקים בסדרה

stg-commit(1)
אחסן לצמיתות את הטלאים המוחלים בבסיס הערימה

stg-float(1)
דחוף את הטלאים לחלק העליון, גם אם מוחל

stg-goto(1)
דחף או תקפיץ טלאים לנתון

stg-hide(1)
הסתר תיקון בסדרה

stg-init(1)
אתחל את הסניף הנוכחי לשימוש עם StGIT

stg-log(1)
הצג את יומן השינויים של התיקון

stg-next(1)
הדפס את שם התיקון הבא

stg-patches(1)
הצג את התיקונים שהוחלו המשנים קובץ

stg-pop(1)
קפץ טלאים אחד או יותר מהערימה

stg-prev(1)
הדפס את השם של התיקון הקודם

stg-publish(1)
דחף את השינויים בערימה לענף ידידותי למיזוג

stg-pull(1)
משוך שינויים ממאגר מרוחק

stg-push(1)
דחוף טלאים אחד או יותר על הערימה

stg-rebase(1)
העבר את בסיס הערימה לנקודה אחרת בהיסטוריה

stg-redo(1)
בטל את פעולת הביטול האחרונה

stg-תיקון(1)
תקן מטא נתונים של StGit אם הענף השתנה עם פקודות git

stg-reset(1)
אפס את ערימת התיקון למצב מוקדם יותר

סדרת stg(1)
הדפס את סדרת התיקון

stg-sink(1)
שלח טלאים עמוק יותר במורד הערימה

stg-סקווש(1)
מעוך שני טלאים או יותר לאחד

stg-top(1)
הדפס את שם התיקון העליון

stg-uncommit(1)
הפוך התחייבויות git רגילות לתיקון StGit

stg-בטל(1)
בטל את הפעולה האחרונה

stg-unhide(1)
גלה הסתרת תיקון מוסתר

תיקון פקודות
stg-delete(1)
מחק תיקונים

stg-edit(1)
ערוך תיאור של תיקון או הבדל

stg-export(1)
ייצוא תיקונים לספרייה

stg-קבצים(1)
הצג את הקבצים ששונו על ידי תיקון (או התיקון הנוכחי)

stg-fold(1)
שלב תיקון GNU diff בתיקון הנוכחי

stg-import(1)
ייבא קובץ GNU diff כתיקון חדש

stg-mail(1)
שלח תיקון או סדרת טלאים בדואר אלקטרוני

stg-חדש(1)
צור תיקון חדש וריק

stg-pick(1)
ייבא תיקון מסניף אחר או אובייקט commit

stg-refresh(1)
צור commit חדש עבור התיקון הנוכחי

stg-rename(1)
שנה שם של תיקון

stg-show(1)
הצג את ה-commit המתאים לתיקון

stg-sync(1)
סנכרן טלאים עם ענף או סדרה

אינדקס/עץ עבודה פקודות
stg-diff(1)
הראה את הבדל העץ

תְצוּרָה מַנגָנוֹן

StGit משתמש באותו מנגנון תצורה כמו Git. לִרְאוֹת סילון(7) לפרטים נוספים.

TEMPLATES

מספר פקודות StGit עושות שימוש בקבצי תבנית כדי לספק טקסטים שימושיים כברירת מחדל
לערוך על ידי המשתמש. אלה קבצי תבנית .tmpl נחפשים בהמשך
ספריות:

1. $GITDIR/ (בפועל, ספריית .git/ במאגר שלך)

2. $HOME/.stgit/templates/

3. /usr/share/stgit/templates/

אורים

1. ההדרכה
[הגדר $man.base.url.for.relative.links]/tutorial.html

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