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

Reply via email to