HG(1)

=====

Matt Mackall <mpm@selenic.com>

名前

--

hg - Mercurial ソースコード管理システム

書式

--

'hg' [-v -d -q -y] <command> [command options] [files]

説明

--

hg(1) コマンドは Mercurial システムへのコマンドラインインターフェ

イスを提供します。

オプション

----

-R, --repository::

    リポジトリのルートディレクトリを指定します。

--cwd::

    作業ディレクトリを変更します。

-y, --noninteractive::

    プロンプトを出さずに、要求された答えが全て 'yes' であると仮定

    します。

-q, --quiet::

    出力を抑制します。

-v, --verbose::

    さらなる出力を可能にします。

7--debug::

    デバッグ出力を可能にします。

--traceback::

    例外時にトレースバックを表示します。

--time::

    コマンドにどのくらい時間がかかるかを表示します。

--profile::

    コマンドを実行したときのプロファイルを表示します。

--version::

    バージョン情報を表示して終了します。

-h, --help::

    ヘルプを表示して終了します。

コマンドの要素

-------

files ...::

    1つ以上のファイル名か相対的なパスを表します; パターンマッチン

    グの情報は「ファイル名のパターン」を参照してください。

path::

    ローカルマシン上のパスを表します

revision::

    チェンジセットのリビジョンナンバー, タグ, チェンジセットのハッ

    シュ値のユニークな部分文字列により指定できるチェンジセットを表

    します

repository path::

    ローカルのリポジトリのパス名かリモートのリポジトリの URI を表

    します。URI のプロトコルとしては現在 2 つが利用可能です。

    http:// は高速で、static-http:// は遅いですがウェブのホストに特別

    なサーバを必要としません。

コマンド

----

add [options] [files ...]::

    ファイルをバージョン管理下に置きリポジトリに追加することを予定

    します。

    ファイルは次にコミット時にリポジトリに追加されます。

    ファイル名が与えられなければ、現在のディレクトリとサブディレク

    トリの全てのファイルを追加します。

addremove [options] [files ...]::

    新しいファイルを全て追加し無くなったファイルを全てリポジトリか

    ら取り除きます。

    新しいファイルは .hgignore 中のパターンにマッチした場合無視さ

    れます。add のようにこの変更は次のコミット時に効果を持ちます。

annotate [-r <rev> -u -n -c] [files ...]::

    ファイル中の変更を列挙し、各行の原因であるリビジョン id を表示

    します。

    このコマンドある変更が生じた際に誰がその変更をしたかを発見する

    のに役に立ちます。

    -a オプションが無いと、annotate はバイナリとして検出されたファ

    イルを避けるようになります。-a があると、annotate はとくかく注

    釈を生成し、おそらく望ましくない結果になるでしょう。

    オプション:

    -a, --text            全てのファイルをテキストとして扱います

    -I, --include <pat>   与えられたパターンにマッチした名前を含め

                          ます

    -X, --exclude <pat>   与えられたパターンにマッチした名前を除外

                          します

    -r, --revision <rev>  指定されたリビジョンの注釈を生成します

    -u, --user            著者を列挙します

    -c, --changeset       チェンジセットを列挙します

    -n, --number          リビジョンナンバーを列挙します

                          (デフォルト)

bundle <file> <other>::

    (実験的)

    他のリポジトリには見付からなかった全てのチェンジセットを集めた、

    圧縮済みチェンジグループファイルを生成します。

    このファイルは従来の方法で転送することができ、他のリポジトリに

    unbundle コマンドで適用できます。これは push と pull が使えな

    いか、リポジトリ全体をエクスポートしてしまうことが望ましくない

    ときに便利です。標準のファイル拡張子は ".hg" です。

    import/export と違って、これはパーミッション、名前変更のデータ、

    リビジョンの履歴を含めたチェンジセットの内容全てを保存します。

cat [options] <file ...>::

    指定されたファイルを与えられたリビジョンの内容で表示します。リ

    ビジョンが指定されなかった場合は tip が使われます。

    出力はファイルに対しても可能です。その場合、ファイル名はフォー

    マット文字列により指定されます。フォーマット規則は export コマ

    ンドと同じですが、さらに次のものが追加されます。

    %s   出力されるファイルのベース名

    %d   出力されるファイルのディレクトリ名か、リポジトリのルート

         にいる場合は "."

    %p   出力されるファイルのルートからの相対パス

    オプション:

    -I, --include <pat>       与えられたパターンにマッチした名前

                              を含めます

    -X, --exclude <pat>       与えられたパターンにマッチした名前

                              を除外します

    -o, --output <filespec>   整形された名前でファイルに出力しま

                              す

    -r, --rev <rev>           与えられたリビジョンを表示します

