From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ken Raeburn Newsgroups: gmane.lisp.guile.bugs Subject: Re: Missing and out-of-date information in guile.1, the Guile man page Date: Wed, 19 Jan 2011 14:50:29 -0500 Message-ID: <3D05815A-48F6-43E8-8A9D-5415972D032F@raeburn.org> References: <8CD818429F4EFE0-D0C-28BFF@Webmail-m115.sysops.aol.com> <87d3nxgaf9.fsf@ossau.uklinux.net> <8CD83CC14D7A7E0-1624-1AA70@webmail-m056.sysops.aol.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 (Apple Message framework v1082) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1295466651 20183 80.91.229.12 (19 Jan 2011 19:50:51 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 19 Jan 2011 19:50:51 +0000 (UTC) Cc: bug-guile@gnu.org To: Mark Harig Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Wed Jan 19 20:50:47 2011 Return-path: Envelope-to: guile-bugs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Pfe3K-0002Ja-LB for guile-bugs@m.gmane.org; Wed, 19 Jan 2011 20:50:46 +0100 Original-Received: from localhost ([127.0.0.1]:39783 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pfe3K-0007TJ-2w for guile-bugs@m.gmane.org; Wed, 19 Jan 2011 14:50:46 -0500 Original-Received: from [140.186.70.92] (port=46709 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pfe3B-0007QX-C8 for bug-guile@gnu.org; Wed, 19 Jan 2011 14:50:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Pfe3A-000824-Bh for bug-guile@gnu.org; Wed, 19 Jan 2011 14:50:37 -0500 Original-Received: from mail-vw0-f41.google.com ([209.85.212.41]:64691) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Pfe3A-00081d-9J for bug-guile@gnu.org; Wed, 19 Jan 2011 14:50:36 -0500 Original-Received: by vws10 with SMTP id 10so556083vws.0 for ; Wed, 19 Jan 2011 11:50:35 -0800 (PST) Original-Received: by 10.220.199.201 with SMTP id et9mr297754vcb.126.1295466634006; Wed, 19 Jan 2011 11:50:34 -0800 (PST) Original-Received: from [10.1.12.8] (vpn.permabit.com [204.246.225.2]) by mx.google.com with ESMTPS id u4sm2353999vch.12.2011.01.19.11.50.31 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 19 Jan 2011 11:50:32 -0800 (PST) In-Reply-To: <8CD83CC14D7A7E0-1624-1AA70@webmail-m056.sysops.aol.com> X-Mailer: Apple Mail (2.1082) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: bug-guile@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.bugs:4978 Archived-At: On Jan 16, 2011, at 14:38, Mark Harig wrote: >>=20 >> I'd say too OS-dependent; or more to do with how guile should be >> properly installed, than how to use it once it is installed. >>=20 >> But on the other hand, I might be misunderstanding what you had in=20 > mind; >> if you'd like to propose some specific text... >>=20 >=20 > If a user has followed the instructions in the section "Obtaining and > Installing Guile", and installed guile in the "/usr/local/" directory > tree, then, on systems that use the dynamic linker/loader ld.so or > ld-linux.so*, the instructions in the section "Linking Guile into > Programs" will fail because the new program 'simple-guile' will not be > able to locate the shared library 'libguile-2.0.so*'. I think the right answer for that is not to tell people that they have = to set environment variables in order to run Guile programs, but to tell = developers how to link programs properly so that they find the library = at run time. This tends to be somewhat platform-dependent, but often = arguments like "-R" or "-rpath" are needed; libtool should just Do The = Right Thing, if it's used. I'm less familiar with pkg-config, but = expect it should be have similarly. In fact, the man page for = pkg-config on my system (Mac OS X with MacPorts installed) says the = "--libs-only-L" option "prints the -L/-R part" of the link options, = which suggests to me that pkg-config is indeed supposed to be printing = options to set the run-time load path. If it's not doing that for you, = then we should figure out why not. In short, don't document how to work around a bug, if you can just fix = the bug. :-) Ken=