GNU bug report logs - #5580
23.1.91; doc string of toggle-truncate-lines

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 5580 in the body.
You can then email your comments to 5580 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: <emacs-pretest-bug <at> gnu.org>
Subject: 23.1.91; doc string of toggle-truncate-lines
Date: Sun, 14 Feb 2010 20:33:16 -0800

Doc string:

"Toggle whether to fold or truncate long lines for the current buffer.
With prefix argument ARG, truncate long lines if ARG is positive,
otherwise don't truncate them...."

The first sentence is incorrect.  What it says is that the function
toggles whether to fold-or-truncate, that is, it turns
folding-or-truncating alternately on and off (whatever that might
mean).

That's not what it does.  What it does is what the doc string used
to say it does, prior to Emacs 22: it _toggles truncating_.

Do not try to say, in the same sentence, that turning off
truncating means turning on folding.  Say that separately.

What the doc string should say:

"Toggle truncating of long lines for the current buffer.
When truncating is off, long lines are folded.
With prefix argument ARG, truncate long lines if ARG is positive,
otherwise fold them...."


In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600)
 of 2009-07-29 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4)'

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 5580 <at> debbugs.gnu.org
Subject: Re: 23.1.91; doc string of toggle-truncate-lines
Date: Wed, 13 Jul 2011 18:40:16 +0200

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

> What the doc string should say:
>
> "Toggle truncating of long lines for the current buffer.
> When truncating is off, long lines are folded.
> With prefix argument ARG, truncate long lines if ARG is positive,
> otherwise fold them...."

Thanks; I've installed this version.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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