bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

[Alan Mackenzie]

Hello, Emacs.

The Subject: says it all, really.  "Syntax Table Internals" is missing a
bit that says:

    `c'      `(1 lsh 23)'

.  Is it too late to fix for Emacs 26.1?  If not, should I fix it, or
will you (Eli) do it?

-- 
Alan Mackenzie (Nuremberg, Germany).

bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

[Eli Zaretskii]

> Date: Thu, 12 Apr 2018 19:34:09 +0000
> From: Alan Mackenzie <acm@muc.de>
> 
> The Subject: says it all, really.  "Syntax Table Internals" is missing a
> bit that says:
> 
>     `c'      `(1 lsh 23)'
> 
> .  Is it too late to fix for Emacs 26.1?  If not, should I fix it, or
> will you (Eli) do it?

Documentation fixes are okay on the release branch.

Thanks.

bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

[Alan Mackenzie]

Hello, Eli.

On Fri, Apr 13, 2018 at 10:36:02 +0300, Eli Zaretskii wrote:
> > Date: Thu, 12 Apr 2018 19:34:09 +0000
> > From: Alan Mackenzie <acm@muc.de>

> > The Subject: says it all, really.  "Syntax Table Internals" is missing a
> > bit that says:

> >     `c'      `(1 lsh 23)'

> > .  Is it too late to fix for Emacs 26.1?  If not, should I fix it, or
> > will you (Eli) do it?

> Documentation fixes are okay on the release branch.

OK, I've fixed it.  But there must be a time coming, fairly soon, when
even doc fixes are no longer welcome.

> Thanks.

-- 
Alan Mackenzie (Nuremberg, Germany).

bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

[Eli Zaretskii]

> Date: Fri, 13 Apr 2018 14:46:07 +0000
> Cc: 31140@debbugs.gnu.org
> From: Alan Mackenzie <acm@muc.de>
> 
> > Documentation fixes are okay on the release branch.
> 
> OK, I've fixed it.  But there must be a time coming, fairly soon, when
> even doc fixes are no longer welcome.

Why would documentation changes become unwelcome?

bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

[Glenn Morris]

Eli Zaretskii wrote:

>> OK, I've fixed it.  But there must be a time coming, fairly soon, when
>> even doc fixes are no longer welcome.
>
> Why would documentation changes become unwelcome?

They might fail to build in some cases that aren't trivial to spot (eg
with some specific makeinfo version; the manuals being prebuilt in
tarfiles doesn't obviate this because many distributions seem to do
bootstrap builds or builds from git tags); or they might cause problems
with the pdf or html version, which isn't frequently checked. And it
creates work for the person making the release, who can't just release
the release candidate, but has to make another one for frankly trivial
reasons. In short, your interpretation of "release candidate" differs
from mine.

bug#31140: Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.

[Eli Zaretskii]

> From: Glenn Morris <rgm@gnu.org>
> Cc: Alan Mackenzie <acm@muc.de>,  31140@debbugs.gnu.org
> Date: Fri, 13 Apr 2018 12:36:44 -0400
> 
> Eli Zaretskii wrote:
> 
> >> OK, I've fixed it.  But there must be a time coming, fairly soon, when
> >> even doc fixes are no longer welcome.
> >
> > Why would documentation changes become unwelcome?
> 
> They might fail to build in some cases that aren't trivial to spot (eg
> with some specific makeinfo version; the manuals being prebuilt in
> tarfiles doesn't obviate this because many distributions seem to do
> bootstrap builds or builds from git tags); or they might cause problems
> with the pdf or html version, which isn't frequently checked.

With such simple changes, this is unlikely.

> And it creates work for the person making the release, who can't
> just release the release candidate, but has to make another one for
> frankly trivial reasons.

That ship has sailed already, because we have one code change on the
release branch which I considered important enough to have.

> In short, your interpretation of "release candidate" differs from
> mine.

We've established that already during the previous release, I don't
see why you needed to reiterate that.  But feel free to volunteer to
be the next maintainer, I will gladly step down that very moment,
because I think you are a much better candidate for that job.

bug#31140: Acknowledgement (Emacs 26, elisp manual, "Syntax Table Internals", a description of flag 'c' is missing.)

[Alan Mackenzie]

Bug fixed on the emacs-26 branch with commit
f1450e9f348723d442d6faa57b685826ac557cc2.

-- 
Alan Mackenzie (Nuremberg, Germany).


On Thu, Apr 12, 2018 at 19:37:02 +0000, GNU bug Tracking System wrote:
> Thank you for filing a new bug report with debbugs.gnu.org.

> This is an automatically generated reply to let you know your message
> has been received.

> Your message is being forwarded to the package maintainers and other
> interested parties for their attention; they will reply in due course.

> Your message has been sent to the package maintainer(s):
>  bug-gnu-emacs@gnu.org

> If you wish to submit further information on this problem, please
> send it to 31140@debbugs.gnu.org.

> Please do not send mail to help-debbugs@gnu.org unless you wish
> to report a problem with the Bug-tracking system.

> -- 
> 31140: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=31140
> GNU Bug Tracking System
> Contact help-debbugs@gnu.org with problems