About News Download Docs Forum Bugs Contact

Spell/Files/HISTORY

Information

Tools

Resources

HISTORY

The HISTORY file is used to contain the revision history of the spell for all to see: every change that impacts behavior gets an entry in HISTORY, consisting of one entry head, and a number of entry lines describing the edit in more detail. The format is the common ChangeLog format. The permissions are set to the standard 0644.

Layout

Every entry head holds:

Every entry line gets:

Longer lines get wrapped: use one tab and two spaces to line out the lines.


Examples

2005-01-26[one-space]John Doe[one-space]<john@example.net>
[one-tab]*[one-space]This line is supposed to look like a too long line, so the line gets
[one-tab][two-spaces]wrapped to the next line, not using another asterisk.

2002-10-31[one-space]John Doe[one-space]<john@example.net>
[one-tab]*[one-space]BUILD: modified to use more of default_build from
[one-tab][two-spaces]/var/lib/sorcery/modules/libgrimoire; fixed Bug #1448

2002-10-07[one-space]John Doe[one-space]<john@example.net>
[one-tab]*[one-space]DETAILS, DEPENDS, BUILD: created spell
[newline]

will look like:

2005-01-26 John Doe <john@example.net>
	* This line is supposed to look like a too long line, so the line gets
	  wrapped to the next line, not using another asterisk.

2002-10-31 John Doe <john@example.net>
	* BUILD: modified to use more of default_build from
	  /var/lib/sorcery/modules/libgrimoire; fixed Bug #1448

2002-10-07 John Doe <john@example.net>
	* DETAILS, DEPENDS, BUILD: created spell


The "Don'ts"

Some changes are not considered worth mentioning in HISTORY, such as: