* bug#35651: 26.2; doc of `delimit-columns-*' commands
@ 2019-05-09 15:11 Drew Adams
2019-07-09 2:51 ` Lars Ingebrigtsen
0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2019-05-09 15:11 UTC (permalink / raw)
To: 35651
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''
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#35651: 26.2; doc of `delimit-columns-*' commands
2019-05-09 15:11 bug#35651: 26.2; doc of `delimit-columns-*' commands Drew Adams
@ 2019-07-09 2:51 ` Lars Ingebrigtsen
0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2019-07-09 2:51 UTC (permalink / raw)
To: Drew Adams; +Cc: 35651
Drew Adams <drew.adams@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
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2019-07-09 2:51 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-05-09 15:11 bug#35651: 26.2; doc of `delimit-columns-*' commands Drew Adams
2019-07-09 2:51 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).