clone [-U] <source> [dest]::

    既存のリポジトリのコピーを新しいディレクトリに作成します

    コピー先のディレクトリ名が指定されなければ、デフォルトでソース

    のベース名を使用します。

    今後の pull に使えるように、コピー元が新しいリポジトリの

    .hg/hgrc に追加されます。

    効率のために、コピー元とコピー先が同じファイルシステム上にある

    場合はハードリンクが使われます。

    オプションン:

    -U, --noupdate   新しい作業ディレクトリで update を行いません

    -e, --ssh        使用される ssh コマンドを指定します

    --remotecmd      リモート側で実行する hg コマンドを指定します

commit [options] [files...]::

    指定されたファイルの変更をリポジトリにコミットします。

    もしファイルのリストが省略されたら、リポジトリのルートから実行

    した"hg status" で報告される全ての変更がコミットされます。

    HGEDITOR や EDITOR 環境変数はコミット時のコメントを追加するエ

    ディタを起動するために使われます。

    オプション:

    -A, --addremove       コミット中に addremove を実行します

    -I, --include <pat>   与えられたパターンにマッチした名前を含め

                          ます

    -X, --exclude <pat>   与えられたパターンにマッチした名前を除外

                          します

    -m, --message <text>  <text> をコミットメッセージとして使いま

                          す

    -l, --logfile <file>  <file> からコミットメッセージを読み込み

                          ます

    -d, --date <datecode> datecode をコミットした日付として記録し

                          ます

    -u, --user <user>     user をコミッタとして記録します。

    別名: ci

copy <source ...> <dest>::

    コピー先がコピー元のファイルのコピーを持っていると印を付けます。

    もしコピー先がディレクトリなら、コピーはディレクトリ中に置かれ

    ます。もしコピー先がファイルなら、コピー元は1つのみ指定可能で

    す。

    デフォルトでは、このコマンドはファイルがその作業ディレクトリに

    あるものとしてその内容をコピーします。もし --after と一緒に呼

    び出されれば、操作は記録されますが、コピーは実行されません。

    このコマンドは次のコミット時に効果を持ちます。

    注意: このコマンドは実験的です。リネームされたファイルを適切に

    記録できますが、この情報はマージによってまだ完全には使われませ

    んし、ログで完全に報告されることもありません。

    オプション:

    -A, --after           既に発生したコピーを記録します。

    -I, --include <pat>   与えられたパターンにマッチした名前を含め

                          ます

    -X, --exclude <pat>   与えられたパターンにマッチした名前を除外

                          します

    -f, --force           既存の変更されたファイルに無理矢理コピー

                          します

    -p, --parents         コピー先にコピー元のパスを追加します

    別名: cp

diff [-a] [-r revision] [-r revision] [files ...]::

    指定されたファイルのリビジョン間の差分を表示します。

    ファイル間の差分は unified diff 形式で表示されます。

    2つのリビジョンが引数として指定された場合、それらのリビジョン

    間の差分が表示されます。1つのリビジョンしか指定されなければ、

    そのリビジョンは作業ディレクトリと比較されます。そして リビジョ

    ンが指定されなければ、作業ディレクトリのファイルがその親と比較

    されます。

    -a オプション無しでは、diff はバイナリファイルを検出したときに

    その差分を生成するのを避けます。-a オプションでは、diff はとに

    かく差分を生成し、恐らく望ましくない結果をもたらすでしょう。

    オプション:

    -a, --text           全てのファイルをテキストとして扱います

    -I, --include <pat>  与えられたパターンにマッチした名前を含め

                         ます

    -X, --exclude <pat>  与えられたパターンにマッチした名前を除外

                         します

export [-o filespec] [revision] ...::

    1つ以上のリビジョンのチェンジセットのヘッダと差分を出力します。

    チェンジセットのヘッダに表示される情報は: 著者、チェンジセット

    のハッシュ、親、コミット時のコメントです。

    出力はファイルに対しても可能です。その場合、ファイル名はフォー

    マット文字列により指定されます。フォーマット規則は下記の通りで

    す:

    %%   そのままの "%" 文字

    %H   チェンジセットのハッシュ (40 バイトの 16 進数)

    %N   生成されているパッチの番号

    %R   チェンジセットのリビジョンナンバー

    %b   エクスポートしているリポジトリのメース名

    %h   短い形式のチェンジセットのハッシュ (12 バイトの 16 進数)

    %n   0 で 詰められた 1 から始まる連番

    %r   0 で 詰められたリビジョンナンバー

    -a オプション無しでは、diff はバイナリファイルを検出したときに

    その差分を生成するのを避けます。-a オプションでは、diff はとに

    かく差分を生成し、恐らく望ましくない結果をもたらすでしょう。

    オプション:

    -a, --text                全てのファイルをテキストとして扱います

    -o, --output <filespec>   整形された名前でファイルに出力します

