From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Canonical location for emacs-version string in source tree? Date: Mon, 24 May 2010 13:44:16 -0400 Message-ID: References: <5E9E2370-F371-46DE-A970-3FB825E90BBF@raeburn.org> <83632iqwpe.fsf@gnu.org> <32115842-89C0-4628-9523-C9C209FB4B0D@raeburn.org> <83ocg9ym77.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1274723091 20772 80.91.229.12 (24 May 2010 17:44:51 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 24 May 2010 17:44:51 +0000 (UTC) Cc: eliz@gnu.org, raeburn@raeburn.org, emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon May 24 19:44:49 2010 connect(): No such file or directory Return-path: Envelope-to: ged-emacs-devel@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 1OGbhl-0001GG-9P for ged-emacs-devel@m.gmane.org; Mon, 24 May 2010 19:44:49 +0200 Original-Received: from localhost ([127.0.0.1]:41831 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OGbhj-0004Gn-QL for ged-emacs-devel@m.gmane.org; Mon, 24 May 2010 13:44:43 -0400 Original-Received: from [140.186.70.92] (port=40252 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OGbha-0004Cf-J4 for emacs-devel@gnu.org; Mon, 24 May 2010 13:44:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OGbhV-0004GB-Jz for emacs-devel@gnu.org; Mon, 24 May 2010 13:44:34 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:65311 helo=ironport2-out.pppoe.ca) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OGbhJ-0004EF-2m; Mon, 24 May 2010 13:44:17 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ArAFAMlX+ktFpZMM/2dsb2JhbACRd4wDcsBdhRMEg2CIXw X-IronPort-AV: E=Sophos;i="4.53,292,1272859200"; d="scan'208";a="64936707" Original-Received: from 69-165-147-12.dsl.teksavvy.com (HELO pastel.home) ([69.165.147.12]) by ironport2-out.pppoe.ca with ESMTP; 24 May 2010 13:44:16 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id 193908266; Mon, 24 May 2010 13:44:16 -0400 (EDT) In-Reply-To: (Richard Stallman's message of "Mon, 24 May 2010 11:38:02 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:125199 Archived-At: > I have several co-existing `emacs' executables here, and they coexist > just fine with a single DOC file. They just all show the same > docstrings, which I wouldn't even consider as an issue. > That means only one of them gives the correct doc strings. Depends what you mean by "correct docstrings". It means they will all show the latest docstrings, which are usually the more correct ones, in my world. As you know all too well, documentation is not quite like code. It's for that same reason that we do not need to document every docstring change in the ChangeLog. > I set up a mechanism that has worked fine for decades > and enables each version to display its own doc string. Actually, it stopped working when we started to leave docstrings (and "worse": byte-code) in the .elc files. Ever since this (good) change was installed your mechanism has only worked for pre-loaded packages. And noone complained about it, AFAICT, so this subtlety you're trying to defend is really not worth the trouble. My bet is that if you try it, you won't notice the difference. Stefan