* Pertinent NEWS parts for the Emacs 26 manual draft
@ 2017-10-09 18:16 Richard Stallman
0 siblings, 0 replies; 7+ messages in thread
From: Richard Stallman @ 2017-10-09 18:16 UTC (permalink / raw)
To: emacs-devel
[[[ 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'd like people to look at the NEWS files for Emacs 26, Emacs 25 and
Emacs 24 and extract the parts that are relevant to the Emacs manual.
Those are the parts about user commands and user-visible behavior,
but excluding modes that are not described in the Emacs manual.
The idea is for someone who is experienced to do this just once, and
then we will post the results in gnu.org/software/emacs for checkers
to review.
Checking the Emacs 26 manual is waiting for this; would someone please
do it?
--
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Pertinent NEWS parts for the Emacs 26 manual draft
@ 2017-09-25 22:08 Richard Stallman
2017-09-29 10:07 ` Eli Zaretskii
0 siblings, 1 reply; 7+ messages in thread
From: Richard Stallman @ 2017-09-25 22:08 UTC (permalink / raw)
To: emacs-devel
Would someone please look at the NEWS files for Emacs 26, Emacs 25 and
Emacs 24 and extract the parts that are relevant to the Emacs manual?
THe parts to include are those about changes in user commands and
user-visible behavior, but excluding changes in modes that are not
documented in the Emacs manual (which is most of them).
The idea is for someone who is experienced to do this just once, so we
can post the results in gnu.org/software/emacs for checkers to review.
--
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Pertinent NEWS parts for the Emacs 26 manual draft
2017-09-25 22:08 Richard Stallman
@ 2017-09-29 10:07 ` Eli Zaretskii
2017-09-29 21:55 ` Richard Stallman
0 siblings, 1 reply; 7+ messages in thread
From: Eli Zaretskii @ 2017-09-29 10:07 UTC (permalink / raw)
To: rms; +Cc: emacs-devel
> From: Richard Stallman <rms@gnu.org>
> Date: Mon, 25 Sep 2017 18:08:16 -0400
>
> Would someone please look at the NEWS files for Emacs 26, Emacs 25 and
> Emacs 24 and extract the parts that are relevant to the Emacs manual?
>
> THe parts to include are those about changes in user commands and
> user-visible behavior, but excluding changes in modes that are not
> documented in the Emacs manual (which is most of them).
Maybe I misunderstand, but don't the "+++" markers in NEWS already
tell that?
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Pertinent NEWS parts for the Emacs 26 manual draft
2017-09-29 10:07 ` Eli Zaretskii
@ 2017-09-29 21:55 ` Richard Stallman
2017-09-30 6:56 ` Eli Zaretskii
0 siblings, 1 reply; 7+ messages in thread
From: Richard Stallman @ 2017-09-29 21:55 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel
[[[ 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. ]]]
> > Would someone please look at the NEWS files for Emacs 26, Emacs 25 and
> > Emacs 24 and extract the parts that are relevant to the Emacs manual?
> >
> > THe parts to include are those about changes in user commands and
> > user-visible behavior, but excluding changes in modes that are not
> > documented in the Emacs manual (which is most of them).
> Maybe I misunderstand, but don't the "+++" markers in NEWS already
> tell that?
Whether the +++ markings are a reliable guide depends on the state of
work on NEWS. They might not yet have been put in; they might have
been removed. An item might have a --- instead, put there because
someone mistakenly thought that item isn't pertinent to the Emacs
Manual.
Supposing that at present all pertineny items have a +++ marking, they
don't necessarily refer to the Emacs Manual; some indicate that a
feature has been documented in the Emacs Lisp Manual.
But even that isn't the deepest point here. Let's suppose that the
items with +++ are exactly the items a reviewer of the Emacs Manual
shoulod look at. Is that equivalent to what I've asked for?
Absolutely not! This is not a math exercise, this is making it easy
for others to do a job we are asking them to do.
With +++ you can (maybe) find the pertinent parts, if you know the
rules and you think about it.
With the filtered NEWS file, you could find them effortlessly.
Please let's make this effortless, to encourage people to check
parts of the Emacs Manual.
--
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Pertinent NEWS parts for the Emacs 26 manual draft
2017-09-29 21:55 ` Richard Stallman
@ 2017-09-30 6:56 ` Eli Zaretskii
2017-09-30 23:14 ` Richard Stallman
0 siblings, 1 reply; 7+ messages in thread
From: Eli Zaretskii @ 2017-09-30 6:56 UTC (permalink / raw)
To: rms; +Cc: emacs-devel
> From: Richard Stallman <rms@gnu.org>
> CC: emacs-devel@gnu.org
> Date: Fri, 29 Sep 2017 17:55:15 -0400
>
> > > THe parts to include are those about changes in user commands and
> > > user-visible behavior, but excluding changes in modes that are not
> > > documented in the Emacs manual (which is most of them).
>
> > Maybe I misunderstand, but don't the "+++" markers in NEWS already
> > tell that?
>
> Whether the +++ markings are a reliable guide depends on the state of
> work on NEWS. They might not yet have been put in; they might have
> been removed. An item might have a --- instead, put there because
> someone mistakenly thought that item isn't pertinent to the Emacs
> Manual.
Since I've already asked Nicolas to make a pretest for Emacs 26.1, it
should be clear that NEWS was already reviewed (by me in this case),
and any such blunders, if there were ones, were already fixed.
> Supposing that at present all pertineny items have a +++ marking, they
> don't necessarily refer to the Emacs Manual; some indicate that a
> feature has been documented in the Emacs Lisp Manual.
NEWS has separate sections for Lisp and non-Lisp changes.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Pertinent NEWS parts for the Emacs 26 manual draft
2017-09-30 6:56 ` Eli Zaretskii
@ 2017-09-30 23:14 ` Richard Stallman
0 siblings, 0 replies; 7+ messages in thread
From: Richard Stallman @ 2017-09-30 23:14 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel
[[[ 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. ]]]
> Since I've already asked Nicolas to make a pretest for Emacs 26.1, it
> should be clear that NEWS was already reviewed (by me in this case),
> and any such blunders, if there were ones, were already fixed.
I'm glad this is so. I didn't know how things stood.
However, my main point is the last one: regardless of the current state
of marking up NEWS, we still need someone to collect just the parts
that checkers should read.
> NEWS has separate sections for Lisp and non-Lisp changes.
To make things really easy, we should omit the parts of NEWS that
aren't pertinent and someone doesn't need to read for this purpose.
Would someone please volunteer to do it?
--
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Pertinent NEWS parts for the Emacs 26 manual draft
@ 2017-09-21 18:26 Richard Stallman
0 siblings, 0 replies; 7+ messages in thread
From: Richard Stallman @ 2017-09-21 18:26 UTC (permalink / raw)
To: emacs-devel
[[[ 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'd like people to look at the NEWS files for Emacs 26, Emacs 25 and
Emacs 24 and extract the parts that are relevant to the Emacs manual.
Those are the parts about user commands and user-visible behavior,
but excluding modes that are not described in the Emacs manual.
The idea is for someone who is experienced to do this just once, and
then we will post the results in gnu.org/software/emacs for checkers
to review.
--
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2017-10-09 18:16 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-10-09 18:16 Pertinent NEWS parts for the Emacs 26 manual draft Richard Stallman
-- strict thread matches above, loose matches on Subject: below --
2017-09-25 22:08 Richard Stallman
2017-09-29 10:07 ` Eli Zaretskii
2017-09-29 21:55 ` Richard Stallman
2017-09-30 6:56 ` Eli Zaretskii
2017-09-30 23:14 ` Richard Stallman
2017-09-21 18:26 Richard Stallman
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
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).