From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/54982 Path: main.gmane.org!not-for-mail From: Reiner Steib <4.uce.03.r.s@nurfuerspam.de> Newsgroups: gmane.emacs.gnus.general Subject: Re: Adding :link '(custom-manual ...) in defcustom Date: Sat, 29 Nov 2003 00:52:09 +0100 Organization: Dept. of Theoretical Physics, University of Ulm Sender: ding-owner@lists.math.uh.edu Message-ID: References: Reply-To: reiner.steib@gmx.de NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1070063583 31699 80.91.224.253 (28 Nov 2003 23:53:03 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 28 Nov 2003 23:53:03 +0000 (UTC) Original-X-From: ding-owner+M3522@lists.math.uh.edu Sat Nov 29 00:53:00 2003 Return-path: Original-Received: from malifon.math.uh.edu ([129.7.128.13]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1APsPz-00007b-00 for ; Sat, 29 Nov 2003 00:52:59 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by malifon.math.uh.edu with smtp (Exim 3.20 #1) id 1APsPg-0006Cz-00; Fri, 28 Nov 2003 17:52:40 -0600 Original-Received: from justine.libertine.org ([66.139.78.221] ident=postfix) by malifon.math.uh.edu with esmtp (Exim 3.20 #1) id 1APsPX-0006Cr-00 for ding@lists.math.uh.edu; Fri, 28 Nov 2003 17:52:31 -0600 Original-Received: from main.gmane.org (main.gmane.org [80.91.224.249]) by justine.libertine.org (Postfix) with ESMTP id A231C3A0034 for ; Fri, 28 Nov 2003 17:52:30 -0600 (CST) Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 1APsPV-00077h-00 for ; Sat, 29 Nov 2003 00:52:29 +0100 Mail-Followup-To: ding@gnus.org X-Injected-Via-Gmane: http://gmane.org/ Original-To: ding@gnus.org Original-Received: from sea.gmane.org ([80.91.224.252]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1APsPU-00077Y-00 for ; Sat, 29 Nov 2003 00:52:28 +0100 Original-Received: from news by sea.gmane.org with local (Exim 3.35 #1 (Debian)) id 1APsPU-0008EM-00 for ; Sat, 29 Nov 2003 00:52:28 +0100 Original-Lines: 75 Original-X-Complaints-To: usenet@sea.gmane.org X-Face: .*T0'iU(sujq_j9\J>-d4fg;N/1++U#U$_5ii6k.=|"-n'?5O:Hyz&wi'-!I~,}7~GgT=0S /&-R5sbkNy5+Xo1y{Tw2KKxi@Xh"g@]Qc|.U<*]WDd)qvGowFDvfU1F]{EDho:7P0@|oOD=Bc{K4?> WP68K[Mx:}=`ZT'6g4'f+g?;`vri2!)xGy}3:=l'(/Cea0l4lo^H5#@/Z3ev Mail-Copies-To: nobody User-Agent: Gnus/5.1003 (Gnus v5.10.3) Emacs/21.3 (gnu/linux) Cancel-Lock: sha1:+WVaxfX39e+N3+BQNxwFwVEGEwc= Precedence: bulk Xref: main.gmane.org gmane.emacs.gnus.general:54982 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:54982 On Fri, Nov 28 2003, Reiner Steib wrote: > I'm now aware of a policy when to add them and when not. Any ^^^ not > pointers? [1] And I couldn't see any usage pattern. I thought that > they were just missing, because the programmer forgot to add them in > the first place. ,----[ ] | From: Per Abrahamsen | Subject: Re: defgroup / customize-apropos | Newsgroups: comp.emacs | Date: Sun, 24 Feb 2002 09:47:29 +0100 | Message-ID: | | "James Crowell" writes: | | > I looked at the 'defcustom' documentation and did not see any ':tag' | > description or any ':' parameter that I thought would help me. | | It is documented in the Emacs Lisp Reference Manual, but unfortunately | omitted from the doc string. Fixed in Emacs 21.3. | | Even worse, the :link tag was also omitted, and unlike :tag it is | something everyone should use. `---- s/21.3/CVS HEAD/ > [1] (info "(elisp)Variable Definitions") doesn't mention :link at all. > `C-h f defcustom RET' neither. FWIW, I found something in (info "(elisp)Common Keywords") of CVS HEAD. But no "policy". ,----[ (info "(elisp)Common Keywords") ] | `:link LINK-DATA' | Include an external link after the documentation string for this | item. This is a sentence containing an active field which | references some other documentation. | | There are four alternatives you can use for LINK-DATA: | | `(custom-manual INFO-NODE)' | Link to an Info node; INFO-NODE is a string which specifies | the node name, as in `"(emacs)Top"'. The link appears as | `[manual]' in the customization buffer. | | `(info-link INFO-NODE)' | Like `custom-manual' except that the link appears in the | customization buffer with the Info node name. | | `(url-link URL)' | Link to a web page; URL is a string which specifies the URL. | The link appears in the customization buffer as URL. | | `(emacs-commentary-link LIBRARY)' | Link to the commentary section of a library; LIBRARY is a | string which specifies the library name. | | You can specify the text to use in the customization buffer by | adding `:tag NAME' after the first element of the LINK-DATA; for | example, `(info-link :tag "foo" "(emacs)Top")' makes a link to the | Emacs manual which appears in the buffer as `foo'. | | An item can have more than one external link; however, most items | have none at all. `---- Bye, Reiner. -- ,,, (o o) ---ooO-(_)-Ooo--- PGP key available via WWW http://rsteib.home.pages.de/