From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) Newsgroups: gmane.lisp.guile.devel Subject: Re: ffi docs Date: Wed, 07 Apr 2010 23:38:32 +0200 Message-ID: <87k4sjndt3.fsf@gnu.org> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1270676344 28176 80.91.229.12 (7 Apr 2010 21:39:04 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 7 Apr 2010 21:39:04 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Wed Apr 07 23:39:04 2010 Return-path: Envelope-to: guile-devel@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 1Nzcxh-0007nc-P0 for guile-devel@m.gmane.org; Wed, 07 Apr 2010 23:39:02 +0200 Original-Received: from localhost ([127.0.0.1]:46743 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nzcxh-0007rf-9b for guile-devel@m.gmane.org; Wed, 07 Apr 2010 17:39:01 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NzcxZ-0007rQ-G7 for guile-devel@gnu.org; Wed, 07 Apr 2010 17:38:53 -0400 Original-Received: from [140.186.70.92] (port=36894 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NzcxX-0007rI-9W for guile-devel@gnu.org; Wed, 07 Apr 2010 17:38:52 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1NzcxU-0006Me-Re for guile-devel@gnu.org; Wed, 07 Apr 2010 17:38:51 -0400 Original-Received: from lo.gmane.org ([80.91.229.12]:42074) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1NzcxU-0006Ma-HT for guile-devel@gnu.org; Wed, 07 Apr 2010 17:38:48 -0400 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1NzcxR-0007hV-Eg for guile-devel@gnu.org; Wed, 07 Apr 2010 23:38:45 +0200 Original-Received: from acces.bordeaux.inria.fr ([193.50.110.5]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 07 Apr 2010 23:38:45 +0200 Original-Received: from ludo by acces.bordeaux.inria.fr with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 07 Apr 2010 23:38:45 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 46 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: acces.bordeaux.inria.fr X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 18 Germinal an 218 de la =?iso-8859-1?Q?R=E9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) Cancel-Lock: sha1:1XBBe9aWIT3lAcyEKI4DhQW5Q44= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:10158 Archived-At: Hello, Andy Wingo writes: > I reorganized the manual sections on dynamic linking, and wrote some > sections on the dynamic FFI. I'm appending a text rendering of the > documentation. Comments welcome! Not much to say, apart from the fact that I’m happy with all this work! :-) I like the introductory text about shared libraries & co., and I like the tone. > Most modern Unices have something called "shared libraries". ... or “dynamic shared objects” (DSOs). [Drepper et al. use this terminology.] > to Scheme - and that estrangement extends to components of foreign This should be an em dash (‘---’ with no space around in Texinfo). > (1) Some people also refer to the final linking stage at program > startup as `dynamic linking', so if you want to make yourself perfectly > clear, it is probably best to use the more technical term "dlopening", > as suggested by Gordon Matzigkeit in his libtool documentation. s/libtool/Libtool/, and an xref to the Libtool manual? > ;; struct timeval { > ;; time_t tv_sec; /* seconds */ > ;; suseconds_t tv_usec; /* microseconds */ > ;; }; > ;; assuming fields are of type "long" I think this assumption is one of the main pitfalls of a dynamic FFI. More generally, a problem is that there’s no compile-time check that the bindings correspond to the C code. How about adding a paragraph to mention it? BTW, I remember seeing occurrences of “her” in new material, where I’d personally prefer “their” (see ). Thanks, Ludo’.