Sign in Join
Wiki copytemporary

Creating A Patch/ja: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: Creating A Patch/ja

OldNewLine
1+FPC や Lazarus を改良したコードを提出する場合は、開発者がマージしやすいようにパッチで提出するようにしてください。
2+
3+例外事項：
4+
5+1. 翻訳用の .po ファイルはパッチではなくファイルをそのまま提出してください
6+2. 新規に作られたファイルは、ファイルをそのまま提出して、設置場所を明記してください
7+
8+## 必要なもの
9+
10+Lazarus の main/開発版。SVN か Git いずれかを使って入手できます。
11+
12+- Git：https://gitlab.com/freepascal.org/lazarus/lazarus。
13+- SVN：
14+
15+` svn checkout --depth files `[`https://github.com/fpc/Lazarus/branches`](https://github.com/fpc/Lazarus/branches)` all`\
16+` cd all`\
17+` svn update --set-depth infinity main`
18+
19+## プラットフォームで異なるところ
20+
21+コマンドプロンプトを開いてリポジトリのあるディレクトリに移動 (cd) する部分が若干異なります。詳しくは以下に示します。
22+
23+### Windows
24+
25+チェックアウトした Lazarus が C:\lazarus にある場合：
26+
27+1. コマンドプロンプトを開きます（例：「ファイル名を指定して実行」で **cmd.exe** と入力）
28+
29+2. ```dos
30+ c:
31+ ```
32+
33+3. ```dos
34+ cd \lazarus
35+ ```
36+
37+> **Note:** [TortoiseSVN](http://tortoisesvn.tigris.org/) をお使いでしたら、Windows エクスプローラ上の Lazarus をチェックアウトしたフォルダを選択し、右クリックから TortoiseSVN → パッチを作成 からでも行えます。
38+
39+問題がある場合は、[[TortoiseSvn|TortoiseSvn#Troubleshooting]] もご覧になってください。
40+
41+### Unix 系
42+
43+チェックアウトした Lazarus が ~/lazarus にある場合：
44+
45+1. 端末を開きます
46+
47+2. ``` bash
48+ cd ~/lazarus
49+ ```
50+
51+## SVN を使ってパッチを作成する
52+
53+``` bash
54+svn diff > mypatch.diff
55+```
56+
57+こうして作られたパッチには、SVN リポジトリのすべての変更が含まれます。
58+
59+個別にパッチを作りたい場合は、関係のないものが含まれないように以下のように行います。
60+
61+``` bash
62+svn diff ide/main.pp ideintf/objectinspector.pp > mypatch.diff
63+```
64+
65+## Git を使ってパッチを作成する
66+
67+開発はローカルブランチで行います。開発しているブランチ内で動作が確認できたら、以下のコマンドでローカルコミットのパッチをすべて作成します。
68+
69+``` bash
70+git format-patch master
71+```
72+
73+"0001-CommitMsg.patch"、"0002-CommitMsg.patch" といった名前のファイルの組が作られます。
74+
75+1 つのパッチにすべての変更をまとめたいのであれば、"git rebase -i ..." を使ってコミットをまとめるか、以下のコマンドを使います。
76+
77+``` bash
78+git format-patch master --stdout > mypatch.patch
79+```
80+
81+## パッチの提出
82+
83+パッチを提出する前に、それで問題ないか入念な確認をお願いいたします。
84+
85+[bug tracker](http://bugs.freepascal.org) を通してパッチを提出するのがお勧めの方法です。詳しくは、[[How do I create a bug report/ja|不具合報告のやり方をご]]覧になってください。bug tracker に報告されている課題を修正するパッチであればその課題項目へ、そうでない場合は bug tracker 上に新しく課題項目を作成しそこへパッチを提出します。課題項目に対してアップロードできたら提出完了です。
86+
87+## フォークされている Git リポジトリの直接使用
88+
89+Lazarus の開発においても Git を使って配布するというやり方もありでしょう。最近では JuhaManninen 氏と Alexander Klenin ("Ask") 氏が Git リポジトリへのコードの受け入れを進んで行っています。
90+
91+実際、彼らのリポジトリは GitHub 内において Lazarus のミラーからフォークされています。当然ながら受け入れられたコードは、独立したブランチ内の存在であり、"upstream" ブランチより rebase された状態にあります。これらのコードはまだテストされてはおらず、誰かによってこれらのリポジトリをフォークされたりそこからコードを作成されたりすると、やるべきテストなどがどっと増やされてしまうかもしれません。
92+
93+このような限られた場というのは、Git を使って専門の開発をする人達のためのものでしょう。そこでのコードを多くの人に利用してもらいたいのであれば、Git を使って適宜パッチを作り、bug tracker へ提出するべきでしょう。
94+
95+## パッチの適用
96+
97+ここでは、他のだれかが作ったパッチをお使いになられているローカルリポジトリに適用する方法について説明します。以下のように --dry-run スイッチを使うことでパッチの影響テストが行えます。
98+
99+``` bash
100+patch --dry-run < somepatch.diff
101+```
102+
103+このパッチテストの出力結果は実際に行われるパッチと同じものですが、ソースファイルを変更することはありません。かなり厳格なテストなので、お使いになられている環境のソースファイルが思いがけず乱されるということはまずないでしょう。
104+
105+### "svn diff" で作られたパッチ
106+
107+テストで問題なかったら、以下のコマンドを使ってパッチを適用します。
108+
109+``` bash
110+patch < somepatch.diff
111+```
112+
113+これでうまくいかないのは、お使いになられている環境がパッチが作られた環境と異なっているからです。その場合は、以下のようにしてパス情報をすべて引き出すように指定してください。
114+
115+``` bash
116+patch -p0 < somepatch.diff
117+```
118+
119+Windows 用の GUI バージョン管理ツールでもこれらのパッチは適用できます。
120+
121+### "git format-patch" で作られたパッチ
122+
123+#### Git
124+
125+Git にパッチを適用するには以下のようにします。
126+
127+``` bash
128+git apply 0001-gitpatch.patch
129+```
130+
131+#### patch コマンド
132+
133+patch コマンドは -p1 スイッチで git 書式にも対応しています。Linux 版の patch v.2.6.1 で動作確認しました。古いバージョンはおそらく対応していないでしょう。
134+
135+``` bash
136+patch -p1 < 0001-gitpatch.patch
137+```
138+
139+patch コマンドは Windows でも利用できます。また、GUI ツールにも同じ機能があります。
140+
141+#### TortoiseMerge
142+
143+TortoiseMerge は Git 書式のパッチも問題なく使用できます。Tortoise SVN をインストールすると TortoiseMerge もインストールされますが、エクスプローラの右クリックメニューには表示されません。スタートメニューから起動してください。（訳注：ずばりの名称は右クリックメニューには出ませんが、パッチを適用 とかで開かれるものが TortoiseMerge です。）
144+
145+ToDo：Git 書式のパッチをサポートする GUI ツールが他にもあるようでしたらここに追加してください
146+
147+### トラブルシューティング
148+
149+パッチを適用する段階になって Unix/Linux の改行コード (LF) と Windows の改行コード (CR+LF) が異なってうまくいかないことがあります。Windows 環境では patch.exe の改行コード処理がいい加減なので、パッチ適用前にファイルを変換する必要があるでしょう。
150+
151+Windows 版の FPC/Lazarus に付属している patch.exe はかなり使いづらいです。Git に付属している patch.exe の方がいいでしょう。
152+
153+```dos
154+"C:\Program Files (x86)\Git\bin\patch.exe" -p0 < mypatch.diff
155+```
156+
157+SVN 1.7 以降でしたら SVN の patch コマンドも利用できます。
158+
159+## 関連項目
160+
161+- [[How do I create a bug report/ja|不具合報告のやり方]] - 不具合報告の一般的な情報
162+- [[Tips on writing bug reports|不具合報告を書く上でのヒント]] - 不具合を報告するさいのトラブルやそうならないための対策
163+- [[Database bug reporting|データベース関連の不具合報告]] - データベース関連の不具合報告用の簡単なプログラムと関連する情報
164+
165+---
166+*From the Free Pascal wiki, page "Creating A Patch/ja", as it stood on 2022-01-13 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*
167+Category: Debugging/ja
168+Category: FPC/ja
169+Category: Lazarus/ja

Back to history