GNU bug report logs - #35651
26.2; doc of `delimit-columns-*' commands

Previous Next

Package: emacs;

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

Date: Thu, 9 May 2019 15:14:02 UTC

Severity: minor

Tags: fixed

Found in version 26.2

Fixed in version 27.1

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

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#35651; Package emacs. (Thu, 09 May 2019 15:14:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Thu, 09 May 2019 15:14:02 GMT) Full text and rfc822 format available.

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: 26.2; doc of `delimit-columns-*' commands
Date: Thu, 9 May 2019 08:11:20 -0700 (PDT)

The doc strings are woefully inadequate.  "Prettify all columns..."  is
unclear.  The behavior - what the commands do - is not described at all.

And there is nothing in any manual about these commands either.  Users
are forced to consult the code to have any idea of what this "delimit
columns" stuff is all about.

Please do the Emacs thing for these commands: document them for users.

In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32)
 of 2019-04-13
Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749
Windowing system distributor `Microsoft Corp.', version 10.0.17134
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#35651; Package emacs. (Tue, 09 Jul 2019 03:45:02 GMT) Full text and rfc822 format available.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 35651 <at> debbugs.gnu.org
Subject: Re: bug#35651: 26.2; doc of `delimit-columns-*' commands
Date: Tue, 09 Jul 2019 04:51:13 +0200

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

> The doc strings are woefully inadequate.  "Prettify all columns..."  is
> unclear.  The behavior - what the commands do - is not described at all.
>
> And there is nothing in any manual about these commands either.  Users
> are forced to consult the code to have any idea of what this "delimit
> columns" stuff is all about.

That was a pretty minimal doc string.  I've now adapted some of the text
from the comments in the file as a doc string.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no
Added tag(s) fixed. Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Tue, 09 Jul 2019 03:45:02 GMT) Full text and rfc822 format available.
bug marked as fixed in version 27.1, send any further explanations to 35651 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com> Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Tue, 09 Jul 2019 03:45:02 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Tue, 06 Aug 2019 11:24:05 GMT) Full text and rfc822 format available.
This bug report was last modified 4 years and 263 days ago.

Previous Next

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