unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
@ 2011-08-24 15:57 Drew Adams
  2011-08-24 16:57 ` Eli Zaretskii
  0 siblings, 1 reply; 9+ messages in thread
From: Drew Adams @ 2011-08-24 15:57 UTC (permalink / raw)
  To: 9358

emacs -Q
 
There is nothing about file attributes indexed in the manual (except
`w32-get-true-file-attributes).  At least index function
`file-attributes', and possible also `file attributes'.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-08-22 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt'
 






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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 15:57 bug#9358: 24.0.50; please index `file-attributes' in Elisp manual Drew Adams
@ 2011-08-24 16:57 ` Eli Zaretskii
  2011-08-24 17:04   ` Drew Adams
  2011-08-24 17:04   ` Sean Sieger
  0 siblings, 2 replies; 9+ messages in thread
From: Eli Zaretskii @ 2011-08-24 16:57 UTC (permalink / raw)
  To: Drew Adams; +Cc: 9358

> From: "Drew Adams" <drew.adams@oracle.com>
> Date: Wed, 24 Aug 2011 08:57:34 -0700
> 
> emacs -Q
>  
> There is nothing about file attributes indexed in the manual (except
> `w32-get-true-file-attributes).  At least index function
> `file-attributes', and possible also `file attributes'.

??? file-attributes _is_ indexed.  It must be, as every function and
variable described in the ELisp manual is automatically indexed by the
program that generates the manual.





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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 16:57 ` Eli Zaretskii
@ 2011-08-24 17:04   ` Drew Adams
  2011-08-24 17:42     ` Eli Zaretskii
  2011-08-24 17:04   ` Sean Sieger
  1 sibling, 1 reply; 9+ messages in thread
From: Drew Adams @ 2011-08-24 17:04 UTC (permalink / raw)
  To: 'Eli Zaretskii'; +Cc: 9358

> > There is nothing about file attributes indexed in the manual (except
> > `w32-get-true-file-attributes).  At least index function
> > `file-attributes', and possible also `file attributes'.
> 
> ??? file-attributes _is_ indexed.  It must be, as every function and
> variable described in the ELisp manual is automatically indexed by the
> program that generates the manual.

Sorry, I meant the Emacs manual.  All of what I wrote applies to the Emacs
manual, but I mistyped the Subject line.






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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 16:57 ` Eli Zaretskii
  2011-08-24 17:04   ` Drew Adams
@ 2011-08-24 17:04   ` Sean Sieger
  1 sibling, 0 replies; 9+ messages in thread
From: Sean Sieger @ 2011-08-24 17:04 UTC (permalink / raw)
  To: 9358

Eli Zaretskii <eliz@gnu.org> writes:

    > From: "Drew Adams" <drew.adams@oracle.com>
    > Date: Wed, 24 Aug 2011 08:57:34 -0700
    > 
    > emacs -Q
    >  
    > There is nothing about file attributes indexed in the manual (except
    > `w32-get-true-file-attributes).  At least index function
    > `file-attributes', and possible also `file attributes'.

    ??? file-attributes _is_ indexed.  It must be, as every function and
    variable described in the ELisp manual is automatically indexed by the
    program that generates the manual.

On checking, I think Drew's referring to the Emacs manual.






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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 17:04   ` Drew Adams
@ 2011-08-24 17:42     ` Eli Zaretskii
  2011-08-24 17:57       ` Drew Adams
  0 siblings, 1 reply; 9+ messages in thread
From: Eli Zaretskii @ 2011-08-24 17:42 UTC (permalink / raw)
  To: Drew Adams; +Cc: 9358

> From: "Drew Adams" <drew.adams@oracle.com>
> Cc: <9358@debbugs.gnu.org>
> Date: Wed, 24 Aug 2011 10:04:08 -0700
> 
> > > There is nothing about file attributes indexed in the manual (except
> > > `w32-get-true-file-attributes).  At least index function
> > > `file-attributes', and possible also `file attributes'.
> > 
> > ??? file-attributes _is_ indexed.  It must be, as every function and
> > variable described in the ELisp manual is automatically indexed by the
> > program that generates the manual.
> 
> Sorry, I meant the Emacs manual.  All of what I wrote applies to the Emacs
> manual, but I mistyped the Subject line.

