【しばらく編集不可モードで運営します】 新規作成 | 一覧 | RSS | FrontPage | 検索 | 更新履歴

ChangeLog - - ソフトウェアの変更履歴を書くためのテキストの形式

差分表示


- ソフトウェアの変更履歴を書くためのテキストの形式

* ChangeLogとは何か

- ソフトウェアの変更履歴を書くためのテキストの形式
- 一部の人々はメモ帳として利用している
- さらに一部の人々は日記として利用している

** ChangeLogの書式について

- ChangeLogの書式についてはあちこちで議論があるようです。
-- (1)GNU styleにすると良い
-- (2)EmacsでChangeLogを開くと、change-log-modeになる。そのとき、C-x 4 a と入力すると新な項目(日付と 名前と mail address)が追加される。
--- (2)のデフォルトの設定が、(1)であるらしい。http://home.catv.ne.jp/pp/ginoue/gnu/miscfile.html
-- (3)ChangeLog内で統一的なフォーマットが維持されれば、自由でよい。
-- 参考URL
--- [mew-dist 18396][mew-dist 18407][mew-dist 18412][mew-dist 18431][mew-dist 18474][mew-dist 18475]
--- http://easter.kuee.kyoto-u.ac.jp/~tsutsui/manual/changelog.html

** CVSとChangeLogについて

- ChangeLogはプロジェクト全体の変更履歴が一箇所にまとまったもの。
- CVSは個々のファイルの詳細な変更履歴を管理するもの。
- CVSの変更履歴を要約・集約して、ChangeLogを作成することがある。↓以下のCVSのコミットログをcvs2clでChangeLog化するはその連携。

*ChangeLogの具体的な使い方

** 本来のChangeLogの使い方

- 本来、ChangeLogは「ソフトウェアの変更履歴を書くためのテキストの形式」である。
-- http://www.rubyist.net/~rubikitch/computer/clwiki/ (ChangeLogメモをwikiっぽく使ってみる)

- また、「ChangeLog とは、人間が読みやすいようデザインされた形式で、プロジェクトの変更履歴を時系列順に並べたドキュメント」である。
-- http://www.hssh.jp/~hssh/doc/j-cvsbook-1.12/j-main_242.html (Generate GNU-Style ChangeLogs )

** ChangeLogをメモとして使う方法

-横着プログラミング Unixのメモ技術
-- http://namazu.org/~satoru/unimag/1/
-- 高林哲さんによるUnix Magazine連載記事。
-- これによると、ChangeLogはテキストエディタEmacsを基本にしている。(EmacsにChangeLogという機能がある?)

-Let's try ChangeLog MEMO
-- http://pop-club.hp.infoseek.co.jp/emacs/changelog.html
-- EmacsのChangeLogのTips.

-ChangeLogメモをwikiっぽく使ってみる
-- http://www.rubyist.net/~rubikitch/computer/clwiki/
-- EmacsでChangeLogを作成するとき、wikiのようなリンク機能が欲しいというところから派生したEmacsのマクロ機能(?)の紹介。

** Emacs以外でChangeLogを書いてみる

-はてな ▼ChangeLogメモを秀丸で行うには?http://namazu.org/~satoru/unimag/1/↑ にでている方法でメモを取ってみたいと考えました。私はWindowsユーザーなので秀丸のマクロを利用しようと思いつきましたが、なかなか思うようなモノはありません。Windowsユーザーでchangelog形式のメモを利用されている人はいるのでしょうか?またどのような方法で利用しているのでしょうか?上記HPのようなメモを秀丸で実現できるのでしょうか?
-- http://www.hatena.ne.jp/detail?qid=1038137704
-- Windows派な人たちがChangeLogを行うには?という質問。質問は終了済み。
-- やはりWindowsでもemacs(mule)をインストールして使えば?という結論で終わっているようです。

--本家にマクロがありました。
--http://hide.maruo.co.jp/lib/macro/changelog.html

別にChangeLogのフォーマットがメモ用途に優れているということはない。
-行頭にタブが必須だとか、いちいち挿入されるメールアドレスとか

単にEmacs周辺ではすでにそれを扱う便利なツール類が
揃っているので利用させてもらう、というだけのこと。
それを Meadow をインストールしろというのは本末転倒。

たとえばム板の「アイデアメモの方法」スレには
 277 :デフォルトの名無しさん :02/10/18 19:12
    >>276
    秀丸同志。

    漏れの場合、
    Subject:02/10/18(金) 19:08:57 タイトル
    をマクロで挿入。

    行強調設定すれば、タイトル一覧が見える。
という人もいたし。

まずはMS Windows標準のメモ帳のヘルプを開いて「メモ帳で日誌を作る」という項目を見てみよう。

基本的には Emacsan を使うが、他のエディタでも共用したいという場合は?。

** CVSのコミットログを cvs2cl で Changelog 化する

- cvs2cl.pl - http://www.red-bean.com/cvs2cl/

- CVSのコミットログをまとめてChangeLogの形式にするためのツール -  [[henoheno]]
-- CVSに特化したオプション(リビジョン番号やブランチ名の表示)がある
-- 時刻でChangelog化する範囲を限定できる (最近一ヶ月のコミットログを・・・等)
-- 同じコミットログで違うファイルに/時間を空けて行った複数のコミットを「端折る」機能がある
-- CVSリポジトリの最新状況をクライアントが俯瞰する際にも活用できます
-- CVSのコミットを適切に行う習慣があり、コミットログを適切に記入する習慣があると効果は増すことでしょう。

- http://www.mikamama.com/CVSBook/draft/app2.html
-- GNUスタイルにもできる
-- XMLで出力する事もできる


*ChangeLog関連ツール

-chalow
-- http://nais.to/~yto/tools/chalow/
-- 山下達雄氏によるChangeLog ファイルを HTML ファイルに変換して Web日記にするツール。

-changelog-checker
-- http://search.namazu.org/ml/namazu-dev/msg01391.html
-- 高林哲さんによるChangeLogの作業量算出スクリプト。

- clview - ChangeLogMemo Viewer
-- http://apollo.u-gakugei.ac.jp/~yoshiki/clview/
-- clview は ChangeLog メモを見やすくする Viewer

- changelogmemo.l (xyzzy向けスクリプト)
-- http://www5e.biglobe.ne.jp/~fukafuka/xyzzy/script/index.html#changelogmemo
-- xyzzyでChangeLogをemacsライクに使うためのスクリプト

- pickup
-- http://www.craftone.jpn.org/frog/etc/unix/pickup
-- キーワードを与えたら該当する記事(ChangeLog)を検索して表示するPerlスクリプト
-- ChangeLogでメモをとろう http://www.craftone.jpn.org/frog/etc/unix/chlog.html

*コメント

- 2003-03-25 (Tue) 23:48:07 ローカルなメモに使うんだったら、それこそ cat >> memo でも充分かもしれない。(これじゃ日付けが入らないけど・・・)
- 2003-04-10 (Thu) 09:37:46 UNIX系の人のサイトに「ChangeLog」コーナーがあることが多いですね。
- 2004-04-06 (Tue) 09:53:58 ''[[zuihu]]'' : WZ Editor用ChangeLogマクロとTeraPad用ChangeLogツールなどリリースしました。http://blogger.main.jp/changelog/
- 2007-06-15 (Fri) 10:35:32 ''[[Astrid]]'' : Good Site . Nice work. 
[[#comment]]