stg - En ligne dans le Cloud

PROGRAMME:

Nom

stg - Gérer des piles de correctifs à l'aide du tracker de contenu Git

SYNOPSIS

stg [--version | --aider]
stg [--aider | --aider]
stg [OPTIONS DE COMMANDE] [ARGS]

DESCRIPTION

StGit (Stacked Git) est une application qui fournit un moyen pratique de maintenir un pièce
empiler au-dessus d'une branche Git :

· Les commits les plus hauts (les plus récents) d'une branche reçoivent des noms. Un tel commit nommé est
appelé un pièce.

· Après avoir apporté des modifications à l'arbre de travail, vous pouvez incorporer les modifications dans un
pièce; c'est appelé rafraîchissant. Vous pouvez actualiser n'importe quel patch, pas seulement le plus haut.

· Vous pouvez pop un patch : le mettre temporairement de côté, afin que le patch en dessous devienne
le patch le plus haut. Plus tard, vous pouvez pousser le remettre sur la pile. Poussant et éclatant peut
être utilisé pour réorganiser les correctifs.

· Vous pouvez facilement rebasement votre pile de correctifs au-dessus de tout autre commit Git. (Les base d'un
la pile de correctifs est le commit Git le plus récent qui n'est pas un correctif StGit.) Par exemple, si
vous avez commencé à créer des correctifs au-dessus de la branche de quelqu'un d'autre, et cette personne publie
une branche mise à jour, vous pouvez prendre tous vos correctifs et les appliquer par-dessus la mise à jour
branche.

· Comme on peut s'y attendre, changer ce qui se trouve en dessous d'un correctif peut empêcher ce correctif de
appliquer proprement — cela peut se produire lorsque vous réorganisez des correctifs, rebasez des correctifs ou actualisez un
patch non supérieur. StGit utilise la capacité de fusion à trois voies avec renommage de Git pour
réparer automatiquement ce qu'il peut ; s'il échoue toujours, il vous permet de résoudre manuellement le
conflit comme vous le feriez pour résoudre un conflit de fusion dans Git.

· La pile de correctifs n'est que quelques métadonnées supplémentaires attachées aux commits Git réguliers, vous
peut continuer à utiliser la plupart des outils Git avec StGit.

Résolution Usages
Branche de suivi
Suivi des modifications depuis une succursale distante, tout en maintenant les modifications locales par rapport à
cette branche, peut-être dans l'intention d'envoyer des correctifs en amont. Vous pouvez modifier
votre pile de patchs autant que vous le souhaitez, et quand vos patchs sont enfin acceptés
en amont, l'historique Git enregistré en permanence ne contiendra que la séquence finale de
correctifs, et non la séquence désordonnée de modifications qui les a produits.

Les commandes d'intérêt dans ce workflow sont par exemple rebase et mail.

Branche développement
Même si vous n'avez pas "en amont" vers lequel envoyer des correctifs, vous pouvez utiliser StGit comme un moyen pratique
moyen de modifier l'historique récent d'une branche Git. Par exemple, au lieu d'abord
engager le changement A, puis changez B, et alors A2 à fixer A parce que ce n'était pas tout à fait
à droite, vous pouvez incorporer le correctif directement dans A. Cette façon de travailler se traduit par une
histoire Git beaucoup plus lisible que si vous aviez immortalisé chaque faux pas que vous avez fait sur
votre chemin vers la bonne solution.

Les commandes d'intérêt dans ce workflow sont par exemple uncommit, qui peut être utilisée pour déplacer le
base de la pile de correctifs vers le bas - c'est-à-dire transformer les commits Git en correctifs StGit après coup
— et commit, son inverse.
Pour plus d'informations, voir le tutoriel[1].

Spécification patchs
De nombreuses commandes StGit prennent des références aux correctifs StGit comme arguments. Patchs dans la pile
sont identifiés par des noms courts, dont chacun doit être unique dans la pile.

Les correctifs de la branche actuelle sont simplement désignés par leur nom. Certaines commandes permettent
vous de spécifier un patch dans une autre branche du référentiel ; cela se fait en préfixant le
patch name avec le nom de la branche et deux points (par exemple otherbranch:thatpatch).

Spécification commits
Certaines commandes StGit prennent les commits Git comme arguments. StGit accepte toutes les expressions de validation
que Git fait ; et en plus, un nom de patch (éventuellement préfixé par un nom de branche et un
deux-points) est autorisé dans ce contexte. Les modificateurs Git habituels ^ et ~ sont également autorisés ; par exemple,
abranch:apatch~2 est le grand-parent du commit qui est le patch apatch sur la branche
une branche.

Au lieu d'un nom de patch, vous pouvez dire {base} pour faire référence à la base de la pile (le commit vient
sous le patch le plus bas); donc, abranch :{base} est la base de la pile dans la branche
une branche.

