GNU bug report logs - #8678
24.0.50; `isearch-barrier' referred to in doc string, but it has no doc itself

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Mon, 16 May 2011 17:59:01 UTC

Severity: minor

Tags: fixed

Found in version 24.0.50

Fixed in version 24.1

Done: Lars Magne Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log

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.0.50;
	`isearch-barrier' referred to in doc string, but it has no doc itself
Date: Mon, 16 May 2011 10:58:35 -0700

There are many internal variables in isearch.el that have no doc strings
and no comments that would help communicate the design (intention) for
readers of the code.  I wish this info were added.
 
At the very least, a doc string is needed for `isearch-barrier', because
it is referred to in the doc string of `isearch-fallback'.  IOW, we are
using it to explain something else, yet it is an unknown.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-05-10 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/build/include'
This bug report was last modified 13 years and 318 days ago.

Previous Next

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