From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Undocumented hyperlinks in doc strings. Date: Wed, 15 Oct 2003 18:52:29 -0500 (CDT) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200310152352.h9FNqTH18721@raven.dms.auburn.edu> References: <200310090050.h990oIa15681@raven.dms.auburn.edu> <200310100327.h9A3REl20310@raven.dms.auburn.edu> <200310150138.h9F1cWg10456@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1066262372 9043 80.91.224.253 (15 Oct 2003 23:59:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 15 Oct 2003 23:59:32 +0000 (UTC) Cc: monnier@IRO.UMontreal.CA, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu Oct 16 01:59:29 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1A9vY9-0000QF-00 for ; Thu, 16 Oct 2003 01:59:29 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1A9vY9-00039H-00 for ; Thu, 16 Oct 2003 01:59:29 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1A9vX0-0003LT-Lj for emacs-devel@quimby.gnus.org; Wed, 15 Oct 2003 19:58:18 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1A9vWi-0003Ko-Sz for emacs-devel@gnu.org; Wed, 15 Oct 2003 19:58:00 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1A9vWB-0003FS-R8 for emacs-devel@gnu.org; Wed, 15 Oct 2003 19:57:58 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1A9vVg-0003At-0n; Wed, 15 Oct 2003 19:56:56 -0400 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id h9FNus5E002912; Wed, 15 Oct 2003 18:56:54 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id h9FNqTH18721; Wed, 15 Oct 2003 18:52:29 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: rms@gnu.org In-reply-to: (message from Richard Stallman on Wed, 15 Oct 2003 16:00:45 -0400) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:17130 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17130 Richard Stallman wrote: It is not unusual to comment out code that was replaced. Whether it is worth keeping depends on details. Maybe it would be just as well to delete that comment, but I would not say all such comments should always be deleted. Is this commenting out instead of deletion done for historical record or because one was not sure about the change and because hence there is the possibility that one might want to sooner or later revert to the original code? If the former, one could keep the code in question, after maybe pointing out more clearly that the code was the old alternative to 'help-function-def. Otherwise, the `define-button-type' for 'help-function-def contains a modified version of that code, with a comment explaining why that modification was necessary. Sincerely, Luc.