api-diff usage example + paranoid admonishment

[Thien-Thi Nguyen]

sample output below.  here is the commentary excerpt:

  Usage: api-diff [-d GROUPS] ALIST-FILE-A ALIST-FILE-B
  
  Read in the alists from files ALIST-FILE-A and ALIST-FILE-B
  and display a (count) summary of the groups defined therein.
  Optional arg "--details" (or "-d") specifies a comma-separated
  list of groups, in which case api-diff displays instead the
  elements added and deleted for each of the specified groups.
  
  For scheme programming, this module exports the proc:
   (api-diff A-file B-file)
  
  Note that the convention is that the "older" alist/file is
  specified first.

this whole exercise is to point out that embedded libltdl functions
(that begin with "lt_") are gone in 1.4.1, and to show everyone a way of
verifying this, which is a roundabout way of saying "don't trust people,
don't trust code, only trust YOURSELF running code YOU have examined".
(transparency is only valuable if you look through things. :-)

note that guile-C-API grouping still needs (a lot of) work.  also,
api-diff doesn't recognize "renaming" changes.

thi


________________________________________
cd ~/build/www.glug.org/snap/api/
ttn-do guile-scripts api-diff 1.4 branch_release-1-4
  1448   1434    -14      C
     0      0      0      C+scheme
   217    217      0      POSIX
  1477   1477      0      Scheme
    34     34      0      coop
    14      0    -14      embedded-libltdl
     4      4      0      g-fdes
    10     10      0      gdb
   112    112      0      gh
   156    156      0      guile-C-API
   236    236      0      k
     6      6      0      libguile-internal
    18     18      0      math
     3      3      0      r-fdes
  1267   1267      0      scm

Compilation finished at Sat May 11 20:45:05

____________________________________________
cd ~/build/www.glug.org/snap/api/
ttn-do guile-scripts api-diff -d embedded-libltdl 1.4 branch_release-1-4
embedded-libltdl removals:
 lt_dlsym
 lt_dlsetsearchpath
 lt_dlpreload_default
 lt_dlpreload
 lt_dlopenext
 lt_dlopen
 lt_dlmalloc
 lt_dlinit
 lt_dlgetsearchpath
 lt_dlfree
 lt_dlexit
 lt_dlerror
 lt_dlclose
 lt_dladdsearchdir

Compilation finished at Sat May 11 20:45:08