Comment accéder aux commutateurs de commande dans Magit

17

La plupart des magitcommandes sont appelées avec une seule touche, qui fait apparaître un menu de sous-commandes et de commutateurs. Par exemple, Paffiche Pet en ttant que sous-commandes et -fet en -utant que «commutateurs».

Frapper les lettres pour les sous-commandes les appelle, mais comment invoquer les commutateurs? J'ai un référentiel avec deux télécommandes, et je voulais pousser vers l'autre télécommande. Le -ucommutateur ressemble à la chose, mais si je tape P -u, il -udevient rouge, mais Magit ne demande pas la télécommande.

Le manuel ne dit rien sur ces commutateurs pour aucune des commandes pour autant que je sache.

Quelqu'un pourrait-il expliquer comment ces commutateurs sont utilisés en général. Je ne suis pas seulement concerné par ce commutateur particulier, mais par l'installation en général.

ddoherty
la source
4
Pour pousser vers une télécommande, ajoutez un argument de préfixe avant d'appuyer sur P P.
Tu Do
tout en appuyant sur la ?touche depuis Magit est utile pour afficher le menu, certaines touches ne sont toujours pas là. Par exemple, essayez l hde reflog. Donc, je suis d'accord avec vous qu'un menu / aide plus complet est toujours nécessaire.
doctorat le

Réponses:

13

La façon dont vous activez les commutateurs est correcte, comme en témoigne le fait qu'ils "deviennent rouges" lorsque vous appuyez, -suivi d'une lettre.

Dans votre cas, ce -un'est tout simplement pas le commutateur que vous souhaitez. De man git-push:

-u, --set-upstream

Pour chaque branche mise à jour ou poussée avec succès, ajoutez une référence en amont (suivi), utilisée par les commandes sans argument git-pull(1) et d'autres commandes. Pour plus d'informations, voir branch.<name>.merge dans git-config(1).

Donc, lorsque vous poussez avec le -ucommutateur activé, vous verrez quelque chose comme ça dans le *magit-process*tampon:

0 git --no-pager -c core.preloadindex=true push -v origin foo:refs/heads/foo -u

Pousser vers https://example.com/project.git

Compter les objets: 15, c'est fait. [...].

Branche foo configurée pour suivre la branche distante foo depuis l'origine. [...]

Cela vous indique que Magit a en fait envisagé le -uchangement.


Comme le souligne @TuDo, pour que Magit vous invite à envoyer une télécommande, vous devez appuyer sur C-u P P.


Commutateurs et args

En général, lorsque vous traitez avec les menus que Magit propose pour différentes commandes, il est utile de se rappeler que les commutateurs ne sont que cela: des commutateurs . Vous pouvez les activer et les désactiver, et c'est tout. Ils ne vous demandent pas de fournir des informations supplémentaires, donc Magit ne vous demandera rien lorsque vous les activerez.

Les args, en revanche, nécessitent des informations supplémentaires, donc lorsque vous dites à Magit que vous souhaitez exécuter une commande avec un argument spécifique, vous serez invité en conséquence. Les args diffèrent également des commutateurs en ce qu'ils sont activés en appuyant sur =suivi d'une lettre.

itsjeyd
la source