From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: "Mike Gran" Newsgroups: gmane.lisp.guile.user Subject: Re: snarfing docstrings in c extensions Date: Sat, 7 Apr 2018 19:27:27 -0700 Message-ID: <20180408022727.GA5638@joshua.dnsalias.com> References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: blaine.gmane.org 1523154363 32164 195.159.176.226 (8 Apr 2018 02:26:03 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 8 Apr 2018 02:26:03 +0000 (UTC) User-Agent: Mutt/1.9.2 (2017-12-15) Cc: "guile-user@gnu.org" To: Samuel Barreto Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Sun Apr 08 04:25:58 2018 Return-path: Envelope-to: guile-user@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f501l-0008Fe-TK for guile-user@m.gmane.org; Sun, 08 Apr 2018 04:25:58 +0200 Original-Received: from localhost ([::1]:42770 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f503r-0004oY-73 for guile-user@m.gmane.org; Sat, 07 Apr 2018 22:28:07 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37410) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f503S-0004nn-MU for guile-user@gnu.org; Sat, 07 Apr 2018 22:27:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f503N-0002Ym-QR for guile-user@gnu.org; Sat, 07 Apr 2018 22:27:42 -0400 Original-Received: from sonic305-21.consmr.mail.gq1.yahoo.com ([98.137.64.84]:38442) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1f503N-0002XW-IV for guile-user@gnu.org; Sat, 07 Apr 2018 22:27:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1523154455; bh=oXGIxX612tCMzka5yeUVfreLF1YOcN2avv5pxierslk=; h=From:Date:To:Cc:Subject:References:In-Reply-To:From:Subject; b=Az81xPRUCYBnkaZP2uS9Nc2mDr0gb+16tvL7erdlbtzv26t/bUatArA13kwAOPZjBsm28J0H2R8ZS5rAAldZN1+Z7VOTXBCCDq6hmrokb2WV8+gisci3evm2cGaNI+Z0bsug3UAOwQfQpvHqM+y+PGhnbRihat5H4hxX/CsFoO6dBxtdr5o/yI++VYXCnPTC47yNSXWDWFgsgdXYvIv5Kd8osm4Z9P4WvvEQf0YUZ0OThI0ERU821cx10hE21hwAzq7Mz3jGuZ7tRPqZpvxgFLpO0mkMeZ/EVrHU2k8SdbG5nKjdIbTrqaHmOw5OnjTKL1HC7eQXozt7JVQYWQ7WCw== X-YMail-OSG: LwY4.lwVM1m4epeO15rtdxu_MrH8gMlLCWxqSroI.aiADXKa29d77hHhU70ZRBx qBES8hrNaGjTfncRf.Wfi5vzPOA4nstYcJT4U9TDjt5SdxqmdFpq8ZoX2IaUFpJw9cLHLndv1Wfe AZVjq11T6xZ03dx4m4rP9LRuCBb4AwvCQcqxFk1DbkL0LX2PnCz2.xjLmLNx_YXtJ4vklzBauzjN 6wk9SYkW9TaCSJ946GAQzAyWTOUgv5nY_Pzwv.G68069kWI1HjMq_eQP_nyYfIga5DMYVFurdrLQ QjZAl8AdXBEDcmHGGiOutp5CQfGXCAicgTHBSA9WZrj6njO5S7wdSWL1Doy4aJV4l7ImRst8Bwx4 eB0tb321bP_XK67k7yVt03uMjwjN.qaizGEN85DIWPwwwzGSl_42oEIYOeUpfIdjMqkDbM7oyvm5 0nbnSj4vH2lms8M3y5kkcVLkaqF.JLoXfeMUBl9ghj9ye9T62.PldX7Jj.pSRJJnV.hkKA68LQyi kxt7j3Q-- Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic305.consmr.mail.gq1.yahoo.com with HTTP; Sun, 8 Apr 2018 02:27:35 +0000 Original-Received: from 162-197-224-133.lightspeed.irvnca.sbcglobal.net (EHLO joshua.spikycactus.dnsalias.com) ([162.197.224.133]) by smtp410.mail.gq1.yahoo.com (Oath Hermes SMTP Server) with ESMTPA ID 25d7550f57a68b120973a60bf8b8ad90; Sun, 08 Apr 2018 02:27:29 +0000 (UTC) Original-Received: by joshua.spikycactus.dnsalias.com (sSMTP sendmail emulation); Sat, 07 Apr 2018 19:27:27 -0700 Content-Disposition: inline In-Reply-To: esFrom: Mike Gran X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 98.137.64.84 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.lisp.guile.user:14538 Archived-At: On Sat, Apr 07, 2018 at 08:59:32PM +0200, Samuel Barreto wrote: > So I do am able to generate the info files that I want. My two problems > are: > > 1. how to use guile-snarf-docs portably ? (I have hardcoded them in my > Makefile for now.) Since they don't get installed, it is hard to know the most robust method. They are used as internal tools to Guile. > ... > And from a broader perspective, is it the way it is supposed to work ? I > mean, am I doing it the right way or are other "guile-extension-writers" > doing it otherwise ? That is the way it is supposed to work. But, I stopped doing it that way. I had the same sort of problems you are having now. Instead, I started writing scheme wrappers around my C functions. In C, let's say I had a library with a function named %foo. In scheme, I would make a procedure (define (foo x) "docstring" (%foo x)) It is a lot of wasted effort that way, but, it is easier to understand for me. I'm not sure I should recommend it, tho. -Mike Gran