From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: "Stefan Monnier <foo@acm.com>" <monnier+gnu.emacs.help/news/@flint.cs.yale.edu>
Newsgroups: gmane.emacs.help
Subject: Re: dynamical parts of a docstring
Date: 22 Oct 2002 10:55:13 -0400
Organization: Yale University
Sender: help-gnu-emacs-admin@gnu.org
Message-ID: <5lu1je8qwe.fsf@rum.cs.yale.edu>
References: <uznt61zg0.fsf@sdm.de>
NNTP-Posting-Host: main.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Trace: main.gmane.org 1035299159 15587 80.91.224.249 (22 Oct 2002 15:05:59 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Tue, 22 Oct 2002 15:05:59 +0000 (UTC)
Return-path: <help-gnu-emacs-admin@gnu.org>
Original-Received: from monty-python.gnu.org ([199.232.76.173])
	by main.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 1840bW-000435-00
	for <gnu-help-gnu-emacs@m.gmane.org>; Tue, 22 Oct 2002 17:05:58 +0200
Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.10)
	id 1840bw-0004GJ-00; Tue, 22 Oct 2002 11:06:24 -0400
Original-Path: shelby.stanford.edu!newsfeed.stanford.edu!news.uchicago.edu!news-hog.berkeley.edu!ucberkeley!news.ycc.yale.edu!rum.cs.yale.edu!rum.cs.yale.edu
Original-Newsgroups: gnu.emacs.help
Original-Lines: 20
Original-NNTP-Posting-Host: rum.cs.yale.edu
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50
X-Original-NNTP-Posting-Host: rum.cs.yale.edu
X-Original-Trace: 22 Oct 2002 10:55:14 -0400, rum.cs.yale.edu
Original-Xref: shelby.stanford.edu gnu.emacs.help:106277
Original-To: help-gnu-emacs@gnu.org
Errors-To: help-gnu-emacs-admin@gnu.org
X-BeenThere: help-gnu-emacs@gnu.org
X-Mailman-Version: 2.0.11
Precedence: bulk
List-Help: <mailto:help-gnu-emacs-request@gnu.org?subject=help>
List-Post: <mailto:help-gnu-emacs@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/help-gnu-emacs>,
	<mailto:help-gnu-emacs-request@gnu.org?subject=subscribe>
List-Id: Users list for the GNU Emacs text editor <help-gnu-emacs.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/help-gnu-emacs>,
	<mailto:help-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/help-gnu-emacs/>
Xref: main.gmane.org gmane.emacs.help:2827
X-Report-Spam: http://spam.gmane.org/gmane.emacs.help:2827

>>>>> "Klaus" == Klaus Berndl <Klaus.Berndl@sdm.de> writes:
> Is it possible to add some elisp-code to a docstring which is evaluated at
> the time the docstring is displayed (e.g. by calling `describe-variable'
> or `customize-option') so the result of this code is added to the
> docstring at display-time??

Right now, no.  Someone requested the same kind of feature a year or two
ago, and a few days ago such a feature could have been used in order
not to duplicate the documentation of directory-files.

I think I even coded up a hack that allowed embedded elisp in docstrings
that looked like:

        Call a function and return \\\\(fun arg1 arg2).

but I think I had some problems because the escape sequence accidentally
appeared in a few pre-existing docstrings or somesuch.


        Stefan