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: node Subdirectories in Dired in Emacs manual Date: Wed, 5 Mar 2008 07:13:15 -0800 Message-ID: <001701c87ed3$704f65f0$0600a8c0@us.oracle.com> References: <003701c87e52$e730eb20$0600a8c0@us.oracle.com><000001c87e6f$b6126e70$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 1204730199 16951 80.91.229.12 (5 Mar 2008 15:16:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 5 Mar 2008 15:16:39 +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:17:02 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 1JWvLj-000766-TQ for geb-bug-gnu-emacs@m.gmane.org; Wed, 05 Mar 2008 16:16:08 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JWvLC-00028A-Hy for geb-bug-gnu-emacs@m.gmane.org; Wed, 05 Mar 2008 10:15:34 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JWvKO-0001eA-O2 for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:14:44 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JWvKJ-0001a4-Ux for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:14:44 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JWvKJ-0001Zr-Mo for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:14:39 -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 1JWvKI-000776-Rh for bug-gnu-emacs@gnu.org; Wed, 05 Mar 2008 10:14:39 -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 m25FEZD1005226; Wed, 5 Mar 2008 08:14:35 -0700 Original-Received: from acsmt350.oracle.com (acsmt350.oracle.com [141.146.40.150]) by agmgw2.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m25BZC3B019573; Wed, 5 Mar 2008 08:14:34 -0700 Original-Received: from inet-141-146-46-1.oracle.com by acsmt351.oracle.com with ESMTP id 3600703711204729991; Wed, 05 Mar 2008 07:13:11 -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:13:11 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Ach+qkLH7PY7gW2hT6yx/XJS3bCN9QAJSdCg 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:17663 Archived-At: > >> > This text in the node is misleading or unintelligible: > >> > > >> > If the subdirectory's contents are already present in the > >> > buffer, the `i' command just moves to it. > >> > > >> > I tried `i' everywhere in the buffer, and it did nothing of the > >> > kind...except if the cursor is over the subdir line of the parent > >> > directory. That needs to be said. > >> > >> That's exactly what the preceding paragraph says. > > > > Not at all. Hitting `i' *WHERE* > > "on a line that describes a file which is a directory" Which could also be interpreted to mean a subdir header line. And the sentence "If the subdirectory's..." should not be in a separate paragraph, especially if you expect someone to assume the same context (e.g. location) for hitting `i'. > > just moves to *WHERE*? > > "the subdirectory's contents" That's not a place. The English and the logic are bad. > Just as the paragraph says. You seem interested in justifying, rather than learning. Take it from a user: the text is not as clear as it should be. Or take it from someone who has been writing, editing, and managing technical documentation professionally for a couple decades. Or not - remain stubborn and don't try to learn or improve. Your choice.