unofficial mirror of help-gnu-emacs@gnu.org
 help / color / mirror / Atom feed
* Typo in Emacs 29 manual?
@ 2022-03-05 17:56 Natalie
  2022-03-05 17:57 ` Natalie
  0 siblings, 1 reply; 6+ messages in thread
From: Natalie @ 2022-03-05 17:56 UTC (permalink / raw)
  To: help-gnu-emacs

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



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Typo in Emacs 29 manual?
  2022-03-05 17:56 Typo in Emacs 29 manual? Natalie
@ 2022-03-05 17:57 ` Natalie
  2022-03-05 21:13   ` John Yates
  0 siblings, 1 reply; 6+ messages in thread
From: Natalie @ 2022-03-05 17:57 UTC (permalink / raw)
  To: help-gnu-emacs

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



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Typo in Emacs 29 manual?
  2022-03-05 17:57 ` Natalie
@ 2022-03-05 21:13   ` John Yates
  2022-03-05 23:26     ` Michael Heerdegen
  0 siblings, 1 reply; 6+ messages in thread
From: John Yates @ 2022-03-05 21:13 UTC (permalink / raw)
  To: Natalie; +Cc: Help Gnu Emacs mailing list

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


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Typo in Emacs 29 manual?
  2022-03-05 21:13   ` John Yates
@ 2022-03-05 23:26     ` Michael Heerdegen
  2022-03-07  0:20       ` John Yates
  0 siblings, 1 reply; 6+ messages in thread
From: Michael Heerdegen @ 2022-03-05 23:26 UTC (permalink / raw)
  To: help-gnu-emacs

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.




^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Typo in Emacs 29 manual?
  2022-03-05 23:26     ` Michael Heerdegen
@ 2022-03-07  0:20       ` John Yates
  2022-03-07 12:40         ` Eli Zaretskii
  0 siblings, 1 reply; 6+ messages in thread
From: John Yates @ 2022-03-07  0:20 UTC (permalink / raw)
  To: Michael Heerdegen; +Cc: Help Gnu Emacs mailing list

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.



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Typo in Emacs 29 manual?
  2022-03-07  0:20       ` John Yates
@ 2022-03-07 12:40         ` Eli Zaretskii
  0 siblings, 0 replies; 6+ messages in thread
From: Eli Zaretskii @ 2022-03-07 12:40 UTC (permalink / raw)
  To: help-gnu-emacs

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



^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2022-03-07 12:40 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-03-05 17:56 Typo in Emacs 29 manual? Natalie
2022-03-05 17:57 ` Natalie
2022-03-05 21:13   ` John Yates
2022-03-05 23:26     ` Michael Heerdegen
2022-03-07  0:20       ` John Yates
2022-03-07 12:40         ` Eli Zaretskii

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