GNU bug report logs - #6788
Documentation: `delete-region' should explicity mention its parameters.

Previous Next

Package: emacs;

Reported by: MON KEY <monkey <at> sandpframing.com>

Date: Tue, 3 Aug 2010 19:11:01 UTC

Severity: minor

Tags: fixed

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 #12 received at 6788 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: MON KEY <monkey <at> sandpframing.com>
Cc: 6788 <at> debbugs.gnu.org
Subject: Re: Documentation: `delete-region' should explicity mention its
	parameters.
Date: Thu, 14 Jul 2011 15:41:20 +0200

MON KEY <monkey <at> sandpframing.com> writes:

> While it is reasonable that the docs indicate the _command_ will:
>
>  "Delete the text between point and mark."
>
> The docstring should also explicitly mention the parameters elsewhere
> as delete region can be called programmatically (and probably more
> often so than from user input).  The following portion:
>
>  "When called from a program, expects two arguments, positions
>   (integers or markers) specifying the stretch to be deleted."

I've now clarified the doc string in Emacs 24.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/
This bug report was last modified 14 years and 31 days ago.

Previous Next

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