From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#5744: 23.1.92; doc string of `version<' etc. Date: Sat, 20 Mar 2010 12:55:16 -0700 Message-ID: <6448B1F535A546C7A163C6019F528EAB@us.oracle.com> References: <4E614B66A7BE41B496EA061D77C80C2E@us.oracle.com><87pr2yriq4.fsf@gmail.com><9C18B608A91D4DE5B54FC6ACB722141C@us.oracle.com> <87ljdmrcu9.fsf@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-2" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1269116721 5050 80.91.229.12 (20 Mar 2010 20:25:21 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 20 Mar 2010 20:25:21 +0000 (UTC) Cc: 5744@debbugs.gnu.org To: =?UTF-8?Q?"'=C5=A0tep=C3=A1n?= Nemec'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 20 21:25:17 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 1Nt5EO-0004tj-OR for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Mar 2010 21:25:13 +0100 Original-Received: from localhost ([127.0.0.1]:44466 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nt5EO-0002ru-3B for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Mar 2010 16:25:12 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Nt5EK-0002rC-97 for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 16:25:08 -0400 Original-Received: from [140.186.70.92] (port=57857 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nt5EI-0002qT-KN for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 16:25:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Nt5EG-0003Im-7O for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 16:25:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34101) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nt5EG-0003Ii-5S for bug-gnu-emacs@gnu.org; Sat, 20 Mar 2010 16:25:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Nt4n8-0001Ex-3f; Sat, 20 Mar 2010 15:57:02 -0400 X-Loop: bug-gnu-emacs@gnu.org Resent-From: "Drew Adams" 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 19:57: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.12691150144724 (code B ref 5744); Sat, 20 Mar 2010 19:57:02 +0000 Original-Received: (at 5744) by debbugs.gnu.org; 20 Mar 2010 19:56:54 +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 1Nt4mz-0001E9-SG for submit@debbugs.gnu.org; Sat, 20 Mar 2010 15:56:54 -0400 Original-Received: from acsinet11.oracle.com ([141.146.126.233]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nt4my-0001DZ-70 for 5744@debbugs.gnu.org; Sat, 20 Mar 2010 15:56:52 -0400 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet11.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id o2KJukhT015901 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 20 Mar 2010 19:56:47 GMT Original-Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o2KJA64w010941; Sat, 20 Mar 2010 19:56:45 GMT Original-Received: from abhmt003.oracle.com by acsmt355.oracle.com with ESMTP id 97625941269114914; Sat, 20 Mar 2010 12:55:14 -0700 Original-Received: from dradamslap1 (/24.5.179.75) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 20 Mar 2010 12:55:14 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcrIZpXdptVhSas0QNGvFhXNaqB08gAAEdtQ In-Reply-To: <87ljdmrcu9.fsf@gmail.com> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt355.oracle.com [141.146.40.155] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090204.4BA5287D.010C:SCFMA4539814,ss=1,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 20 Mar 2010 15:57: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:35663 Archived-At: > The actual behaviour depends on values of a few variables. See the doc > strings for `version-regexp-alist', `version-to-list' and > `version-separator'. > > Perhaps pointing to them (and fixing the typos) in all the > version-related functions would be a solution? Yes. If there is a one of them that covers everything (e.g. by linking to the others), then it would be enough to link to just that one. But if the reader needs to understand all 3 variables in order to understand the acceptable formats, then we should link to all 3. > >> Also note that you would most probably want to change docstrings of > >> the whole family of the version functions to stay consistent. > > > > Of course. That's why I wrote "`version<' ETC." in the subject line. > > Indeed, I noticed that only after having replied, I'm sorry. No problem. Admittedly, it wasn't very obvious.