mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-09 07:24:04 +08:00
16 lines
13 KiB
HTML
16 lines
13 KiB
HTML
<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>命名</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-show-ref - 在本地存储库中列出引用</p></div></div><div class="doc-postil"><div class="c-markdown"><p>后缀为<code>@</code>带括号的后缀（例如<code>{1}</code>，<code>{15}</code>）指定了该ref的第n个前置值。例如<code>master@{1}</code>，<code>master</code>while <code>master@{5}</code>是第5个先前值的即时先验值<code>master</code>。该后缀只能在ref名称后面使用，并且ref必须具有现有的日志（<code>$GIT_DIR/logs/<refname></code>）。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git show-ref [-q|--quiet] [--verify] [--head] [-d|--dereference] [-s|--hash[=<n>]] [--abbrev[=<n>]] [--tags] [--heads] [--] [<pattern>…]git show-ref --exclude-existing[=<pattern>]</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>显示本地存储库中可用的引用以及关联的提交ID。可以使用模式过滤结果，并可以将标记解引用到对象ID中。此外，它可以用来测试一个特定的ref是否存在。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>该构造<code>@{-<n>}</code>意味着在当前之前检出的第n个分支/提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--exclude-existing表单是一个反过来的过滤器。它从stdin中读取ref，每行一个ref，并显示那些不存在于本地存储库中的文件。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>鼓励使用此实用程序，以便直接访问目录下的<code>.git</code>文件。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p><code>@{push}</code>如果在检出时<code>git push</code>运行<code>branchname</code>（或当前<code>HEAD</code>没有指定branchname），后缀将报告分支“我们将推送到哪里” 。由于我们的推送目标位于远程存储库中，当然，我们会报告与该分支对应的本地跟踪分支（即，某处<code>refs/remotes/</code>）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这里有一个例子可以使它更加清晰：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">$ git config push.default current
|
||
|
||
$ git config remote.pushdefault myfork
|
||
|
||
$ git checkout -b mybranch origin/master
|
||
|
||
|
||
|
||
$ git rev-parse --symbolic-full-name @{upstream}refs/remotes/origin/master
|
||
|
||
|
||
|
||
$ git rev-parse --symbolic-full-name @{push}refs/remotes/myfork/mybranch</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>在示例中请注意，我们建立了一个三角形工作流程，我们从一个位置拉出并推送到另一个位置。在非三角形工作流程中，与之<code>@{push}</code>相同<code>@{upstream}</code>，并且不需要它。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当拼写成大写字母时，这个后缀也是可以接受的，无论大小写是什么意思都是相同的。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;"><rev>^</em>, e.g. <em style="font-style: italic;">HEAD^, v1.5.1^0</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>^</code>修订参数的后缀表示该提交对象的第一个父代。<code>^<n></code>意味着第n个父母（即<code><rev>^</code>相当于<code><rev>^1</code>）。作为一个特殊规则，<code><rev>^0</code>意味着提交本身，并在<code><rev></code>引用提交对象的标记对象的对象名称时使用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;"><rev>~<n></em>, e.g. <em style="font-style: italic;">master~3</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>~<n></code>修订参数的后缀表示作为指定提交对象的第n代祖先的提交对象，仅在第一个父代之后。即<code><rev>~3</code>相当于<code><rev>^^^</code>哪个相当于<code><rev>^1^1^1</code>。请参阅下面的表格来说明此表格的用法。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;"><rev>^{<type>}</em>, e.g. <em style="font-style: italic;">v0.99.8^{commit}</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个后缀<code>^</code>跟在括号内的对象类型名称意味着以<code><rev></code>递归方式解引用对象，直到<code><type></code>找到类型的对象或者对象不能被解除引用（在这种情况下，barf）。例如，如果<code><rev></code>是commit-ish，则<code><rev>^{commit}</code>描述相应的提交对象。同样，如果<code><rev></code>是树型，则<code><rev>^{tree}</code>描述相应的树型对象。<code><rev>^0</code>是短暂的<code><rev>^{commit}</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>rev^{object}</code>可以用来确定<code>rev</code>存在的对象的名称，而不需要<code>rev</code>作为标签，也不需要解引用<code>rev</code>; 因为一个标签已经是一个对象，所以即使一次到达一个对象也不需要解除引用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>rev^{tag}</code>可以用来确保<code>rev</code>识别现有的标签对象。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;"><rev>^{}</em>, e.g. <em style="font-style: italic;">v0.99.8^{}</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个后缀<code>^</code>跟一个空括号对意味着对象可以是一个标签，并递归地引用标签，直到找到一个非标签对象。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;"><rev>^{/<text>}</em>, e.g. <em style="font-style: italic;">HEAD^{/fix nasty bug}</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>后缀<code>^</code>的修正参数，其次，它包含用斜线为首的文本的一对括号，是一样的<code>:/fix nasty bug</code>下面的语法不同之处在于它返回最年轻的匹配提交其是从可到达<code><rev></code>之前<code>^</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">:/<text></em>, e.g. <em style="font-style: italic;">:/fix nasty bug</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个冒号，后跟一个斜线，后跟一个文本，命名提交消息与指定正则表达式匹配的提交。该名称返回可从任何ref访问的最年轻匹配提交。正则表达式可以匹配提交消息的任何部分。要匹配以字符串开头的消息，可以使用例如<code>:/^foo</code>。特殊序列<code>:/!</code>保留给修饰符以匹配内容。<code>:/!-foo</code>执行否定匹配，同时<code>:/!!foo</code>匹配文字<code>!</code>字符，然后匹配<code>foo</code>。任何以其他序列开始的序列<code>:/!</code>现在都被保留。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;"><rev>:<path></em>, e.g. <em style="font-style: italic;">HEAD:README</em>, <em style="font-style: italic;">:README</em>, <em style="font-style: italic;">master:./README</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个后缀<code>:</code>后面跟着一个路径的名称是由冒号前部分命名的tree-ish对象中给定路径上的blob或树。<code>:path</code>（在冒号前有一个空白部分）是下面描述的语法的特例：记录在给定路径索引处的内容。以当前工作目录开始<code>./</code>或<code>../</code>相对于当前工作目录的路径。给定的路径将被转换为相对于工作树的根目录。这对于从具有与工作树相同树结构的提交或树来处理blob或树是非常有用的。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">:<n>:<path></em>, e.g. <em style="font-style: italic;">:0:README</em>, <em style="font-style: italic;">:README</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个冒号，后跟一个阶段号（0到3）和一个冒号，后跟一个路径，在给定路径的索引中命名一个blob对象。缺少的阶段编号（以及后面的冒号）命名为0阶段编号。在合并期间，阶段1是共同的祖先，阶段2是目标分支的版本（通常是当前分支），阶段3是来自正在合并的分支的版本。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>以下是Jon Loeliger的插图。提交节点B和C都是提交节点A的父节点。父提交按从左到右的顺序排列。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">G H I J
|
||
|
||
\ / \ /
|
||
|
||
D E F
|
||
|
||
\ | / \
|
||
|
||
\ | / |
|
||
|
||
\|/ |
|
||
|
||
B C
|
||
|
||
\ /
|
||
|
||
\ /
|
||
|
||
A</pre></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">A = = A^0B = A^ = A^1 = A~1C = A^2 = A^2D = A^^ = A^1^1 = A~2E = B^2 = A^^2F = B^3 = A^^3G = A^^^ = A^1^1^1 = A~3H = D^2 = B^^2 = A^^^2 = A~2^2I = F^ = B^3^ = A^^3^J = F^2 = B^3^2 = A^^3^2</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>指定范围</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>历史遍历命令，例如<code>git log</code>对一组提交进行操作，而不仅仅是一次提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>对于这些命令，使用上一节中描述的符号来指定单个修订，意味着<code>reachable</code>来自给定提交的一组提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>提交的可达集是提交本身和祖先链中的提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><h3>提交排除</h3></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">^<rev></em> (caret) Notation</p></div></div><div class="doc-postil"><div class="c-markdown"><p>要排除提交可达的提交，使用前缀<code>^</code>符号。例如，<code>^r1 r2</code>意味着提交可达，<code>r2</code>但不包括从<code>r1</code>（即<code>r1</code>其祖先）可达的。</p></div></div><div class="doc-postil"><div class="c-markdown"><h3>虚线表示法</h3></div></div><div class="doc-postil"><div class="c-markdown"><p>The <em style="font-style: italic;">..</em> (two-dot) Range Notation</p></div></div><div class="doc-postil"><div class="c-markdown"><p>该<code>^r1 r2</code>组操作似乎经常有它的简写。当你有两个提交<code>r1</code>并且<code>r2</code>（根据上面指定版本中所述的语法命名）时，你可以要求提交从r2到达的提交，但不包括从r1到达的那些提交，<code>^r1 r2</code>它可以写为<code>r1..r2</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>The <em style="font-style: italic;">…</em> (three dot) Symmetric Difference Notation</p></div></div><div class="doc-postil"><div class="c-markdown"><p>类似的符号<code>r1...r2</code>被称为和的对称差，<code>r1</code>并被<code>r2</code>定义为<code>r1 r2 --not $(git merge-base --all r1 r2)</code>。它是从<code>r1</code>（左侧）或<code>r2</code>（右侧）中的任一个可达的提交集合，但不是来自两者。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在这两个简写符号中，可以省略一端，并将其默认为HEAD。例如，<code>origin..</code>是一个简写，<code>origin..HEAD</code>并问“自从我从原始分支分出后，我做了什么？” 同样，它<code>..origin</code>也是一种速记，<code>HEAD..origin</code>并问道：“我从他们身上分离出来后，起源究竟发生了什么？” 请注意，<code>..</code>这意味着<code>HEAD..HEAD</code>哪个空白区域可以从HEAD到达和无法到达。</p></div></div><div class="doc-postil"><div class="c-markdown"><h3>Other <rev>^ Parent Shorthand Notations</h3></div></div></div> |