The Emacs manual does not document functions, only commands.  Why
should a user worry about file-attributes?






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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 17:42     ` Eli Zaretskii
@ 2011-08-24 17:57       ` Drew Adams
  2011-08-24 19:26         ` Eli Zaretskii
  0 siblings, 1 reply; 9+ messages in thread
From: Drew Adams @ 2011-08-24 17:57 UTC (permalink / raw)
  To: 'Eli Zaretskii'; +Cc: 9358

> The Emacs manual does not document functions, only commands.  Why
> should a user worry about file-attributes?

Bzzzzzzzzt! Wrong, but thanks for playing.

The Emacs manual is not a reference manual.  It does not provide reference doc
for functions.  But it does provide information about some functions - and not
just commands.

And lo and behold, `file-attributes' is one of those functions that the Emacs
manual says something about.  Please index that information.  Thx.

Tip: You will have to search for it; it's not in the index. ;-)






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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 17:57       ` Drew Adams
@ 2011-08-24 19:26         ` Eli Zaretskii
  2011-08-25  9:09           ` Juri Linkov
  2011-09-11  2:24           ` Lars Magne Ingebrigtsen
  0 siblings, 2 replies; 9+ messages in thread
From: Eli Zaretskii @ 2011-08-24 19:26 UTC (permalink / raw)
  To: Drew Adams; +Cc: 9358

> From: "Drew Adams" <drew.adams@oracle.com>
> Cc: <9358@debbugs.gnu.org>
> Date: Wed, 24 Aug 2011 10:57:08 -0700
> 
> And lo and behold, `file-attributes' is one of those functions that the Emacs
> manual says something about.  Please index that information.

There's nothing it says that is worth indexing.  The function's name is
mentioned, that's all.

Index entries are for something that is _described_.  file-attributes
is not described in that manual, nor is there any significant
information pertaining to file-attributes that is in this manual.





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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 19:26         ` Eli Zaretskii
@ 2011-08-25  9:09           ` Juri Linkov
  2011-09-11  2:24           ` Lars Magne Ingebrigtsen
  1 sibling, 0 replies; 9+ messages in thread
From: Juri Linkov @ 2011-08-25  9:09 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 9358

>> And lo and behold, `file-attributes' is one of those functions that the Emacs
>> manual says something about.  Please index that information.
>
> There's nothing it says that is worth indexing.  The function's name is
> mentioned, that's all.
>
> Index entries are for something that is _described_.  file-attributes
> is not described in that manual, nor is there any significant
> information pertaining to file-attributes that is in this manual.

It could provide a link/reference to the description of file-attributes
in the Elisp manual.





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

* bug#9358: 24.0.50; please index `file-attributes' in Elisp manual
  2011-08-24 19:26         ` Eli Zaretskii
  2011-08-25  9:09           ` Juri Linkov
@ 2011-09-11  2:24           ` Lars Magne Ingebrigtsen
  1 sibling, 0 replies; 9+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-09-11  2:24 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 9358

Eli Zaretskii <eliz@gnu.org> writes:

> There's nothing it says that is worth indexing.  The function's name is
> mentioned, that's all.

I agree.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





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

end of thread, other threads:[~2011-09-11  2:24 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2011-08-24 15:57 bug#9358: 24.0.50; please index `file-attributes' in Elisp manual Drew Adams
2011-08-24 16:57 ` Eli Zaretskii
2011-08-24 17:04   ` Drew Adams
2011-08-24 17:42     ` Eli Zaretskii
2011-08-24 17:57       ` Drew Adams
2011-08-24 19:26         ` Eli Zaretskii
2011-08-25  9:09           ` Juri Linkov
2011-09-11  2:24           ` Lars Magne Ingebrigtsen
2011-08-24 17:04   ` Sean Sieger

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