On Wed, Sep 26, 2012 at 06:19:10PM +0200, Lieven Govaerts wrote: > Although I agree that a general overview would be nice, given that the > detailed info is easily available via: > $ svn log --c 1390435 > > maybe it would be easier to add these log messages (or a shortened > version) to the commit mail instead of asking the committer to copy > all of them? > Or via the viewvc url?
I think it's reasonable to write a summary of the implemented changes, with details available in the individual branch commits for those interested. Here's one example where I did this: ------------------------------------------------------------------------ r871120 | stsp | 2008-05-06 18:29:01 +0200 (Tue, 06 May 2008) | 32 lines Merge the dont-save-plaintext-passwords-by-default branch into trunk. Summary of the functionality implemented: - Add a 'store-plaintext-passwords' option, which can be set to 'yes', 'no', or 'ask' (which is the default). If the option is set to 'ask', ask the user before saving plaintext passwords to disk. This is done from a callback that should be implemented by all clients. The callback is called once per authentication realm. If a client does not implement the callback, and does not provide an explicit default value, we default to storing plaintext passwords. I don't like this, but it's a compromise because we don't really want the semantics of the old API to change retroactively. We can, however, change this default anytime by tweaking a single line of code, should we decide to do so. The old API has been deprecated. - Provide an implementation of the callback for our command line client, which, in addition to prompting, prints a warning explaining that the password can only be stored unencrypted, and shows the name of the authentication realm in question. - Authentication parameter configuration has been moved to the RA layer completely. For users, this means that parameters which used to be configured in the [auth] section in the 'config' file are now configured in the 'servers' file, and can be specified both in the [global] section, and per server group. The [auth] section in 'config' is still being evaluated, but is overridden by anything specified in 'servers'. Please consult the log messages of the branch for a detailed list of all changes. ------------------------------------------------------------------------
