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