GNU bug report logs - #18335
24.4.50; Typo: title of `enriched.txt' is `enriched.el'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 18335 in the body.
You can then email your comments to 18335 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.4.50; Typo: title of `enriched.txt' is `enriched.el'
Date: Tue, 26 Aug 2014 21:32:37 -0700 (PDT)

Presumably, someone renamed the file and forgot to update the title at
the top of the text.  This oublie predates even Emacs 20, it seems, for
there the file is named `enriched.doc' (it is the same file, with the
same name, for Emacs 24.3 and prior) but the title remains
`enriched.el'.

But I wonder about this: The file was presumably originally
`enriched.el', and so presumably in Emacs Lisp mode.  The Emacs manual,
node `Enriched Text' currently says this:

 Enriched mode is typically used with Text mode (*note Text Mode::).
 It is _not_ compatible with Font Lock mode, which is used by many major
 modes, including most programming language modes, for syntax
 highlighting (*note Font Lock::).  Unlike Enriched mode, Font Lock mode
 assigns text properties automatically, based on the current buffer
 contents; those properties are not saved to disk.

I would like to know more about just what this incompatibility amounts
to.  This text is new with Emacs 24.4, and there is no more explanation
than that.  Why was this added?  Why not let users know what it means?

If you mean only that font-lock highlighting interferes with
enriched-mode highlighting, that is one thing - and in this,
enriched-mode is no different from other highlighting using
text-property `face'.  If you something stronger wrt incompatibility,
then please document what it is.


In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-06-28 on ODIEONE
Bzr revision: 117431 rgm <at> gnu.org-20140628015517-eku6hj8mpgcvfnso
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/snapshot/trunk
 --enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
 LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
 -Ic:/Devel/emacs/include''

Message #12 received at 18335-done <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: 18335-done <at> debbugs.gnu.org
Subject: Re: bug#18335: 24.4.50; Typo: title of `enriched.txt' is `enriched.el'
Date: Wed, 27 Aug 2014 00:51:09 -0400

Drew Adams wrote:

> the title remains `enriched.el'.

It's describing the features of enriched.el.

Message #15 received at 18335-done <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Glenn Morris <rgm <at> gnu.org>, 18335-done <at> debbugs.gnu.org
Subject: RE: bug#18335: 24.4.50; Typo: title of `enriched.txt' is `enriched.el'
Date: Tue, 26 Aug 2014 22:06:10 -0700 (PDT)

> > the title remains `enriched.el'.
> 
> It's describing the features of enriched.el.

Well of course it does that - anything that describes Enriched mode
does that.  But it certainly is not describing `enriched.el'. 
It tells you nothing about the code.

And Emacs does not introduce this file to its users as something
that describes `enriched.el'.  Not at all.  This is how Emacs
introduces the file to users - in (emacs) `Enriched Text':

  The file `enriched.txt' in Emacs's `data-directory' serves as an
  example of the features of Enriched mode.
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The file serves as our primary example, for ordinary users (not
necessarily Lispers), of Enriched mode.  It is end-user doc about
Enriched mode.  It is not an explanation or description of
`enriched.el'.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.