From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: (no subject) Date: Mon, 27 Sep 2004 10:53:59 -0400 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: References: <200409270032.i8R0W2B04571@raven.dms.auburn.edu> Reply-To: rms@gnu.org NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1096296901 30729 80.91.229.6 (27 Sep 2004 14:55:01 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 27 Sep 2004 14:55:01 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 27 16:54:54 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CBwtx-0006gm-00 for ; Mon, 27 Sep 2004 16:54:53 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBx08-0002K0-Jw for ged-emacs-devel@m.gmane.org; Mon, 27 Sep 2004 11:01:16 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CBwzQ-0001wz-M9 for emacs-devel@gnu.org; Mon, 27 Sep 2004 11:00:32 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CBwzP-0001vf-18 for emacs-devel@gnu.org; Mon, 27 Sep 2004 11:00:31 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBwzO-0001vK-Os for emacs-devel@gnu.org; Mon, 27 Sep 2004 11:00:30 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CBwt6-0001dO-BH for emacs-devel@gnu.org; Mon, 27 Sep 2004 10:54:00 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1CBwt5-0000GY-UB; Mon, 27 Sep 2004 10:54:00 -0400 Original-To: Luc Teirlinck In-reply-to: <200409270032.i8R0W2B04571@raven.dms.auburn.edu> (message from Luc Teirlinck on Sun, 26 Sep 2004 19:32:02 -0500 (CDT)) 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: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:27619 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:27619 But `enriched-translations' is defined in enriched.el with a def_const_. This suggest (maybe misleadingly) that the value should not be messed with. Thanks for noticing that. Please fix that. There also is the problem that the text quoted above makes things look much simpler than they are. If one wants to successfully add annotations for saving additional text properties, one will have to (at least) read through three docstrings, two of which are rather long and some parts of which assume at least some familiarity with Elisp and with the text/enriched standard. Could you add xrefs in the doc string for enriched-translations to point to the other two symbols whose doc strings people need to read? It might be better to mention this somewhere other than the Emacs Manual, but there is no logical other place to do it. I think it is right for the text in the Emacs manual to be brief and refer people to other sources.