From owner-freebsd-questions Tue Oct 8 11:48:57 2002 Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2850137B401 for ; Tue, 8 Oct 2002 11:48:56 -0700 (PDT) Received: from sccrmhc01.attbi.com (sccrmhc01.attbi.com [204.127.202.61]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7F21943E8A for ; Tue, 8 Oct 2002 11:48:55 -0700 (PDT) (envelope-from swear@attbi.com) Received: from localhost.localdomain ([12.242.158.67]) by sccrmhc01.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20021008184854.VNAG6431.sccrmhc01.attbi.com@localhost.localdomain>; Tue, 8 Oct 2002 18:48:54 +0000 Received: from localhost.localdomain (localhost [127.0.0.1]) by localhost.localdomain (8.12.5/8.12.5) with ESMTP id g98IpToS094572; Tue, 8 Oct 2002 11:51:29 -0700 (PDT) (envelope-from swear@attbi.com) Received: (from jojo@localhost) by localhost.localdomain (8.12.5/8.12.5/Submit) id g98IpI86094567; Tue, 8 Oct 2002 11:51:18 -0700 (PDT) (envelope-from swear@attbi.com) X-Authentication-Warning: localhost.localdomain: jojo set sender to swear@attbi.com using -f To: Peter Leftwich Cc: SweeTLeaF , FreeBSD LIST Subject: Re: help with ln "linking" Please! [attn manpage authors!] References: <20021008011209.B35848-100000@earl-grey.cloud9.net> From: swear@attbi.com (Gary W. Swearingen) Date: 08 Oct 2002 11:51:18 -0700 In-Reply-To: <20021008011209.B35848-100000@earl-grey.cloud9.net> Message-ID: Lines: 32 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG Peter Leftwich writes: > The manpage is super unclear about sourcefile and targetfile, I have said > this for years. Think of this paragraph: > > SYNOPSIS > ln [-fhinsv] source_file [target_file] ... > ... as this instead `ln -s actualfile linkfile` That's not the best way to think of it, since "actualfile" need not be an actual file! Nor "existing", as the manual has. The "source" concept is actually pretty good, since the "source file" is used as the source of data when "target file" is accessed. Confusion comes about mostly because the "ls" command shows an arrow pointing from the target (AKA destination) to the source, backwards from what most people would expect when thinking of source and destination/target. The arrow points away from the target! It also shows them in reverse order from how they are given to "ln". How about this: ln [-fhinsv] source_filename [link_filename] I just TRY to remember them as being bassackwards from the more natural order of "ls": link -> source Anybody else have terms they'd prefer the manual use in both the SYNOPSIS and DESCRIPTION? Peter, who have you "said this for years" TO? Have you filed a Problem Report which I could send a patch for? If so, what's the number? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message