From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.lisp.guile.devel Subject: Re: [PATCH] Correct docstring of 'symlink' Date: Mon, 09 Mar 2015 20:52:54 -0400 Message-ID: References: <87mw48mjaw.fsf@taylan.uni.cx> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1425948815 15145 80.91.229.3 (10 Mar 2015 00:53:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 10 Mar 2015 00:53:35 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Tue Mar 10 01:53:27 2015 Return-path: Envelope-to: guile-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 1YV8QI-0003KU-CA for guile-devel@m.gmane.org; Tue, 10 Mar 2015 01:53:26 +0100 Original-Received: from localhost ([::1]:45959 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YV8QH-0001Cl-P4 for guile-devel@m.gmane.org; Mon, 09 Mar 2015 20:53:25 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38109) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YV8QD-0001Cd-Qb for guile-devel@gnu.org; Mon, 09 Mar 2015 20:53:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YV8QA-00087x-KT for guile-devel@gnu.org; Mon, 09 Mar 2015 20:53:21 -0400 Original-Received: from plane.gmane.org ([80.91.229.3]:60131) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YV8QA-00087H-Di for guile-devel@gnu.org; Mon, 09 Mar 2015 20:53:18 -0400 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1YV8Q4-0003AO-RV for guile-devel@gnu.org; Tue, 10 Mar 2015 01:53:12 +0100 Original-Received: from 75-119-253-35.dsl.teksavvy.com ([75.119.253.35]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 10 Mar 2015 01:53:12 +0100 Original-Received: from monnier by 75-119-253-35.dsl.teksavvy.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 10 Mar 2015 01:53:12 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 22 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: 75-119-253-35.dsl.teksavvy.com User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) Cancel-Lock: sha1:tiRIpNNSTzJpwm7I6YuVmKyGOQE= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:17691 Archived-At: > - "Create a symbolic link named @var{oldpath} with the value\n" > - "(i.e., pointing to) @var{newpath}. The return value is\n" > + "Create a symbolic link named @var{newpath} with the value\n" > + "(i.e., pointing to) @var{oldpath}. The return value is\n" This is weird terminology. First the "new vs old" is meaningless for a symlink since the target may not even exist. In "man ln" the terminology used is "link-name vs target" which I think is a lot more clear (Elisp's `make-symbolic-link' uses "filename vs linkname" which is not as good). Second, the GNU coding standards says: Please do not use the term "pathname" that is used in Unix documentation; use "file name" (two words) instead. We use the term "path" only for search paths, which are lists of directory names. so none of the two args should be named "path". Stefan