Reference documentation of modules and library

[Mike Gran]

Hi-

So I was reading through the reference manual.  There is the
"API Reference" and "Guile Modules" chapter followed by the
"Standard Library" chapter.  I know historically why they
are separated that way, but if you didn't know about guile-lib
you aren't going to understand why they're divided that way.


What would you think moving things around to give each chapter
a better identity?  Maybe something like this

---


API REFERENCE AND STANDARD LIBRARY
These are all the procedures that exist in the base namespace, and
 don't require "use-module"

EXTENDED LIBRARY
These procedures require "use-module"


---

or alternately, you could split them up by how specialized they
are.


API REFERENCE
"This is all your basic language stuff."


STANDARD LIBRARY
"These procedures provide commonly-used functionality."

 - posix
 - r6rs

 - srfi
 - formatted output

 - getopt
 - pattern matching
 - readline
 - pretty-printing
 - ftw - buffered input
 - expect

EXTENDED LIBRARY
"These are more specialized libraries"

 - http
 - profiling
 - sxml
 - sxml match
 - texinfo
 - queues
 - streams


3rd-PARTY LIBRARIES
"These 3rd party libraries are not included in Guile but
provide important functionality.  Their use is encouraged."
 - slib
 - jacal
 - (maybe bitrotten scsh)
 - (maybe others??)

What do you think?

-Mike