* node Subdirectories in Dired in Emacs manual
@ 2008-03-04 23:53 Drew Adams
2008-03-05 0:51 ` Andreas Schwab
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2008-03-04 23:53 UTC (permalink / raw
To: bug-gnu-emacs
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.
In GNU Emacs 22.1.1 (i386-mingw-nt5.1.2600)
of 2007-06-02 on RELEASE
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: node Subdirectories in Dired in Emacs manual
2008-03-04 23:53 node Subdirectories in Dired in Emacs manual Drew Adams
@ 2008-03-05 0:51 ` Andreas Schwab
2008-03-05 3:19 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Andreas Schwab @ 2008-03-05 0:51 UTC (permalink / raw
To: Drew Adams; +Cc: bug-gnu-emacs
"Drew Adams" <drew.adams@oracle.com> writes:
> 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.
Andreas.
--
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5
"And now for something completely different."
^ permalink raw reply [flat|nested] 5+ messages in thread
* RE: node Subdirectories in Dired in Emacs manual
2008-03-05 0:51 ` Andreas Schwab
@ 2008-03-05 3:19 ` Drew Adams
2008-03-05 10:17 ` Andreas Schwab
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2008-03-05 3:19 UTC (permalink / raw
To: 'Andreas Schwab'; +Cc: bug-gnu-emacs
> > 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* just moves to *WHERE*? It says nothing about
where the cursor is when you hit `i', in order to have this effect. And even
the effect is unclear: "moves to it" is ambiguous - what is "it"? For that
matter, the "and moves there" of the previous paragraph is also unclear -
moves where? Inserts the directory "and moves *THERE*"?
This is all poorly phrased. Perhaps you are handicapped by knowing the
behavior. Try reading it from the standpoint of someone who doesn't already
know what the behavior is. You'll see that the description given doesn't
help.
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: node Subdirectories in Dired in Emacs manual
2008-03-05 3:19 ` Drew Adams
@ 2008-03-05 10:17 ` Andreas Schwab
2008-03-05 15:13 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Andreas Schwab @ 2008-03-05 10:17 UTC (permalink / raw
To: Drew Adams; +Cc: bug-gnu-emacs
"Drew Adams" <drew.adams@oracle.com> writes:
>> > 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"
> just moves to *WHERE*?
"the subdirectory's contents"
Just as the paragraph says.
Andreas.
--
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5
"And now for something completely different."
^ permalink raw reply [flat|nested] 5+ messages in thread
* RE: node Subdirectories in Dired in Emacs manual
2008-03-05 10:17 ` Andreas Schwab
@ 2008-03-05 15:13 ` Drew Adams
0 siblings, 0 replies; 5+ messages in thread
From: Drew Adams @ 2008-03-05 15:13 UTC (permalink / raw
To: 'Andreas Schwab'; +Cc: bug-gnu-emacs
> >> > 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.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2008-03-05 15:13 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-03-04 23:53 node Subdirectories in Dired in Emacs manual Drew Adams
2008-03-05 0:51 ` Andreas Schwab
2008-03-05 3:19 ` Drew Adams
2008-03-05 10:17 ` Andreas Schwab
2008-03-05 15:13 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).