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: Fri, 10 Oct 2003 13:21:58 -0500 (CDT) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200310101821.h9AILwD24100@raven.dms.auburn.edu> References: <200310090050.h990oIa15681@raven.dms.auburn.edu> <200310100327.h9A3REl20310@raven.dms.auburn.edu> <200310101531.h9AFVnX22383@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1065810664 4764 80.91.224.253 (10 Oct 2003 18:31:04 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 10 Oct 2003 18:31:04 +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 20:31:02 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 1A822Y-00017U-00 for ; Fri, 10 Oct 2003 20:31:02 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1A822Y-0002T4-00 for ; Fri, 10 Oct 2003 20:31:02 +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 1A81yU-00013F-Ua for emacs-devel@quimby.gnus.org; Fri, 10 Oct 2003 14:26:50 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1A81yP-000130-NI for emacs-devel@gnu.org; Fri, 10 Oct 2003 14:26:45 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1A81xt-0000zb-Ta for emacs-devel@gnu.org; Fri, 10 Oct 2003 14:26:44 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1A81xs-0000zO-V4; Fri, 10 Oct 2003 14:26:13 -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 h9AIQAAJ025767; Fri, 10 Oct 2003 13:26:11 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id h9AILwD24100; Fri, 10 Oct 2003 13:21:58 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: monnier@IRO.UMontreal.CA In-reply-to: (message from Stefan Monnier on 10 Oct 2003 13:23:28 -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:17022 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17022 Stefan Monnier wrote: C-M-q doesn't need to differentiate between major headings and other comments, so as far as I know, it is completely unaffected by the issue discussed here. Unless I missed something, of course. Well at least _something_ needs to be changed to the current ";; this used:" commented out code fragment in `help-make-xrefs', if it is to become "C-M-q invariant". Just go to the beginning of the `help-make-xrefs' defun and do C-M-q. I doubt that the result is what you really want. Maybe: ((match-string 7) ;; this used: ;; #'(lambda (arg) ;; (let ((location ;; (find-function-noselect arg))) ;; (pop-to-buffer (car location)) ;; (goto-char (cdr location)))) (help-xref-button 8 'help-function-def sym)) But I do turn the three-semi to two-semi when I come across them with outline-minor-mode. If you just do that mechanically, without checking that the result is "C-M-q" invariant, and then somebody else mechanically applies C-M-q to the function, the result is not going to look good. In the case of `help-make-xrefs' such a mechanical change appears to have been made. I believe this should be fixed one way or the other. The current indentation is a "C-M-q hazard". Sincerely, Luc.