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