GNU bug report logs - #5744
23.1.92; doc string of `version<' etc.

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Sat, 20 Mar 2010 15:00:03 UTC

Severity: minor

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Štěpán Němec <stepnem <at> gmail.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 5744 <at> debbugs.gnu.org
Subject: bug#5744: 23.1.92; doc string of `version<' etc.
Date: Sat, 20 Mar 2010 18:44:19 +0100
"Drew Adams" <drew.adams <at> oracle.com> writes:

> 1. Change "lesser than" to "less than".

"Lesser" seems completely fine to me, but I'm not a native speaker.

>
> 2. Say explicitly that V1 and V2 are strings.

I think that's clear from the docstring, but more clarity never hurts, yes.

> Say in fact that they are strings of the format returned by variable
> `emacs-version'.

That would be misleading at best IMHO.
The function accepts a far wider set of arguments.

Also note that you would most probably want to change docstrings of
the whole family of the version functions to stay consistent.




This bug report was last modified 15 years and 59 days ago.

Previous Next


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