GNU bug report logs - #10319
24.0.92; doc string of `file-remote-p'

Previous Next

Full log

View this message in rfc822 format

From: Michael Albinus <michael.albinus <at> gmx.de>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 10319 <at> debbugs.gnu.org
Subject: bug#10319: 24.0.92; doc string of `file-remote-p'
Date: Sun, 18 Dec 2011 09:33:20 +0100

"Drew Adams" <drew.adams <at> oracle.com> writes:

> This part means nothing, and is misleading:
>  
> "`file-remote-p' will never open a connection on its own."
>  
> What could "on its own" possibly mean here.  This function can invoke a
> handler, which can open a connection.  So this function can open a
> connection.  We don't distinguish what the implementation of a function
> does from what the function does.  If the code in the body of
> `file-remote-p' ends up opening a connection, then `file-remote-p' opens
> a connection.

the intention is exactly as said: any implementation of `file-remote-p'
shall not open a new remote connection, if it is not established yet.

> You are probably trying to say something useful here (what?), but so far
> you have not said anything useful by this sentence.  And it misleads.

The wording comes from me. If there are better ways to say this, please
propose. I'm not a native English speaker.

Best regards, Michael.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.