From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Jim Blandy" Newsgroups: gmane.emacs.devel Subject: Re: proced-refine: confusing doc string Date: Sun, 28 Sep 2008 23:27:11 -0700 Message-ID: <8f2776cb0809282327o701b7ba1y6953826a5117a99a@mail.gmail.com> References: <18655.56783.720526.517468@gargle.gargle.HOWL> <48DFDF4F.5080704@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_43270_1007071.1222669631205" X-Trace: ger.gmane.org 1222669651 26300 80.91.229.12 (29 Sep 2008 06:27:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 29 Sep 2008 06:27:31 +0000 (UTC) Cc: raman@users.sf.net, emacs-devel@gnu.org To: "Lennart Borgman (gmail)" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 29 08:28:29 2008 connect(): Connection refused Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1KkCF6-00061Q-85 for ged-emacs-devel@m.gmane.org; Mon, 29 Sep 2008 08:28:24 +0200 Original-Received: from localhost ([127.0.0.1]:44400 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KkCE3-0005zY-J4 for ged-emacs-devel@m.gmane.org; Mon, 29 Sep 2008 02:27:19 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KkCDy-0005yr-6O for emacs-devel@gnu.org; Mon, 29 Sep 2008 02:27:14 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KkCDw-0005yW-Ca for emacs-devel@gnu.org; Mon, 29 Sep 2008 02:27:12 -0400 Original-Received: from [199.232.76.173] (port=43767 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KkCDw-0005yT-6G for emacs-devel@gnu.org; Mon, 29 Sep 2008 02:27:12 -0400 Original-Received: from yw-out-1718.google.com ([74.125.46.155]:24721) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KkCDv-0001Ap-UI for emacs-devel@gnu.org; Mon, 29 Sep 2008 02:27:12 -0400 Original-Received: by yw-out-1718.google.com with SMTP id 9so289663ywk.66 for ; Sun, 28 Sep 2008 23:27:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:sender :to:subject:cc:in-reply-to:mime-version:content-type:references :x-google-sender-auth; bh=Cmo574DJgVBRLLMHnzqh37KHTQvjkC3E5wDAg1lwC2M=; b=bskWJ0s7/uZTAvLMTcI8KArHl78kl+mc03TXgflFrI1Jy8FwFxen86XQMK+auAYkVn A8cy3xNXutE+W1TmnenYrDjZufcUXOJzvRGHS35B7JSaZ0sCxPV7LKwVL28o0EigMMuI /HLzSa5MfxQzSlXPCajALAiJb495sG7oTF+PQ= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version :content-type:references:x-google-sender-auth; b=JUyiTdSpUxn78n1T2/d8VxnQd4G4wpFvy6O5RwpS9F66SLXIFdXSF4h/3x4qkGOglS VzO/iihdWKyCpRewdc+HyfIs2Itd3MW4eKA+xEJZOtm5GDpNjOQwjZ7+zRa2+oJI0lHt 1SX0vb3ZTi7r9QB8VyVOm3GW/EUX4W9YwqSEk= Original-Received: by 10.100.232.13 with SMTP id e13mr3718755anh.140.1222669631239; Sun, 28 Sep 2008 23:27:11 -0700 (PDT) Original-Received: by 10.100.209.13 with HTTP; Sun, 28 Sep 2008 23:27:11 -0700 (PDT) In-Reply-To: <48DFDF4F.5080704@gmail.com> X-Google-Sender-Auth: a215d787a34ed3b2 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:104214 Archived-At: ------=_Part_43270_1007071.1222669631205 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline On Sun, Sep 28, 2008 at 12:47 PM, Lennart Borgman (gmail) wrote: > T. V. Raman wrote: >> The proced-refine command has the following as part of its doc >> string: >> >> >> If point is on the attribute ATTR, this command compares the value of ATTR >> of every process with the value of ATTR of the process at the position >> of point. One can select processes for which the value of ATTR is >> \"less than\", \"equal\", and / or \"larger\" than ATTR of the process >> point is on. >> >> >> >> The initial sentence talks about point being in the header, the >> latter half talks about the process that point is on. How can >> point be in both places at once? > > Doesn't it mean the column ATTR (or however it is layed out, I do not know)? It does --- but Raman is certainly not the only user reading it that way. Should the docstring be more explicit? Attached is what would make sense to me. ------=_Part_43270_1007071.1222669631205 Content-Type: text/x-diff; name=jimb.proced-refine-doc.patch Content-Transfer-Encoding: base64 X-Attachment-Id: f_flopwdje0 Content-Disposition: attachment; filename=jimb.proced-refine-doc.patch SXQgc2VlbXMgbGlrZSB0aGVyZSdzIG5vIG5lZWQgdG8gcmVwZWF0IGRldGFpbHMgb2YgcHJvY2Vk LXJlZmluZSdzCmJlaGF2aW9yIGluIHRoZSBwcm9jZWQtbW9kZSBkb2NzdHJpbmcuCgpUaGUgJ3By b2NlZC1yZWZpbmUnIGRvY3N0cmluZyBzaG91bGQgYmUgY2xlYXJlciBhYm91dCBleGFjdGx5IHdo ZXJlCnBvaW50IG5lZWRzIHRvIGJlLgoKVGhlIHBocmFzZSAnYXQgdGhlIHBvc2l0aW9uIG9mIHBv aW50JyBpcyByZWR1bmRhbnQ7IEVtYWNzCmRvY3VtZW50YXRpb24gc2ltcGx5IHNheXMsICdhdCBw b2ludCcuCgoyMDA4LTA5LTI5ICBKaW0gQmxhbmR5ICA8amltYkByZWQtYmVhbi5jb20+CgoJKiBw cm9jZWQuZWwgKHByb2NlZC1tb2RlLCBwcm9jZWQtcmVmaW5lKTogRG9jIGZpeGVzLgoKZGlmZiAt LWdpdCBhL2xpc3AvcHJvY2VkLmVsIGIvbGlzcC9wcm9jZWQuZWwKLS0tIGEvbGlzcC9wcm9jZWQu ZWwKKysrIGIvbGlzcC9wcm9jZWQuZWwKQEAgLTU1MSwxMSArNTUxLDkgQEAgdG8gY2hhbmdlIHRo ZSBzb3J0IHNjaGVtZS4gIFRoZSBjdXJyZW50IAogdG8gY2hhbmdlIHRoZSBzb3J0IHNjaGVtZS4g IFRoZSBjdXJyZW50IHNvcnQgc2NoZW1lIGlzIGluZGljYXRlZCBpbiB0aGUKIG1vZGUgbGluZSwg dXNpbmcgXCIrXCIgb3IgXCItXCIgZm9yIGFzY2VuZGluZyBvciBkZXNjZW5kaW5nIHNvcnQgb3Jk ZXIuCiAKLUFuIGV4aXN0aW5nIFByb2NlZCBsaXN0aW5nIGNhbiBiZSByZWZpbmVkIGJ5IHR5cGlu ZyBcXFtwcm9jZWQtcmVmaW5lXQotd2l0aCBwb2ludCBvbiB0aGUgYXR0cmlidXRlIG9mIGEgcHJv Y2Vzcy4gIElmIHBvaW50IGlzIG9uIHRoZSBhdHRyaWJ1dGUgQVRUUiwKLXRoaXMgY29tcGFyZXMg dGhlIHZhbHVlIG9mIEFUVFIgb2YgZXZlcnkgcHJvY2VzcyB3aXRoIHRoZSB2YWx1ZSBvZiBBVFRS Ci1vZiB0aGUgcHJvY2VzcyBhdCB0aGUgcG9zaXRpb24gb2YgcG9pbnQuICBTZWUgYHByb2NlZC1y ZWZpbmUnIGZvciBkZXRhaWxzLgotUmVmaW5pbmcgYW4gZXhpc3RpbmcgbGlzdGluZyBkb2VzIG5v dCB1cGRhdGUgdGhlIHZhcmlhYmxlIGBwcm9jZWQtZmlsdGVyJy4KK1lvdSBjYW4gZHJvcCBwcm9j ZXNzZXMgZnJvbSB0aGUgbGlzdCBiYXNlZCBvbiB0aGVpciBhdHRyaWJ1dGUKK3ZhbHVlcyBieSB0 eXBpbmcgXFxbcHJvY2VkLXJlZmluZV0uICBTZWUgYHByb2NlZC1yZWZpbmUnIGZvcgorZGV0YWls cy4KIAogVGhlIGF0dHJpYnV0ZS1zcGVjaWZpYyBydWxlcyBmb3IgZm9ybWF0dGluZywgZmlsdGVy aW5nLCBzb3J0aW5nLCBhbmQgcmVmaW5pbmcKIGFyZSBkZWZpbmVkIGluIGBwcm9jZWQtZ3JhbW1h ci1hbGlzdCcuCkBAIC04ODQsOSArODgyLDkgQEAgVGhpcyBsaXN0IGluY2x1ZGVzIENQSUQgdW5s ZXNzIE9NSVQtQ1BJRAogICAiUmVmaW5lIFByb2NlZCBsaXN0aW5nIGJ5IGNvbXBhcmluZyB3aXRo IHRoZSBhdHRyaWJ1dGUgdmFsdWUgYXQgcG9pbnQuCiBPcHRpb25hbCBFVkVOVCBpcyB0aGUgbG9j YXRpb24gb2YgdGhlIFByb2NlZCBmaWVsZC4KIAotSWYgcG9pbnQgaXMgb24gdGhlIGF0dHJpYnV0 ZSBBVFRSLCB0aGlzIGNvbW1hbmQgY29tcGFyZXMgdGhlIHZhbHVlIG9mIEFUVFIKLW9mIGV2ZXJ5 IHByb2Nlc3Mgd2l0aCB0aGUgdmFsdWUgb2YgQVRUUiBvZiB0aGUgcHJvY2VzcyBhdCB0aGUgcG9z aXRpb24KLW9mIHBvaW50LiAgT25lIGNhbiBzZWxlY3QgcHJvY2Vzc2VzIGZvciB3aGljaCB0aGUg dmFsdWUgb2YgQVRUUiBpcworSWYgcG9pbnQgaXMgb24gYSBwcm9jZXNzJ3MgdmFsdWUgZm9yIHRo ZSBhdHRyaWJ1dGUgQVRUUiwgdGhpcyBjb21tYW5kIGNvbXBhcmVzIHRoZSB2YWx1ZSBvZiBBVFRS CitvZiBldmVyeSBwcm9jZXNzIHdpdGggdGhlIHZhbHVlIG9mIEFUVFIgb2YgdGhlIHByb2Nlc3Mg YXQKK3BvaW50LiAgT25lIGNhbiBzZWxlY3QgcHJvY2Vzc2VzIGZvciB3aGljaCB0aGUgdmFsdWUg b2YgQVRUUiBpcwogXCJsZXNzIHRoYW5cIiwgXCJlcXVhbFwiLCBhbmQgLyBvciBcImxhcmdlclwi IHRoYW4gQVRUUiBvZiB0aGUgcHJvY2VzcwogcG9pbnQgaXMgb24uCiAK ------=_Part_43270_1007071.1222669631205--