From unknown Fri Aug 22 01:03:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6785: Documentation: `kill-region' needs to be re-filled in at least two places 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: Tue, 03 Aug 2010 18:30:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 6785 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 6785@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.128086015214795 (code B ref -1); Tue, 03 Aug 2010 18:30:03 +0000 Received: (at submit) by debbugs.gnu.org; 3 Aug 2010 18:29:12 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgMEi-0003qa-Fn for submit@debbugs.gnu.org; Tue, 03 Aug 2010 14:29:12 -0400 Received: from mail.gnu.org ([199.232.76.166] helo=mx10.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgMEg-0003qT-93 for submit@debbugs.gnu.org; Tue, 03 Aug 2010 14:29:11 -0400 Received: from lists.gnu.org ([199.232.76.165]:52105) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1OgMF6-0002bd-ME for submit@debbugs.gnu.org; Tue, 03 Aug 2010 14:29:36 -0400 Received: from [140.186.70.92] (port=49452 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OgMF5-0008Ef-Di for bug-gnu-emacs@gnu.org; Tue, 03 Aug 2010 14:29:36 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable version=3.3.1 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OgMF4-0004QG-AH for bug-gnu-emacs@gnu.org; Tue, 03 Aug 2010 14:29:35 -0400 Received: from mail-wy0-f169.google.com ([74.125.82.169]:34866) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgMF4-0004Pk-6G for bug-gnu-emacs@gnu.org; Tue, 03 Aug 2010 14:29:34 -0400 Received: by wyg36 with SMTP id 36so5155426wyg.0 for ; Tue, 03 Aug 2010 11:29:32 -0700 (PDT) MIME-Version: 1.0 Received: by 10.216.159.6 with SMTP id r6mr1081091wek.55.1280860171938; Tue, 03 Aug 2010 11:29:31 -0700 (PDT) Received: by 10.216.49.84 with HTTP; Tue, 3 Aug 2010 11:29:30 -0700 (PDT) Date: Tue, 3 Aug 2010 14:29:30 -0400 X-Google-Sender-Auth: y7XhpAgtS-HqPTOiI8eWKipvYmk Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-Spam-Score: -5.1 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -5.1 (-----) Documentation: `kill-region' needs to be re-filled in at least two places. ,---- (documentation 'kill-region) | | {...} | | This is the primitive for programs to kill text (as opposed to deleting it). | Supply two arguments, character positions indicating the stretch of text | to be killed. | | {...} | `---- " to be killed." ^ This needs to be refilled. As does this: ,---- | {...} | | Any command that calls this function is a "kill command". | If the previous command was also a kill command, | the text killed this time appends to the text killed last time | to make one entry in the kill ring. | `---- after: " {...} also a kill command," and before: "the text killed this {...}" Problem is current through Bzr-100920. -- /s_P\ From unknown Fri Aug 22 01:03:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6785: Documentation: `kill-region' needs to be re-filled in at least two places Resent-From: Juanma Barranquero Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 03 Aug 2010 21:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6785 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: MON KEY Cc: 6785@debbugs.gnu.org Received: via spool by 6785-submit@debbugs.gnu.org id=B6785.128086931019176 (code B ref 6785); Tue, 03 Aug 2010 21:02:02 +0000 Received: (at 6785) by debbugs.gnu.org; 3 Aug 2010 21:01:50 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgOcQ-0004zF-CZ for submit@debbugs.gnu.org; Tue, 03 Aug 2010 17:01:50 -0400 Received: from mail-gy0-f196.google.com ([209.85.160.196]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgOcO-0004zA-8x for 6785@debbugs.gnu.org; Tue, 03 Aug 2010 17:01:48 -0400 Received: by gyg8 with SMTP id 8so777861gyg.3 for <6785@debbugs.gnu.org>; Tue, 03 Aug 2010 14:02:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:mime-version:received:in-reply-to :references:from:date:message-id:subject:to:cc:content-type :content-transfer-encoding; bh=Tem1iDFzEsyxmbr6ByBag6tKCRNdR3jr17lAb2B1PsM=; b=eUSwj0gq7XCMLyTaWFwaTSU4Fk72ODYR2TOMQQGyPRZTFWBo28v8ULaCTKbeeLqOwa Qab+e7Q05wnjop+hYq0bK1ajirsyteA/l8C+ZzSY0508d8QE4lMm03ryWeojyMqISxeE HPPxcA/l9MXN0xq9aAd0L2bOoZKiJkZk2C/FI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:content-transfer-encoding; b=XSsTz4/p1IdPT1fpv9Sv0rX4WJSh3bjm89VvGwo+7jHlkQjRBldeoVW/pEz6TSz5Km dolUKqORqOKDFzlrptLHIngeLyjboju+6ueKRU6bO3ZhIvRCwy+mKjpRytbTlBc69jNx m7bzURzgqyX8VgiNg2jNsDzdz5pI60tSxykWo= Received: by 10.100.171.16 with SMTP id t16mr8809193ane.83.1280869334649; Tue, 03 Aug 2010 14:02:14 -0700 (PDT) MIME-Version: 1.0 Received: by 10.231.162.4 with HTTP; Tue, 3 Aug 2010 14:01:54 -0700 (PDT) In-Reply-To: References: From: Juanma Barranquero Date: Tue, 3 Aug 2010 23:01:54 +0200 Message-ID: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) On Tue, Aug 3, 2010 at 20:29, MON KEY wrote: > " to be killed." > =C2=A0^ > This needs to be refilled. OK. > | Any command that calls this function is a "kill command". > | If the previous command was also a kill command, > | the text killed this time appends to the text killed last time > | to make one entry in the kill ring. > after: > > " {...} also a kill command," > > and before: > > "the text killed this {...}" Most docstrings aren't exactly filled up to the fill-column, but depending on legibility, punctuation, etc. =C2=A0 =C2=A0 Juanma From unknown Fri Aug 22 01:03:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6785: Documentation: `kill-region' needs to be re-filled in at least two places 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 6785 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Juanma Barranquero Cc: 6787@debbugs.gnu.org, 6785@debbugs.gnu.org Received: via spool by 6785-submit@debbugs.gnu.org id=B6785.12809493599899 (code B ref 6785); Wed, 04 Aug 2010 19:16:02 +0000 Received: (at 6785) by debbugs.gnu.org; 4 Aug 2010 19:15:59 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgjRX-0002Zb-84 for submit@debbugs.gnu.org; Wed, 04 Aug 2010 15:15:59 -0400 Received: from mail-ey0-f172.google.com ([209.85.215.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OgjRU-0002ZQ-DF for 6785@debbugs.gnu.org; Wed, 04 Aug 2010 15:15:57 -0400 Received: by eyb7 with SMTP id 7so1998332eyb.3 for <6785@debbugs.gnu.org>; Wed, 04 Aug 2010 12:16:25 -0700 (PDT) MIME-Version: 1.0 Received: by 10.216.44.208 with SMTP id n58mr2462967web.73.1280949384839; Wed, 04 Aug 2010 12:16:24 -0700 (PDT) Received: by 10.216.49.84 with HTTP; Wed, 4 Aug 2010 12:16:24 -0700 (PDT) In-Reply-To: References: Date: Wed, 4 Aug 2010 15:16:24 -0400 X-Google-Sender-Auth: kwdP3jiQCLF9Nw-OmEIgj-KGFyo Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -1.8 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.0 (---) 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\ From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 02 12:43:11 2011 Received: (at control) by debbugs.gnu.org; 2 Jul 2011 16:43:11 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qd3Hj-0002la-JQ for submit@debbugs.gnu.org; Sat, 02 Jul 2011 12:43:11 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qd3Hh-0002lM-HF for control@debbugs.gnu.org; Sat, 02 Jul 2011 12:43:09 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qd3HW-00008S-Fa for control@debbugs.gnu.org; Sat, 02 Jul 2011 18:42:58 +0200 Date: Sat, 02 Jul 2011 18:42:57 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #6785 X-MailScanner-ID: 1Qd3HW-00008S-Fa X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310229779.00057@+pjBCyZDh/7CCUBIm0R2aQ X-Spam-Status: No X-Spam-Score: -2.9 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.9 (--) close 6785