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: RE: doc string of dired-do-kill-lines, "killing" lines in Dired Date: Wed, 5 Mar 2008 07:53:59 -0800 Message-ID: <001e01c87ed9$20d7b670$0600a8c0@us.oracle.com> References: <003801c87e54$1961eda0$0600a8c0@us.oracle.com><000101c87e6f$b7d77700$0600a8c0@us.oracle.com><001601c87ed3$676a5440$0600a8c0@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: ger.gmane.org 1204732608 26923 80.91.229.12 (5 Mar 2008 15:56:48 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 5 Mar 2008 15:56:48 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org To: "'Andreas Schwab'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Mar 05 16:57:13 2008 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.50) id 1JWvy9-0007b5-Ev for geb-bug-gnu-emacs@m.gmane.org; Wed, 05 Mar 2008 16:55:49 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JWvxc-0002z3-9u for geb-bug-gnu-emacs@m.gmane.org; Wed, 05 Mar 2008 10:55:16 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JWvxY-0002yf-1Z for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:55:12 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JWvxV-0002yQ-9w for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:55:10 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JWvxV-0002yN-6y for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:55:09 -0500 Original-Received: from rgminet01.oracle.com ([148.87.113.118]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JWvxU-0008I9-MW for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:55:08 -0500 Original-Received: from agmgw2.us.oracle.com (agmgw2.us.oracle.com [152.68.180.213]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id m25Ft4Ti020192; Wed, 5 Mar 2008 08:55:05 -0700 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by agmgw2.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m2509k8L014482; Wed, 5 Mar 2008 08:55:04 -0700 Original-Received: from inet-141-146-46-1.oracle.com by acsmt351.oracle.com with ESMTP id 3599584821204732435; Wed, 05 Mar 2008 07:53:55 -0800 Original-Received: from dradamslap1 (/141.144.74.81) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 05 Mar 2008 07:53:55 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Ach+1ayp1OZgK/CfSneVB6QSq0PxvgAAnTHg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:17665 Archived-At: > > If something can be misunderstood, it will be. > > There are two ways to read documentation: trying to find the worst > possible interpretation and trying to find the best possible > interpretation. Yes, and the writer should always read it trying to find the worst possible interpretation. That is the burden you need to assume, if you want to communicate. Why? Because that is how you improve communication. Progress comes through contradiction. If you as a writer read only what you intended to say, and not what you actually wrote, with all of its reasonable possible interpretations, then you are not putting yourself in the place of the reader. And you write _for the reader_. This is no different from writing code. The reader is your compiler or interpreter: it is s?he who lets you know if what you wrote makes sense.