forked from git/git-scm.com
-
Notifications
You must be signed in to change notification settings - Fork 8
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
dscho
committed
Oct 11, 2023
1 parent
b2825d8
commit 94a0fdc
Showing
576 changed files
with
96,989 additions
and
3,435 deletions.
There are no files selected for viewing
424 changes: 424 additions & 0 deletions
424
_generated-asciidoc/001e1a38c7517e99be9f40169a4fa5c2f0e7edc7
Large diffs are not rendered by default.
Oops, something went wrong.
89 changes: 89 additions & 0 deletions
89
_generated-asciidoc/00e6c7a21bf16985e6ebb50d2dee94a70dc6d091
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,89 @@ | ||
git-gui(1) | ||
========== | ||
|
||
NOM | ||
--- | ||
git-gui - Une interface graphique portable pour Git | ||
|
||
SYNOPSIS | ||
-------- | ||
[verse] | ||
'git gui' [<commande>] [<arguments>] | ||
|
||
DESCRIPTION | ||
----------- | ||
Interface graphique de Git basée sur Tcl/Tk. 'git gui' permet aux utilisateurs d'apporter des modifications à leur dépôt en faisant de nouveaux commits, en modifiant les commits existants, en créant des branches, en effectuant des fusions locales, et en récupérant/poussant vers des dépôts distants. | ||
|
||
Contrairement à 'gitk', 'git gui' se concentre sur la génération de commit et l'annotation de fichiers uniques et n'affiche pas l'historique du projet. Il fournit cependant des actions de menu pour démarrer une session 'gitk' à partir de 'git gui'. | ||
|
||
'git gui' est connu pour fonctionner sur tous les systèmes UNIX courants, Mac OS X et Windows (sous Cygwin et MSYS). Dans la mesure du possible, les directives d'interface utilisateur spécifiques au système d'exploitation sont respectées, ce qui fait de 'git gui' une interface relativement native pour les utilisateurs. | ||
|
||
COMMANDES | ||
--------- | ||
blâmer:: | ||
Lancer un visualiseur de blâme sur le fichier spécifié dans la version donnée (ou dans le répertoire de travail s'il n'est pas spécifié). | ||
|
||
browser:: | ||
Lance un navigateur d'arborescence affichant tous les fichiers du commit spécifié. Les fichiers sélectionnés dans le navigateur sont ouverts dans le visualiseur de blâme. | ||
|
||
citool:: | ||
Lancer 'git gui' et faire en sorte d'effectuer exactement un commit avant de quitter l'application et de revenir à l'interpréteur de commandes. L'interface est limitée aux actions de validation, ce qui réduit légèrement le temps de démarrage de l'application et simplifie la barre de menus. | ||
|
||
version:: | ||
Afficher la version en cours de 'git gui'. | ||
|
||
|
||
Exemples | ||
-------- | ||
`git gui blame Makefile`:: | ||
|
||
Afficher le contenu du fichier "Makefile" dans le répertoire de travail actuel, et fournir des annotations à la fois pour l'auteur original de chaque ligne, et pour la personne qui a déplacé la ligne à son emplacement actuel. Le fichier non validé est annoté, et les modifications non validées (s'il y en a) sont explicitement attribuées à "Pas encore validé". | ||
|
||
`git gui blame v0.99.8 Makefile`:: | ||
|
||
Montrer le contenu de "Makefile" dans la révision "v0.99.8" et fournir des annotations pour chaque ligne. Contrairement à l'exemple précédent, le fichier est lu à partir de la base de données des objets et non du répertoire de travail. | ||
|
||
`git gui blame --line=100 Makefile`:: | ||
|
||
Charger les annotations comme décrit ci-dessus et faire défiler automatiquement la vue pour la centrer sur la ligne '100'. | ||
|
||
`git gui citool`:: | ||
|
||
Effectuer une validation et revenir à l'interpréteur de commandes lorsqu'elle est terminée. Cette commande renvoie un code de sortie non nul si la fenêtre a été fermée d'une autre manière qu'en effectuant une validation. | ||
|
||
`git gui citool --amend`:: | ||
|
||
Entrer automatiquement dans le mode "Modifier le dernier engagement" de l'interface. | ||
|
||
`git gui citool --nocommit`:: | ||
|
||
Se comporter comme un citool normal, mais au lieu de faire un commit, se terminer simplement avec un code de sortie nul. Il vérifie toujours que l'index ne contient pas d'entrées non fusionnées, vous pouvez donc l'utiliser comme une version graphique de linkgit:git-mergetool[1] | ||
|
||
`git citool`:: | ||
|
||
Identique à `git gui citool` (ci-dessus). | ||
|
||
`git gui browser maint`:: | ||
|
||
Afficher un navigateur pour l'arbre de la branche 'maint'. Les fichiers sélectionnés dans le navigateur peuvent être visualisés à l'aide de la visionneuse interne de blâmes. | ||
|
||
VOIR AUSSI | ||
---------- | ||
linkgit:gitk[1]:: | ||
L'explorateur du dépôt Git. Affiche les branches, l'historique des commits et les différences entre les fichiers. gitk est l'utilitaire lancé par les actions de visualisation du dépôt de 'git gui'. | ||
|
||
Autre | ||
----- | ||
'git gui' est en fait un projet indépendant, mais des versions stables sont distribuées dans le cadre de la suite Git pour la commodité des utilisateurs finaux. | ||
|
||
Le dépôt officiel du projet 'git gui' se trouve à l'adresse suivante : | ||
|
||
https://github.com/prati0100/git-gui.git/ | ||
|
||
GIT | ||
--- | ||
Fait partie de la suite linkgit:git[1] | ||
|
||
TRADUCTION | ||
---------- | ||
Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n . |
157 changes: 157 additions & 0 deletions
157
_generated-asciidoc/0113e67071a522cbf423acf7001668848bc6e5c3
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,157 @@ | ||
git-restore(1) | ||
============== | ||
|
||
名称 | ||
-- | ||
git-restore - 恢复工作树文件 | ||
|
||
概述 | ||
-- | ||
[verse] | ||
'git restore' [<options>] [--source=<tree>] [--staged] [--worktree] [--] <pathspec>... | ||
'git restore' [<options>] [--source=<tree>] [--staged] [--worktree] --pathspec-from-file=<file> [--pathspec-file-nul] 。 | ||
'git restore' (-p|--patch) [<options>] [--source=<tree>] [--staged] [--worktree] [--] [<pathspec>...] | ||
|
||
描述 | ||
-- | ||
用还原源的一些内容还原工作树中的指定路径。如果一个路径被跟踪,但在还原源中不存在,它将被删除以匹配源。 | ||
|
||
该命令还可以用来用`--staged`恢复索引中的内容,或者用`--staged --worktree`同时恢复工作树和索引。 | ||
|
||
默认情况下,如果给了`--staged`,内容将从`HEAD`恢复,否则从索引恢复。使用`--source`来恢复不同的提交。 | ||
|
||
关于这三个命令的区别,见linkgit:git[1]中的 "重置、恢复和还原"。 | ||
|
||
这个命令是试验性的。其行为可能会改变。 | ||
|
||
选项 | ||
-- | ||
-s <tree>:: | ||
--source=<tree>(来源)。:: | ||
用给定树的内容恢复工作树的文件。通常是通过命名与之相关的提交、分支或标签来指定源树。 | ||
+ | ||
如果没有指定,如果给了`--staged`,则从`HEAD`恢复内容,否则从索引恢复。 | ||
+ | ||
作为一种特殊情况,如果正好有一个合并基数,你可以使用`"A...B "作为`A`和`B`的合并基数的快捷方式。你最多可以漏掉`A`和`B`中的一个,在这种情况下,它默认为`HEAD`。 | ||
|
||
-p:: | ||
--patch:: | ||
交互式地选择还原源和还原位置之间的差异中的猎物。参见 linkgit:git-add[1] 的 "互动模式 "部分,了解如何操作"--补丁 "模式。 | ||
+ | ||
请注意,`--patch`可以不接受任何pathspec,并会提示恢复所有修改的路径。 | ||
|
||
-W:: | ||
--worktree:: | ||
-S:: | ||
--staged:: | ||
指定恢复的位置。如果两个选项都没有指定,默认情况下会还原工作树。指定`--staged`将只恢复索引。指定两个选项将同时还原。 | ||
|
||
-q:: | ||
--quiet:: | ||
安静,抑制反馈信息。意味着"--没有进展"。 | ||
|
||
--progress:: | ||
--no-progress:: | ||
当它附加到终端时,除非指定 `--quiet`,否则默认情况下会在标准错误流中报告进度状态。这个标志可以启用进度报告,即使没有附在到终端,而不管 `--quiet`。 | ||
|
||
--ours:: | ||
--theirs:: | ||
当从索引中恢复工作树中的文件时,对未合并的路径使用阶段#2('我们的')或#3('他们的')。 | ||
+ | ||
注意,在`git rebase`和`git pull --rebase`过程中,'我们的'和'他们的'可能会出现互换。详见 linkgit:git-checkout[1] 中对相同选项的解释。 | ||
|
||
-m:: | ||
--merge:: | ||
当从索引恢复工作树上的文件时,在未合并的路径中重新创建冲突的合并。 | ||
|
||
--conflict=<style>:: | ||
The same as `--merge` option above, but changes the way the conflicting hunks are presented, overriding the `merge.conflictStyle` configuration variable. Possible values are "merge" (default), "diff3", and "zdiff3". | ||
|
||
--ignore-unmerged:: | ||
当从索引中恢复工作树上的文件时,如果有未合并的条目,并且没有指定`--我们的`、`--他们的`、`--合并`或`--冲突`,不要中止操作。工作树上未合并的路径将被忽略。 | ||
|
||
--ignore-skip-worktree-bits:: | ||
在稀疏检出模式下,默认情况下只更新由`<pathspec>`和$GIT_DIR/info/sparse-checkout中稀疏模式匹配的条目。这个选项忽略了稀疏模式,无条件地恢复了`<pathspec>`中的任何文件。 | ||
|
||
--recurse-submodules:: | ||
--no-recurse-submodules:: | ||
如果`<pathspec>`命名了一个活动的子模块,并且恢复的位置包括工作树,只有在给出这个选项的情况下,子模块才会被更新,在这种情况下,它的工作树将被恢复到超级项目中记录的提交,并且任何本地修改都会被覆盖。如果什么都不使用(或`--no-recurse-submodules`),子模块的工作树将不会被更新。就像linkgit:git-checkout[1],这将分离子模块的`HEAD`。 | ||
|
||
--overlay:: | ||
--no-overlay:: | ||
在覆盖模式下,该命令在恢复时不会删除文件。在无覆盖模式下,不出现在"--源 "树中的被追踪文件会被删除,以使它们与"<tree>"完全匹配。默认是无覆盖模式。 | ||
|
||
--pathspec-from-file=<file>:: | ||
Pathspec在 `<file>` 中传递,而不是在命令行参数中传递。如果 `<file>` 正好是 `-`,则使用标准输入。Pathspec 元素由 LF 或 CR/LF 分隔。可以引用配置变量 `core.quotePath` 的 Pathspec 元素(请参见 linkgit:git-config[1])。另请参见 `--pathspec-file-nul `和全局 `--literal-pathspecs`。 | ||
|
||
--pathspec-file-nul:: | ||
Only meaningful with `--pathspec-from-file`. Pathspec elements are separated with NUL character and all other characters are taken literally (including newlines and quotes). | ||
|
||
\--:: | ||
不将之后的参数解释为选项。 | ||
|
||
<pathspec>...:: | ||
限制受操作影响的路径。 | ||
+ | ||
更多细节请参见 linkgit:gitglossary[7] 中的 '路径规范' 条目。 | ||
|
||
实例 | ||
-- | ||
|
||
下面的序列切换到 "master "分支,将 "Makefile "恢复到两个修订版,错误地删除了hello.c,并从索引中取回它。 | ||
|
||
------------ | ||
$ git switch master | ||
$ git restore --source master~2 Makefile <1> | ||
$ rm -f hello.c | ||
$ git restore hello.c <2> | ||
------------ | ||
|
||
<1> 将一个文件从另一个提交中取出 | ||
<2> 从索引中恢复 hello.c | ||
|
||
如果你想恢复_所有的C源文件,使之与索引中的版本一致,你可以说 | ||
|
||
------------ | ||
$ git restore '*.c' | ||
------------ | ||
|
||
注意 "*.c "周围的引号。 文件`hello.c`也将被恢复,尽管它已经不在工作树中了,因为文件globbing是用来匹配索引中的条目的(不是由shell在工作树中)。 | ||
|
||
要恢复当前目录下的所有文件 | ||
|
||
------------ | ||
$ git restore . | ||
------------ | ||
|
||
或者用'top'pathspec魔法恢复所有工作树文件(见linkgit:gitglossary[7])。 | ||
|
||
------------ | ||
$ git restore :/ | ||
------------ | ||
|
||
将索引中的文件恢复到与`HEAD`中的版本一致(这与使用linkgit:git-reset[1]相同)。 | ||
|
||
------------ | ||
$ git restore --staged hello.c | ||
------------ | ||
|
||
或者你可以同时恢复索引和工作树(这与使用linkgit:git-checkout[1]相同)。 | ||
|
||
------------ | ||
$ git restore --source=HEAD --staged --worktree hello.c | ||
------------ | ||
|
||
或更实用但可读性较差的简短形式。 | ||
|
||
------------ | ||
$ git restore -s@ -SW hello.c | ||
------------ | ||
|
||
参见 | ||
-- | ||
linkgit:git-checkout[1], linkgit:git-reset[1] | ||
|
||
GIT | ||
--- | ||
属于 linkgit:git[1] 文档 |
Oops, something went wrong.