diff options
| -rw-r--r-- | doc/pkg/basic-expat.mdwn | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/pkg/basic-expat.mdwn b/doc/pkg/basic-expat.mdwn index e6a587a..e59e747 100644 --- a/doc/pkg/basic-expat.mdwn +++ b/doc/pkg/basic-expat.mdwn @@ -116,6 +116,12 @@ Our expat `changelog` file looks like this: -- "J. Random Hacker" <jrandom@example.com> Sun, 18 Nov 2012 11:58:19 -0500 +Be careful – the changelog format is quite strict and tends to confuse many new +package maintainers. There are no spaces before the package name, version, and +distribution (called the "header"); at least two spaces before each line of +change details; one space before the line starting with `--` (called the +"trailer"); and two spaces between the maintainer and the date. + [spf-changelog]: http://specs.proteanos.com/spf-2.0/metadata.html#changelog |