From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: display-completion-list should not strip text properties Date: Tue, 04 Sep 2007 02:48:28 +0300 Organization: JURTA Message-ID: <87wsv71esh.fsf@jurta.org> References: <877in93z6c.fsf@jurta.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1188865100 22389 80.91.229.12 (4 Sep 2007 00:18:20 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 4 Sep 2007 00:18:20 +0000 (UTC) Cc: bojohan+news@dd.chalmers.se, drew.adams@oracle.com, emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 04 02:18:20 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1ISM7U-00050x-57 for ged-emacs-devel@m.gmane.org; Tue, 04 Sep 2007 02:18:16 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ISM7O-0002FA-7Z for ged-emacs-devel@m.gmane.org; Mon, 03 Sep 2007 20:18:10 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1ISM6B-0000lE-NK for emacs-devel@gnu.org; Mon, 03 Sep 2007 20:16:55 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1ISM6B-0000ju-5e for emacs-devel@gnu.org; Mon, 03 Sep 2007 20:16:55 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ISM6A-0000jh-Oy for emacs-devel@gnu.org; Mon, 03 Sep 2007 20:16:54 -0400 Original-Received: from relay02.kiev.sovam.com ([62.64.120.197]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1ISM65-0001d0-NM; Mon, 03 Sep 2007 20:16:50 -0400 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay02.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1ISM5e-000M8w-OV; Tue, 04 Sep 2007 03:16:31 +0300 In-Reply-To: (Richard Stallman's message of "Mon\, 03 Sep 2007 14\:25\:32 -0400") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/23.0.50 (gnu/linux) X-Scanner-Signature: 6f32a619495bd298c8ed4cb100af0918 X-DrWeb-checked: yes X-SpamTest-Envelope-From: juri@jurta.org X-SpamTest-Group-ID: 00000000 X-SpamTest-Header: Not Detected X-SpamTest-Info: Profiles 1428 [September 3 2007] X-SpamTest-Info: helo_type=3 X-SpamTest-Info: {HEADERS: header Content-Type found without required header Content-Transfer-Encoding} X-SpamTest-Method: none X-SpamTest-Rate: 10 X-SpamTest-Status: Not detected X-SpamTest-Status-Extended: not_detected X-SpamTest-Version: SMTP-Filter Version 3.0.0 [0255], KAS30/Release X-Detected-Kernel: FreeBSD 4.8-5.1 (or MacOS X 10.2-10.3) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:77698 Archived-At: > Or using \, like in the query-replace string to eval part of the > replacement string: > > (defun foo () > "mumble \\,(propertize "toto" 'face 'highlight) titi" > whatever) > > That is a clean feature. I proposed only a new syntax for this feature, but now after thinking more about the whole idea, I see that this feature is too ad-hoc. Allowing to eval arbitrary expressions while printing the doc string in the Help buffer is too fragile approach. There is no guarantee that after all interacting evaluations there will a readable result in the Help buffer. I think a better approach is to use a markup language in doc strings, be it XHTML or even TexinfoML. Then using a style sheet it can be formatted nicely in the Help buffer. Example of a doc string: (defun foo () "To create a file, just visit it with C-x C-f. See also find-file-literally." ) Another advantage is this approach is that instead of using heuristics for guessing the formatting of the doc string (highlighting the function arguments, and making references for quoted symbols) it is possible to specify this explicitly. -- Juri Linkov http://www.jurta.org/emacs/