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: More missing options for guile/doc/guile.1 Date: Thu, 27 Jan 2011 23:35:01 +0100 Message-ID: References: <8CD818E9822F6DE-D0C-29CF8@Webmail-m115.sysops.aol.com> <8739otg977.fsf@ossau.uklinux.net> <8CD8C6F1AF294F7-1AF8-149B8@Webmail-d115.sysops.aol.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1296199565 9212 80.91.229.12 (28 Jan 2011 07:26:05 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 28 Jan 2011 07:26:05 +0000 (UTC) Cc: bug-guile@gnu.org, neil@ossau.uklinux.net To: Mark Harig Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Fri Jan 28 08:26:01 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 1PiiiU-0001sG-JR for guile-bugs@m.gmane.org; Fri, 28 Jan 2011 08:25:59 +0100 Original-Received: from localhost ([127.0.0.1]:44954 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PiiYQ-0006Q0-CI for guile-bugs@m.gmane.org; Fri, 28 Jan 2011 02:15:34 -0500 Original-Received: from [140.186.70.92] (port=51401 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PiiUU-00050M-PE for bug-guile@gnu.org; Fri, 28 Jan 2011 02:11:36 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PiiPT-0007rZ-UC for bug-guile@gnu.org; Fri, 28 Jan 2011 02:06:24 -0500 Original-Received: from a-pb-sasl-sd.pobox.com ([64.74.157.62]:34433 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PiiPT-0007rM-Ov for bug-guile@gnu.org; Fri, 28 Jan 2011 02:06:19 -0500 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 42ED52EFB; Thu, 27 Jan 2011 17:30:59 -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=RlsYyhh+kD66MKE1mPWIcOAsBHk=; b=r/fDhA CkVe6Jx69dkKWVff1tfjArBQTD19+Dllq2CPk7az44b4t7A3Wk4ff7a9NsbyOmQz 57Ij/FTvmHHDxZhSHZBldAlAun9hZ7X9pAO5hQvfGBKHV3G70/cCf5WRDNmewl45 2XLlgH8oxFDgh1eThT4ndKUZF6yoGE8ba7u5M= 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=PrmHfywuAk2BzXw8ZB/HXjb5BYkuUte9 FrdMQhS+4HpuHK2mAaai5w3PeEYhsEAV1r7DaxyL8nTvjK50uEAWym8vwzhVL9dZ Zr/uEfqjkzVmaT6deP+eFPD5UkM+6UtnhgccVnWqMFih8UxFNKs0JKYR48WNs7vK TNytCvg3/WY= 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 1F0342EF7; Thu, 27 Jan 2011 17:30:57 -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 1E9702EF6; Thu, 27 Jan 2011 17:30:53 -0500 (EST) In-Reply-To: <8CD8C6F1AF294F7-1AF8-149B8@Webmail-d115.sysops.aol.com> (Mark Harig's message of "Thu, 27 Jan 2011 14:25:35 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) X-Pobox-Relay-ID: 1BFE9340-2A65-11E0-B693-BC4EF3E828EC-02397024!a-pb-sasl-sd.pobox.com X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-Received-From: 64.74.157.62 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:5062 Archived-At: On Thu 27 Jan 2011 20:25, Mark Harig writes: > Here are some other language interpreters that have manual pages: > > awk, bash, bc, clisp, dc, emacs, make > > "emacs" and "make" follow the terse approach, while the others do not. > These can be examined to help decide whether you would prefer for those > programs to have a terse manual page or not. For what it's worth, I think a more complete man page is better for users. However I personally don't want to maintain a man page. If you are interested in working on the man page though, by all means, let's have a nice one! > Speaking of on-line manuals, I would like to point to Org-mode's manual, > which has melded info and HTML together so that info keyboard > commands can be used to move through the manual (that is, some > commands, such as 'n', 'p', 'u', 't', '1', '2', but not all), while > still allowing > mouse users to click on links. > > http://orgmode.org/guide/index.html > > This is something I would like to see all GNU online manuals that > are derived from texinfo files aspire to. Can a guile version of > http://orgmode.org/org-keys.js be written? Neat! Yes is the answer; but it would be best if this made its way into makeinfo itself. I hear makeinfo is about to undergo a new release -- see http://www.gnu.org/bulletins/gnustatus-2011-01.html#Texinfo -- with a new more active maintenance, so perhaps now is the hour for great GNU manuals, across the board! Cheers, Andy -- http://wingolog.org/