From: "Drew Adams" <drew.adams@oracle.com>
To: "'Michael Albinus'" <michael.albinus@gmx.de>
Cc: 10319@debbugs.gnu.org
Subject: bug#10319: 24.0.92; doc string of `file-remote-p'
Date: Mon, 19 Dec 2011 13:29:31 -0800 [thread overview]
Message-ID: <9F8218E3FA3645D9B59B2F8EEE480A8C@us.oracle.com> (raw)
In-Reply-To: <877h1sdzv0.fsf@gmx.de>
> The second sentence means that a relative filename like
> "/sudo::../../.." does not make sense, because it cannot
> expand out of the "/sudo::" jail.
So what are we trying to tell _users_ here?
Is this what we are really trying to say?
FILE must be an absolute file name.
If so, what should we say happens if you nevertheless pass a relative file name?
Return value is unspecified (could be nil or non-nil)? An error is raised?
What should we tell users is the behavior?
> > Something like this (but see my question about relative
> > file names not working):
> >
> > Test whether FILE specifies a location on a remote system.
> > A file is considered remote if accessing it is likely to
> > be slower or less reliable than accessing local files.
> >
> > `file-remote-p' never opens a new remote connection. It can
> > only reuse a connection that is already open. Relative file
> > names do not work across remote connections (????).
> >
> > Return nil or a string identifying the remote connection
> > (ideally a prefix of FILE). For example, the remote
> > identification for filename "/user@host:/foo" could be
> > "/user@host:".
> >
> > IDENTIFICATION specifies which part of the identification to
> > return. IDENTIFICATION can be the symbol `method',
> > `user', `host', or `localname'. Any other value is handled
> > like nil and means to return the complete identification.
> > The string returned for IDENTIFICATION `localname' can differ
> > depending on whether there is an existing connection."
> >
> > If CONNECTED is non-nil, return an identification only
> > if FILE is located on a remote system and a connection is
> > established to that remote system.
>
> Sounds OK to me. From my point of view you could submit the
> changed docstring.
>
> > We should also perhaps say what "the complete
> > identification" is/means. IOW, when IDENTIFICATION is nil,
> > what can we say about the return value?
>
> In that case, the returned string could make a local file
> name remote. We could always offer to apply
> (concat (file-remote-p "whatever") "local-file-name")
> given that `concat' accepts nil as argument.
Sorry, I just don't understand your reply to my question (what is the complete
identification - what is returned if IDENTIFICATION is nil). Could you rephrase
or elaborate?
Thx - Drew
next prev parent reply other threads:[~2011-12-19 21:29 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-12-18 2:17 bug#10319: 24.0.92; doc string of `file-remote-p' Drew Adams
2011-12-18 8:33 ` Michael Albinus
2011-12-18 15:02 ` Drew Adams
2011-12-19 8:40 ` Michael Albinus
2011-12-19 16:10 ` Drew Adams
2011-12-19 18:26 ` Michael Albinus
2011-12-19 19:44 ` Drew Adams
2011-12-19 21:18 ` Michael Albinus
2011-12-19 21:29 ` Drew Adams [this message]
2011-12-20 9:15 ` Michael Albinus
2011-12-20 15:53 ` Drew Adams
2011-12-20 17:02 ` Michael Albinus
2011-12-20 17:08 ` Drew Adams
2011-12-20 17:14 ` Michael Albinus
2011-12-20 17:33 ` Drew Adams
2011-12-21 18:34 ` Michael Albinus
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=9F8218E3FA3645D9B59B2F8EEE480A8C@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=10319@debbugs.gnu.org \
--cc=michael.albinus@gmx.de \
/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.