From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Mark Harig Newsgroups: gmane.lisp.guile.bugs Subject: Re: Missing and out-of-date information in guile.1, the Guile man page Date: Sun, 16 Jan 2011 14:38:27 -0500 Message-ID: <8CD83CC14D7A7E0-1624-1AA70@webmail-m056.sysops.aol.com> References: <8CD818429F4EFE0-D0C-28BFF@Webmail-m115.sysops.aol.com> <87d3nxgaf9.fsf@ossau.uklinux.net> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; format=flowed Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1295206737 27922 80.91.229.12 (16 Jan 2011 19:38:57 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 16 Jan 2011 19:38:57 +0000 (UTC) To: bug-guile@gnu.org Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Sun Jan 16 20:38:53 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 1PeYRB-0006iA-F2 for guile-bugs@m.gmane.org; Sun, 16 Jan 2011 20:38:53 +0100 Original-Received: from localhost ([127.0.0.1]:47873 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PeYRB-0001oX-0y for guile-bugs@m.gmane.org; Sun, 16 Jan 2011 14:38:53 -0500 Original-Received: from [140.186.70.92] (port=56482 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PeYR4-0001oR-VT for bug-guile@gnu.org; Sun, 16 Jan 2011 14:38:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PeYR3-0002Xy-Px for bug-guile@gnu.org; Sun, 16 Jan 2011 14:38:46 -0500 Original-Received: from imr-da06.mx.aol.com ([205.188.169.203]:57105) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PeYR3-0002Xr-NU for bug-guile@gnu.org; Sun, 16 Jan 2011 14:38:45 -0500 Original-Received: from imo-ma02.mx.aol.com (imo-ma02.mx.aol.com [64.12.78.137]) by imr-da06.mx.aol.com (8.14.1/8.14.1) with ESMTP id p0GJcZ1s004289 for ; Sun, 16 Jan 2011 14:38:35 -0500 Original-Received: from idirectscm@aim.com by imo-ma02.mx.aol.com (mail_out_v42.9.) id 7.e54.fbf100f (37540) for ; Sun, 16 Jan 2011 14:38:30 -0500 (EST) Original-Received: from smtprly-mc03.mx.aol.com (smtprly-mc03.mx.aol.com [64.12.95.99]) by cia-mb02.mx.aol.com (v129.7) with ESMTP id MAILCIAMB021-d3d84d3349332fd; Sun, 16 Jan 2011 14:38:30 -0500 Original-Received: from webmail-m056 (webmail-m056.sim.aol.com [64.12.158.156]) by smtprly-mc03.mx.aol.com (v129.5) with ESMTP id MAILSMTPRLYMC032-d3d84d3349332fd; Sun, 16 Jan 2011 14:38:27 -0500 X-AOL-IP: 98.185.24.91 In-Reply-To: <87d3nxgaf9.fsf@ossau.uklinux.net> X-MB-Message-Source: WebUI X-MB-Message-Type: User X-Mailer: AIM WebMail 33069-STANDARD Original-Received: from 98.185.24.91 by webmail-m056.sysops.aol.com (64.12.158.156) with HTTP (WebMailUI); Sun, 16 Jan 2011 14:38:27 -0500 X-AOL-SENDER: idirectscm@aim.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:4964 Archived-At: > > 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. > > But on the other hand, I might be misunderstanding what you had in=20 mind; > if you'd like to propose some specific text... > 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*'. Here is some suggested text for the ENVIRONMENT and SEE ALSO sections of the guile.1 manual page: ENVIRONMENT LD_LIBRARY_PATH This variable may need to be set on operating systems that use the dynamic linker/loader ld.so/ld-linux.so* to specify where the shared libraries that are provided by Guile can be found. The variable should provide a colon-separated list of directories. For example, in the bash shell the following assignment may be used: export LD_LIBRARY_PATH=3D/usr/local/lib:$LD_LIBRARY_PATH More information about this variable can be found in the documentation for the dynamic linker/loader (ld.so(8) or ld-linux.so(8)). SEE ALSO ld.so(8), ld-linux.so(8) Another item of information that would be useful to add to the guile.1 manual page would be the date and version of Guile that the manual page describes. For example, the Emacs manual page lists the date that it is effective and the version. This appears at the bottom of the manual page, even though the directive describing it appears at the top of emacs.1: .TH EMACS 1 "2007 April 13" "GNU Emacs 23.2" Likewise, Guile might have: .TH GUILE 1 "2011 Jan 16" "GNU Guile 2.0" --