On Sun, Sep 17, 2017 at 09:51:19PM +0900, Osamu Aoki wrote: > control: reassign -1 debmake-doc ... > The current text is > https://www.debian.org/doc/manuals/debmake-doc/ch05.en.html#changelog
Since then (1.9-1), I have added few words around there: diff --git a/asciidoc/25-changelog.txt b/asciidoc/25-changelog.txt index b0dd43f..0c83d95 100644 --- a/asciidoc/25-changelog.txt +++ b/asciidoc/25-changelog.txt @@ -1,12 +1,14 @@ [[changelog]] === debian/changelog -The *debian/changelog* file records the Debian package history and defines the upstream package version and the Debian revision in its first line. +The *debian/changelog* file records the Debian package history and defines the upstream package version and the Debian revision in its first line. The changes need to be documented in the specific, formal, and concise style. The *debmake* command creates the initial template file with the upstream package version and the Debian revision. The distribution is set to *UNRELEASED* to prevent accidental upload to the Debian archive. The *debchange* command (alias *dch*) is used to edit this. +TIP: You can edit the *debian/changelog* file manually with any text editor as long as you follow the formatting convention used by the *debchange* command. + TIP: The date string used in the *debian/changelog* file can be manually generated by the ``*LC_ALL=C date -R*'' command. This is installed in the */usr/share/doc/*'binarypackage' directory as *changelog.Debian.gz* by the *dh_installchangelogs* command. Osamu