forget [options] [files]::

    次のコミット時に予定された 'hg add' を取り消します。

    オプション:

    -I, --include <pat> 与えられたパターンにマッチした名前を含めま

    -すX, --exclude <pat> 与えられたパターンにマッチした名前を除外

    -します

grep [options] pattern [files]::

    正規表現によりファイルのリビジョンを検索します。

    このコマンドは Unix の grep とは違う振舞いをします。これは

    Python/Perl の正規表現だけを受けつけます。これは作業ディレクト

    リではなくリポジトリの履歴を検索します。これは常にマッチしたも

    のが現れたリビジョンナンバーを表示します。

    デフォルトでは、grep はマッチしたものが見つかったファイルの最

    初のリビジョンを出力します。マッチ状況の変化("-" はマッチが非

    マッチに、"+" は非マッチがマッチに)を含んだ各リビジョンを表示

    するには、--all フラグを使ってください。

    オプション:

    -0, --print0              ファイル名を NUL で終えます。

    -I, --include <pat>       与えられたパターンにマッチした名前

                              を含めます

    -X, --exclude <pat>       与えられたパターンにマッチした名前

                              を除外します

        --all                 マッチした全てのリビジョンを表示し

                              ます

    -i, --ignore-case         マッチのときに英大文字と小文字を区

                              別しないようにします

    -l, --files-with-matches  マッチしたファイル名とリビジョンの

                              みを表示します

    -n, --line-number         マッチした行番号を表示します

    -r, --rev <rev>           指定されたリビジョンの間で検索しま

                              す

    -u, --user                その変更をコミットしたユーザを表示

                              します

heads::

    リポジトリの先頭のチェンジセットを全て表示します。

    リポジトリの「先頭」とは子のチェンジセットを持っていないチェン

    ジセットです。それらは大抵開発が行われる場所で、通常 update と

    merge 操作の対象となるところです。

identify::

    レポジトリの現在の状態の短いサマリを表示します。

    このサマリはリポジトリの状態を1つまたは2つの親のハッシュ識別子

    を使って識別します。親のハッシュ識別子はもし作業ディレクトリに

    コミットされていない変更があれば後ろに + が付き、更にその後に

    このリビジョンのタグのリストが付きます。

    別名: id

import [-p <n> -b <base> -f] <patches>::

    一連のパッチをインポートし、それぞれ個別にコミットします。

    作業ディレクトリに未解決の変更があった場合、import は -f フラ

    グが指定されてなければ中断します。

    もしパッチがメールのよう(最初の行が "From " か RFC 822 ヘッダ

    のよう) であれば、-f オプションが使われていない限りそれは適用

    されません。インポート機構はメールのヘッダをパースもしなければ

    破棄もしないので、本物のメールをインポートしないようにする「メー

    ルのようなものの」健全性チェックを上書きするためだけに -f を使っ

    てください。

    オプション:

    -p, --strip <n>   patch の ディレクトリ除去オプションです。これ

                      は関連する patch のオプションと同じ意味を持ち

                      ます

    -b <path>         パッチを読み込むベースとなるディレクトリを指

                      定します

    -f, --force       未解決でまだコミットされていない変更のチェッ

                      クを省略します

    別名: patch

incoming [-p] [source]::

    指定されたリポジトリか、デフォルトで pull するリポジトリ中に見

    つかった新しいチェンジセットを表示します。これらは pull が要求

    されたときにpull されるチェンジセットです。

    現在はローカルのリポジトリのみがサポートされています。

    オプション:

    -p, --patch           パッチを表示します

    別名: in

init [dest]::

    指定されたディレクトリ中に新しいリポジトリを初期化します。指定

    されたディレクトリが存在しない場合は作成されます。

    ディレクトリが指定されなければ、現在のディレクトリが使用されま

    す。

