slackful guile-api.alist maintenance update

[Thien-Thi Nguyen]

fyi, here's text of the file now:

  Part of the build process is recording the API and its groupings.
  This should be done after changing Scheme or C interface, or
                      after changing doc/groupings.alist.
  
  To do this:
  
    cd $(top_builddir)/doc
    make guile-api.alist
  
  The new guile-api.alist is actually deposited in $(top_srcdir)/doc.

this concludes my API-related reflection work for now.  there are still
holes where self-awareness can elude us, but the gaps are smaller...  at
a later point we still need to add machinery to define/detect renamings,
handle elements in C+Scheme group, etc.

for now the art will be in crafting groupings.alist usefully (for
ourselves and for users).  for example, i think some useful attributes
would be "documented", "in-headers", "SCM_API" and so on (including
those related to compilation).

it's pretty important to keep the `grok' parts of groupings.alist in
sync across branches if we want it to mean something we can depend on
(obviously the `members' clauses can and should be branch-specific).

heading towards 1.4.1 spiffing!

thi


------- Start of forwarded message -------
From: Thien-Thi Nguyen <address@hidden>
Subject: guile/workbook/build recording-api.text
Date: Sun, 12 May 2002 01:52:49 -0400
To: address@hidden

CVSROOT:        /cvsroot/guile
Module name:    guile
Changes by:     Thien-Thi Nguyen <address@hidden>       02/05/12 01:52:48

Modified files:
        workbook/build : recording-api.text 

Log message:
        Now move to "normal development time" instead of "release time".
        Update instructions to use make(1).

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile/workbook/build/recording-api.text.diff?tr1=1.2&tr2=1.3&r1=text&r2=text


_______________________________________________
Guile-cvs mailing list
address@hidden
http://mail.gnu.org/mailman/listinfo/guile-cvs
------- End of forwarded message -------