bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Drew Adams]

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'
 

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Eli Zaretskii]

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

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Drew Adams]

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

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Eli Zaretskii]

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

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Drew Adams]

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

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Eli Zaretskii]

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

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Juri Linkov]

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

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Lars Magne Ingebrigtsen]

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/

bug#9358: 24.0.50; please index `file-attributes' in Elisp manual

[Sean Sieger]

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.