From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.bugs Subject: bug#6787: bug#6785: Documentation: `kill-region' needs to be re-filled in at least two places Date: Wed, 4 Aug 2010 15:16:24 -0400 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1280950704 22903 80.91.229.12 (4 Aug 2010 19:38:24 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 4 Aug 2010 19:38:24 +0000 (UTC) Cc: 6787@debbugs.gnu.org, 6785@debbugs.gnu.org To: Juanma Barranquero Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Aug 04 21:38:21 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OgjnA-0002ij-Qf for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Aug 2010 21:38:21 +0200 Original-Received: from localhost ([127.0.0.1]:53580 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OgjnA-0005IR-5K for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Aug 2010 15:38:20 -0400 Original-Received: from [140.186.70.92] (port=43153 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ogjmz-0005EE-8l for bug-gnu-emacs@gnu.org; Wed, 04 Aug 2010 15:38:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Ogjmx-0006rE-VB for bug-gnu-emacs@gnu.org; Wed, 04 Aug 2010 15:38:09 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39706) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ogjmx-0006r9-RR for bug-gnu-emacs@gnu.org; Wed, 04 Aug 2010 15:38:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OgjRa-0002Zx-Un; Wed, 04 Aug 2010 15:16:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Aug 2010 19:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6787 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6787-submit@debbugs.gnu.org id=B6787.12809493599903 (code B ref 6787); Wed, 04 Aug 2010 19:16:02 +0000 Original-Received: (at 6787) by debbugs.gnu.org; 4 Aug 2010 19:15:59 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgjRX-0002Ze-Ga for submit@debbugs.gnu.org; Wed, 04 Aug 2010 15:15:59 -0400 Original-Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgjRU-0002ZR-JT for 6787@debbugs.gnu.org; Wed, 04 Aug 2010 15:15:57 -0400 Original-Received: by wyb40 with SMTP id 40so5577944wyb.3 for <6787@debbugs.gnu.org>; Wed, 04 Aug 2010 12:16:25 -0700 (PDT) Original-Received: by 10.216.44.208 with SMTP id n58mr2462967web.73.1280949384839; Wed, 04 Aug 2010 12:16:24 -0700 (PDT) Original-Received: by 10.216.49.84 with HTTP; Wed, 4 Aug 2010 12:16:24 -0700 (PDT) In-Reply-To: X-Google-Sender-Auth: kwdP3jiQCLF9Nw-OmEIgj-KGFyo X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 04 Aug 2010 15:16:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:39238 Archived-At: On Tue, Aug 3, 2010 at 6:07 PM, Juanma Barranquero wrote= : > On Tue, Aug 3, 2010 at 23:17, MON KEY wrote: > >> In general, that doc prob. needs some attention w/re formatting, >> and adding =C2=A0some more "\n" would go a long way. > > Don't hesitate to send a patch :-) OK. Following is my attempt at tweaking that doc. Note, I took the liberty of also adjusting for the problem I described in bug#6787 http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D6787 "Kill (\"cut\") buffer text in region between point and mark. This removes the text from the buffer saving it on the kill ring. Use the command \\[yank] to retrieve the killed text on the kill ring. \(To save the region without killing it, use \\[kill-ring-save].) Commands which call this function are \"kill commands\". When the most recent previous command was a kill command, the text to be killed by the current kill command can be appended to the most recently killed text on the kill ring such that the killed text of each of the two kill commnads are combined into one entry at the beginning of the kill ring= . To append the killed region to the last killed text, use \\[append-next-kil= l] before \\[kill-region]. When invoked in a read-only buffer Emacs will ding and does not remove the text from the buffer, however the text of the region is placed on kill ring= . This means a region killing command will \"copy\" text in read-only buffers even when it does not appear to be killed (\"cut\") in the buffer. This function is intended as the primary interface for lisp programs which kill text (as opposed to deleting text as if by `delete-region'). When called from a program the arguments BEG and END are buffer positions indicating the stretch of text to be killed. When the optional third arg YANK-HANDLER is non-nil, the killed text has th= e yank-handler property set non-nil. Setting this property non-nil affects wether yank commands will apply `yank-excluded-properties' as described in the doc string for `insert-for-yank-1', which see." > Juanma > -- /s_P\