Skip to content

Commit 92f9022

Browse files
author
dscho
committed
Update translated manual pages
Updated via the `update-translated-manual-pages.yml` GitHub workflow.
1 parent fdcb992 commit 92f9022

File tree

232 files changed

+47268
-1178
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

232 files changed

+47268
-1178
lines changed
Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
git-annotate(1)
2+
===============
3+
4+
名称
5+
--
6+
git-annotate - 用提交信息注释文件行
7+
8+
概述
9+
--
10+
[verse]
11+
'git annotate' [<选项>] [<修订选项>] [<修订>] [--] <文件>
12+
13+
描述
14+
--
15+
用引入该行的提交信息来注释给定文件中的每一行。也可以选择从给定的修订版中进行注释。
16+
17+
这个命令和 linkgit:git-blame[1] 的唯一区别是,它们使用的输出格式略有不同,这个命令的存在只是为了向后兼容,以支持现有的脚本,并为来自其他 SCM 系统的人提供一个更熟悉的命令名称。
18+
19+
选项
20+
--
21+
-b::
22+
为边界提交显示空白的 SHA-1。 这也可以通过 `blame.blankBoundary` 配置选项来控制。
23+
24+
--root::
25+
不把根提交当作边界。 这也可以通过 `blame.showRoot` 配置选项来控制。
26+
27+
--show-stats::
28+
在历史追溯输出的结尾处包括额外的统计数据。
29+
30+
-L <start>,<end>::
31+
-L :<funcname>::
32+
仅注释由'<start>,<end>'或功能名称正则表达式'<funcname>'给出的行范围。 可以指定多次。 允许重叠范围。
33+
+
34+
'<start>' 和 '<end>' 是可选的 `-L <start>` 或 `-L <start>,` 范围从 '<start>' 到文件末尾。 `-L ,<end>` 从文件开始到 '<end>'.
35+
+
36+
'<开始>' 和 '<结束>' 可以采取这些形式之一:
37+
38+
- 数目
39+
+
40+
如果'<开始>'或'<结束>'是一个数字,它指定了一个绝对行数(行数从1开始计算)。
41+
+
42+
43+
- `/正则表达式/`
44+
+
45+
这种形式将使用与给定的 POSIX 正则表达式匹配的第一行。如果 '<start>' 是一个重词,它将从前一个 `-L` 范围的末尾开始搜索,如果有的话,则从文件的开始。 如果 '<start>' 是 `^/regex/`,它将从文件的开始搜索。 如果 '<end>' 是一个正则表达式,它将从 '<start>' 所给的行开始搜索。
46+
+
47+
48+
- +offset或-offset
49+
+
50+
这只对'<end>'有效,将指定'<start>'所给的行前或行后的数量。
51+
52+
+
53+
如果 `:<funcname>` 代替了 '<start>' 和 '<end>' ,它是一个正则表达式,表示从第一个匹配 '<funcname>' 的 funcname 行开始,直到下一个 funcname 行的范围。`:<funcname>` 从上一个 `-L` 范围的末尾开始搜索,如果有的话,则从文件的开始搜索。`^:<funcname>`从文件的开始搜索。函数名的确定方式与 `git diff` 确定补丁组头的方式相同(见 linkgit:gitattributes[5] 中的'定义自定义组头')。
54+
[]
55+
56+
-l::
57+
显示长转(默认值:关闭)。
58+
59+
-t::
60+
显示原始时间戳(默认值:关闭)。
61+
62+
-S <修订文件>::
63+
使用revs-file中的修订,而不是调用 linkgit:git-rev-list[1]。
64+
65+
--reverse <修订>..<修订>::
66+
Walk history forward instead of backward. Instead of showing the revision in which a line appeared, this shows the last revision in which a line has existed. This requires a range of revision like START..END where the path to blame exists in START. `git blame --reverse START` is taken as `git blame --reverse START..HEAD` for convenience.
67+
68+
--first-parent::
69+
在看到合并提交时只关注第一个父提交。这个选项可以用来确定某一行何时被引入某个特定的集成分支,而不是何时被引入整个历史中。
70+
71+
-p::
72+
--porcelain::
73+
以适合机器使用的格式显示。
74+
75+
--line-porcelain::
76+
显示上层命令格式,但输出每一行的提交信息,而不仅仅是第一次引用提交时的信息。 意味着 --porcelain。
77+
78+
--incremental::
79+
以适合机器使用的格式逐步显示结果。
80+
81+
--encoding=<编码>::
82+
指定用于输出作者姓名和提交摘要的编码。设置为 `none` 会使历史追溯输出未转换的数据。更多信息见 linkgit:git-log[1] 手册页中关于编码的讨论。
83+
84+
--contents <文件>::
85+
使用指定文件中的内容进行注释,如果指定了 <rev>,则从 <rev> 开始,否则从 HEAD 开始。你可以指定 '-' 来使命令从标准输入中读取文件内容。
86+
87+
--date <格式>::
88+
指定用于输出日期的格式。如果没有提供 --date,则使用 blame.date 配置变量的值。如果 blame.date 配置变量也没有设置,则使用 iso 格式。关于支持的值,请参见 linkgit:git-log[1] 中关于 --date 选项的讨论。
89+
90+
--[no-]progress::
91+
当它连接到一个终端时,默认情况下进度状态会在标准错误流中报告。这个标志可以使进度报告即使没有连接到终端。`--porcelain`或`--incremental` 不能与 `--progress` 一起使用。
92+
93+
-M[<数量>]::
94+
检测文件中移动或复制的行。当一次提交移动或复制一个行块时(例如,原始文件有 A,然后是 B,而提交将其改为 B,然后是 A),传统的 'blame' 算法只注意到一半的移动,通常将向上移动的行(即 B )归咎于父代,而将向下移动的行(即 A )归咎于子代提交。 有了这个选项,通过运行额外的检查,两组行都会被归咎于父代。
95+
+
96+
<num> 是可选的,但它是 Git 必须检测到的在文件中移动或复制的字母数字字符的数量的下限,以便它将这些行与父提交相关联。默认值是20。
97+
98+
-C[<数量>]::
99+
除了`-M`之外,还可以检测在同一提交中被修改的其他文件中移动或复制的行。 这在你重新组织程序并在不同文件间移动代码时很有用。 当这个选项被赋予两次时,命令会在创建文件的提交中额外寻找其他文件的拷贝。当这个选项出现三次时,命令会在任何一次提交中额外寻找其他文件的副本。
100+
+
101+
<num> 是可选的,但它是 Git 必须检测到的在文件之间移动或复制的字母数字字符的数量的下限,以便它将这些行与父提交关联起来。而默认值是 40。如果有一个以上的 `-C` 选项,只有最后一个 `-C` 的 <num> 参数起作用。
102+
103+
--ignore-rev <修订>::
104+
Ignore changes made by the revision when assigning blame, as if the change never happened. Lines that were changed or added by an ignored commit will be blamed on the previous commit that changed that line or nearby lines. This option may be specified multiple times to ignore more than one revision. If the `blame.markIgnoredLines` config option is set, then lines that were changed by an ignored commit and attributed to another commit will be marked with a `?` in the blame output. If the `blame.markUnblamableLines` config option is set, then those lines touched by an ignored commit that we could not attribute to another revision are marked with a '*'. In the porcelain modes, we print 'ignored' and 'unblamable' on a newline respectively.
105+
106+
--ignore-revs-file <文件>::
107+
忽略 `file` 中列出的修订,其格式必须与 `fsck.skipList` 相同。 这个选项可以重复使用,这些文件将在任何用 `blame.ignoreRevsFile` 配置选项指定的文件之后被处理。 一个空的文件名,`""`,将清除以前处理的文件的 Revs 列表。
108+
109+
--color-lines::
110+
在默认格式下,如果行注释与前一行来自同一提交,则颜色不同。这可以让我们更容易区分不同提交的代码块。颜色默认为青色,可以使用 `color.blame.repeatedLines` 配置选项进行调整。
111+
112+
--color-by-age::
113+
根据默认格式的行的阶段,给行的注释着色。 `color.blame.highlightRecent` 配置选项控制每个阶段范围使用什么颜色。
114+
115+
-h::
116+
显示帮助信息。
117+
[]
118+
119+
参见
120+
--
121+
linkgit:git-blame[1]
122+
123+
GIT
124+
---
125+
属于 linkgit:git[1] 文档
Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
git-annotate(1)
2+
===============
3+
4+
NAME
5+
----
6+
git-annotate - ファイルの行にコミット情報を注釈する
7+
8+
概要
9+
--
10+
[verse]
11+
'git annotate' [<オプション>] [<リビジョンオプション>] [<リビジョン>] [--] <ファイル>
12+
13+
説明
14+
--
15+
指定されたファイルの各行に、その行を導入したコミットからの情報で注釈を付けます。オプションで指定されたリビジョンからの注釈を付けることもできます。
16+
17+
このコマンドとlinkgit:git-blame[1]の唯一の違いは、出力形式がわずかに異なることです。このコマンドは、既存のスクリプトをサポートするための下位互換性のためだけに存在し、他のSCMシステムから来た人々により馴染みのあるコマンド名を提供します。
18+
19+
オプション
20+
-----
21+
-b::
22+
履歴の境界となるコミットの SHA-1 を空欄で表示します。この動作は `blame.blankBoundary` 設定でも切り替え可能です。
23+
24+
--root::
25+
履歴の最初のコミット(ルート)を境界として扱いません。この動作は `blame.showRoot` 設定でも切り替え可能です。
26+
27+
--show-stats::
28+
blame の出力末尾に追加の統計情報を表示します。
29+
30+
-L <開始>,<終了>::
31+
-L :<関数名>::
32+
'<開始>,<終了>' または関数名の正規表現 '<関数名>' で指定した範囲の行だけに注釈を付けます。複数回指定でき、範囲が重なっても問題ありません。
33+
+
34+
'<開始>' と '<終了>' は省略できます。`-L <開始>` または `-L <開始>,` なら '<開始>' からファイル末尾まで、`-L ,<終了>` ならファイル先頭から '<終了>' までが対象です。
35+
+
36+
37+
38+
[WARNING]
39+
====
40+
Missing `ja/line-range-format.adoc`
41+
42+
See original version for this content.
43+
====
44+
45+
[]
46+
47+
-l::
48+
完全なリビジョン(長い形式)を表示します(デフォルトは非表示)。
49+
50+
-t::
51+
生のタイムスタンプを表示します(デフォルトは非表示)。
52+
53+
-S <リビジョンファイル>::
54+
linkgit:git-rev-list[1] を使わず、指定したリビジョンファイルの内容を利用します。
55+
56+
--reverse <リビジョン>..<リビジョン>::
57+
履歴を通常とは逆に(過去から未来へ)たどります。各行が現れたリビジョンではなく、その行が最後に存在したリビジョンを表示します。START..END のようなリビジョン範囲が必要で、START に blame 対象のパスが存在している必要があります。`git blame --reverse START` は `git blame --reverse START..HEAD` と同じ意味になります。
58+
59+
--first-parent::
60+
マージコミットに出会った場合、最初の親コミットだけをたどります。これにより、全体の履歴ではなく、特定の統合ブランチに行が追加されたタイミングを調べることができます。
61+
62+
-p::
63+
--porcelain::
64+
機械処理しやすい形式で出力します。
65+
66+
--line-porcelain::
67+
porcelain フォーマットで、すべての行ごとにコミット情報を出力します(最初の参照時だけでなく全行)。--porcelain を含みます。
68+
69+
--incremental::
70+
機械処理しやすい形式で、結果を順次出力します。
71+
72+
--encoding=<エンコーディング>::
73+
著者名やコミット要約の出力エンコーディングを指定します。`none` を指定すると変換せずそのまま出力します。詳しくは linkgit:git-log[1] のエンコーディングの説明を参照してください。
74+
75+
--contents <ファイル>::
76+
指定したファイルの内容を使って注釈を付けます。<rev> を指定しない場合は HEAD から開始します。ファイル名に '-' を指定すると標準入力から内容を読み込みます。
77+
78+
--date <フォーマット>::
79+
日付の出力フォーマットを指定します。--date を指定しない場合は blame.date 設定値が使われ、設定がなければ iso 形式になります。利用可能な値は linkgit:git-log[1] の --date オプションの説明を参照してください。
80+
81+
--[no-]progress::
82+
進捗状況は、デフォルトでは標準エラー出力が端末に接続されている場合に表示されます。このフラグを指定すると、端末に接続されていなくても進捗が表示されます。`--progress` は `--porcelain` や `--incremental` と同時に使用できません。
83+
84+
-M[<数値>]::
85+
ファイル内で移動やコピーされた行を検出します。たとえば、A→B だったものが B→A になるような変更では、従来の blame では一方しか検出できませんが、このオプションを使うと両方の行を親コミットに帰属させるよう追加で検査します。
86+
+
87+
<数値>は省略可能で、Gitが移動やコピーとみなすために必要な英数字の最小文字数です。デフォルトは20です。
88+
89+
-C[<数値>]::
90+
`-M` に加えて、同じコミット内で他のファイルから移動またはコピーされた行も検出します。規模が大きいリファクタリング時に便利です。このオプションを2回指定すると、ファイルを新規作成したコミット内の他のファイルからのコピーも検出対象になります。3回指定した場合は、あらゆるコミット内の他のファイルからのコピーも検出されます。
91+
+
92+
<num> は省略可能ですが、Gitがファイル間で移動やコピーと判定するために必要な英数字の最小文字数を指定します。デフォルト値は40です。`-C` オプションが複数指定された場合、最後に指定した `-C` の <num> が有効になります。
93+
94+
--ignore-rev <リビジョン>::
95+
Ignore changes made by the revision when assigning blame, as if the change never happened. Lines that were changed or added by an ignored commit will be blamed on the previous commit that changed that line or nearby lines. This option may be specified multiple times to ignore more than one revision. If the `blame.markIgnoredLines` config option is set, then lines that were changed by an ignored commit and attributed to another commit will be marked with a `?` in the blame output. If the `blame.markUnblamableLines` config option is set, then those lines touched by an ignored commit that we could not attribute to another revision are marked with a '*'. In the porcelain modes, we print 'ignored' and 'unblamable' on a newline respectively.
96+
97+
--ignore-revs-file <ファイル>::
98+
`fsck.skipList` と同じ形式でリビジョンを列挙したファイル内のリビジョンを無視します。複数回指定でき、blame.ignoreRevsFile 設定より後に処理されます。空文字("")を指定すると、これまでに処理したリストをクリアします。
99+
100+
--color-lines::
101+
デフォルト形式で、直前の行と同じコミット由来の行を色分けします。これにより、異なるコミットによるコードブロックの区別がしやすくなります。色はデフォルトでシアンですが、 `color.blame.repeatedLines` 設定で変更できます。
102+
103+
--color-by-age::
104+
デフォルト形式で、行の古さに応じて色分けします。色の範囲は color.blame.highlightRecent 設定で調整できます。
105+
106+
-h::
107+
ヘルプを表示します。
108+
[]
109+
110+
関連項目
111+
----
112+
linkgit:git-blame[1]
113+
114+
GIT
115+
---
116+
Part of the linkgit:git[1] suite

0 commit comments

Comments
 (0)