bug#31529: Sentence order in dired.texi(emacs-26)

bug#31529: Sentence order in dired.texi(emacs-26)

[Takesi Ayanokoji]

[-- Attachment #1: Type: text/plain, Size: 1356 bytes --]

Hi emacs developers.

In dired.texi:240..253

 You can delete empty directories just like other files, but normally
Dired cannot delete directories that are nonempty.  If the variable
@code{dired-recursive-deletes} is non-@code{nil}, then Dired can
delete nonempty directories including all their contents.  That can be
somewhat risky.  If the value of the variable is @code{always}, Dired
will delete nonempty directories recursively, which is even more
risky.  Even if you have set @code{dired-recursive-deletes} to
@code{nil}, you might want sometimes to delete recursively directories
without being asked for confirmation for all of them.  This is handy
when you have marked many directories for deletion and you are very
sure that all of them can safely be deleted.  For every nonempty
directory you are asked for confirmation; if you answer @code{all},
then all the remaining directories will be deleted without more
questions.

I think the sentence

Even if you have set @code{dired-recursive-deletes} to
@code{nil}, you might want sometimes to delete recursively directories
without being asked for confirmation for all of them.

and the sentence

This is handy
when you have marked many directories for deletion and you are very
sure that all of them can safely be deleted.

is reverse order.

How is this?

ayatakesi <ayanokoji.takesi@gmail.com>

[-- Attachment #2: Type: text/html, Size: 1564 bytes --]

bug#31529: Sentence order in dired.texi(emacs-26)

[Noam Postavsky]

On 19 May 2018 at 12:47, Takesi Ayanokoji <ayanokoji.takesi@gmail.com> wrote:

> I think the sentence
>
> Even if you have set @code{dired-recursive-deletes} to
> @code{nil}, you might want sometimes to delete recursively directories
> without being asked for confirmation for all of them.
>
> and the sentence
>
> This is handy
> when you have marked many directories for deletion and you are very
> sure that all of them can safely be deleted.
>
> is reverse order.

I don't think they're reversed, "this is handy" refers to the previous
sentence "delete [...] without being asked [...] for all of them".
Maybe it would be clearer if the second sentence said "For example"
instead of "This is handy".

Also, I'd say the word "recursively" *is* reversed with one of the words
around it, it should be either "recursively delete directories" or
"delete directories recursively".

bug#31529: Sentence order in dired.texi(emacs-26)

[Eli Zaretskii]

> From: Noam Postavsky <npostavs@gmail.com>
> Date: Thu, 07 Jun 2018 19:25:27 -0400
> Cc: 31529@debbugs.gnu.org
> 
> On 19 May 2018 at 12:47, Takesi Ayanokoji <ayanokoji.takesi@gmail.com> wrote:
> 
> > I think the sentence
> >
> > Even if you have set @code{dired-recursive-deletes} to
> > @code{nil}, you might want sometimes to delete recursively directories
> > without being asked for confirmation for all of them.
> >
> > and the sentence
> >
> > This is handy
> > when you have marked many directories for deletion and you are very
> > sure that all of them can safely be deleted.
> >
> > is reverse order.
> 
> I don't think they're reversed, "this is handy" refers to the previous
> sentence "delete [...] without being asked [...] for all of them".
> Maybe it would be clearer if the second sentence said "For example"
> instead of "This is handy".
> 
> Also, I'd say the word "recursively" *is* reversed with one of the words
> around it, it should be either "recursively delete directories" or
> "delete directories recursively".

OK, I clarified the text there, and I'm marking the bug done.