From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Mark H Weaver Newsgroups: gmane.lisp.guile.devel Subject: Re: [Guile-commits] GNU Guile branch, stable-2.0, updated. v2.0.7-25-g990b11c Date: Sat, 12 Jan 2013 10:17:34 -0500 Message-ID: <878v7ysa5t.fsf@tines.lan> References: <87k3rj3ak7.fsf@gnu.org> <87txqnxy4j.fsf@pobox.com> <87d2xbz3us.fsf@gnu.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 1358003894 2213 80.91.229.3 (12 Jan 2013 15:18:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 12 Jan 2013 15:18:14 +0000 (UTC) Cc: Andy Wingo , guile-devel@gnu.org To: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sat Jan 12 16:18:32 2013 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 1Tu2qo-0004Ig-N4 for guile-devel@m.gmane.org; Sat, 12 Jan 2013 16:18:26 +0100 Original-Received: from localhost ([::1]:49788 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tu2qY-0003cy-Lx for guile-devel@m.gmane.org; Sat, 12 Jan 2013 10:18:10 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:54218) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tu2qV-0003cm-G2 for guile-devel@gnu.org; Sat, 12 Jan 2013 10:18:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Tu2qO-0005i1-1l for guile-devel@gnu.org; Sat, 12 Jan 2013 10:18:07 -0500 Original-Received: from world.peace.net ([96.39.62.75]:57239) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tu2qN-0005gn-Te; Sat, 12 Jan 2013 10:17:59 -0500 Original-Received: from 209-6-92-20.c3-0.smr-ubr1.sbo-smr.ma.cable.rcn.com ([209.6.92.20] helo=tines.lan) by world.peace.net with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Tu2q6-0005H7-Qw; Sat, 12 Jan 2013 10:17:43 -0500 In-Reply-To: <87d2xbz3us.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Sat, 12 Jan 2013 00:39:39 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 96.39.62.75 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:15404 Archived-At: ludo@gnu.org (Ludovic Court=C3=A8s) writes: > Andy Wingo skribis: >> Incidentally, it would be nice to start using texinfo in docstrings, and >> use (texinfo serialize) to render them. > > That=E2=80=99d be ideal, but I wonder whether there are tools around that= would > end up displaying raw Texinfo, such as anything that use > =E2=80=98procedure-documentation=E2=80=99. Perhaps that can be solved ea= sily. FWIW, I agree with Andy that it would be good to support texinfo markup in docstrings. At present, the docstrings for procedures implemented in C are much nicer looking than the Scheme ones. This does not bode well for future docstrings as we move more code from C to Scheme. I've been sad to see the recent patches that strip texinfo markup from docstrings. That's going in the wrong direction, IMO. Instead, we should be bringing Scheme docstrings up to par with their C counterparts. Regarding 'procedure-documentation', I think it should return the rendered version, just like it does for procedures defined in C. What do you think? Mark