unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#23502: 24.5; Document auto-save-* user options in Emacs manual
@ 2016-05-10  5:13 Drew Adams
  2016-05-11 11:37 ` Eli Zaretskii
  0 siblings, 1 reply; 6+ messages in thread
From: Drew Adams @ 2016-05-10  5:13 UTC (permalink / raw)
  To: 23502

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'





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#23502: 24.5; Document auto-save-* user options in Emacs manual
  2016-05-10  5:13 bug#23502: 24.5; Document auto-save-* user options in Emacs manual Drew Adams
@ 2016-05-11 11:37 ` Eli Zaretskii
  0 siblings, 0 replies; 6+ messages in thread
From: Eli Zaretskii @ 2016-05-11 11:37 UTC (permalink / raw)
  To: Drew Adams; +Cc: 23502

> Date: Mon, 9 May 2016 22:13:29 -0700 (PDT)
> From: Drew Adams <drew.adams@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?





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#23502: 24.5; Document auto-save-* user options in Emacs manual
       [not found] ` <<83inykbzbt.fsf@gnu.org>
@ 2016-05-11 14:35   ` Drew Adams
  2016-05-11 14:46     ` Eli Zaretskii
  0 siblings, 1 reply; 6+ messages in thread
From: Drew Adams @ 2016-05-11 14:35 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 23502

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





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#23502: 24.5; Document auto-save-* user options in Emacs manual
  2016-05-11 14:35   ` Drew Adams
@ 2016-05-11 14:46     ` Eli Zaretskii
  0 siblings, 0 replies; 6+ messages in thread
From: Eli Zaretskii @ 2016-05-11 14:46 UTC (permalink / raw)
  To: Drew Adams; +Cc: 23502

> Date: Wed, 11 May 2016 07:35:41 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: 23502@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.





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#23502: 24.5; Document auto-save-* user options in Emacs manual
       [not found]     ` <<83d1osbqkd.fsf@gnu.org>
@ 2016-05-11 15:36       ` Drew Adams
  2016-05-11 15:54         ` Eli Zaretskii
  0 siblings, 1 reply; 6+ messages in thread
From: Drew Adams @ 2016-05-11 15:36 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 23502

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





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#23502: 24.5; Document auto-save-* user options in Emacs manual
  2016-05-11 15:36       ` Drew Adams
@ 2016-05-11 15:54         ` Eli Zaretskii
  0 siblings, 0 replies; 6+ messages in thread
From: Eli Zaretskii @ 2016-05-11 15:54 UTC (permalink / raw)
  To: Drew Adams; +Cc: 23502-done

> Date: Wed, 11 May 2016 08:36:19 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: 23502@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.





^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2016-05-11 15:54 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-05-10  5:13 bug#23502: 24.5; Document auto-save-* user options in Emacs manual Drew Adams
2016-05-11 11:37 ` Eli Zaretskii
     [not found] <<a23b5534-87b8-45ff-b007-7bed6a341157@default>
     [not found] ` <<83inykbzbt.fsf@gnu.org>
2016-05-11 14:35   ` Drew Adams
2016-05-11 14:46     ` Eli Zaretskii
     [not found] <<<a23b5534-87b8-45ff-b007-7bed6a341157@default>
     [not found] ` <<<83inykbzbt.fsf@gnu.org>
     [not found]   ` <<d12e67f8-7f7c-4b8d-a0d9-3e1f33e57fe8@default>
     [not found]     ` <<83d1osbqkd.fsf@gnu.org>
2016-05-11 15:36       ` Drew Adams
2016-05-11 15:54         ` Eli Zaretskii

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