Si vous devez passer une référence StGit donnée à une commande Git, id-stg(1) le convertira en
un identifiant de commit Git pour vous.

OPTIONS

Les indicateurs d'option génériques suivants sont disponibles. Des options supplémentaires sont disponibles pour
(et documenté avec) les différentes sous-commandes.

--version
Imprime la version StGit, ainsi que la version des autres composants utilisés, tels que Git et
python.

--Aidez-moi
Imprime le synopsis et une liste de toutes les sous-commandes. Si une sous-commande StGit est donnée,
imprime le résumé de cette sous-commande.

STGIT COMMANDES

Nous divisons les commandes StGit en groupes thématiques, selon le type principal d'objet qu'elles
créer ou modifier.

Voici une brève description de chaque commande. Une description plus détaillée est disponible dans
pages de manuel de commandes individuelles. Ces pages de manuel sont nommées stg- (1).

Dépôt commandes
clone stg(1)
Faire un clone local d'un dépôt distant

id-stg(1)
Imprimer la valeur de hachage git d'une référence StGit

Stack (branche) commandes
stg-branche(1)
Opérations de branche : basculer, lister, créer, renommer, supprimer, ...

stg-nettoyer(1)
Supprimer les patchs vides de la série

stg-commit(1)
Stockez de manière permanente les correctifs appliqués dans la base de la pile

flotteur stg(1)
Poussez les patchs vers le haut, même s'ils sont appliqués

stg-aller à(1)
Push ou pop patchs sur celui donné

stg-masquer(1)
Cacher un patch dans la série

stg-init(1)
Initialiser la branche actuelle à utiliser avec StGIT

journal stg(1)
Afficher le journal des modifications du correctif

stg-suivant(1)
Imprimer le nom du prochain patch

correctifs-stg(1)
Afficher les correctifs appliqués modifiant un fichier

stg-pop(1)
Extrayez un ou plusieurs patchs de la pile

stg-précédent(1)
Imprimer le nom du patch précédent

stg-publier(1)
Transférer les modifications de la pile vers une branche compatible avec la fusion

stg-tirer(1)
Extraire les modifications d'un référentiel distant

stg-pousser(1)
Poussez un ou plusieurs patchs sur la pile

stg-rebase(1)
Déplacer la base de la pile vers un autre point de l'histoire

stg-refaire(1)
Annuler la dernière opération d'annulation

stg-réparation(1)
Corrige les métadonnées StGit si la branche a été modifiée avec les commandes git

stg-réinitialisation(1)
Réinitialiser la pile de correctifs à un état antérieur

série stg(1)
Imprimer la série de patchs

stg-évier(1)
Envoyez des correctifs plus loin dans la pile

stg-squash(1)
Écraser deux patchs ou plus en un seul

stg-haut(1)
Imprimer le nom du patch supérieur

stg-désengager(1)
Transformez les commits git réguliers en correctifs StGit

stg-annuler(1)
Annuler la dernière opération

stg-afficher(1)
Afficher un patch caché

Pièce commandes
stg-supprimer(1)
Supprimer les correctifs

stg-modifier(1)
Modifier une description ou une différence de correctif

stg-export(1)
Exporter les correctifs vers un répertoire

fichiers-stg(1)
Afficher les fichiers modifiés par un patch (ou le patch en cours)

pli stg(1)
Intégrer un correctif GNU diff dans le correctif actuel

stg-importation(1)
Importer un fichier GNU diff en tant que nouveau correctif

stg-mail(1)
Envoyer un patch ou une série de patchs par e-mail

stg-nouveau(1)
Créer un nouveau patch vide

stg-choisir(1)
Importer un patch d'une autre branche ou d'un objet commit

stg-rafraîchir(1)
Générer un nouveau commit pour le patch actuel

stg-renommer(1)
Renommer un patch

stg-show(1)
Afficher le commit correspondant à un patch

synchronisation stg(1)
Synchroniser les patchs avec une branche ou une série

Index/arbre de travail commandes
stg-diff(1)
Afficher l'arbre diff

CONFIGURATION MÉCANISME

StGit utilise le même mécanisme de configuration que Git. Voir jet(7) pour plus de détails.

MODÈLES

Un certain nombre de commandes StGit utilisent des fichiers modèles pour fournir des textes par défaut utiles à
être édité par l'utilisateur. Ces Les fichiers de modèle .tmpl sont recherchés dans ce qui suit
répertoires :

1. $GITDIR/ (en pratique, le répertoire .git/ dans votre référentiel)

2. $HOME/.stgit/templates/

3. /usr/share/stgit/templates/

NOTES

1. le tutoriel
[définir $man.base.url.for.relative.links]/tutorial.html

Utiliser stg en ligne à l'aide des services onworks.net