GNU bug report logs - #23485
25.1.50; patch (docstring) for vc-hg.el

Previous Next

Full log

Message #8 received at 23485 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Uwe Brauer <oub <at> mat.ucm.es>
Cc: 23485 <at> debbugs.gnu.org
Subject: Re: bug#23485: 25.1.50; patch (docstring) for vc-hg.el
Date: Tue, 25 Jun 2019 15:48:58 +0200

Uwe Brauer <oub <at> mat.ucm.es> writes:

> This little patch provides some additional information for vc-hg.el in
> order to get the old behavior of the modeline.

[...]

> +If you want the old behaviour of `vc-hg.el' (see the variable
> +'vc-hg-use-file-version-for-mode-line-version')  namely that
> +the modline displays [Hg-revnumber], then you must set the variable
> +to the list (\"{rev}\")."

I think (except in some peculiar circumstances), the place to talk about
"the old behaviour" is in the NEWS file, not in docstrings: The doc
string should talk about current behaviour, because (new) users won't
have seen the old behaviour.

So I'm closing this bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.