変更履歴のエントリは、現在の日付、氏名(変数 add-log-full-name
から取得)、およびメールアドレス(変数 add-log-mailing-address
から取得)を含むヘッダー行で始まります。これらのヘッダー行を除き、変更履歴のすべての行はスペースまたはタブで始まります。エントリの大部分は項目で構成されており、各項目は空白文字とアスタリスクで始まる行から始まります。以下に、ともに1993年5月の日付で、それぞれ2つの項目と1つの項目を持つ2つのエントリを示します。
1993-05-25 Richard Stallman <rms@gnu.org>
* man.el: Rename symbols 'man-*' to 'Man-*'.
(manual-entry): Make prompt string clearer.
* simple.el (blink-matching-paren-distance):
Change default to 12,000.
1993-05-24 Richard Stallman <rms@gnu.org>
* vc.el (minor-mode-map-alist): Don't use it if it's void.
(vc-cancel-version): Doc fix.
1つのエントリで複数の変更を記述できます。各変更は個別の項目とするか、同一項目内の別行として記述してください。通常、項目間には空行を1行入れる必要があります。項目同士が関連している場合(同一変更の異なる箇所など)は、空行を挟まずにまとめてください。このような複数項目からなるエントリは、多くの場合、変更セット全体を簡潔にまとめた1行のテキストから始まります。また、要約行と最初の変更項目の間に、追加の説明テキストを記載することも可能です。この説明テキストも空行で挟むようにしてください。以下に例を示します:
2026-02-27 Sean Whitton <spwhitton@spwhitton.name>
New 'log-outstanding' value for vc-log-view-type
This fixes vc-hg-print-log's choice of -r arguments to 'hg log'.
* lisp/vc/vc.el (vc-log-view-type): New 'log-outstanding' value.
(vc-log-outstanding): Pass it.
* lisp/vc/vc-git.el (vc-git-log-view-mode):
* lisp/vc/vc-hg.el (vc-hg-print-log, vc-hg-log-view-mode): Treat
'log-outstanding' the same as 'log-outgoing'.
他者に配布するソフトウェアパッケージに1つ以上の変更履歴ファイルを含める場合は、各変更履歴ファイルの末尾に著作権表示および利用許諾表示を記載してください。以下に例を示します。
Copyright 1997--1998, 2025--2026 Free Software Foundation, Inc. Copying and distribution of this file, with or without modification, are permitted provided the copyright notice and this notice are preserved.
もちろん、適切な年号と著作権者に置き換えてください。