chiark - git - mdw - dpkg/blob - man/ja/dpkg-mergechangelogs.man

   1 .\" dpkg manual page - dpkg-mergechangelogs(1)
   2 .\"
   3 .\" Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org>
   4 .\"
   5 .\" This is free software; you can redistribute it and/or modify
   6 .\" it under the terms of the GNU General Public License as published by
   7 .\" the Free Software Foundation; either version 2 of the License, or
   8 .\" (at your option) any later version.
   9 .\"
  10 .\" This is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\" GNU General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  17 .
  18 .\"*******************************************************************
  19 .\"
  20 .\" This file was generated with po4a. Translate the source file.
  21 .\"
  22 .\"*******************************************************************
  23 .TH dpkg\-mergechangelogs 1 %RELEASE_DATE% %VERSION% "dpkg suite"
  24 .nh
  25 .SH 名前
  26 dpkg\-mergechangelogs \- debian/changelogs ファイルの 3\-way マージ
  27 .
  28 .SH 書式
  29 \fBdpkg\-mergechangelogs\fP [\fIoption\fP...] \fIold\fP \fInew\-a\fP \fInew\-b\fP [\fIout\fP]
  30 .
  31 .SH 説明
  32 .P
  33 このプログラムは、3 つの Debian changelog のバージョンから、マージされたchangelog ファイルを生成する。生成された
  34 changelog は \fIout\fP ファイルに保存されるが、パラメータが指定されなかった場合は 標準出力に出力される。
  35 .P
  36 各エントリはバージョン番号によって区別され、競合が発生していないことが前提となる。これらは右から順番に (バージョン番号を減らすことで)
  37 単純にマージされる。\fB\-\-merge\-prereleases\fP
  38 が指定された場合、バージョン番号の最後のチルダより後の部分が除外されるため、1.0\-1~exp1 と 1.0\-1~exp5
  39 は同じエントリだと見なされる。\fInew\-a\fP と \fInew\-b\fP とに同じバージョンがある場合、標準的な行ベースの 3\-way マージが試行される
  40 (Algorithm::Merge モジュールが利用可能な場合。— これは、libalgorithm\-merge\-perl パッケージの一部である。 —
  41 利用できない場合は、該当のエントリにおいて競合が発生する)。
  42 .
  43 .SH オプション
  44 .TP
  45 \fB\-m\fP, \fB\-\-merge\-prereleases\fP
  46 2 つのエントリが同一と見なされるかどうかを確認するバージョン比較の際に、バージョン番号の最後のチルダより後の部分を除外する。
  47 .sp
  48 これは、バージョン番号を常に増加させているものの、同一の changelog
  49 エントリの使用を継続したい場合に有用である。一例として、2.3\-1~exp1, 2.3\-1~exp2 というバージョンが公式なリリースである 2.3\-1
  50 まで続くような場合に、これらを時系列順に並べて同一の changelog エントリにしたい場合などが挙げられる。
  51 .TP
  52 \fB\-\-help\fP
  53 利用方法を表示して終了する。
  54 .TP
  55 \fB\-\-version\fP
  56 バージョン情報を表示して終了する。
  57 .
  58 .SH 制限事項
  59 .P
  60 Dpkg::Changelog で解析できない内容は、マージの際に消失する。これには vim
  61 のモードライン、存在しているとは見なされないコメントなどが挙げられる。
  62 .
  63 .SH "GIT との連携"
  64 .P
  65 このプログラムを git リポジトリにある Debian changelog ファイルのマージに用いる場合は、最初に \fB.git/config\fP
  66 もしくは \fB~/.gitconfig\fP に新しいマージドライバを登録しておく必要がある:
  67 .P
  68  [merge "dpkg\-mergechangelogs"]
  69      name = debian/changelog merge driver
  70      driver = dpkg\-mergechangelogs \-m %O %A %B %A
  71 .P
  72 ついで、debian/changelog ファイルの merge 属性をリポジトリ内の \fB.gitattributes\fP もしくは
  73 \&\fB.git/info/attributes\fP 中に設定する必要がある:
  74 .P
  75  debian/changelog merge=dpkg\-mergechangelogs
  76 .SH 翻訳者
  77 高橋 基信 <monyo@monyo.com>.
  78 喜瀬 浩 <kise@fuyuneko.jp>.
  79 関戸 幸一 <sekido@mbox.kyoto-inet.or.jp>.
  80 鍋谷 栄展 <nabe@debian.or.jp>.
  81 倉澤 望 <nabetaro@debian.or.jp>.
  82 石川 睦 <ishikawa@linux.or.jp>.
  83 鵜飼 文敏 <ukai@debian.or.jp>.
  84 中野 武雄 <nakano@apm.seikei.ac.jp>.
  85 .SH 翻訳校正
  86 Debian JP Documentation ML <debian-doc@debian.or.jp>.