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: More missing options for guile/doc/guile.1 Date: Thu, 27 Jan 2011 14:25:35 -0500 Message-ID: <8CD8C6F1AF294F7-1AF8-149B8@Webmail-d115.sysops.aol.com> References: <8CD818E9822F6DE-D0C-29CF8@Webmail-m115.sysops.aol.com><8739otg977.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 1296157668 25978 80.91.229.12 (27 Jan 2011 19:47:48 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 27 Jan 2011 19:47:48 +0000 (UTC) Cc: bug-guile@gnu.org To: wingo@pobox.com, neil@ossau.uklinux.net Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Thu Jan 27 20:47:44 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 1PiXok-0002rz-Tj for guile-bugs@m.gmane.org; Thu, 27 Jan 2011 20:47:43 +0100 Original-Received: from localhost ([127.0.0.1]:42952 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PiXUJ-0002Bt-Lg for guile-bugs@m.gmane.org; Thu, 27 Jan 2011 14:26:35 -0500 Original-Received: from [140.186.70.92] (port=38734 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PiXUA-0002BG-Gx for bug-guile@gnu.org; Thu, 27 Jan 2011 14:26:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PiXU5-0007xl-Tu for bug-guile@gnu.org; Thu, 27 Jan 2011 14:26:22 -0500 Original-Received: from imr-db01.mx.aol.com ([205.188.91.95]:46630) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PiXU5-0007xc-Lo for bug-guile@gnu.org; Thu, 27 Jan 2011 14:26:21 -0500 Original-Received: from imo-ma02.mx.aol.com (imo-ma02.mx.aol.com [64.12.78.137]) by imr-db01.mx.aol.com (8.14.1/8.14.1) with ESMTP id p0RJPtRT007452; Thu, 27 Jan 2011 14:25:55 -0500 Original-Received: from idirectscm@aim.com by imo-ma02.mx.aol.com (mail_out_v42.9.) id 8.d7c.15289c9f (43835); Thu, 27 Jan 2011 14:25:50 -0500 (EST) Original-Received: from smtprly-ma01.mx.aol.com (smtprly-ma01.mx.aol.com [64.12.207.140]) by cia-dc02.mx.aol.com (v129.8) with ESMTP id MAILCIADC028-5c494d41c6af157; Thu, 27 Jan 2011 14:25:50 -0500 Original-Received: from Webmail-d115 (webmail-d115.sim.aol.com [205.188.146.16]) by smtprly-ma01.mx.aol.com (v129.8) with ESMTP id MAILSMTPRLYMA017-5c494d41c6af157; Thu, 27 Jan 2011 14:25:35 -0500 X-MB-Message-Type: User Original-Received: from 98.185.24.91 by Webmail-d115.sysops.aol.com (205.188.146.16) with HTTP (WebMailUI); Thu, 27 Jan 2011 14:25:35 -0500 X-AOL-IP: 98.185.24.91 X-MB-Message-Source: WebUI X-Mailer: AIM WebMail 33124-STANDARD In-Reply-To: X-AOL-SENDER: idirectscm@aim.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 205.188.91.95 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:5060 Archived-At: 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. Although my preferred documentation format is "info," requiring new users to learn info or emacs before learning guile is another barrier to adoption, it seems to me. If the terse approach is adopted, the manual page should at least include a reference to the on-line manual. (kept scrupulously up to date for each release, for example version 1.9.14 is *not* available here http://www.gnu.org/software/guile/docs/master/guile.html/index.html). 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=20 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? ---