Typo in Emacs 29 manual?

Typo in Emacs 29 manual?

[Natalie]

I'm not filing a bug about this (yet), because I think I might be
missing something. But can someone tell me if this is a typo?

From 30.1 Entering Dired (pulled from git master's emacs.info)
> Typing ‘C-x C-j’ (‘dired-jump’) in any buffer will open a Dired buffer and move point to the line corresponding to the current file. In Dired, move up a level and go to the previous directory’s line.  Typing ‘C-x 4 C-j’ (‘dired-jump-other-window’ has the same effect but opens a new window for the Dired buffer.

"In Dired, move up a level and go to the previous directory's line" is
the part I'm talking about. What does this mean? It seems like a
keybinding might be missing here, like: move up a level and go to the
previous directory's line by pressing FOO.

-Natalie

Re: Typo in Emacs 29 manual?

[Natalie]

On 2022-03-05 12:56, Natalie wrote:
> I'm not filing a bug about this (yet), because I think I might be
> missing something. But can someone tell me if this is a typo?
> 
> From 30.1 Entering Dired (pulled from git master's emacs.info)
>> Typing ‘C-x C-j’ (‘dired-jump’) in any buffer will open a Dired buffer and move point to the line corresponding to the current file. In Dired, move up a level and go to the previous directory’s line.  Typing ‘C-x 4 C-j’ (‘dired-jump-other-window’ has the same effect but opens a new window for the Dired buffer.

Of course, I just figured it out right after sending this. I suggest
saying "In Dired, THIS WILL move up a level and go to the previous
directory's line." Just no capitals..

Re: Typo in Emacs 29 manual?

[John Yates]

The two described behaviors are mutually exclusive.  The opening

> Typing ‘C-x C-j’ (‘dired-jump’) in any buffer will open a Dired buffer...

is imprecise (to wit the next sentence).  Perhaps better might be:

Typing ‘C-x C-j’ (‘dired-jump’) in a Dired buffer will move up a level
and move point to the previous directory’s line.  Typing ‘C-x C-j’
(‘dired-jump’) in any other kind of buffer will open a Dired buffer in
that same window and move point to the line corresponding to the
current file.  Typing ‘C-x 4 C-j’ (‘dired-jump-other-window’ has the
same effect but opens a new window for the Dired buffer.

Question: what if the original buffer is neither a Dired buffer nor a
buffer visiting a file?



On Sat, Mar 5, 2022 at 3:27 PM Natalie <batalie@riseup.net> wrote:

> On 2022-03-05 12:56, Natalie wrote:
> > I'm not filing a bug about this (yet), because I think I might be
> > missing something. But can someone tell me if this is a typo?
> >
> > From 30.1 Entering Dired (pulled from git master's emacs.info)
> >> Typing ‘C-x C-j’ (‘dired-jump’) in any buffer will open a Dired buffer
> and move point to the line corresponding to the current file. In Dired,
> move up a level and go to the previous directory’s line.  Typing ‘C-x 4
> C-j’ (‘dired-jump-other-window’ has the same effect but opens a new window
> for the Dired buffer.
>
> Of course, I just figured it out right after sending this. I suggest
> saying "In Dired, THIS WILL move up a level and go to the previous
> directory's line." Just no capitals..
>
>

-- 
John Yates
505 Tremont St, #803
Boston, MA 02116

Re: Typo in Emacs 29 manual?

[Michael Heerdegen]

John Yates <john@yates-sheets.org> writes:

> Question: what if the original buffer is neither a Dired buffer nor a
> buffer visiting a file?

Seems you get (dired default-directory).

Michael.

Re: Typo in Emacs 29 manual?

[John Yates]

On Sat, Mar 5, 2022 at 6:26 PM Michael Heerdegen
<michael_heerdegen@web.de> wrote:
> Seems you get (dired default-directory).

So then I would modify my previous suggestion to read:

Typing ‘C-x C-j’ (‘dired-jump’) displays a Dired buffer in the current
window.  If the starting buffer was a Dired buffer then the new buffer
displays its parent directory.  If the starting buffer was a file buffer
then the new buffer displays that files directory with point positioned
on that file.  Finally, if the original buffer was neither a Dired buffer
nor a file buffer then the new buffer displays the directory identified
by that buffer's default-directory.   Typing ‘C-x 4 C-j’
(‘dired-jump-other-window’) has the same effect except that it
displays the new Dired buffer in another window.

Re: Typo in Emacs 29 manual?

[Eli Zaretskii]

> From: John Yates <john@yates-sheets.org>
> Date: Sun, 6 Mar 2022 19:20:39 -0500
> Cc: Help Gnu Emacs mailing list <help-gnu-emacs@gnu.org>
> 
> On Sat, Mar 5, 2022 at 6:26 PM Michael Heerdegen
> <michael_heerdegen@web.de> wrote:
> > Seems you get (dired default-directory).
> 
> So then I would modify my previous suggestion to read:
> 
> Typing ‘C-x C-j’ (‘dired-jump’) displays a Dired buffer in the current
> window.  If the starting buffer was a Dired buffer then the new buffer
> displays its parent directory.  If the starting buffer was a file buffer
> then the new buffer displays that files directory with point positioned
> on that file.  Finally, if the original buffer was neither a Dired buffer
> nor a file buffer then the new buffer displays the directory identified
> by that buffer's default-directory.   Typing ‘C-x 4 C-j’
> (‘dired-jump-other-window’) has the same effect except that it
> displays the new Dired buffer in another window.

Thanks, I fixed the wording there (on the emacs-28 branch, because
this is not new in Emacs 29).