*** empty log message ***
[bpt/guile.git] / doc / ref / ChangeLog
index 21bd99b..25e9647 100644 (file)
@@ -1,3 +1,215 @@
+2003-11-09  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-data.texi (Random): In random, use @code for *random-state*.
+       Reported by Stephen Compall.
+
+2003-11-03  Kevin Ryde  <user42@zip.com.au>
+
+       * misc-modules.texi (File Tree Walk): New chapter.
+       * guile.texi: Add it.
+
+2003-10-18  Kevin Ryde  <user42@zip.com.au>
+
+       * gh.texi (Calling Scheme procedures from C, scm transition summary):
+       Refer to scm_list_n, not the old name scm_listify.
+       (scm transition summary): For gh_apply, recommend scm_apply_0, which
+       is now documented.
+
+       * gh.texi (Defining new Scheme procedures in C): Don't use
+       @strong{Note:}, latest makeinfo will complain it looks like a cross
+       reference.
+
+       * posix.texi (Time): Correction to strftime glibc cross reference
+       node, now "Formatting Calendar Time".
+
+       * srfi-modules.texi (SRFI-1 Searching): In break, note conflict with
+       binding established by `while'.
+
+2003-10-09  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-compound.texi (Hash Table Reference): Decribe rehashing, note
+       no hashx-remove!, describe make-hash-table size parameter.
+
+2003-10-06  Marius Vollmer  <mvo@zagadka.de>
+
+       * scheme-memory.texi: Added a short explanation of the GC and the
+       conservative stack scanning.
+       (scm_gc_protect_object, scm_gc_unprotect_object,
+       scm_permanent_object): New.
+
+       * data-rep.texi, scheme-memory.texi (scm_remember_upto_here_1,
+       scm_remember_upto_here_2): Moved from data-rep.texi to
+       scheme-memory.texi.
+       
+2003-10-02  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-io.texi (String Ports): In call-with-output-string, note proc
+       should not close the port.  In get-output-string, note string must be
+       gotten before closing the port.
+
+2003-09-21  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (File System): In access?, reword a bit, clarify real
+       versus effective ID handling, cross reference glibc on that, and
+       recommend against access tests in library functions.
+
+2003-09-13  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (File System): In stat:dev and stat:mode, clarify that
+       both are numbers.
+
+       * posix.texi (Network Address Conversion): Under IPv4, describe
+       numeric representation in Guile, add INADDR_LOOPBACK and
+       INADDR_BROADCAST, add commented-out INADDR_NONE.
+
+       * scheme-compound.texi (Append/Reverse): Merge reverse and reverse!,
+       describe newtail parameter for reverse!, remove confusing caveat about
+       head becoming tail for reverse!.
+
+       * scheme-io.texi (Reading): In port-column, port-line,
+       set-port-column! and set-port-line!, port parameter must be given,
+       there's no default to current input.
+
+       * scheme-io.texi (Reading): Add scm_c_read.
+       (Writing): Add scm_c_write.
+
+       * srfi-modules.texi (SRFI-1 Constructors): Add list-copy.
+
+       * srfi-modules.texi (SRFI-19): Rewrite, adding descriptions of all
+       functions, and a bit of an introduction.
+
+2003-09-03  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-data.texi (Keyword Primitives): Add examples to
+       make-keyword-from-dash-symbol and keyword-dash-symbol.  Add
+       scm_c_make_keyword.
+
+       * scheme-data.texi (Symbol Primitives): In gensym, cross reference
+       uninterned symbols, use @w{} on " g" prefix to avoid any chance of a
+       line break obscuring it.
+
+2003-08-30  Kevin Ryde  <user42@zip.com.au>
+
+       * data-rep.texi (Remembering During Operations): Note
+       scm_remember_upto_here_1 applies only to C automatic variables.
+
+       * guile.texi: Move @contents to usual place after title page, and
+       after first menu since that looks nice in html.
+
+       * posix.texi (Ports and File Descriptors): In pipe PIPE_BUF, use
+       @defvar, reword a bit for clarity, cross reference glibc.
+
+       * posix.texi (Network Sockets and Communication): In socket, use
+       @defvar for protocol variables, cross reference for getprotobyname,
+       note it's usually connect and accept that establishes communication.
+
+       * posix.texi (Network Sockets and Communication): In socketpair,
+       clarify the return is a pair with ports in car and cdr, note
+       connection is full duplex, refer to socket for parameters, refer to
+       PF_UNIX rather than AF_UNIX.
+
+       * scheme-compound.texi (Append/Reverse): Merge append and append!,
+       shown parameters as lst1 ... lstN, describe list argument for
+       scm_append and scm_append_x and note that it's unmodified.
+
+       * scheme-compound.texi (Hash Table Reference): Add hashx- case
+       insensitive string example, add cross references to symbol-hash,
+       string-hash, string-hash-ci, and char-set-hash.
+
+       * scheme-control.texi (Multiple Values): In values, show args as "arg1
+       ... argN".  In scm_values, note args is a list and returned object
+       shares structure with it.
+
+       * scheme-control.texi (Catch): Add scm_internal_catch.
+       (Lazy Catch): Add scm_internal_lazy_catch.
+
+       * scheme-data.texi (Arithmetic): Use a table for scheme to C libm
+       equivalences, add C99 trunc.
+
+       * scheme-procedures.texi (Lambda): Note ". rest" list argument is
+       always newly created.
+
+       * srfi-modules.texi (SRFI-1 Association Lists): In alist-delete and
+       alist-delete!, note argument order for the equality calls per SRFI-1
+       spec.
+
+2003-08-26  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-data.texi (Scientific): Add two-argument atan.
+
+       * tools.texi (How guile-snarf works): Need @@ for texinfo in example.
+
+2003-08-17  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-compound.texi (Hash Table Reference): Collect up groups of
+       functions to avoid duplication.  Revise notes on hashx functions and
+       on vector implementation.  In make-hash-table, size is now optional.
+       Add hash-map and hash-for-each.
+
+2003-08-14  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-control.texi (while do): Update `while' for code rewrite, in
+       particular describe break and continue.
+
+2003-08-09  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-memory.texi (Memory Blocks): Add index entries for deprecated
+       scm_must_malloc and friends.
+
+2003-07-29  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-compound.texi (List Constructors): Remove scm_cons_star,
+       since it's not very helpful.
+
+       * scheme-utility.texi (Property Primitives): In primitive-property-ref,
+       note parameters to not-found-proc, use hyphens rather than underscores
+       for that parameter name.
+       In primitive-property-set!, VAL is the value parameter not CODE.
+
+2003-07-24  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-control.texi (Dynamic Wind): Untabify.
+       (Multiple Values): Use @result.
+       Reported by Stephen Compall <s11@member.fsf.org>.
+
+       * scheme-control.texi (Continuations): Rewrite with more detail.
+
+       * scheme-scheduling.texi (System asyncs): Add index entries for C
+       functions.
+
+       * scheme-scheduling.texi (Parallel Forms): New section.
+
+2003-07-18  Kevin Ryde  <user42@zip.com.au>
+
+       * scheme-compound.texi (List Constructors): In list, use "elem1
+       ... elemN".  Add scm_list_1, scm_list_2, scm_list_3, scm_list_4,
+       scm_list_5, scm_list_n.  Remove scm_list, since it's a no-op.
+       * guile.texi (nicode): New macro.
+
+        * scheme-evaluation.texi (Fly Evaluation): In apply, reword for
+        clarity, drop the "append" example.  Add scm_apply, scm_apply_0,
+        scm_apply_1, scm_apply_2, scm_apply_3.
+        Add scm_call_0, scm_call_1, scm_call_2, scm_call_3.
+        In apply:nconc2last, move down after "apply", reword for clarity, note
+        correspondence to apply params.
+
+       * srfi-modules.texi (SRFI-0): Add cond-expand index entry.
+       (SRFI-9): Add define-record-type index entry.
+
+2003-07-12  Kevin Ryde  <user42@zip.com.au>
+
+       * srfi-modules.texi (SRFI-1 Constructors): In iota, reword a bit for
+       clarity and add a couple of examples.
+
+2003-07-10  Kevin Ryde  <user42@zip.com.au>
+
+       * deprecated.texi (Deprecated): Add scm_remember.
+
+2003-06-22  Kevin Ryde  <user42@zip.com.au>
+
+       * data-rep.texi (Remembering During Operations): Refer to all "Guile
+       library functions" as provoking gc.
+
 2003-06-19  Kevin Ryde  <user42@zip.com.au>
 
        * scheme-io.texi (File Ports): Describe call-with-input-file and