Changes between Version 1 and Version 2 of TracChangeset

Timestamp:

2007/03/06 12:34:28 (17 years ago)

Author:

trac

Comment:

--

TracChangeset

@@ -1 @@
-= チェンジセット =
+= Trac チェンジセットモジュール =
 [[TracGuideToc]]
 
-Trac にはビジュアル化された “diff” (ファイル間の差分をとる) 機能が組み込まれています。
+Trac には "diffs" - ファイルの差分 を画面表示する機能があります。
 
-[wiki:TracLinks Wikiリンク] されたチェンジセットや、
-[wiki:TracTimeline タイムライン]
-のチェンジセットイベント行をクリックしたときに、
-Tracはコミットによって生じた変更を表示します。
+チェンジセットといってもいろいろな種類があります。
+あるリビジョンにおけるファイルの変更だったり、
+異なるリビジョン間における変更を累積したものもありますが、
+結局のところどんな差分でも表示することができます。
 
-チェンジセットビューは、 ''ヘッダ'' と ''diff 表示'' の2つの部品で構成されます。
+チェンジセットビューは ''ヘッダ'' と 
+''diff ビュー'' の2つで構成されています。
 
 == チェンジセットヘッダ ==
 
-ヘッダはチェンジセット全体の概要を表示します。
-これには以下の情報が含まれます:
+ヘッダは、チェンジセット全体の概要を表示します。
+以下のような情報を得ることができます :
 
- * コミット日時 -- いつコミットされたか
- * コミッタ -- 誰がコミットしたか
- * ログメッセージ -- コミッタによるチェンジセットの説明 (コミットログのメッセージ)
- * 更新ファイル -- チェンジセットに関連するファイルのリスト
+ * コミット日時 -- チェンジセットがコミットされた日時
+ * 更新者 -- チェンジセットをコミットした人
+ * ログメッセージ -- 更新者による簡単な説明 (コミットログ)
+ * ファイル -- チェンジセットによって更新などの影響をうけたファイルのリスト
 
-リストのそれぞれのファイルの前に、色付きの四角があります。この色は
-チェンジセットによって、どのように更新されたか示しています。
+複数のリビジョンのチェンジセットが含まれる場合、
+''コミット日時'', ''更新者'', ''ログメッセージ'' フィールドは
+表示されません。
+
+リストされているファイル名の前に、色のついた四角が見えるでしょう。
+それぞれの色は、チェンジセットによってファイルがどのような影響を受けたかを示しています。
  
- * Green: 追加
- * Red: 削除
- * Yellow: 更新
- * Blue: コピー
- * Gray: 移動
+ * 緑: 追加
+ * 赤: 削除
+ * 黄色: 更新
+ * 青: コピー
+ * グレー: 移動
 
-この意味を思い出せるように、ヘッダの下部に色の説明が表示されます。
+色の凡例はヘッダの下に備忘録として載っています。
 
-== diff 表示 ==
+== diff ビュー ==
 
-ヘッダの下は、チェンジセットビューのメインとなる diff 表示です。各ファイルはそれぞれ別のセクションに表示され、それぞれチェンジセットによって更新された部分だけを表示します。 diff の表示は、 ''インライン'' と ''並べて表示'' という、2つの異なるスタイルで表示することができます。(スタイルの切り替えは右上のフォームで変更できます):
+ヘッダの下がチェンジセットの主な部分となる diff ビューです。それぞれのファイルがセクションで区切って表示されています。そして、各セクションには、チェンジセットによって該当のファイルが影響を受けた部分のみが含まれています。 diff の表示には 2 種類あります: ''インライン'' と ''並べて表示'' 形式です。 (設定フォームで、 2 つのスタイルを切り替えることができます):
 
