Re: emacs-26 275e735: More changes in the Emacs manuals

Re: emacs-26 275e735: More changes in the Emacs manuals

[Robert Pluim]

eliz@gnu.org (Eli Zaretskii) writes:

>    You can use a numeric argument before a self-inserting character to
>  insert multiple copies of it.  This is straightforward when the
> -character is not a digit; for example, @kbd{C-u 6 4 a} inserts 64
> +character is not a digit; for example, @w{@kbd{C-u 6 4 a}} inserts 64
>  copies of the character @samp{a}.  But this does not work for
> -inserting digits; @kbd{C-u 6 4 1} specifies an argument of 641.  You
> -can separate the argument from the digit to insert with another
> -@kbd{C-u}; for example, @kbd{C-u 6 4 C-u 1} does insert 64 copies of
> -the character @samp{1}.
> +inserting digits; @w{@kbd{C-u 6 4 1}} specifies an argument of 641.
> +You can separate the argument from the digit to insert with another
> +@kbd{C-u}; for example, @w{@kbd{C-u 6 4 C-u 1}} does insert 64 copies
> +of the character @samp{1}.
>

'does insert' => 'inserts'. There's no contrasting with a previous
'does not' phrase going on.

>    The @dfn{state} of the group indicates whether setting in that group
> -has been edited, set or saved.  @xref{Changing a Variable}.
> +has been edited, set, or saved.  @xref{Changing a Variable}.

Are we standardising on the Oxford comma now? I heartily approve.

Robert

Re: emacs-26 275e735: More changes in the Emacs manuals

[Eli Zaretskii]

> From: Robert Pluim <rpluim@gmail.com>
> Cc: Eli Zaretskii <eliz@gnu.org>
> Date: Mon, 19 Feb 2018 17:50:59 +0100
> 
> >    You can use a numeric argument before a self-inserting character to
> >  insert multiple copies of it.  This is straightforward when the
> > -character is not a digit; for example, @kbd{C-u 6 4 a} inserts 64
> > +character is not a digit; for example, @w{@kbd{C-u 6 4 a}} inserts 64
> >  copies of the character @samp{a}.  But this does not work for
> > -inserting digits; @kbd{C-u 6 4 1} specifies an argument of 641.  You
> > -can separate the argument from the digit to insert with another
> > -@kbd{C-u}; for example, @kbd{C-u 6 4 C-u 1} does insert 64 copies of
> > -the character @samp{1}.
> > +inserting digits; @w{@kbd{C-u 6 4 1}} specifies an argument of 641.
> > +You can separate the argument from the digit to insert with another
> > +@kbd{C-u}; for example, @w{@kbd{C-u 6 4 C-u 1}} does insert 64 copies
> > +of the character @samp{1}.
> >
> 
> 'does insert' => 'inserts'. There's no contrasting with a previous
> 'does not' phrase going on.

Yes, there is such a contrast: note the "does not work" part.

> >    The @dfn{state} of the group indicates whether setting in that group
> > -has been edited, set or saved.  @xref{Changing a Variable}.
> > +has been edited, set, or saved.  @xref{Changing a Variable}.
> 
> Are we standardising on the Oxford comma now? I heartily approve.

Ah, so that's what it's called...

Re: emacs-26 275e735: More changes in the Emacs manuals

