From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7500: 24.0.50; doc string of `current-kill' Date: Sat, 27 Nov 2010 11:34:02 -0800 Message-ID: <1EBA2F5127644D558E53F883DFF2C07B@us.oracle.com> References: <666F7CF5EB224E20857BA05E5630DEC1@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1290887108 5558 80.91.229.12 (27 Nov 2010 19:45:08 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 27 Nov 2010 19:45:08 +0000 (UTC) Cc: 7500@debbugs.gnu.org To: "'Stefan Monnier'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 27 20:45:04 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 1PMQhj-0006xr-MX for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Nov 2010 20:45:04 +0100 Original-Received: from localhost ([127.0.0.1]:48406 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PMQhj-0006ec-5f for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Nov 2010 14:45:03 -0500 Original-Received: from [140.186.70.92] (port=54581 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PMQhZ-0006cp-TP for bug-gnu-emacs@gnu.org; Sat, 27 Nov 2010 14:44:55 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PMQhX-0008De-Iy for bug-gnu-emacs@gnu.org; Sat, 27 Nov 2010 14:44:53 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36428) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PMQhX-0008DR-H6 for bug-gnu-emacs@gnu.org; Sat, 27 Nov 2010 14:44:51 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PMQUA-0006KR-5O; Sat, 27 Nov 2010 14:31:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Nov 2010 19:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7500 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7500-submit@debbugs.gnu.org id=B7500.129088620424243 (code B ref 7500); Sat, 27 Nov 2010 19:31:02 +0000 Original-Received: (at 7500) by debbugs.gnu.org; 27 Nov 2010 19:30:04 +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 1PMQTD-0006Iy-3H for submit@debbugs.gnu.org; Sat, 27 Nov 2010 14:30:03 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PMQTB-0006IS-CG for 7500@debbugs.gnu.org; Sat, 27 Nov 2010 14:30:01 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oARJZSbC030155 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 27 Nov 2010 19:35:30 GMT Original-Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oARJPJIi008050; Sat, 27 Nov 2010 19:35:26 GMT Original-Received: from abhmt005.oracle.com by acsmt353.oracle.com with ESMTP id 818491331290886433; Sat, 27 Nov 2010 11:33:53 -0800 Original-Received: from dradamslap1 (/10.159.217.122) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 27 Nov 2010 11:33:53 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcuOYm3IBz+R+7MlS3S3vSFdyeAhYQAAesZQ X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 27 Nov 2010 14:31:02 -0500 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:41938 Archived-At: > > "If N is zero, `interprogram-paste-function' is set, and calling > > The above is parsed as > (and "if N is zero" > "`interprogram-paste-function' is set" > "calling ...") Thank you! That's just the kind of succinct statement that makes the meaning clear and advances the schmilblick. But if that is the meaning then we also need to document what happens if N is zero and one of the other conjuncts is false. Are you sure you don't mean the following instead? When N is zero, if i-p-f is set then calling... IOW, _IF_ N is zero then (if `i-p-f' is....) else ZZZ. (We already say what happens when N is not zero (ZZZ).) > since (and A B C) is usually written in (US) English "A, B, and C". > How 'bout: > > "If N is zero and `interprogram-paste-function' is set to a function > that returns a string or list of strings, then that string (or > list) is added to the front of the kill ring and the string (or > first string in the list) is returned as the latest kill." See above. If my guess above is correct, then: When N is zero, if `i-p-f' is set to... And since the return value of i-p-a is _supposed_ to be either nil or a string-or-list-of-strings: When N is zero, call the value of `interprogram-paste-function'. If that call returns nil, do nothing more and return the kill-ring car (??). Otherwise, prepend the returned string (or list of strings) to the kill ring and then return the new kill-ring car. See "??" above. What does `current-kill' return if `i-p-f' returns nil when called? the existing kill-ring head? nil?