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: Thu, 16 Oct 2003 22:32:28 -0500 (CDT) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200310170332.h9H3WSC25439@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 1066362011 7306 80.91.224.253 (17 Oct 2003 03:40:11 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 17 Oct 2003 03:40:11 +0000 (UTC) Cc: monnier@IRO.UMontreal.CA, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri Oct 17 05:40:09 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 1AALTE-00020N-00 for ; Fri, 17 Oct 2003 05:40:08 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AALTE-0007Wg-00 for ; Fri, 17 Oct 2003 05:40:08 +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 1AALRq-0003dN-O5 for emacs-devel@quimby.gnus.org; Thu, 16 Oct 2003 23:38:42 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AALRC-0003Vb-Mv for emacs-devel@gnu.org; Thu, 16 Oct 2003 23:38:02 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AALQf-0003Is-H5 for emacs-devel@gnu.org; Thu, 16 Oct 2003 23:38:00 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AALQ7-0003CE-SL; Thu, 16 Oct 2003 23:36:55 -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 h9H3as5E009784; Thu, 16 Oct 2003 22:36:54 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id h9H3WSC25439; Thu, 16 Oct 2003 22:32:28 -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 Thu, 16 Oct 2003 10:06:58 -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:17191 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17191 Richard Stallman wrote: That could be mended by a slight change in the current standard (which, to me, means: "as recommended in the Elisp manual") way of commenting out code, which I proposed in an earlier message: follow the semicolons by a single space if the line is meant to be a heading line and by at least two spaces otherwise. That convention, in itself, would not hurt anything. But if we wanted to follow it all the time, what exactly would we make comment-region do, for Lisp code? Would we make it insert two spaces always? Two spaces, when given an arg of 3? And what would uncomment-region do? If we make it try to remove two spaces (when there are two), then it would uncomment all the existing commented-out code wrong. I am not saying that these answer have to be perfect, but we need to pick answers. The three semicolons seem to be mainly important for commented out code _inside_ functions, to prevent C-M-q from messing things up badly. If it would be considered OK to use two semicolons for commenting out entire top-level forms, then I believe we would not even need to worry about comment-region or uncomment-region. Indeed the only line that would not automatically get the two spaces anyway would appear to be the introductory line, like ;; this used: in the example we have been looking at. This line has to be written in manually and deleted manually after uncommenting anyway. People would only have to type an extra space at the beginning of that one line they have to type in anyway. If using three semicolons for commented out entire top level forms would be important, then things would get more complicated. Sincerely, Luc.