From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alexei Matveev Newsgroups: gmane.lisp.guile.bugs Subject: bug#17869: wrong return type for void scm_c_export(const char *name, ...) in docs Date: Sun, 29 Jun 2014 13:55:13 +0200 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=e89a8ff1ccae2362c904fcf837ff X-Trace: ger.gmane.org 1404042989 14816 80.91.229.3 (29 Jun 2014 11:56:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 29 Jun 2014 11:56:29 +0000 (UTC) To: 17869@debbugs.gnu.org Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Sun Jun 29 13:56:22 2014 Return-path: Envelope-to: guile-bugs@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 1X1DiX-0004vl-Gn for guile-bugs@m.gmane.org; Sun, 29 Jun 2014 13:56:21 +0200 Original-Received: from localhost ([::1]:57315 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X1DiX-00012s-5A for guile-bugs@m.gmane.org; Sun, 29 Jun 2014 07:56:21 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45012) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X1DiG-0000kN-4A for bug-guile@gnu.org; Sun, 29 Jun 2014 07:56:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X1DiF-0003uy-6r for bug-guile@gnu.org; Sun, 29 Jun 2014 07:56:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:45341) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X1DiF-0003uu-38 for bug-guile@gnu.org; Sun, 29 Jun 2014 07:56:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1X1DiE-0001jo-Go for bug-guile@gnu.org; Sun, 29 Jun 2014 07:56:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Alexei Matveev Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Sun, 29 Jun 2014 11:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 17869 X-GNU-PR-Package: guile X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-guile@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.14040429296616 (code B ref -1); Sun, 29 Jun 2014 11:56:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Jun 2014 11:55:29 +0000 Original-Received: from localhost ([127.0.0.1]:36491 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X1Dhg-0001id-Fi for submit@debbugs.gnu.org; Sun, 29 Jun 2014 07:55:28 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:43168) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X1Dhb-0001iL-Cl for submit@debbugs.gnu.org; Sun, 29 Jun 2014 07:55:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X1DhV-0003pX-6s for submit@debbugs.gnu.org; Sun, 29 Jun 2014 07:55:18 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:54247) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X1DhV-0003pT-3G for submit@debbugs.gnu.org; Sun, 29 Jun 2014 07:55:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44886) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X1DhU-0008V2-4R for bug-guile@gnu.org; Sun, 29 Jun 2014 07:55:17 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X1DhT-0003pD-73 for bug-guile@gnu.org; Sun, 29 Jun 2014 07:55:16 -0400 Original-Received: from mail-ob0-x22e.google.com ([2607:f8b0:4003:c01::22e]:38371) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X1DhT-0003p9-1d for bug-guile@gnu.org; Sun, 29 Jun 2014 07:55:15 -0400 Original-Received: by mail-ob0-f174.google.com with SMTP id va2so7502000obc.19 for ; Sun, 29 Jun 2014 04:55:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=98nUtl4+BXeGTNmjeDbanFyMlzH1ZiSiyjAIiYtKIuc=; b=gcb0OAw0sMREQ/R2duO3qENbTMHsqVDzBrnQfoPBYcpk62DSTycLBIO+i24X9RgnZ0 pFKM+jiDTH0VJpoA1pi68vRasUv8VW7GagBqbsyst7/ZlNl5lwwP0yrb5GolgoXu+tCr 4d+z4uJrNWiAgqpxDoW5X7phalLYcCPCKTux07mYwcSdt5xaXh0gz9yE9EuREG4zwhuD C+K7lReLP0/HFB17dyE7a24LqRhX4Y02/PHvcZX5kPNsgj7mgjANyIdl2hCmGsnPIRFO /hgBIPk64JL+hCQrnIkBRtiENy1dIIPEMLVqqNSBG86egh7yR6rWrwfenHCvj3iVaP0p 9zmQ== X-Received: by 10.182.171.7 with SMTP id aq7mr1844180obc.67.1404042913995; Sun, 29 Jun 2014 04:55:13 -0700 (PDT) Original-Received: by 10.182.23.107 with HTTP; Sun, 29 Jun 2014 04:55:13 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Original-Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.bugs:7511 Archived-At: --e89a8ff1ccae2362c904fcf837ff Content-Type: text/plain; charset=UTF-8 Dear Guile Developers, The reference guide documents the wrong return type for the vararg function void scm_c_export(const char *name, ...) saying it is SCM. Consider applying the diff below. Also, again vararg functions are troublesome (impossible) to call from Fortran and, maybe other languages, please dont let them proliferate in Guile API. Alexei alexei@ThinkPad:~/devel/guile$ git diff diff --git a/doc/ref/api-modules.texi b/doc/ref/api-modules.texi index 286a37d..e2dc65f 100644 --- a/doc/ref/api-modules.texi +++ b/doc/ref/api-modules.texi @@ -1053,7 +1053,7 @@ module, as with @code{(use-modules @var{name})}. The name is interpreted as for @code{scm_c_define_module}. @end deftypefn -@deftypefn {C Function} SCM scm_c_export ({const char *}@var{name}, ...) +@deftypefn {C Function} void scm_c_export ({const char *}@var{name}, ...) Add the bindings designated by @var{name}, ... to the public interface of the current module. The list of names is terminated by @code{NULL}. --e89a8ff1ccae2362c904fcf837ff Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable

Dear Guile Developers,

The reference guide documents the wrong return type for
the vararg f= unction

=C2=A0 void scm_c_export(const char *name, ...)

saying it is SCM. Consider applying the diff below.

Also, again = vararg functions are troublesome (impossible)
to call from Fortran and, = maybe other languages, please dont
let them proliferate in Guile API.

Alexei

alexei@Thin= kPad:~/devel/guile$ git diff
diff --git a/doc/ref/api-modules.texi b/doc/ref/api-modules.texi
index 2= 86a37d..e2dc65f 100644
--- a/doc/ref/api-modules.texi
+++ b/doc/ref/a= pi-modules.texi
@@ -1053,7 +1053,7 @@ module, as with @code{(use-modules= @var{name})}.=C2=A0 The name is
=C2=A0interpreted as for @code{scm_c_define_module}.
=C2=A0@end deftypef= n
=C2=A0
-@deftypefn {C Function} SCM scm_c_export ({const char *}@va= r{name}, ...)
+@deftypefn {C Function} void scm_c_export ({const char *}= @var{name}, ...)
=C2=A0Add the bindings designated by @var{name}, ... to the public interfac= e
=C2=A0of the current module.=C2=A0 The list of names is terminated by<= br>=C2=A0@code{NULL}.
--e89a8ff1ccae2362c904fcf837ff--