control: retitle -1 Document the changelog convention control: severity -1 wishlist control: tags -1 moreinfo control: reassign -1 debmake-doc
Hi, Please note these are tutorial docs. I will place maint-guide to be about-to-be -deprecated. I am replacing it as debmake-doc. So I don't accept non-critical changes on maint-guide. (Thus reassigning) > > found -1 maint-guide/1.2.37 > Bug #851456 [maint-guide] Please document this changelog convention > Marked as found in versions maint-guide/1.2.37. https://bugs.debian.org/844184 discussion seems to be that Sean Whitton is asking d/changelog entry to be "sensible and understandable". As for normative documentation, that should happen in "Debian Policy" (Hi Sean!). https://www.debian.org/doc/debian-policy/index.html#s-dpkgchangelog This seems to be OK except for the fact it lacks multi-maintainer changelog format normally generated by dch command. In terms of writing style, that is something developers reference should elaborate but policy may provide cursory guidance. I don't go into such details unless someone gives me a concise list of such guidelines which fits into the tutorial. To be honest, I don't write a good changelog. The current text is https://www.debian.org/doc/manuals/debmake-doc/ch05.en.html#changelog Regards, Osamu
