[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Deficiencies in documentation for modules
From: |
Ludovic Courtès |
Subject: |
Re: Deficiencies in documentation for modules |
Date: |
Mon, 02 Dec 2013 14:01:28 +0100 |
User-agent: |
Gnus/5.130007 (Ma Gnus v0.7) Emacs/24.3 (gnu/linux) |
Panicz Maciej Godek <address@hidden> skribis:
> While looking at (ice-9 r5rs), (ice-9 safe-r5rs)
> and (ice-9 null), I've noticed, that there are a few
> undocumented procedures used there, like
> "make-module" or "set-module-kind!". In the thread
> http://lists.gnu.org/archive/html/guile-user/2009-02/msg00000.html
> there is another one mentioned, named "beautify-user-module!".
> Using the readline's completion feature, I also noticed
> that there are procedures "module-obarray",
> "module-observe", "make-modules-in" and some
> others that are lacking an entry in the manual.
>
> Are there any deeper reasons behind their absence,
> or is it just an oversight?
Initially it’s just an oversight.
For now, you can figure it out by browsing boot-9.scm (which is
admittedly suboptimal; patches welcome!)
Nowadays, as Guile moves toward ahead-of-time compilation, there may be
an incentive to keep some of the module API internal, I think.
Thanks,
Ludo’.