bug#31535: Missing object words in misc.texi(emacs-26)

bug#31535: Missing object words in misc.texi(emacs-26)

[Takesi Ayanokoji]

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

Hi  Emacs developers.

In misc.texi: 687..689,

>>> start here
The variables @code{resize-mini-windows} and @code{max-mini-window-height}
(@pxref{Minibuffer Edit}) control * when the output is considered too long
for the echo area.
<<< end here

Currently, there is nothing(empty) at * markd positiin, but I think *
should be 'window resizing' or something like that.

I am not English native, so I am not sure this is correct.

Thanks.

ayatakesi <ayanokoji.takesi@gmail.com>

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

bug#31535: Missing object words in misc.texi(emacs-26)

[Eli Zaretskii]

> From: Takesi Ayanokoji <ayanokoji.takesi@gmail.com>
> Date: Sun, 20 May 2018 10:11:33 +0900
> 
> In misc.texi: 687..689,
> 
> >>> start here
> The variables @code{resize-mini-windows} and @code{max-mini-window-height} (@pxref{Minibuffer Edit})
> control * when the output is considered too long for the echo area.
> <<< end here
> 
> Currently, there is nothing(empty) at * markd positiin, but I think * should be 'window resizing' or something like
> that.

No, the sentence is correct, albeit slightly confusing.  I reworded it
to say this instead:

  The variables @code{resize-mini-windows} and
  @code{max-mini-window-height} (@pxref{Minibuffer Edit}) control when
  Emacs should consider the output to be too long for the echo area.

Is the intent more clear now?

bug#31535: Missing object words in misc.texi(emacs-26)

[Takesi Ayanokoji]

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

Hi Eli.

Yes, it is clear now for me.
Thanks.

ayatakesi <ayanokoji.takesi@gmail.com>

2018年5月20日(日) 16:13 Eli Zaretskii <eliz@gnu.org>:

> > From: Takesi Ayanokoji <ayanokoji.takesi@gmail.com>
> > Date: Sun, 20 May 2018 10:11:33 +0900
> >
> > In misc.texi: 687..689,
> >
> > >>> start here
> > The variables @code{resize-mini-windows} and
> @code{max-mini-window-height} (@pxref{Minibuffer Edit})
> > control * when the output is considered too long for the echo area.
> > <<< end here
> >
> > Currently, there is nothing(empty) at * markd positiin, but I think *
> should be 'window resizing' or something like
> > that.
>
> No, the sentence is correct, albeit slightly confusing.  I reworded it
> to say this instead:
>
>   The variables @code{resize-mini-windows} and
>   @code{max-mini-window-height} (@pxref{Minibuffer Edit}) control when
>   Emacs should consider the output to be too long for the echo area.
>
> Is the intent more clear now?
>

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

bug#31535: Missing object words in misc.texi(emacs-26)

[Eli Zaretskii]

> From: Takesi Ayanokoji <ayanokoji.takesi@gmail.com>
> Date: Sun, 20 May 2018 16:51:21 +0900
> Cc: 31535@debbugs.gnu.org
> 
> Yes, it is clear now for me.

OK, closing the bug.

bug#31535: Missing object words in misc.texi(emacs-26)

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > > The variables @code{resize-mini-windows} and @code{max-mini-window-height} (@pxref{Minibuffer Edit})
  > > control * when the output is considered too long for the echo area.
  > > <<< end here

The passive voice contributesd to the difficulty of that sentence.
You rewrote it as active.  That's generally a good thing to do.

-- 
Dr Richard Stallman
President, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
Skype: No way! See https://stallman.org/skype.html.