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: 10 Oct 2003 10:14:50 -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> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1065795730 4665 80.91.224.253 (10 Oct 2003 14:22:10 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 10 Oct 2003 14:22:10 +0000 (UTC) Cc: rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri Oct 10 16:22:08 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 1A7y9g-0000bN-00 for ; Fri, 10 Oct 2003 16:22: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 1A7y9e-0001XK-00 for ; Fri, 10 Oct 2003 16:22: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 1A7y8Q-0002GD-Bk for emacs-devel@quimby.gnus.org; Fri, 10 Oct 2003 10:20:50 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1A7y6s-0001GI-Nq for emacs-devel@gnu.org; Fri, 10 Oct 2003 10:19:14 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1A7y57-0008FA-0M for emacs-devel@gnu.org; Fri, 10 Oct 2003 10:17:56 -0400 Original-Received: from [132.204.24.67] (helo=mercure.iro.umontreal.ca) by monty-python.gnu.org with esmtp (Exim 4.24) id 1A7y2m-0007KX-AZ; Fri, 10 Oct 2003 10:15:00 -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 h9AEEoKS028886; Fri, 10 Oct 2003 10:14:50 -0400 Original-Received: by vor.iro.umontreal.ca (Postfix, from userid 20848) id 6B8B73C549; Fri, 10 Oct 2003 10:14:50 -0400 (EDT) Original-To: Luc Teirlinck In-Reply-To: <200310100327.h9A3REl20310@raven.dms.auburn.edu> Original-Lines: 13 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 X-MailScanner-DIRO: 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:17014 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17014 > but I made the double semicolons in the commented out code into > triple semicolons myself, because that is how (elisp)Comment Tips > wants code commented out. Please don't. It might be documented that way, but outline-minor-mode behaves very poorly with them. And it's very hard to "fix" outline-minor-mode because it can't tell the difference between the case where the three-semi-comment is used for a major heading or for commented out code. I think the doc should be fixed. Stefan