From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Panicz Maciej Godek Newsgroups: gmane.lisp.guile.user Subject: Re: SLAYER announcement and help request for preparing a GNU package Date: Wed, 8 May 2013 23:44:17 +0200 Message-ID: References: <874nefpzq0.fsf@zigzag.favinet> <87wqr9n7cb.fsf@zigzag.favinet> <87sj1x8ued.fsf@tines.lan> <1368026126.3047.YahooMailNeo@web120403.mail.ne1.yahoo.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a11c2af00fa167a04dc3bd5ad X-Trace: ger.gmane.org 1368049479 24808 80.91.229.3 (8 May 2013 21:44:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 8 May 2013 21:44:39 +0000 (UTC) Cc: "guile-user@gnu.org" , Thien-Thi Nguyen To: Mike Gran Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Wed May 08 23:44:38 2013 Return-path: Envelope-to: guile-user@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 1UaCAA-0006Ij-7F for guile-user@m.gmane.org; Wed, 08 May 2013 23:44:38 +0200 Original-Received: from localhost ([::1]:39383 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UaCA9-0004rB-Rh for guile-user@m.gmane.org; Wed, 08 May 2013 17:44:37 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44928) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UaC9v-0004kQ-VX for guile-user@gnu.org; Wed, 08 May 2013 17:44:25 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UaC9t-0006Ik-6M for guile-user@gnu.org; Wed, 08 May 2013 17:44:23 -0400 Original-Received: from mail-vb0-x230.google.com ([2607:f8b0:400c:c02::230]:33187) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UaC9q-0006HS-Gy; Wed, 08 May 2013 17:44:18 -0400 Original-Received: by mail-vb0-f48.google.com with SMTP id q16so2006123vbe.7 for ; Wed, 08 May 2013 14:44:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=4qaLIczo18dwq05z8riY3gIWRcUcUWSdpYtnc9rkc4k=; b=DJ5KKS7dmHRWjrF9d5q4qlyDwWt6J5s1tl+oahy1fSCNFNUef2/IYAMZow09Uhj9eA 4fe49O/FVC8Dn1D28Jd6LAEU1KOGO8bCEKBWOEIZg5RYRD2DWSfYLFyvF2lxhp89xRoO W9g2GoCoiiGlR5z9+79RANHmhKT8Gp2oUip8e26LhpjlfNHJwLOj6yqPzCkuGdM7rxk6 oIAQS3cAxd6FxXJa5BfxVsZuqOgb9r4u+69O6L+sc3plKQ0feEwwpgvCzbjZMKvHTnZk rPNIi3ZDRX9jGc3POr4I/lnys1uEZDeSHidHCLku5m3MqNwzRjTCaaZQXHDYqnm4b/Br WTMQ== X-Received: by 10.220.76.129 with SMTP id c1mr6002606vck.48.1368049457958; Wed, 08 May 2013 14:44:17 -0700 (PDT) Original-Received: by 10.220.141.10 with HTTP; Wed, 8 May 2013 14:44:17 -0700 (PDT) In-Reply-To: <1368026126.3047.YahooMailNeo@web120403.mail.ne1.yahoo.com> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:400c:c02::230 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Original-Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.user:10343 Archived-At: --001a11c2af00fa167a04dc3bd5ad Content-Type: text/plain; charset=ISO-8859-1 2013/5/8 Mike Gran > > > No, it's not used to generate the manual. It's used to generate > > guile-procedures.txt, which is consulted by 'object-documentation'. > > > > I agree that the current state of docstring handling leaves much to be > > desired. Maybe we should start a discussion on guile-devel about how > > the improve things. > > I once asked the question if it would be possible to create a version > of scm_c_define_gsubr that took a docstring. The opinion at the time > was that it would be difficult. > Well, after a moment of thought I concluded that it's not that difficult, at least with the current version of guile, using scm_set_procedure_property_x: scm_c_define_gsubr("proc", 0, 0, 0 ,(scm_t_subr) proc); scm_c_export("proc" ,NULL); scm_set_procedure_property_x(scm_variable_ref(scm_c_lookup("proc")), scm_from_utf8_symbol("documentation"), scm_from_utf8_string("Does something")); Although it may not be particularly efficient, I think it is sufficient (and it seems to work just fine), unless there are any other contraindications --001a11c2af00fa167a04dc3bd5ad Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable
2013/5/8 Mike Gran <spk121@yahoo.com>

> No, it's not used to generate the manual.=A0 It's used to gene= rate
> guile-procedures.txt, which is consulted by 'object-documentation&= #39;.
>
> I agree that the current state of docstring handling leaves much to be=
> desired.=A0 Maybe we should start a discussion on guile-devel about ho= w
> the improve things.

I once asked the question if it would be possible to create a version=
of scm_c_define_gsubr that took a docstring.=A0 The opinion at the time
was that it would be difficult.

W= ell, after a moment of thought I concluded that it's not that difficult= , at least with the current version of guile, using scm_set_procedure_prope= rty_x:

scm_c_define_gsubr("proc", 0, 0, 0= ,(scm_t_subr) proc);
scm_c_export("proc" ,NULL);

scm_set_procedure_property_x(scm_variable_ref(scm_c= _lookup("proc")),
=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0 =A0 =A0 =A0 =A0 =A0scm_from_utf8_symbol("documentation"),
=
=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 = =A0 =A0 =A0 =A0 =A0 =A0 =A0scm_from_utf8_string("Does something")= );

Although it may not be particularly efficient, I thi= nk it is sufficient (and it seems to work just fine), unless there are any = other contraindications

--001a11c2af00fa167a04dc3bd5ad--