From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chad Albers Newsgroups: gmane.lisp.guile.devel Subject: Re: Contributions to Guile Date: Mon, 8 Feb 2016 16:28:18 -0500 Message-ID: References: <87twlno63d.fsf@gnu.org> <877figyxb2.fsf@dustycloud.org> <87si13k4nn.fsf@gnu.org> <87twljxbuq.fsf@dustycloud.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1454966909 10011 80.91.229.3 (8 Feb 2016 21:28:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Feb 2016 21:28:29 +0000 (UTC) Cc: =?UTF-8?Q?Ludovic_Court=C3=A8s?= , guile-devel@gnu.org To: Christopher Allan Webber Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Feb 08 22:28:28 2016 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aStMB-0001tj-Ur for guile-devel@m.gmane.org; Mon, 08 Feb 2016 22:28:28 +0100 Original-Received: from localhost ([::1]:49012 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aStMB-0001Vh-Cj for guile-devel@m.gmane.org; Mon, 08 Feb 2016 16:28:27 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40440) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aStM4-0001Uh-HZ for guile-devel@gnu.org; Mon, 08 Feb 2016 16:28:21 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aStM3-0003SA-H8 for guile-devel@gnu.org; Mon, 08 Feb 2016 16:28:20 -0500 Original-Received: from mail-vk0-x22c.google.com ([2607:f8b0:400c:c05::22c]:34828) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aStM3-0003Rt-AE for guile-devel@gnu.org; Mon, 08 Feb 2016 16:28:19 -0500 Original-Received: by mail-vk0-x22c.google.com with SMTP id e6so104357044vkh.2 for ; Mon, 08 Feb 2016 13:28:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=neomantic-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; bh=zF72IPdZxBFG2rZH0KM1/iE1595Jf+X3+byDrxRDfiE=; b=u+jVGm6Vg8JB50AsjvJS1c5TmPDjzhAxKb4YpbK/fjYXmxpn0KeGbhiWUUObOJsBYh QMaDx2SFwPRd7EilNz0dzIJ+SD+2LgN9TVKTaVlB72z9kdGWZIj1OC1K6we0MCjMLb40 Ns2DX+4cvlzzneVlxBt3/qHN+7tAXAQvBpINjYMRioRZKlTERk7Ud+rXy0oDTWgdDgB7 4zDye2v9BRPlZWmJVJrBeccYRjRRgjxANh21sa9f2WXY4oCnpi5sEpm1K71W1+JrszrS lx/kgVn6YJKdizxssr1XTSClcszZt1B58PpQ/g1Jo8r3br7ccpQyIZW/95cFJsVVI4TT ms6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:date :message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=zF72IPdZxBFG2rZH0KM1/iE1595Jf+X3+byDrxRDfiE=; b=ANknRpA1wpQzAI6zP349YQP9dklAWf6m7t4PeQxSKc6EjcOMz7dwp22de1YKPghAv7 lggYcED6gQ0abaRnz7Q1DSkoOgT9zBELe/edZSt/RjJBNpKRz2Fi58KSw5ddAKWUF/OC 5PnQl6wZAzA1c/n4WYjcOi7qXFPDsverbUZ9ZY9ssxLgwK/s1XKLy3/JMd/1wqjycxb2 L11GsAGmq7g1dq/kNPzylKDLy0oZedJHKXDYnCXb9iL0iNMKnF/GnfFnxQQOSNxGF0DL KTMoTYLVRkywuuZueqZR41Oew7sOPk3sKLHxMhbXJ3Yl634jRgTAQUWI6LWN/Kg0OdD3 OQYg== X-Gm-Message-State: AG10YOSr0w/n+34Eh79cSy/v/Ho9Rb/DOXzG1fVMfFdoMCQFqBaVVJYPt3v7fXWvcqigzeYlXjBU3kJJ/oDqQw== X-Received: by 10.31.52.195 with SMTP id b186mr20920199vka.39.1454966898743; Mon, 08 Feb 2016 13:28:18 -0800 (PST) Original-Received: by 10.31.164.80 with HTTP; Mon, 8 Feb 2016 13:28:18 -0800 (PST) In-Reply-To: <87twljxbuq.fsf@dustycloud.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400c:c05::22c X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:18160 Archived-At: On Mon, Feb 8, 2016 at 2:05 PM, Christopher Allan Webber wrote: > Ludovic Court=C3=A8s writes: > >> Christopher Allan Webber skribis: >> >>> Chad Albers writes: >> >> [...] >> >>>> b. More robust documentation system - texinfo is not the greatest. And >>>> it's non-trivial to generate any documentation (including texinfo) for >>>> modules. >>> >>> Texinfo is pretty nice to use if you're an emacs user... in fact, if >>> you're an emacs user, it's the best documentation reading system in the >>> world. But not everyone's an emacs user. >> >> I think Texinfo is OK even if you=E2=80=99re not an Emacs user, no? Esp= ecially >> with the just-release 6.1 where menus can (finally!) be automatically >> generated. >> >>> If the html export was nicely themed IMHO, HTML has clearly won the documentation game. I believe it goes without saying that most developers have a web browser installed, rather than a textinfo reader. The more the guile project publishes easily searchable (without google) documentation in the most accessible media format the better for guile. -- Chad Albers