forked from skk-dev/temp_web
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathcvs-ja.html
233 lines (207 loc) · 14.6 KB
/
cvs-ja.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
<!DOCTYPE html>
<html>
<head>
<title>SKK Openlab - 開発</title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="common.css" rel="stylesheet" type="text/css">
<link href="index-j.html" rel="index">
<link rev="MADE" href="mailto:[email protected]">
</head>
<body>
<header>
<div id="globalnav">
<ul>
<li><a href="index-j.html" name="top">トップ</a>
<li><a href="dic-ja.html">SKK 辞書</a>
(<a href="dic" title="DownloadDic">ダウンロード</a>,
<a href="wiki/wiki.cgi?page=FrontPage">Wiki</a>)
<li><a href="ddskk-ja.html">DDSKK</a>
(<a href="maintrunk" title="DownloadSKK">ダウンロード</a>)
<li><a href="doc-ja.html">ドキュメント</a>
<li><a href="ml-ja.html">メーリングリスト</a>
<li><a href="cvs-ja.html">開発</a>
<li><a href="wiki/wiki.cgi?page=%A5%EA%A5%F3%A5%AF%BD%B8">リンク</a>
</ul>
</div>
</header>
<article>
<h1><a name="topp">SKK Openlab での開発</a></h1>
<div id="langswitch"><a href="cvs.html">English</a></div>
<h2><a name="TOC">目次</a></h2>
<ol>
<!-- <li><a href="#repository">SKK レポジトリ構成</a> -->
<!-- <li><a href="#get_cvs">CVS の入手方法</a> -->
<!-- <li><a href="#get_source">CVS による SKK ソースの入手</a> -->
<!-- <li><a href="#commit_tag">コミッタのためのガイド</a> -->
<!-- <ul> -->
<!-- <li><a href="#account">CVS での開発参加</a> -->
<!-- <li><a href="#commit">コミット</a> -->
<!-- </ul> -->
<li><a href="#introduction">開発ツールの変更について</a>
<li><a href="#dev_git">git/github.com による開発</a>
<li><a href="#dev_cvs">cvs/openlab.jp による開発</a>
</ol>
<h2><a name="introduction">1. 開発ツールの変更について</a></h2>
<div>
<p>2014年12月、ddskk 及び skktools の開発ツールを cvs から github へ変更しました。</p>
<ul>
<li><a href="http://mail.ring.gr.jp/skk/201412/msg00012.html">
http://mail.ring.gr.jp/skk/201412/msg00012.html</a>
<li><a href="http://mail.ring.gr.jp/skk/201412/msg00061.html">
http://mail.ring.gr.jp/skk/201412/msg00061.html</a>
</ul>
</div>
<h2><a name="dev_git">2. git/github.com による開発</a></h2>
<div>
<p>ddskk 及び skktools は github を利用して開発しています。</p>
<p>開発の流れなどは、次のドキュメントを参考にしてください。<br>
GitHub による開発の流れについて
(<a href="https://github.com/skk-dev/ddskk/blob/master/READMEs/README.git.ja.org">
https://github.com/skk-dev/ddskk/blob/master/READMEs/README.git.ja.org</a>) </p>
</div>
<h3><a name="git-repository">2.1. SKK git レポジトリ構成</a></h3>
<div>
<p>github で開発を行う際のレポジトリは、以下のような構成になっています。</p>
<p>upstream および origin は github のサーバ上にあるレポジトリとなっていて、おもに WEB ブラウザを経由して操作をします。</p>
<p>一方で local は手元の PC 上のレポジトリとなっていて、git checkout (ブランチ名) でブランチを切り替えることができます。
ブランチの中で行った改変は、git コマンドを使用しない限り他のブランチの内容には影響しません。</p>
<p><img type="image/svg+xml" src="branch_ja.svg"></img></p>
</div>
<h3><a name="get_git"></a>2.2. git の入手方法(UN*X環境)</h3>
<div>
<p>ご利用のUN*X環境によっては git の開発環境がインストールされていないことがあります。</p>
<p>git のインストールに関しては、<a href="http://git-scm.com/book/ja/v1/%E4%BD%BF%E3%81%84%E5%A7%8B%E3%82%81%E3%82%8B-Git%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">http://git-scm.com/book/ja/v1/使い始める-Gitのインストール</a>
などのサイトを参照下さい。</p>
</div>
<h3><a name="get_git_win">2.3. git の入手方法(Windows環境)</a></h3>
<div>
<p><a href="https://msysgit.github.io/">https://msysgit.github.io/</a> より Git for Windows を入手します。</p>
<p> インストールする要素の選択（Select Components）は、[Windows Explorer integration]
および [Associate .sh files to be run with Bash] のチェックを外し、次に進みます。</p>
<p> SKK ディストリビューションは、Windows のバッチファイルを含むため、リポジトリの改行コード(LF or CRLF)を保つために、
改行コードの変換設定（Configuring the line ending conversions）は、
[Checkout as-is, commit as-is] にチェッックを入れてください。</p>
</div>
<div>
<p>なお、Windows 環境では cvs と同様に cygwin を利用することも可能です。</p>
<p>cygwin を使用した場合と、上記の Git for Windows を利用する場合では、
shell を起動したときのホームディレクトリが異なることに注意して下さい。</p>
<p>デフォルトのインストールでは、WindowsのログインIDを LOGINID としたときにホームディレクトリは以下のようになります。</p>
<ul>
<li>Git for Windows: c:\Users\LOGINID\</li>
<li>cygwin: c:\cygwin\home\LOGINID\ (または、 c:\cygwin64\home\LOGINID\ </li>
</ul>
</div>
<h3><a name="get_source_from_git">2.4. git による SKK ソースの入手</a></h3>
<div>
<p>単に最新版のソースをダウンロードする場合は以下のようにして SKK ソースの clone をダウンロードすることができます。</p>
<pre>
% git clone https://github.com/skk-dev/ddskk
</pre>
<p>開発に参加される方は、前掲「GitHub による開発の流れについて」をご覧ください。</p>
<p>GitHub における開発のためには、<a href="https://github.com">https://github.com</a>
のアカウントを登録する必要があります。詳しくは GitHub のサイトの案内を参照して下さい。</p>
</div>
<h2><a name="dev_cvs">3. cvs/openlab.jp による開発</a></h2>
<div>
<p>main (=> skk-dev/ddskk) 及び tools (=> skk-dev/skktools) 以外は、従来と変わりません。
また、main 及び tools についても、リリース時には cvs に反映する予定です。</p>
</div>
<h3><a name="repository">3.1. SKK cvs レポジトリ構成</a></h3>
<div>
<p><img type="image/svg+xml" src="cvs_ja.svg"></img></p>
</div>
<h3><a name="get_cvs">3.2. CVS の入手方法</a></h3>
<div>
<p>CVS は <a href="http://ftp.gnu.org/non-gnu/cvs/">http://ftp.gnu.org/non-gnu/cvs/</a> で配布されています。
<p>CVS に関する情報は</p>
<ul>
<li><a href="http://www.nongnu.org/cvs/">http://www.nongnu.org/cvs/</a></li>
</ul>
<p>から入手可能です。また、CVS に関する日本語の情報として、以下のようなページがあります。</p>
<ul>
<li><a href="http://vox.nishimotz.com/cvs/cvs.html">http://vox.nishimotz.com/cvs/cvs.html</a>
<li><a href="http://www.itojun.org/hack/cvs/tut-kernel.html">http://www.itojun.org/hack/cvs/tut-kernel.html</a>
</ul>
<p>なお、Emacs には <a name="pcvs(pcl-cvs)">pcvs (pcl-cvs)</a> というフロントエンドが付属しています。</p>
</div>
<h3><a name="get_source">3.3. CVS による SKK ソースの入手</a></h3>
<div>
<p>ゲストアカウントで openlab.jp の cvs server にログインします。</p>
<pre>
% cvs -d :pserver:[email protected]:/circus/cvsroot login
</pre>
<p>パスワードの入力を促すプロンプトが出るので、パスワードとして <kbd>guest</kbd> を入れ、<kbd>RET</kbd> しましょう。</p>
<pre>
CVS password: guest [RET]
</pre>
<p>~/.cvspass というファイルにパスワードが記録され、次からは入力不要になります。 <span id="footnote-1"><a href="#footnote1">(*注1)</a></span></p>
<p>次に DDSKK のソースを取得します (このファイルを作業コピーといいます)。 <span id="footnote-2"><a href="#footnote2">(*注2)</a></span></p>
<pre>
% cvs -d :pserver:[email protected]:/circus/cvsroot checkout skk/main
</pre>
<p>カレントディレクトリの下にできる skk/main (作業ディレクトリ) にコピーが作成されます。</p>
<p>手元のソースを最新に更新するには作業ディレクトリに移動して<kbd>cvs update</kbd>を実行します。</p>
<pre>
% cd skk/main
% cvs update -dP
</pre>
</div>
<h3><a name="commit_tag">3.4. コミッタのためのガイド</a></h3>
<h4><a name="account">3.4.1. CVS での開発参加</a></h4>
<div>
<p>openlab.jp に SSH2 公開鍵 (OpenSSH) を登録することで開発に参加できます。まず SSH2 公開鍵 (OpenSSH) を <a href="mailto:[email protected]">[email protected]</a> 宛てに送付して下さい。登録完了の通知をお送りします。</p>
<p>SSH 経由のアクセスにおいては <kbd>cvs login</kbd> は必要ありません。skk-cvs というアカウントをコミッタ全員共通で使用します。ソースを取得するには以下のコマンドを実行します。</p>
<pre>
% cvs -d:ext:[email protected]:/circus/cvsroot checkout skk/main
</pre>
<p>また、取得済みのソースを最新に更新するには作業ディレクトリで以下を実行します。</p>
<pre>
% cvs update -dP
</pre>
</div>
<h4><a name="commit">3.4.2. コミット</a></h4>
<div>
<p>下記の手順を踏んでコミットして下さいね。</p>
<ul>
<li>まず作業ディレクトリのソースを自分の環境でコンパイル & インストールします。</li>
<li>動作確認をして下さい。
<ul>
<li> 一度、SKK を起動 & 終了して問題がないことを確認します。</li>
<li> 同じことを <kbd>emacs -Q</kbd> 下でもう一度確認します (できれば空の ~/.skk で)。</li>
</ul></li>
<li>変更の要点をその SKK で書きます。</li>
<li>その間も問題がなければ、作業ディレクトリにて <kbd>cvs commit</kbd> します。</li>
<li>問題なければ書いた変更の要点を <a href="mailto:[email protected]">[email protected]</a> に投稿して下さい。</li>
<li>ChangeLog の更新をお忘れなく。英語で書いていますが、英語が苦痛なら日本語で書いても全然問題ありません。 <span id="footnote-3"><a href="#footnote3">(*注3)</a></span></li>
</ul>
<pre>
% cd skk/main
% cvs commit -m "Update." ChangeLog
% cvs commit -m "あなたのコメントをここに。" skk.el
</pre
</div>
<div id="footnote-sec">
<h4><a name="footnote">脚注</a></h4>
<h5><a name="footnote1">注1</a></h5>
<p>サーバーの情報は作業ディレクトリ下に記録されるので、作業ディレクトリでCVS コマンド
(<kbd>checkout</kbd>, <kbd>update</kbd>, <kbd>commit</kbd> など) を実行すると、
自動的に openlab.jp にログインして、それぞれのコマンドを実行します。</p>
<h5><a name="footnote2">注2</a></h5>
<p>~/.cvsrc に
<pre>
cvs -z3
</pre>
と書いておくと、サーバーとの通信内容が圧縮されます。数字が大きい程圧縮率が高いのですが、圧縮率が高い程サーバの負担が高いので、<kbd>-z3</kbd> ぐらいが丁度良いようです。</p>
<h5><a name="footnote3">注3</a></h5>
<p>CVS の Emacs 用フロントエンド <a href="#pcvs(pcl-cvs)">pcl-cvs</a> (pcvs) を使う場合、コミットのために <kbd>C</kbd> キー (<kbd>cvs-mode-changelog-commit</kbd>) を押すと ChangeLog から当日コミッタ自身が書いた部分を抜き出して、ログを書く手助けをしてくれます。</p>
</div>
<div id="move"><a href="#top">目次へ</a></div>
</article>
<footer>
<div id="mailto">mailto: <a href="mailto:[email protected]">[email protected]</a></div>
<div id="modtime">Last Modified: $Date: 2014/12/24 06:15:27 $</div>
</footer>
</body>
</html>