locate [options] [files]::

    Mercurial の管理下にあるファイルで名前が指定されたパターンにマッ

    チしたものを全て表示します。

    このコマンドは現在のディレクトリとサブディレクトリを検索します。

    リポジトリ全体を検索するには、リポジトリのルートに移動してくだ

    さい。

    もしマッチするためのパターンが与えられなければ、このコマンドは

    全てのファイルの名前を表示します。

    もしこのコマンドの出力を "xargs" コマンドに送りたいなら、

    "-0" オプションをこのコマンドと "xargs" コマンドの両方で使用し

    てください。これは "xargs" がスペースの入ったファイル名を複数

    のファイル名として扱わないようにします。

    オプション:

    -0, --print0         xargs と一緒に使うために、ファイル名を

                         NUL で終えます

    -f, --fullpath       ファイルシステムのルートからの完全なパ

                         スを表示します

    -I, --include <pat>  与えられたパターンにマッチした名前を含

                         めます

    -r, --rev <rev>      rev のときのリポジトリを検索します

    -X, --exclude <pat>  与えられたパターンにマッチした名前を除外

                         します

log [-r revision ...] [-p] [files]::

    指定されたファイルかプロジェクト全体のリビジョンの履歴を表示し

    ます。

    デフォルトではこのコマンドは次のものを出力します: チェンジセッ

    トのid とハッシュ、タグ、親、ユーザ、日付、各コミットのサマ

    リ。-v スイッチは変更されたファイルやマニフェストのハッシュ、

    メッセージのシグネチャといったより詳しい情報を追加します。

    オプション:

    -I, --include <pat>   与えられたパターンにマッチした名前を含め

                          ます

    -X, --exclude <pat>   与えられたパターンにマッチした名前を除外

                          します

    -r, --rev <A>         指定されたリビジョンまたは範囲を表示しま

                          す

    -p, --patch           パッチを表示します

    別名: history

manifest [revision]::

    指定されたリビジョンでバージョン管理されているファイルのリスト

    を表示します。

    manifest はバージョン管理されているファイルのリストです。もし

    リビジョンが指定されなければ、tip が使われます。

outgoing [-p] [dest]::

    指定された行き先のリポジトリかデフォルトで push するリポジトリ

    中に見付からなかったチェンジセットを表示します。これらは push

    が要求されたときに push されるであろうチェンジセットです。

    オプション:

    -p, --patch           パッチを表示します

    別名: out

parents::

    作業ディレクトリの親リビジョンを表示します。

paths [NAME]::

    シンボルのパス名である NAME の行き先を表示します。もしシンボル

    名が指定されなければ、利用可能なシンボル名の行き先を表示します。

    パス名は /etc/mercurial/hgrc と $HOME/.hgrc の [paths] セクショ

    ンで定義されます。もしリポジトリの内部で実行された場

    合、.hg/hgrc も使用されます。

pull <repository path>::

    リモートのリポジトリの変更をローカルのリポジトリに pull します。

    これは指定されたパスや URL にあるリポジトリの全ての変更を見つ

    けて、それらをローカルのリポジトリに追加します。デフォルトでは、

    これは作業ディレクトリのプロジェクトのコピーを更新しません。

    有効な URL の次の形式です:

      local/filesystem/path

      http://[user@]host[:port][/path]

      https://[user@]host[:port][/path]

      ssh://[user@]host[:port][/path]

    SSH は行き先のマシンのシェルアカウントと、リモートのパスにhg

    のコピーが必要になります。SSH を使用すると、パスはデフォルトで

    はリモートのユーザのホームディレクトリの相対パスになります; ファ

    イルシステムのルートからの相対パスであることを指定するには、パ

    スの最初にスラッシュを 2つ使用してください。

    オプション:

    -u, --update   pull の後に作業ディレクトリを tip に更新します

    -e, --ssh    使用する ssh コマンドを指定します

    --remotecmd  リモート側で使われる hg コマンドを指定します

push <destination>::

    ローカルのリポジトリの変更を指定された行き先に push します。

    これは pull と対称的な操作です。これは現在のリポジトリの変更を

    他のリポジトリへ移すのに役立ちます。もし行き先がローカルであれ

    ば、これはそのディレクトリから現在のディレクトリに対して pull

    するのと同じです。

    デフォルトでは、push は実行した結果リモートのヘッドの数が増え

    るならば、実行を拒否します。これはたいていクライアントが push

    する前に sync とmerge を忘れていることを意味します。

    有効な URL は次の形式です:

      local/filesystem/path

      ssh://[user@]host[:port][/path]

    SSH は行き先のマシンのシェルアカウントと、リモートのパスに hg