all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Xue Fuqiao <xfq.free@gmail.com>
To: emacs-devel <emacs-devel@gnu.org>
Subject: Documentation of `file-name-completion' is somewhat confusing
Date: Wed, 12 Jun 2013 10:07:37 +0800	[thread overview]
Message-ID: <CAAF+z6ExcNSmkwBGk+-Faun0u4FDiqdq3iX8t1qQ00kO6oKR1A@mail.gmail.com> (raw)

Hi list,

In (info "(elisp) File Name Completion"):
 -- Function: file-name-completion filename directory &optional
          predicate
[...]
     If PREDICATE is non-`nil' then it ignores possible completions that
     don't satisfy PREDICATE, after calling that function with one
     argument, the expanded absolute file name.

And in the doc string of this function:
    If PREDICATE is non-nil, call PREDICATE with each possible
    completion (in absolute form) and ignore it if PREDICATE returns
    nil.

It seems to me that the arguments of PREDICATE described by these two
paragraphs don't agree with each other: the first one is "the expanded
absolute file name", but the second one is "each possible completion".
IMHO the latter is more appropriate.  Or maybe I got something wrong.
Any ideas?

--
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/



             reply	other threads:[~2013-06-12  2:07 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-06-12  2:07 Xue Fuqiao [this message]
2013-06-12  2:58 ` Documentation of `file-name-completion' is somewhat confusing Eli Zaretskii
2013-06-12 13:39   ` Xue Fuqiao

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CAAF+z6ExcNSmkwBGk+-Faun0u4FDiqdq3iX8t1qQ00kO6oKR1A@mail.gmail.com \
    --to=xfq.free@gmail.com \
    --cc=emacs-devel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
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.