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: (no subject) Date: Sun, 26 Sep 2004 19:32:02 -0500 (CDT) Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <200409270032.i8R0W2B04571@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1096245170 16491 80.91.229.6 (27 Sep 2004 00:32:50 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 27 Sep 2004 00:32:50 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 27 02:32:38 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 1CBjRV-0005JD-00 for ; Mon, 27 Sep 2004 02:32:37 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBjXi-00063q-DG for ged-emacs-devel@m.gmane.org; Sun, 26 Sep 2004 20:39:02 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CBjXb-00063b-Ow for emacs-devel@gnu.org; Sun, 26 Sep 2004 20:38:55 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CBjXa-00063P-6K for emacs-devel@gnu.org; Sun, 26 Sep 2004 20:38:55 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBjXa-00063M-3X for emacs-devel@gnu.org; Sun, 26 Sep 2004 20:38:54 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CBjRL-00087P-3d for emacs-devel@gnu.org; Sun, 26 Sep 2004 20:32:27 -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 i8R0WQiU021183 for ; Sun, 26 Sep 2004 19:32:26 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id i8R0W2B04571; Sun, 26 Sep 2004 19:32:02 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org 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:27590 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:27590 `(emacs)Requesting Formatted Text' contains: You can add annotations for saving additional text properties, which Emacs normally does not save, by adding to `enriched-translations'. Note that the text/enriched standard requires any non-standard annotations to have names starting with `x-', as in `x-read-only'. This ensures that they will not conflict with standard annotations that may be added later. *Note Text Properties: (elisp)Text Properties, for more information about text properties. But `enriched-translations' is defined in enriched.el with a def_const_. This suggest (maybe misleadingly) that the value should not be messed with. Also, if enriched.el gets (re-)loaded, any user redefined value will be overridden again. I believe that the defconst should be changed to a defvar. There seem to be unusually many defconst's in enriched.el. Do some other ones also need to be made into defvar's? 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. Depending on what one wants to do, one might have to be able to write reasonably complex Lisp functions. Remember that this is the Emacs (not Elisp) manual. Do we want to keep the above paragraph in the Emacs manual? It also occurs in enriched.doc, where it more clearly seems aimed at a more sophisticated audience: - You can add annotations for your own text properties by making additions to enriched-translations. Note that the standard requires you to name your annotation starting "x-" (as in "x-read-only"). Please send me any such additions that you think might be of general interest so that I can include them in the distribution. I personally believe that we should make `enriched-translations' into a defvar, regardless of whether we keep the above text in the Emacs manual. Sincerely, Luc.