From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Newsgroups: gmane.emacs.bugs Subject: bug#5744: 23.1.92; doc string of `version<' etc. Date: Sat, 20 Mar 2010 18:44:19 +0100 Message-ID: <87pr2yriq4.fsf@gmail.com> References: <4E614B66A7BE41B496EA061D77C80C2E@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1269107725 9174 80.91.229.12 (20 Mar 2010 17:55:25 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 20 Mar 2010 17:55:25 +0000 (UTC) Cc: 5744@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 20 18:55:20 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Nt2tI-0006dp-GC for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Mar 2010 18:55:20 +0100 Original-Received: from localhost ([127.0.0.1]:43784 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nt2tG-0006SE-7z for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Mar 2010 13:55:14 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Nt2tB-0006Rm-PP for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 13:55:09 -0400 Original-Received: from [140.186.70.92] (port=39835 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nt2tA-0006QY-6C for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 13:55:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Nt2t5-0006Jh-Je for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 13:55:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50546) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nt2t5-0006Jd-GP for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 13:55:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Nt2iQ-00083Y-Kj; Sat, 20 Mar 2010 13:44:02 -0400 X-Loop: bug-gnu-emacs@gnu.org Resent-From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 20 Mar 2010 17:44:02 +0000 Resent-Message-ID: Resent-Sender: bug-gnu-emacs@gnu.org X-GNU-PR-Message: followup 5744 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 5744-submit@debbugs.gnu.org id=B5744.126910700330960 (code B ref 5744); Sat, 20 Mar 2010 17:44:02 +0000 Original-Received: (at 5744) by debbugs.gnu.org; 20 Mar 2010 17:43:23 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nt2hm-00083J-Pl for submit@debbugs.gnu.org; Sat, 20 Mar 2010 13:43:22 -0400 Original-Received: from mail-fx0-f228.google.com ([209.85.220.228]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nt2hk-00083E-Vb for 5744@debbugs.gnu.org; Sat, 20 Mar 2010 13:43:21 -0400 Original-Received: by fxm28 with SMTP id 28so2334981fxm.39 for <5744@debbugs.gnu.org>; Sat, 20 Mar 2010 10:43:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:cc:subject :in-reply-to:references:user-agent:date:message-id:mime-version :content-type; bh=2Vs3OE/b97trltBw/XesT7MF0tVKB19TdbKOxK3NHa0=; b=jjNBePRINq2byiszPSVJcn0893qJ9CbvpFHXIvojsK80C8jg9ssKT9U1j26zui3mR5 uB/kuLvGDynsgcYZl/ZhMx4ZEQoVrOHC/HO1YC/PqBhwlzSdX38RPLFtIvOmLNe3Nkne oWuimDYCu1QSCs9zN35tOB0XHPVpBnfFplSN4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type; b=yDJ6wMsBGbchMP2xXBiVRRaNDWgYMJ6bZ5Il636ooSK6ixklkt8sdwhnhWopz3sCjw 35TkmUYt70AteZqhRcPMDIPcIthx+S5P4lXO3Jxj9K7KyxF78dyuFNluUtlFCRrG8sre enOKGbtl7Kp+C75TgeKav37ePFjwXvQW9sU+A= Original-Received: by 10.223.5.70 with SMTP id 6mr365119fau.18.1269106995913; Sat, 20 Mar 2010 10:43:15 -0700 (PDT) Original-Received: from localhost ([88.103.132.186]) by mx.google.com with ESMTPS id y15sm4857128fkd.8.2010.03.20.10.43.15 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sat, 20 Mar 2010 10:43:15 -0700 (PDT) In-Reply-To: <4E614B66A7BE41B496EA061D77C80C2E@us.oracle.com> (Drew Adams's message of "Sat, 20 Mar 2010 07:54:36 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.91 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 20 Mar 2010 13:44:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:35656 Archived-At: "Drew Adams" 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.