[Robert Pluim]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Robert Pluim <rpluim@gmail.com>
>> Cc: Eli Zaretskii <eliz@gnu.org>
>> Date: Mon, 19 Feb 2018 17:50:59 +0100
>> 
>> >    You can use a numeric argument before a self-inserting character to
>> >  insert multiple copies of it.  This is straightforward when the
>> > -character is not a digit; for example, @kbd{C-u 6 4 a} inserts 64
>> > +character is not a digit; for example, @w{@kbd{C-u 6 4 a}} inserts 64
>> >  copies of the character @samp{a}.  But this does not work for
>> > -inserting digits; @kbd{C-u 6 4 1} specifies an argument of 641.  You
>> > -can separate the argument from the digit to insert with another
>> > -@kbd{C-u}; for example, @kbd{C-u 6 4 C-u 1} does insert 64 copies of
>> > -the character @samp{1}.
>> > +inserting digits; @w{@kbd{C-u 6 4 1}} specifies an argument of 641.
>> > +You can separate the argument from the digit to insert with another
>> > +@kbd{C-u}; for example, @w{@kbd{C-u 6 4 C-u 1}} does insert 64 copies
>> > +of the character @samp{1}.
>> >
>> 
>> 'does insert' => 'inserts'. There's no contrasting with a previous
>> 'does not' phrase going on.
>
> Yes, there is such a contrast: note the "does not work" part.
>

If it said 'does not insert' I'd agree with you.

Re: emacs-26 275e735: More changes in the Emacs manuals

[Eli Zaretskii]

> From: Robert Pluim <rpluim@gmail.com>
> Cc: emacs-devel@gnu.org
> Date: Mon, 19 Feb 2018 18:46:06 +0100
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> >> From: Robert Pluim <rpluim@gmail.com>
> >> Cc: Eli Zaretskii <eliz@gnu.org>
> >> Date: Mon, 19 Feb 2018 17:50:59 +0100
> >> 
> >> >    You can use a numeric argument before a self-inserting character to
> >> >  insert multiple copies of it.  This is straightforward when the
> >> > -character is not a digit; for example, @kbd{C-u 6 4 a} inserts 64
> >> > +character is not a digit; for example, @w{@kbd{C-u 6 4 a}} inserts 64
> >> >  copies of the character @samp{a}.  But this does not work for
> >> > -inserting digits; @kbd{C-u 6 4 1} specifies an argument of 641.  You
> >> > -can separate the argument from the digit to insert with another
> >> > -@kbd{C-u}; for example, @kbd{C-u 6 4 C-u 1} does insert 64 copies of
> >> > -the character @samp{1}.
> >> > +inserting digits; @w{@kbd{C-u 6 4 1}} specifies an argument of 641.
> >> > +You can separate the argument from the digit to insert with another
> >> > +@kbd{C-u}; for example, @w{@kbd{C-u 6 4 C-u 1}} does insert 64 copies
> >> > +of the character @samp{1}.
> >> >
> >> 
> >> 'does insert' => 'inserts'. There's no contrasting with a previous
> >> 'does not' phrase going on.
> >
> > Yes, there is such a contrast: note the "does not work" part.
> >
> 
> If it said 'does not insert' I'd agree with you.

It does say that, albeit not literally:

  You can use [...] to insert [...].  But this does not work for
  inserting [...].  You can [...] insert with another 'C-u'; for
  example, 'C-u 6 4 C-u 1' does insert [...].

Sounds pretty clear to me what is being contrasted with what.

Re: emacs-26 275e735: More changes in the Emacs manuals

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

I don't think we should "standardize" on the Oxford comma.
It is a matter of judgment.  In this particular case, it seems
to read ok either way.

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

Re: emacs-26 275e735: More changes in the Emacs manuals

[Eli Zaretskii]

> From: Richard Stallman <rms@gnu.org>
> Date: Mon, 19 Feb 2018 19:44:28 -0500
> Cc: rpluim@gmail.com, emacs-devel@gnu.org
> 
> I don't think we should "standardize" on the Oxford comma.
> It is a matter of judgment.  In this particular case, it seems
> to read ok either way.

I changed a few of them, but not all.

Re: emacs-26 275e735: More changes in the Emacs manuals

[Robert Pluim]

Richard Stallman <rms@gnu.org> writes:

> I don't think we should "standardize" on the Oxford comma.

There are situations where it removes ambiguity, which is why I like
it. I'm not advocating retroactively updating all the current uses.

Robert