RE: node Subdirectories in Dired in Emacs manual

["Drew Adams" <drew.adams@oracle.com>]

> >> > 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.