From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andy Wingo Newsgroups: gmane.lisp.guile.bugs Subject: Re: Missing and out-of-date information in guile.1, the Guile man page Date: Mon, 24 Jan 2011 22:54:56 +0100 Message-ID: References: <8CD818429F4EFE0-D0C-28BFF@Webmail-m115.sysops.aol.com> <87d3nxgaf9.fsf@ossau.uklinux.net> <8CD83EB73A55053-1624-1C633@webmail-m056.sysops.aol.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: dough.gmane.org 1295906686 6015 80.91.229.12 (24 Jan 2011 22:04:46 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 24 Jan 2011 22:04:46 +0000 (UTC) Cc: bug-guile@gnu.org To: Mark Harig Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Mon Jan 24 23:04:41 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 1PhUWb-0007cg-4j for guile-bugs@m.gmane.org; Mon, 24 Jan 2011 23:04:37 +0100 Original-Received: from localhost ([127.0.0.1]:34724 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PhUWa-0000OJ-D7 for guile-bugs@m.gmane.org; Mon, 24 Jan 2011 17:04:36 -0500 Original-Received: from [140.186.70.92] (port=38057 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PhUIa-0002Wm-V0 for bug-guile@gnu.org; Mon, 24 Jan 2011 16:50:10 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PhUIY-0006vc-NZ for bug-guile@gnu.org; Mon, 24 Jan 2011 16:50:08 -0500 Original-Received: from a-pb-sasl-sd.pobox.com ([64.74.157.62]:59921 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PhUIY-0006uy-IU for bug-guile@gnu.org; Mon, 24 Jan 2011 16:50:06 -0500 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 5B120201E; Mon, 24 Jan 2011 16:50:53 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; s=sasl; bh=IGfuQBmMKrNEx4GKWBdcs/9GduM=; b=XKBA+3 68f/0gNR7zTi/SmCIH0WtDS8guA/fA3aD1wtK9hXEO81iwaczAeGD1RCLOT3yDfs d0HPUqPj5khhsanPAEHQ0e2f+GQmxfrdQzMBFejtbksqZXmVzbPsdPu7Ncbny8sF 0KWDG+yT9gnLGj0ASmpgD+6oPJr+/hAuchqcI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; q=dns; s=sasl; b=AUU32bJSNvl2mp+d4z7O+2jfwhFpP0qE KOKAUXtO35r5hbRwC9bK0i7OXcZiJ0+TGljdBh/R4NP2ADMD4xXwjMAMPw819qLy /4WFMbzjQeFqK8+TdVfNqeY0J1NDc1HCq0OL2Rob5325uAuNynUpvy2v4dwJIcNX 446k9IkOlq8= Original-Received: from a-pb-sasl-sd.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 447AB201D; Mon, 24 Jan 2011 16:50:52 -0500 (EST) Original-Received: from unquote.localdomain (unknown [90.164.198.39]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTPSA id 537BD2011; Mon, 24 Jan 2011 16:50:50 -0500 (EST) In-Reply-To: <8CD83EB73A55053-1624-1C633@webmail-m056.sysops.aol.com> (Mark Harig's message of "Sun, 16 Jan 2011 18:23:01 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) X-Pobox-Relay-ID: 035A955E-2804-11E0-B450-BC4EF3E828EC-02397024!a-pb-sasl-sd.pobox.com X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) 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:5020 Archived-At: --=-=-= Hi Mark, I updated the man page. I don't really know groff though, so please reply with comments (text appended). On Mon 17 Jan 2011 00:23, Mark Harig writes: > - There is no description in the Guile manual page, > guile.1, or the Guile Reference Manual, guile.info*, of > the environment variable GUILE_AUTO_COMPILE. I think that's OK to not have it in the man page, though it should be in the manual. > - The reference manual also briefly mentions the > environment variable GUILE_HISTORY (it describes the > default value as `.guile_history', but does not mention > its default location, presumably $HOME, correct?), but > the manual page does not mention it. Yes, it does put it in $HOME, though argually it should go in .local or .cache or something. I'm also OK with the man page not mentioning this, FWIW. > - Is there an environment variable that can specify the > name of the Guile initialization file (default: .guile)? Nope. You can use -q and -l though. > - Are there any other environment variables that are not > documented in the Guile Reference Manual? Yes. Would you like to submit a patch documenting them? Feel free to ask on the list about what they mean, if the meanings are not clear :) > - For comparison, the Emacs manual includes a section > describing the environment variables that may effect it > when it is invoked. See the Info node "(emacs) > Environment" (a subsection of the appendix "Invoking > Emacs"). Would be good to add to Guile as well. Cheers, Andy --=-=-= Content-Type: application/x-troff-man Content-Disposition: inline; filename=guile.1 Content-Transfer-Encoding: base64 LlwiIFdyaXR0ZW4gYnkgUm9iZXJ0IE1lcmtlbCAocmdtZXJrQG1pcmEubmV0KQouXCIgYXVnbWVu dGVkIGJ5IFJvYiBCcm93bmluZyA8cmxiQGNzLnV0ZXhhcy5lZHU+Ci5cIiBQcm9jZXNzIHRoaXMg ZmlsZSB3aXRoCi5cIiBncm9mZiAtbWFuIC1UYXNjaWkgZm9vLjEKLlwiCi5USCBHVUlMRSAxCi5T SCBOQU1FCmd1aWxlIFwtIHRoZSBHTlUgZXh0ZW5zaW9uIGxhbmd1YWdlCi5TSCBTWU5PUFNJUwou QiBndWlsZSBbLUwgRElSRUNUT1JZXSBbLWwgRklMRV0gWy1lIEZVTkNUSU9OXSBbXFxcXF0KLkIg Wy1jIEVYUFJdIFstcyBTQ1JJUFRdIFstLV0gW1NDUklQVF0gW0FSRy4uLl0KCk9ubHkgdGhlIG1v c3QgdXNlZnVsIG9wdGlvbnMgYXJlIGxpc3RlZCBoZXJlOyBzZWUgYmVsb3cgZm9yIHRoZQpyZW1h aW5kZXIuCi5TSCBERVNDUklQVElPTgpHTlUgR3VpbGUgaXMgYW4gaW1wbGVtZW50aW9uIG9mIHRo ZSBTY2hlbWUgcHJvZ3JhbW1pbmcgbGFuZ3VhZ2UuICBJdApleHRlbmRzIHRoZSBSNVJTIGFuZCBS NlJTIGxhbmd1YWdlIHN0YW5kYXJkcywgcHJvdmlkaW5nIGFkZGl0aW9uYWwKZmVhdHVyZXMgbmVj ZXNzYXJ5IGZvciByZWFsLXdvcmxkIHVzZS4gIEd1aWxlIHdvcmtzIHdlbGwgZm9yIGludGVyYWN0 aXZlCnVzZSwgYmFzaWMgc2NyaXB0aW5nLCBhbmQgZXh0ZW5zaW9uIG9mIGxhcmdlciBhcHBsaWNh dGlvbnMsIGFzIHdlbGwgYXMKZm9yIHN0YW5kLWFsb25lIFNjaGVtZSBhcHBsaWNhdGlvbiBkZXZl bG9wbWVudC4KClRoZQouQiBndWlsZQpleGVjdXRhYmxlIGl0c2VsZiBwcm92aWRlcyBhIHN0YW5k LWFsb25lIGludGVyYWN0aXZlIGNvbXBpbGVyIGFuZApydW4tdGltZSBmb3IgU2NoZW1lIHByb2dy YW1zLCBib3RoIGZvciBpbnRlcmFjdGl2ZSB1c2UgYW5kIGZvciBleGVjdXRpbmcKU2NoZW1lIHNj cmlwdHMgb3IgcHJvZ3JhbXMuCgpUaGlzIG1hbnVhbCBwYWdlIHByb3ZpZGVzIG9ubHkgYnJpZWYg aW5zdHJ1Y3Rpb24gaW4gaW52b2tpbmcKLkIgZ3VpbGUKZnJvbSB0aGUgY29tbWFuZCBsaW5lLiAg UGxlYXNlIGNvbnN1bHQgdGhlIGd1aWxlIGluZm8gZG9jdW1lbnRhdGlvbgoodHlwZSAKLkIgaW5m byAiZ3VpbGUoSW52b2tpbmcgR3VpbGUpIgphdCBhIGNvbW1hbmQgcHJvbXB0KSBmb3IgbW9yZSBp bmZvcm1hdGlvbi4KCi5TSCBPUFRJT05TCi5JUCAtTCBESVJFQ1RPUlkKQWRkIERJUkVDVE9SWSB0 byB0aGUgZnJvbnQgb2YgR3VpbGUncyBtb2R1bGUgbG9hZCBwYXRoLgouSVAgLWwgRklMRQpMb2Fk IHNjaGVtZSBzb3VyY2UgY29kZSBmcm9tIGZpbGUuCi5JUCAtZSBGVU5DVElPTgpBZnRlciByZWFk aW5nIHNjcmlwdCwgYXBwbHkgRlVOQ1RJT04gdG8gY29tbWFuZC1saW5lIGFyZ3VtZW50cy4gIE5v dGUKdGhhdCBGVU5DVElPTiBpcyBldmFsdWF0ZWQsIHNvIGUuZy4KLkIgKEAgKG15LW1vZHVsZSkg bXktcHJvYykKaXMgdmFsaWQgaGVyZS4KLklQIFxcXFwKVGhlICJtZXRhIHN3aXRjaCIsIHVzZWQg dG8gd29yayBhcm91bmQgbGltaXRhdGlvbnMgaW4gIyEgc2NyaXB0cy4KU2VlICJUaGUgTWV0YSBT d2l0Y2giIGluIHRoZSB0ZXhpbmZvIGRvY3VtZW50YXRpb24sIGZvciBtb3JlIGRldGFpbHMuCi5J UCAtLQpTdG9wIGFyZ3VtZW50IHByb2Nlc3NpbmcsIHN0YXJ0IGd1aWxlIGluIGludGVyYWN0aXZl IG1vZGUuCi5JUCAtYyBFWFBSClN0b3AgYXJndW1lbnQgcHJvY2Vzc2luZywgZXZhbHVhdGUgRVhQ UiBhcyBhIHNjaGVtZSBleHByZXNzaW9uLgouSVAgLXMgU0NSSVBULUZJTEUKTG9hZCBTY2hlbWUg c291cmNlIGZyb20gU0NSSVBULUZJTEUgYW5kIGV4ZWN1dGUgYXMgYSBzY3JpcHQuICBOb3RlIHRo YXQKdGhlIGluIG1hbnkgY2FzZXMgaXQgaXMgbm90IG5lY2Vzc2FyeSB0byB1c2UgLXM7IG9uZSBt YXkgaW52b2tlIEd1aWxlCmp1c3QgYXMKLkIgZ3VpbGUgU0NSSVBULUZJTEUgQVJHLi4uCi5JUCAt ZHMKRG8gLXMgU0NSSVBUIGF0IHRoaXMgcG9pbnQuICBOb3RlIHRoYXQgdGhpcyBhcmd1bWVudCBt dXN0IGJlIHVzZWQgaW4KY29uanVjdGlvbiB3aXRoIC1zLgouSVAgLS1kZWJ1ZwpTdGFydCBndWls ZSB3aXRoIHRoZSBkZWJ1Z2dpbmcgVk0uICBCeSBkZWZhdWx0LCBvbiB3aGVuIGludm9rZWQKaW50 ZXJhY3RpdmVseSwgb2ZmIG90aGVyd2lzZS4KLklQIC0tYXV0b2NvbXBpbGUKQ29tcGlsZSBzb3Vy Y2UgZmlsZXMgYXV0b21hdGljYWxseSAoZGVmYXVsdCBiZWhhdmlvcikuCi5JUCAtLW5vLWF1dG9j b21waWxlCkRpc2FibGUgYXV0b21hdGljIHNvdXJjZSBmaWxlIGNvbXBpbGF0aW9uLgouSVAgLS1s aXN0ZW5bPVBdCkxpc3RlbiBvbiBhIHBvcnQgb3Igc29ja2V0IGZvciByZW1vdGUgUkVQTCBjb25u ZWN0aW9ucy4gIFNlZSB0aGUgbWFudWFsCmZvciBtb3JlIGRldGFpbHMuCi5JUCAtLXVzZS1zcmZp PU4sTS4uLgpMb2FkIFNSRkkgZXh0ZW5zaW9ucyBOLCBNLCBldGMuIEZvciBleGFtcGxlLCAiLS11 c2Utc3JmaT04LDEzIi4KLklQIC14IEVYVEVOU0lPTgpBZGQgRVhURU5TSU9OIHRvIHRoZSBHdWls ZSdzIGxvYWQgZXh0ZW5zaW9uIGxpc3QuCi5JUCAtLWhlbHAgCkRlc2NyaWJlIGNvbW1hbmQgbGlu ZSBvcHRpb25zIGFuZCBleGl0Ci5JUCAtLXZlcnNpb24KRGlzcGxheSBndWlsZSB2ZXJzaW9uIGFu ZCBleGl0LgouSVAgLXEKSW4gaW50ZXJhY3RpdmUgbW9kZSwgc3VwcHJlc3MgbG9hZGluZyB0aGUg dXNlcidzIH4vLmd1aWxlIGZpbGUuCgouU0ggRU5WSVJPTk1FTlQKLlwiLlRQIFx3J01BTlJPRkZT RVFcIFwgJ3UKLlRQCi5CIEdVSUxFX0xPQURfUEFUSApJZgouUkIgJCBHVUlMRV9MT0FEX1BBVEgK aXMgc2V0LCBpdHMgdmFsdWUgaXMgdXNlZCB0byBhZ3VtZW50IHRoZSBwYXRoIHRvIHNlYXJjaCBm b3Igc2NoZW1lCmZpbGVzIHdoZW4gbG9hZGluZy4gIEl0IHNob3VsZCBiZSBhIGNvbG9uIHNlcGFy YXRlZCBsaXN0IG9mCmRpcmVjdG9yaWVzIHdoaWNoIHdpbGwgYmUgcHJlcGVuZGVkIHRvIHRoZSBk ZWZhdWx0ICVsb2FkLXBhdGguCgouQiBHVUlMRV9MT0FEX0NPTVBJTEVEX1BBVEgKSWYKLlJCICQg R1VJTEVfTE9BRF9DT01QSUxFRF9QQVRICmlzIHNldCwgaXRzIHZhbHVlIGlzIHVzZWQgdG8gYWd1 bWVudCB0aGUgcGF0aCB0byBzZWFyY2ggZm9yIGNvbXBpbGVkClNjaGVtZSBmaWxlcyAoLmdvIGZp bGVzKSB3aGVuIGxvYWRpbmcuICBJdCBzaG91bGQgYmUgYSBjb2xvbiBzZXBhcmF0ZWQKbGlzdCBv ZiBkaXJlY3RvcmllcyB3aGljaCB3aWxsIGJlIHByZXBlbmRlZCB0byB0aGUgZGVmYXVsdCAlbG9h ZC1wYXRoLgoKLlNIIEZJTEVTCi5JIH4vLmd1aWxlCmlzIGEgZ3VpbGUgc2NyaXB0IHRoYXQgaXMg ZXhlY3V0ZWQgYmVmb3JlIGFueSBvdGhlciBwcm9jZXNzaW5nIG9jY3Vycy4KRm9yIGV4YW1wbGUs IHRoZSBmb2xsb3dpbmcgLmd1aWxlIGFjdGl2YXRlcyBndWlsZSdzIHJlYWRsaW5lCmludGVyZmFj ZToKCi5SUyA0Cih1c2UtbW9kdWxlcyAoaWNlLTkgcmVhZGxpbmUpKQouUlMgMAooYWN0aXZhdGUt cmVhZGxpbmUpCgouU0ggIlNFRSBBTFNPIgpUaGUgZnVsbCBkb2N1bWVudGF0aW9uIGZvciBndWls ZSBpcyBtYWludGFpbmVkIGFzIGEgVGV4aW5mbyBtYW51YWwuICBJZgp0aGUgaW5mbyBhbmQgZ3Vp bGUgcHJvZ3JhbXMgYXJlIHByb3Blcmx5IGluc3RhbGxlZCBhdCB5b3VyIHNpdGUsIHRoZQpjb21t YW5kCi5JUAouQiBpbmZvIGd1aWxlCi5QUApzaG91bGQgZ2l2ZSB5b3UgYWNjZXNzIHRvIHRoZSBj b21wbGV0ZSBtYW51YWwuCgpodHRwOi8vd3d3LnNjaGVtZXJzLm9yZyBwcm92aWRlcyBhIGdlbmVy YWwgaW50cm9kdWN0aW9uIHRvIHRoZQpTY2hlbWUgbGFuZ3VhZ2UuCgouU0ggIlJFUE9SVElORyBC VUdTIgpUaGVyZSBpcyBhIG1haWxpbmcgbGlzdCwgYnVnLWd1aWxlQGdudS5vcmcsIGZvciByZXBv cnRpbmcgR3VpbGUgYnVncyBhbmQKZml4ZXMuICBCdXQgYmVmb3JlIHJlcG9ydGluZyBzb21ldGhp bmcgYXMgYSBidWcsIHBsZWFzZSB0cnkgdG8gYmUgc3VyZQp0aGF0IGl0IHJlYWxseSBpcyBhIGJ1 Zywgbm90IGEgbWlzdW5kZXJzdGFuZGluZyBvciBhIGRlbGliZXJhdGUgZmVhdHVyZS4KV2UgYXNr IHlvdSB0byByZWFkIHRoZSBzZWN0aW9uIGBgUmVwb3J0aW5nIEJ1Z3MnJyBpbiB0aGUgR3VpbGUg cmVmZXJlbmNlCm1hbnVhbCAob3IgSW5mbyBzeXN0ZW0pIGZvciBoaW50cyBvbiBob3cgYW5kIHdo ZW4gdG8gcmVwb3J0IGJ1Z3MuICBBbHNvLAppbmNsdWRlIHRoZSB2ZXJzaW9uIG51bWJlciBvZiB0 aGUgR3VpbGUgeW91IGFyZSBydW5uaW5nIGluIGV2ZXJ5IGJ1ZwpyZXBvcnQgdGhhdCB5b3Ugc2Vu ZCBpbi4gIEJ1Z3MgdGVuZCBhY3R1YWxseSB0byBiZSBmaXhlZCBpZiB0aGV5IGNhbiBiZQppc29s YXRlZCwgc28gaXQgaXMgaW4geW91ciBpbnRlcmVzdCB0byByZXBvcnQgdGhlbSBpbiBzdWNoIGEg d2F5IHRoYXQKdGhleSBjYW4gYmUgZWFzaWx5IHJlcHJvZHVjZWQuCgouU0ggQ09QWUlORwpDb3B5 cmlnaHQgKEMpIDIwMTAgRnJlZSBTb2Z0d2FyZSBGb3VuZGF0aW9uLCBJbmMuCgpQZXJtaXNzaW9u IGlzIGdyYW50ZWQgdG8gbWFrZSBhbmQgZGlzdHJpYnV0ZSB2ZXJiYXRpbSBjb3BpZXMgb2YgdGhp cwpkb2N1bWVudCBwcm92aWRlZCB0aGUgY29weXJpZ2h0IG5vdGljZSBhbmQgdGhpcyBwZXJtaXNz aW9uIG5vdGljZSBhcmUKcHJlc2VydmVkIG9uIGFsbCBjb3BpZXMuCgpQZXJtaXNzaW9uIGlzIGdy YW50ZWQgdG8gY29weSBhbmQgZGlzdHJpYnV0ZSBtb2RpZmllZCB2ZXJzaW9ucyBvZiB0aGlzCmRv Y3VtZW50IHVuZGVyIHRoZSBjb25kaXRpb25zIGZvciB2ZXJiYXRpbSBjb3B5aW5nLCBwcm92aWRl ZCB0aGF0IHRoZQplbnRpcmUgcmVzdWx0aW5nIGRlcml2ZWQgd29yayBpcyBkaXN0cmlidXRlZCB1 bmRlciB0aGUgdGVybXMgb2YgYQpwZXJtaXNzaW9uIG5vdGljZSBpZGVudGljYWwgdG8gdGhpcyBv bmUuCgpQZXJtaXNzaW9uIGlzIGdyYW50ZWQgdG8gY29weSBhbmQgZGlzdHJpYnV0ZSB0cmFuc2xh dGlvbnMgb2YgdGhpcwpkb2N1bWVudCBpbnRvIGFub3RoZXIgbGFuZ3VhZ2UsIHVuZGVyIHRoZSBh Ym92ZSBjb25kaXRpb25zIGZvciBtb2RpZmllZAp2ZXJzaW9ucywgZXhjZXB0IHRoYXQgdGhpcyBw ZXJtaXNzaW9uIG5vdGljZSBtYXkgYmUgc3RhdGVkIGluIGEKdHJhbnNsYXRpb24gYXBwcm92ZWQg YnkgdGhlIEZyZWUgU29mdHdhcmUgRm91bmRhdGlvbi4KCi5TSCBBVVRIT1JTClJvYmVydCBNZXJr ZWwgPHJnbWVya0BtaXJhLm5ldD4gd3JvdGUgdGhpcyBtYW5wYWdlLiAgClJvYiBCcm93bmluZyA8 cmxiQGNzLnV0ZXhhcy5lZHU+IGhhcyBhZGRlZCB0byBpdC4KCi5CIGd1aWxlIAppcyBHTlUgc29m dHdhcmUuICBHdWlsZSBpcyBvcmlnaW5hbGx5IGJhc2VkIG9uIEF1YnJleSBKYWZmZXIncwpTQ00g aW50ZXJwcmV0ZXIsIGFuZCBpcyB0aGUgd29yayBvZiBtYW55IGluZGl2aWR1YWxzLgo= --=-=-=--