From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: load-path contains directories or directory names? Date: Sun, 25 Oct 2015 14:58:44 -0700 (PDT) Message-ID: References: <86lhauus4x.fsf@stephe-leake.org> <87vb9x42io.fsf@web.de> <867fmcey8k.fsf@stephe-leake.org> <83vb9udc86.fsf@gnu.org> <83h9ledavd.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1445810352 27964 80.91.229.3 (25 Oct 2015 21:59:12 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 25 Oct 2015 21:59:12 +0000 (UTC) Cc: michael_heerdegen@web.de, stephen_leake@stephe-leake.org, emacs-devel@gnu.org To: John Wiegley , Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Oct 25 22:58:59 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZqTJY-0001cJ-G7 for ged-emacs-devel@m.gmane.org; Sun, 25 Oct 2015 22:58:56 +0100 Original-Received: from localhost ([::1]:49666 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqTJX-0000NP-VT for ged-emacs-devel@m.gmane.org; Sun, 25 Oct 2015 17:58:55 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51170) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqTJU-0000NK-Jk for emacs-devel@gnu.org; Sun, 25 Oct 2015 17:58:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZqTJT-0007tq-Rr for emacs-devel@gnu.org; Sun, 25 Oct 2015 17:58:52 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:36308) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqTJP-0007oT-VW; Sun, 25 Oct 2015 17:58:48 -0400 Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t9PLwjN6025909 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 25 Oct 2015 21:58:45 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t9PLwivH020105 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 25 Oct 2015 21:58:45 GMT Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t9PLwi1Z022451; Sun, 25 Oct 2015 21:58:44 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:192626 Archived-At: > > IMO, either remove and replace with 'expand-file-name', or describe bot= h > > with a preference to 'expand-file-name'. >=20 > Oh, it doesn't already talk about expand-file-name? It should state the > solution in terms of `expand-file-name', and then maybe mention in a note > that it's implemented as a platform-path-correct use of `concat' under th= e hood. > Or not mention `concat' at all, either way. I think the doc about file and directory names _should_ mention `concat', as that is the gotcha: users are often used to using it to concatenate strings, and some naturally think of using it for constructing file names. (File names are strings, but not all strings are file names.) I think the doc should explicitly point out that `concat' has no notion of file names and their syntax subtleties, and that file-name construction and decomposition are the raison d'etre for the functions described in (elisp) File Names and its subnodes. But definitely, at least node Directory Names should not suggest that users use `concat'. On that I agree with you, and that's the main point here.