all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Adding "Reading File Names" to Info node "File Names"
@ 2006-06-24 22:45 Lennart Borgman
  2006-06-24 23:10 ` Nick Roberts
  2006-06-25  3:14 ` Eli Zaretskii
  0 siblings, 2 replies; 5+ messages in thread
From: Lennart Borgman @ 2006-06-24 22:45 UTC (permalink / raw)


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.

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

* Re: Adding "Reading File Names" to Info node "File Names"
  2006-06-24 22:45 Adding "Reading File Names" to Info node "File Names" Lennart Borgman
@ 2006-06-24 23:10 ` Nick Roberts
  2006-06-25  7:01   ` Lennart Borgman
  2006-06-25  3:14 ` Eli Zaretskii
  1 sibling, 1 reply; 5+ messages in thread
From: Nick Roberts @ 2006-06-24 23:10 UTC (permalink / raw)
  Cc: Emacs Devel

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

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

* Re: Adding "Reading File Names" to Info node "File Names"
  2006-06-24 22:45 Adding "Reading File Names" to Info node "File Names" Lennart Borgman
  2006-06-24 23:10 ` Nick Roberts
@ 2006-06-25  3:14 ` Eli Zaretskii
  1 sibling, 0 replies; 5+ messages in thread
From: Eli Zaretskii @ 2006-06-25  3:14 UTC (permalink / raw)
  Cc: emacs-devel

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

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

* Re: Adding "Reading File Names" to Info node "File Names"
  2006-06-24 23:10 ` Nick Roberts
@ 2006-06-25  7:01   ` Lennart Borgman
  2006-06-26  4:03     ` Richard Stallman
  0 siblings, 1 reply; 5+ messages in thread
From: Lennart Borgman @ 2006-06-25  7:01 UTC (permalink / raw)
  Cc: Emacs Devel

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.

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

* Re: Adding "Reading File Names" to Info node "File Names"
  2006-06-25  7:01   ` Lennart Borgman
@ 2006-06-26  4:03     ` Richard Stallman
  0 siblings, 0 replies; 5+ messages in thread
From: Richard Stallman @ 2006-06-26  4:03 UTC (permalink / raw)
  Cc: nickrob, emacs-devel

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

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

end of thread, other threads:[~2006-06-26  4:03 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-06-24 22:45 Adding "Reading File Names" to Info node "File Names" Lennart Borgman
2006-06-24 23:10 ` Nick Roberts
2006-06-25  7:01   ` Lennart Borgman
2006-06-26  4:03     ` Richard Stallman
2006-06-25  3:14 ` Eli Zaretskii

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.