From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Undocumented hyperlinks in doc strings. Date: 17 Oct 2003 09:47:31 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200310090050.h990oIa15681@raven.dms.auburn.edu> <200310100327.h9A3REl20310@raven.dms.auburn.edu> <200310150138.h9F1cWg10456@raven.dms.auburn.edu> <200310170332.h9H3WSC25439@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1066398915 4736 80.91.224.253 (17 Oct 2003 13:55:15 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 17 Oct 2003 13:55:15 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri Oct 17 15:55:12 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 1AAV4S-0002AT-00 for ; Fri, 17 Oct 2003 15:55:12 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AAV4S-0008Ij-00 for ; Fri, 17 Oct 2003 15:55:12 +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 1AAUyc-0008MV-LX for emacs-devel@quimby.gnus.org; Fri, 17 Oct 2003 09:49:10 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AAUxu-0008IP-VQ for emacs-devel@gnu.org; Fri, 17 Oct 2003 09:48:26 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AAUxO-00088N-Qm for emacs-devel@gnu.org; Fri, 17 Oct 2003 09:48:25 -0400 Original-Received: from [132.204.24.67] (helo=mercure.iro.umontreal.ca) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AAUxO-00088G-HW for emacs-devel@gnu.org; Fri, 17 Oct 2003 09:47:54 -0400 Original-Received: from vor.iro.umontreal.ca (vor.iro.umontreal.ca [132.204.24.42]) by mercure.iro.umontreal.ca (8.12.9/8.12.9) with ESMTP id h9HDlXUN024093; Fri, 17 Oct 2003 09:47:33 -0400 Original-Received: by vor.iro.umontreal.ca (Postfix, from userid 20848) id 98F853C63E; Fri, 17 Oct 2003 09:47:31 -0400 (EDT) Original-To: Luc Teirlinck In-Reply-To: <200310170332.h9H3WSC25439@raven.dms.auburn.edu> Original-Lines: 17 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 X-DIRO-MailScanner: Found to be clean 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:17207 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17207 > 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 We're getting somewhere. Stefan PS: When I started this thread, I hesitated because we'd been through that discussion already and it got stuck. Thank you for your constructive suggestions.