Adding "Reading File Names" to Info node "File Names"

Adding "Reading File Names" to Info node "File Names"

[Lennart Borgman]

The little patch below adds a link to reading file names. I do not 
remember if I sent this before.

Index: lispref/files.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/files.texi,v
retrieving revision 1.95
diff -u -r1.95 files.texi
--- lispref/files.texi    27 May 2006 14:35:49 -0000    1.95
+++ lispref/files.texi    28 May 2006 23:17:51 -0000
@@ -1565,6 +1565,9 @@
 syntax.  This enables Lisp programs to specify file names in Unix syntax
 and work properly on all systems without change.
 
+  For information about how to read file names from the minibuffer see
+@xref{Reading File Names}.
+
 @menu
 * File Name Components::  The directory part of a file name, and the rest.
 * Relative File Names::   Some file names are relative to a current 
directory.

Re: Adding "Reading File Names" to Info node "File Names"

[Nick Roberts]

Lennart Borgman writes:
 > The little patch below adds a link to reading file names. I do not 
 > remember if I sent this before.
 > 
 > Index: lispref/files.texi
 > ===================================================================
 > RCS file: /cvsroot/emacs/emacs/lispref/files.texi,v
 > retrieving revision 1.95
 > diff -u -r1.95 files.texi
 > --- lispref/files.texi    27 May 2006 14:35:49 -0000    1.95
 > +++ lispref/files.texi    28 May 2006 23:17:51 -0000
 > @@ -1565,6 +1565,9 @@
 >  syntax.  This enables Lisp programs to specify file names in Unix syntax
 >  and work properly on all systems without change.
 >  
 > +  For information about how to read file names from the minibuffer see
 > +@xref{Reading File Names}.
 > +
 >  @menu
 >  * File Name Components::  The directory part of a file name, and the rest.
 >  * Relative File Names::   Some file names are relative to a current 
 > directory.

That seems out of context to me.  Maybe the link to the Completion node
in in the File Name Completion node could be changed to Reading File Names:

 @node File Name Completion
 @subsection File Name Completion
 @cindex file name completion subroutines
 @cindex completion, file name

   This section describes low-level subroutines for completing a file
 name.  For higher level functions, see @ref{Reading File Names}.

-- 
Nick                                           http://www.inet.net.nz/~nickrob

Re: Adding "Reading File Names" to Info node "File Names"

[Eli Zaretskii]

> Date: Sun, 25 Jun 2006 00:45:21 +0200
> From: Lennart Borgman <lennart.borgman.073@student.lu.se>
> 
> +  For information about how to read file names from the minibuffer see
> +@xref{Reading File Names}.

I have no opinion about the need for the cross-reference, but this is
incorrect Texinfo usage.  @xref should not be used in the middle of a
sentence, you probably want "see @ref" instead.  Try running your
patched version through makeinfo and look at the result, you will see
what I mean.

Re: Adding "Reading File Names" to Info node "File Names"

[Lennart Borgman]

Nick Roberts wrote:
> Lennart Borgman writes:
>  > The little patch below adds a link to reading file names. I do not 
>  > remember if I sent this before.
>  > 
>  > Index: lispref/files.texi
>  > ===================================================================
>  > RCS file: /cvsroot/emacs/emacs/lispref/files.texi,v
>  > retrieving revision 1.95
>  > diff -u -r1.95 files.texi
>  > --- lispref/files.texi    27 May 2006 14:35:49 -0000    1.95
>  > +++ lispref/files.texi    28 May 2006 23:17:51 -0000
>  > @@ -1565,6 +1565,9 @@
>  >  syntax.  This enables Lisp programs to specify file names in Unix syntax
>  >  and work properly on all systems without change.
>  >  
>  > +  For information about how to read file names from the minibuffer see
>  > +@xref{Reading File Names}.
>  > +
>  >  @menu
>  >  * File Name Components::  The directory part of a file name, and the rest.
>  >  * Relative File Names::   Some file names are relative to a current 
>  > directory.
>
> That seems out of context to me.  Maybe the link to the Completion node
> in in the File Name Completion node could be changed to Reading File Names:
>
>  @node File Name Completion
>  @subsection File Name Completion
>  @cindex file name completion subroutines
>  @cindex completion, file name
>
>    This section describes low-level subroutines for completing a file
>  name.  For higher level functions, see @ref{Reading File Names}.
>   

That seems like a good suggestion to me.

Re: Adding "Reading File Names" to Info node "File Names"

[Richard Stallman]

    >    This section describes low-level subroutines for completing a file
    >  name.  For higher level functions, see @ref{Reading File Names}.
    >   

    That seems like a good suggestion to me.

I agree; would someone please install?