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, 17 Oct 2003 18:30:45 -0500 (CDT) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200310172330.h9HNUjt00965@raven.dms.auburn.edu> References: <200310090050.h990oIa15681@raven.dms.auburn.edu> <200310100327.h9A3REl20310@raven.dms.auburn.edu> <200310120334.h9C3Ygk26986@raven.dms.auburn.edu> <200310140323.h9E3Njf05047@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1066433912 31117 80.91.224.253 (17 Oct 2003 23:38:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 17 Oct 2003 23:38:32 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat Oct 18 01:38:30 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 1AAeAw-0005kA-00 for ; Sat, 18 Oct 2003 01:38:30 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AAeAv-00015g-00 for ; Sat, 18 Oct 2003 01:38:30 +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 1AAe9M-0001NI-Nk for emacs-devel@quimby.gnus.org; Fri, 17 Oct 2003 19:36:52 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AAe8q-0001Lc-C5 for emacs-devel@gnu.org; Fri, 17 Oct 2003 19:36:20 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AAe8J-0001Dq-D2 for emacs-devel@gnu.org; Fri, 17 Oct 2003 19:36:18 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AAe7m-00015B-Cf; Fri, 17 Oct 2003 19:35:14 -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 h9HNZDKk002085; Fri, 17 Oct 2003 18:35:13 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id h9HNUjt00965; Fri, 17 Oct 2003 18:30:45 -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 Fri, 17 Oct 2003 16:46:24 -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:17231 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17231 Richard Stallman wrote: Perhaps it should test that the variable has documentation as a variable. That would be cleaner. Would that do the job? Yes: ((and (boundp sym) (documentation-property sym 'variable-documentation)) (help-xref-button 8 'help-variable sym)) seems to work well. It would still make a hyperlink for the variable if explicitly preceded by the word "variable", so the author could still make hyperlinks for undocumented variables in (I would guess extremely uncommon) situations where this might actually be desirable. Sincerely, Luc.