GNU bug report logs - #23502
24.5; Document auto-save-* user options in Emacs manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 23502 in the body.
You can then email your comments to 23502 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.5; Document auto-save-* user options in Emacs manual
Date: Mon, 9 May 2016 22:13:29 -0700 (PDT)

Why are these options described in detail only in the Elisp manual?

At the very least, there should be a cross-reference from the Emacs
manual, node `Auto Save Control' to (elisp) `Auto-Saving'.

In GNU Emacs 24.5.1 (i686-pc-mingw32)
 of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --host=i686-pc-mingw32'

Message #8 received at 23502 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 23502 <at> debbugs.gnu.org
Subject: Re: bug#23502: 24.5; Document auto-save-* user options in Emacs manual
Date: Wed, 11 May 2016 14:37:10 +0300

> Date: Mon, 9 May 2016 22:13:29 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> Why are these options described in detail only in the Elisp manual?

Which ones aren't in the user manual?  I found all of the user options
mentioned in the "Auto-Saving" node of the ELisp manual documented in
the user manual as well, in the 3 subsections of the "Auto Save"
section.  If I missed some, can you point them out?

Message #11 received at 23502 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 23502 <at> debbugs.gnu.org
Subject: RE: bug#23502: 24.5; Document auto-save-* user options in Emacs manual
Date: Wed, 11 May 2016 07:35:41 -0700 (PDT)

> > Why are these options described in detail only in the Elisp manual?
> > At the very least, there should be a cross-reference from the Emacs
> > manual, node `Auto Save Control' to (elisp) `Auto-Saving'.
> 
> Which ones aren't in the user manual?

Did I say any of them are not "in" the user manual?

They are not described in more detail there.  Or at least please
consider adding cross-references to the information in the Elisp
manual.  These are _user_ options.

> I found all of the user options
> mentioned in the "Auto-Saving" node of the ELisp manual documented in
> the user manual as well, in the 3 subsections of the "Auto Save"
> section.  If I missed some, can you point them out?

What you apparently missed is that the bug report does not say
that any are missing.  What it requests is to provide more info
or point users to the existing info about them in the Elisp manual.

Message #14 received at 23502 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 23502 <at> debbugs.gnu.org
Subject: Re: bug#23502: 24.5; Document auto-save-* user options in Emacs manual
Date: Wed, 11 May 2016 17:46:26 +0300

> Date: Wed, 11 May 2016 07:35:41 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: 23502 <at> debbugs.gnu.org
> 
> > > Why are these options described in detail only in the Elisp manual?
> > > At the very least, there should be a cross-reference from the Emacs
> > > manual, node `Auto Save Control' to (elisp) `Auto-Saving'.
> > 
> > Which ones aren't in the user manual?
> 
> Did I say any of them are not "in" the user manual?
> 
> They are not described in more detail there.

I've read the text, and didn't find the descriptions inadequate, so I
still have no idea what's wrong with their description in the Emacs
manual.

Message #17 received at 23502 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 23502 <at> debbugs.gnu.org
Subject: RE: bug#23502: 24.5; Document auto-save-* user options in Emacs manual
Date: Wed, 11 May 2016 08:36:19 -0700 (PDT)

> > > > Why are these options described in detail only in the Elisp manual?
> > > > At the very least, there should be a cross-reference from the Emacs
> > > > manual, node `Auto Save Control' to (elisp) `Auto-Saving'.
> > >
> > > Which ones aren't in the user manual?
> >
> > Did I say any of them are not "in" the user manual?
> >
> > They are not described in more detail there.  Or at least please
> > consider adding cross-references to the information in the Elisp
> > manual.  These are _user_ options.
> 
> I've read the text, and didn't find the descriptions inadequate, so I
> still have no idea what's wrong with their description in the Emacs
> manual.

Sorry, not interested in playing another tug-of-war game.

Please consider adding a link to the doc in the Elisp manual.
If you're not interested, just move along, please (close bug).

(You might also consider letting `C-h S' recognize these user
options.  That too could help users get to info about them.)

Message #22 received at 23502-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 23502-done <at> debbugs.gnu.org
Subject: Re: bug#23502: 24.5; Document auto-save-* user options in Emacs manual
Date: Wed, 11 May 2016 18:54:34 +0300

> Date: Wed, 11 May 2016 08:36:19 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: 23502 <at> debbugs.gnu.org
> 
> > I've read the text, and didn't find the descriptions inadequate, so I
> > still have no idea what's wrong with their description in the Emacs
> > manual.
> 
> Sorry, not interested in playing another tug-of-war game.
> 
> Please consider adding a link to the doc in the Elisp manual.
> If you're not interested, just move along, please (close bug).

Closed.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.