stg – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

stg – Verwalten Sie Stapel von Patches mit dem Git-Content-Tracker

ZUSAMMENFASSUNG

Stg [--version | --helfen]
Stg [--helfen | --helfen]
Stg [BEFEHLSOPTIONEN] [ARGS]

BESCHREIBUNG

StGit (Stacked Git) ist eine Anwendung, die eine bequeme Möglichkeit zur Verwaltung von a bietet Flicken
Stapel oben auf einem Git-Zweig:

· Die obersten (aktuellsten) Commits eines Zweigs erhalten Namen. Ein solcher benannter Commit ist
genannt Flicken.

· Nachdem Sie Änderungen am Arbeitsbaum vorgenommen haben, können Sie die Änderungen in einen vorhandenen übernehmen
Patch; das nennt man erfrischend. Sie können jeden Patch aktualisieren, nicht nur den obersten.

· Du kannst Pop ein Flicken: vorübergehend beiseite legen, so dass der Flicken darunter entsteht
der oberste Patch. Später vielleicht drücken legen Sie es wieder auf den Stapel. Dose schieben und knallen
kann zum Neuanordnen von Patches verwendet werden.

· Das können Sie ganz einfach zurückweisen Ihren Patch-Stack über jedem anderen Git-Commit. (Der Base einer
(Patch-Stack ist der neueste Git-Commit, der kein StGit-Patch ist.) Zum Beispiel, wenn
Sie haben begonnen, Patches auf dem Zweig einer anderen Person zu erstellen, und diese Person veröffentlicht
In einem aktualisierten Zweig können Sie alle Ihre Patches übernehmen und sie zusätzlich zu den aktualisierten anwenden
Ast.

· Wie zu erwarten ist, kann eine Änderung dessen, was unter einem Patch steht, dazu führen, dass dieser Patch nicht mehr funktioniert
Sauber anwenden – dies kann auftreten, wenn Sie Patches neu anordnen, Patches neu basieren oder einen aktualisieren
nicht oberster Patch. StGit nutzt die umbenennungsfähige Drei-Wege-Merge-Funktion von Git, um
automatisch reparieren, was es kann; Wenn es immer noch fehlschlägt, können Sie das Problem manuell beheben
Konflikt genau so, wie Sie einen Zusammenführungskonflikt in Git lösen würden.

· Der Patch-Stack besteht lediglich aus einigen zusätzlichen Metadaten, die an reguläre Git-Commits angehängt sind
kann weiterhin die meisten Git-Tools zusammen mit StGit verwenden.

Charakteristische verwendet
Tracking-Zweig
Verfolgen Sie Änderungen von einem Remote-Zweig aus und behalten Sie gleichzeitig lokale Änderungen bei
diesen Zweig, möglicherweise mit der Absicht, einige Patches stromaufwärts zu senden. Sie können ändern
Sie können Ihren Patch-Stack so weit erweitern, wie Sie möchten, und wann Ihre Patches endlich akzeptiert werden
Upstream enthält der permanent aufgezeichnete Git-Verlauf nur die letzte Sequenz von
Patches und nicht die chaotische Abfolge von Bearbeitungen, die sie erzeugt haben.

Interessante Befehle in diesem Workflow sind z. B. rebase und mail.

Entwicklungszweig
Selbst wenn Sie keinen „Upstream“ haben, an den Sie Patches senden können, können Sie StGit als praktische Lösung verwenden
Möglichkeit, den aktuellen Verlauf eines Git-Zweigs zu ändern. Zum Beispiel statt zuerst
Veränderung begehen A, dann ändern B, und dann A2 zu beheben A weil es nicht ganz war
Richtig, Sie könnten den Fix direkt in integrieren A. Diese Arbeitsweise führt zu einem
Die Git-Geschichte ist viel besser lesbar, als wenn Sie jeden Fehltritt, den Sie gemacht haben, verewigt hätten
Ihr Weg zur richtigen Lösung.

Interessante Befehle in diesem Workflow sind z. B. uncommit, mit dem sich das verschieben lässt
Patch-Stack-Basis nach unten – dh Git-Commits nachträglich in StGit-Patches umwandeln
– und verpflichten, es ist das Gegenteil.
Für weitere Informationen, siehe Lernprogramm[1].

Angeben schlafpflasters
Viele StGit-Befehle verwenden Verweise auf StGit-Patches als Argumente. Patches im Stapel
werden mit Kurznamen identifiziert, die jeweils im Stapel eindeutig sein müssen.

Patches im aktuellen Zweig werden einfach mit ihrem Namen bezeichnet. Einige Befehle erlauben dies
Sie können einen Patch in einem anderen Zweig des Repositorys angeben; Dies geschieht durch das Präfix
Patch-Name mit dem Zweignamen und einem Doppelpunkt (z. B. otherbranch:thatpatch).

Angeben verpflichtet
Einige StGit-Befehle akzeptieren Git-Commits als Argumente. StGit akzeptiert alle Commit-Ausdrücke
das tut Git; und zusätzlich einen Patch-Namen (optional mit dem Präfix eines Branch-Namens und eines
Doppelpunkt) ist in diesem Zusammenhang zulässig. Die üblichen Git-Modifikatoren ^ und ~ sind ebenfalls zulässig; z.B,
abranch:apatch~2 ist der Großelternteil des Commits, der der Patch-Apatch auf dem Zweig ist
ein Zweig.

Anstelle eines Patch-Namens können Sie {base} sagen, um auf die Stack-Basis (nur das Commit) zu verweisen
unterhalb des untersten Flecks); abranch:{base} ist also die Basis des Stapels in branch
ein Zweig.