- * ''インライン'' スタイルでは、2つのファイルを重ねて、変更があった行だけを表示します。ファイルから削除された行は赤に、追加された行は緑に着色されます。変更された行は古いリビジョン、新しいリビジョンの順で表示します。左側の行番号は古いリビジョンと、新しいリビジョンの両方で、変更を行った正確な位置を示します。
- * ''並べて表示'' スタイルでは、左に古いリビジョン、右に新しいリビジョンを表示します(これは通常、インラインスタイルより多くのスクリーン幅を必要とするでしょう。)。追加だけ、または削除だけが行われた行は、インラインスタイルの場合と同様(それぞれ緑と赤)に着色されますが、変更された行は黄色に着色されます。
+ * ''インライン'' スタイルはファイルの変更部分を一列で表示します。ファイルから削除された部分は、赤くマーキングされ、追加された部分は緑色にマーキングされます。更新された場合は、古いバージョンは新しいバージョンの上に表示されます。左側の行番号は古いバージョンと新しいバージョンのファイルのそれぞれ変更があった行番号を示しています。
+ * ''並べて表示'' スタイルは古いバージョンを左側に、新しいバージョンは右側に表示されます (インラインスタイルよりも横幅が長い画面が必要となるでしょう。) 追加または削除された部分はインラインスタイルと同様に色づけ (それぞれ緑、赤で) されます。更新された部分は黄色の背景で表示されます。
 
-さらに、様々な高度なオプションが用意されています。右上のフォームを使用すると diff の表示を好みに調整することができます。:
- * 更新があった行の前後に、それぞれ何行表示するのか指定できます。
- * 機能的な変更だけを手早く確認したい場合に、空行、大文字小文字の変更、空白文字の変更をそれぞれ無視することができます。
+加えて、設定フォームで diff の表示方法を調整するためのいろいろなオプションを利用可能となっています:
+ * 差分の発生行の前後に何行表示するかを設定することができます。
+   (''all'' を使用するとファイル全体が表示されます)
+ * 空白行、大文字/小文字、空白文字の変更を無視リストに追加することができます。これらを設定することによって、より素早く機能上の変更を見ることが可能になります。
+
+
+== diff を見る他の方法 ==
+
+=== チェンジセットを見る ===
+
+リポジトリへのチェックインを見るとき、
+チェンジセットの [wiki:TracLinks リンク] や [wiki:TracTimeline タイムライン] 
+のチェンジセットイベントをみるようなとき、 Trac はチェックインによって
+変更された部分を表示するでしょう。
+
+そのとき、ナビゲーションリンクに ''前のチェンジセット'' 
+と ''後のチェンジセット'' が表示されるでしょう。
+
+=== リビジョン間の diff を見る ===
+
+しばしば ファイルやディレクトリの複数のリビジョンをまたがった変更を見たい
+ことがあるでしょう。
+もっとも簡単な方法は TracRevisionLog から取得することです。
+そして、 ファイルやディレクトリの '''旧''' リビジョンと '''新''' リビジョンを選択し、
+''更新を見る''ボタンをクリックします。
+
+=== ブランチ間の diff を見る ===
+
+バージョン管理システムの主となる特徴の一つとして、
+一般的に "ブランチ" と呼ばれる ''開発系統'' が同時に2つ以上走る可能性があるということです。
+Trac はこのような ブランチ間の diff を
+をみることを可能にしています。
+
+TracBrowser の '''変更箇所を見る...''' ボタンをクリックすることにより、任意の
+パスとリビジョンの ''Base (From)'' と ''Target (To)'' を選択するフォームを表示します。
+diff の一覧は ''To:'' の内容に合わせるために ''From:'' の内容に適用するべき
+変更点でできています。
+
+チェンジセットのページの ''Diff を反転'' リンクをクリックすることによって、 
+'''旧''' と '''新''' パス/リビジョンの役割を反転させることが可能です。
+
+=== 最終更新をみる ===
+
+最後に、変更にみるにあたっては、
+TracBrowser が提供する ''最終更新'' リンクを使用することでしょう。
+
+このリンクはそのパスで起こった最後の変更を表示します。
+そこから、 ''前のチェンジセット'' と ''後のチェンジセット'' リンクを使用
+することで、そのファイルやディレクトリの変更履歴を横断的に見ることができます。
 
 ----