hg.stevelosh.com > docs.stevelosh.com

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
  <head>
    <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />

    <title>
      hg-prompt » Keywords
    </title>

    <link rel="stylesheet" type="text/css" href="/media/css/reset.css" media="screen, projection" />
    <link rel="stylesheet" type="text/css" href="/media/css/layout.css" media="screen, projection" />
    <link rel="stylesheet" type="text/css" href="/media/css/typography.css" media="screen, projection" />
    <link rel="stylesheet" type="text/css" href="/media/css/pygments.css" media="screen, projection" />
  </head>

  <body>
    <div id="content">


        <div id="breadcrumbs">
          <p>


                  <a href="/">index</a> &#187;


                  <a href="/documentation/">documentation</a> &#187;


                  keywords


          </p>
        </div> <!-- div#breadcrumbs -->


  <h1 id="keywords">Keywords</h1>
<p>There a number of keywords available.  If you have any suggestions for more please <a href="http://bitbucket.org/sjl/hg-prompt/issues">let me know</a>.</p>
<p>Some of the keywords support filters.  These filters can be combined when it makes sense.  If in doubt, try it!</p>
<div class="toc">
<ul>
<li><a href="#keywords">Keywords</a><ul>
<li><a href="#bookmark">bookmark</a></li>
<li><a href="#branch">branch</a></li>
<li><a href="#node">node</a></li>
<li><a href="#patch">patch</a></li>
<li><a href="#rev">rev</a></li>
<li><a href="#root">root</a></li>
<li><a href="#status">status</a></li>
<li><a href="#tags">tags</a></li>
<li><a href="#task">task</a></li>
<li><a href="#tip">tip</a></li>
<li><a href="#update">update</a></li>
</ul>
</li>
</ul>
</div>
<h2 id="bookmark">bookmark</h2>
<dl>
<dd>Display the current bookmark (requires the <a href="http://mercurial.selenic.com/wiki/BookmarksExtension">bookmarks</a> extension).</dd>
</dl>
<h2 id="branch">branch</h2>
<dl>
<dd>Display the current branch.</dd>
</dl>
<h2 id="node">node</h2>
<dl>
<dd>
<p>Display the (full) changeset hash of the current parent.</p>
<dl>
<dt>|short</dt>
<dd>Display the hash as the short, 12-character form.</dd>
<dt>|merge</dt>
<dd>Display the hash of the changeset you're merging with.</dd>
</dl>
</dd>
</dl>
<h2 id="patch">patch</h2>
<dl>
<dd>
<p>Display the topmost currently-applied patch (requires the <a href="http://mercurial.selenic.com/wiki/MqExtension">mq</a>
extension).</p>
<dl>
<dt>|count</dt>
<dd>Display the number of patches in the queue.</dd>
<dt>|applied</dt>
<dd>Display the number of currently applied patches in the queue.</dd>
<dt>|unapplied</dt>
<dd>Display the number of currently unapplied patches in the queue.</dd>
</dl>
</dd>
</dl>
<h2 id="rev">rev</h2>
<dl>
<dd>
<p>Display the repository-local changeset number of the current parent.</p>
<dl>
<dt>|merge</dt>
<dd>Display the repository-local changeset number of the changeset you're
merging with.</dd>
</dl>
</dd>
</dl>
<h2 id="root">root</h2>
<dl>
<dd>
<p>Display the full path to the root of the current repository, without a
trailing slash.</p>
<dl>
<dt>|basename</dt>
<dd>Display the directory name of the root of the current repository. For
example, if the repository is in <code>/home/u/myrepo</code> then this keyword
would expand to <code>myrepo</code>.</dd>
</dl>
</dd>
</dl>
<h2 id="status">status</h2>
<dl>
<dd>
<p>Display <code>!</code> if the repository has any changed/added/removed files,
otherwise <code>?</code> if it has any untracked (but not ignored) files, otherwise
nothing.</p>
<dl>
<dt>|modified</dt>
<dd>Display <code>!</code> if the current repository contains files that have been
modified, added, removed, or deleted, otherwise nothing.</dd>
<dt>|unknown</dt>
<dd>Display <code>?</code> if the current repository contains untracked files,
otherwise nothing.</dd>
</dl>
</dd>
</dl>
<h2 id="tags">tags</h2>
<dl>
<dd>
<p>Display the tags of the current parent, separated by a space.</p>
<dl>
<dt>|SEP</dt>
<dd>Display the tags of the current parent, separated by <code>SEP</code>.</dd>
</dl>
</dd>
</dl>
<h2 id="task">task</h2>
<dl>
<dd>Display the current task (requires the <a href="http://bitbucket.org/alu/hgtasks/wiki/Home">tasks</a> extension).</dd>
</dl>
<h2 id="tip">tip</h2>
<dl>
<dd>
<p>Display the repository-local changeset number of the current tip.</p>
<dl>
<dt>|node</dt>
<dd>Display the (full) changeset hash of the current tip.</dd>
<dt>|short</dt>
<dd>Display a short form of the changeset hash of the current tip (must be
used with the <strong>|node</strong> filter)</dd>
</dl>
</dd>
</dl>
<h2 id="update">update</h2>
<dl>
<dd>Display <code>^</code> if the current parent is not the tip of the current branch,
otherwise nothing.  In effect, this lets you see if running <code>hg update</code>
would do something.</dd>
</dl>


      <p id="footer">

          hg-prompt &mdash;

        Powered by <a href="http://bitbucket.org/zacharyvoase/markdoc">Markdoc</a>.
      </p>

    </div> <!-- div#content -->
  </body>
</html>
author	Steve Losh <steve@stevelosh.com>
date	Wed, 18 Nov 2009 20:48:00 -0500
parents	(none)
children	d72a55aed48f