Hello Osamu, On Sun, Sep 17 2017, Osamu Aoki wrote:
> -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. There is disagreement within the project about this. Dev. ref. says something like "document only user-visible changes". And lots of people do this. But for the RFS process, much more detail is required (as you saw in the muse-el RFS). The other thing is that when packages are maintained in git, we do not need to duplicate the git commit history in the changelog. But some people do. I do not have a settled opinion myself on what our best practice should be. However, your diff quoted above seems sensible for a beginner's guide, as we would expect people reading it to be going through the RFS process. -- Sean Whitton
signature.asc
Description: PGP signature