Wenn Sie eine bestimmte StGit-Referenz an einen Git-Befehl übergeben müssen, stg-id(1) wird es konvertieren in
eine Git-Commit-ID für Sie.

OPTIONAL

Die folgenden generischen Optionsflags sind verfügbar. Zusätzliche Optionen sind verfügbar für
(und dokumentiert mit) den verschiedenen Unterbefehlen.

--Version
Druckt die StGit-Version sowie die Version anderer verwendeter Komponenten wie Git und
Python.

--help
Druckt die Zusammenfassung und eine Liste aller Unterbefehle. Wenn ein StGit-Unterbefehl angegeben wird,
gibt die Zusammenfassung für diesen Unterbefehl aus.

STGIT BEFEHLE

Wir unterteilen StGit-Befehle in thematische Gruppen, entsprechend dem primären Objekttyp, den sie verwenden
erstellen oder ändern.

Hier finden Sie eine kurze Beschreibung jedes Befehls. Eine ausführlichere Beschreibung finden Sie in
individuelle Befehls-Manpages. Diese Manpages werden benannt stg- (1).

Dokumente Befehle
stg-Klon(1)
Erstellen Sie einen lokalen Klon eines Remote-Repositorys

stg-id(1)
Gibt den Git-Hash-Wert einer StGit-Referenz aus

Stapeln (Zweig) Befehle
stg-Zweig(1)
Zweigoperationen: wechseln, auflisten, erstellen, umbenennen, löschen, ...

stg-clean(1)
Löschen Sie die leeren Patches in der Serie

stg-commit(1)
Bewahren Sie die aufgetragenen Pflaster dauerhaft in der Stapelbasis auf

stg-Schwimmer(1)
Schieben Sie die Flicken nach oben, auch wenn sie angebracht sind

stg-goto(1)
Pushen oder Pop-Patches auf den angegebenen Patch

stg-hide(1)
Verstecke einen Patch in der Serie

stg-init(1)
Initialisieren Sie den aktuellen Zweig für die Verwendung mit StGIT

stg-log(1)
Zeigen Sie das Patch-Änderungsprotokoll an

stg-next(1)
Drucken Sie den Namen des nächsten Patches aus

stg-Patches(1)
Zeigt die angewendeten Patches an, die eine Datei ändern

stg-pop(1)
Nehmen Sie einen oder mehrere Patches vom Stapel

stg-prev(1)
Drucken Sie den Namen des vorherigen Patches aus

stg-publish(1)
Schieben Sie die Stapeländerungen in einen zusammenführungsfreundlichen Zweig

stg-pull(1)
Ziehen Sie Änderungen aus einem Remote-Repository

stg-push(1)
Schieben Sie einen oder mehrere Patches auf den Stapel

stg-rebase(1)
Verschieben Sie die Stapelbasis an einen anderen Punkt im Verlauf

stg-redo(1)
Machen Sie den letzten Rückgängig-Vorgang rückgängig

stg-Reparatur(1)
Korrigieren Sie die StGit-Metadaten, wenn der Zweig mit Git-Befehlen geändert wurde

stg-reset(1)
Setzen Sie den Patch-Stack auf einen früheren Zustand zurück

stg-serie(1)
Drucken Sie die Patch-Serie aus

stg-senke(1)
Senden Sie Patches weiter unten im Stapel

stg-squash(1)
Quetschen Sie zwei oder mehr Patches zu einem

stg-top(1)
Drucken Sie den Namen des oberen Patches aus

stg-uncommit(1)
Verwandeln Sie reguläre Git-Commits in StGit-Patches

stg-rückgängig machen(1)
Machen Sie den letzten Vorgang rückgängig

stg-unhide(1)
Blenden Sie einen versteckten Patch ein

Patch Befehle
stg-löschen(1)
Patches löschen

stg-edit(1)
Bearbeiten Sie eine Patch-Beschreibung oder einen Unterschied

stg-export(1)
Exportieren Sie Patches in ein Verzeichnis

stg-Dateien(1)
Zeigt die durch einen Patch (oder den aktuellen Patch) geänderten Dateien an.

stg-Faltung(1)
Integrieren Sie einen GNU-Diff-Patch in den aktuellen Patch

stg-import(1)
Importieren Sie eine GNU-Diff-Datei als neuen Patch

stg-mail(1)
Senden Sie einen Patch oder eine Reihe von Patches per E-Mail

stg-neu(1)
Erstellen Sie einen neuen, leeren Patch

stg-pick(1)
Importieren Sie einen Patch aus einem anderen Zweig oder einem Commit-Objekt

stg-refresh(1)
Generieren Sie ein neues Commit für den aktuellen Patch

stg-umbenennen(1)
Benennen Sie einen Patch um

stg-show(1)
Zeigen Sie den Commit an, der einem Patch entspricht

stg-sync(1)
Synchronisieren Sie Patches mit einem Zweig oder einer Serie

Index/Arbeitsbaum Befehle
stg-diff(1)
Zeigen Sie den Baumunterschied an

CONFIGURATION MECHANISMUS

StGit verwendet denselben Konfigurationsmechanismus wie Git. Sehen git(7) für weitere Details.

TEMPLATES

Eine Reihe von StGit-Befehlen nutzen Vorlagendateien, um nützliche Standardtexte bereitzustellen
vom Benutzer bearbeitet werden. Diese Im Folgenden wird nach .tmpl-Vorlagendateien gesucht
Verzeichnisse:

1. $GITDIR/ (in der Praxis das .git/-Verzeichnis in Ihrem Repository)

2. $HOME/.stgit/templates/

3. /usr/share/stgit/templates/

ANMERKUNG

1. das Tutorial
[set $man.base.url.for.relative.links]/tutorial.html

Nutzen Sie stg online über die Dienste von onworks.net