* api-debug.texi (Breakpoints): Removed (all wrong).
[bpt/guile.git] / doc / ref / ChangeLog
index 1c469a5..1f7b4fc 100644 (file)
@@ -1,3 +1,421 @@
+2006-08-01  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-debug.texi (Breakpoints): Removed (all wrong).
+
+       * guile.texi (API Reference): Improved summary for "Debugging"
+       menu item.
+
+       * scheme-debugging.texi (Debug Last Error, Interactive Debugger):
+       Moved/merged to scheme-using.texi, as REPL features.
+       (Examples): New.
+       (Intro to Breakpoints): New introductory text here.  Removed all
+       subnodes except for Breakpoints Overview.
+
+       * scheme-using.texi: New.
+
+       * guile.texi (Programming in Scheme): Include new
+       scheme-using.texi file.
+
+       * Makefile.am (guile_TEXINFOS): Include new scheme-using.texi
+       file.
+
+2006-06-16  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+       * api-utility.texi (Equality): Mentioned the behavior of `equal?'
+       for structures (as suggested by Kevin Ryde).
+
+2006-06-13  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+       * api-compound.texi (Structure Concepts): Mentioned the behavior
+       of `equal?' for structures.
+
+2006-05-28  Kevin Ryde  <user42@zip.com.au>
+
+       * srfi-modules.texi (SRFI-1 Length Append etc): Add an append-reverse
+       example.
+
+2006-05-20  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (Pairs): Cross reference SRFI-1 second, third,
+       fourth.
+       (List Modification): Cross reference SRFI-1 delete and lset-difference.
+       (List Searching): Cross reference SRFI-1 member.
+       (List Mapping): Cross reference SRFI-1 map etc.
+       (Retrieving Alist Entries): Cross reference SRFI-1 assoc.
+
+       * srfi-modules.texi (SRFI-1 Association Lists): Describe argument
+       order for "=" procedure.
+
+2006-05-15  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Processes): Add primitive-_exit.
+
+2006-05-10  Kevin Ryde  <user42@zip.com.au>
+
+       * intro.texi (Linking Guile into Programs): Enhance example program,
+       change scm_str2string to scm_from_locale_string, since scm_str2string
+       is "discouraged".  And check for NULL from getenv since neither
+       scm_str2string nor scm_from_locale_string can cope with that.
+       Reported by Frithjof.
+
+2006-05-09  Kevin Ryde  <user42@zip.com.au>
+
+       * api-control.texi (Multiple Values): In `receive', add an example,
+       cross ref SRFI-8, tweak wording.
+
+       * api-io.texi (Port Implementation): @defun style for
+       scm_make_port_type and the various set functions.
+
+       * posix.texi (Ports and File Descriptors): Tweaks to fcntl.
+
+2006-04-29  Kevin Ryde  <user42@zip.com.au>
+
+       * api-scheduling.texi (Threads): In call-with-new-thread, handler arg
+       is optional (as of 1.8.0).
+
+2006-04-15  Kevin Ryde  <user42@zip.com.au>
+
+       * api-scheduling.texi (System asyncs): "{void *}" in @deffnx to keep
+       the "*" out of the name in the index.
+
+2006-04-06  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Ports and File Descriptors): Clarify fcntl a bit,
+       and correction FD_CLOEXEC goes with FD_SETFD not FD_SETFL.
+       (Network Sockets and Communication): In accept, cross-reference to
+       fcntl on O_NONBLOCK.
+
+2006-03-28  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (Vector Accessing from C): Show
+       SCM_SIMPLE_VECTOR_SET not SCM_SIMPLE_VECTOR_SET_X, the former is
+       what's in vector.h.
+
+2006-03-21  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+       * api-data.texi (Conversion): Add scm_c_locale_stringn_to_number.
+
+2006-03-05  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (Array Procedures): @pxref for `equal?'.
+       (Shared Arrays): Correction to make-shared-array stride example, need
+       `list' on the mapper return value.
+
+2006-02-13  Marius Vollmer  <mvo@zagadka.de>
+
+       * api-utility.texi (Object Properties): Removed confusing
+       paragraph about 'name' property.
+
+2006-02-07  Kevin Ryde  <user42@zip.com.au>
+
+       * api-modules.texi (Compiled Code Installation): Revise, in particular
+       @libdir@ needs to go via the makefile.
+
+2006-02-04  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-control.texi (Throw Handlers): New node.
+       (Throw): Moved to after the Lazy Catch node.
+       (Catch): Enhance to cover the optional pre-unwind handler, and new
+       APIs scm_c_catch, scm_catch_with_pre_unwind_handler.
+       (Lazy Catch): Describe relationship to with-throw-handler.
+       Document that the handler may return, and what happens if it does.
+       (Throw): Mention that a throw can be handled by a throw handler as
+       well as by a catch.
+
+2006-02-04  Kevin Ryde  <user42@zip.com.au>
+
+       * api-options.texi (Build Config): pxref libtool on libguileinterface
+       version info.
+       * intro.texi (Writing Guile Extensions), libguile-extensions.texi (A
+       Sample Guile Extension): pxref libtool manual.
+
+       * api-modules.texi (Compiled Code Installation): New section.
+
+       * posix.texi (Network Address Conversion, Network Databases)
+       (Network Sockets and Communication, Internet Socket Examples): Misc
+       tweaks.
+
+2006-01-29  Marius Vollmer  <mvo@zagadka.de>
+
+       * api-scheduling.texi: Removed "Futures" node.
+
+       Renamed the "frames" that are related to dynamic-wind to "dynamic
+       contexts.  Renamed all functions from scm_frame_ to scm_dynwind_.
+       Updated documentation.
+
+2005-12-19  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+        * api-data.texi (Operations Related to Symbols):
+        Documented `scm_take_locale_symbol ()'.
+       
+2005-12-15  Kevin Ryde  <user42@zip.com.au>
+
+       * api-evaluation.texi (Fly Evaluation): Add scm_call_4, suggested by
+       Bruce Korb.
+
+       * misc-modules.texi (Streams): In stream->list&length and
+       stream->reversed-list&length, make the two values clearer.
+
+2005-12-14  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-options.texi (Evaluator trap options): Trap calls now always
+       use a debug object rather than a continuation.
+       (Debugger options, Examples of option use): Update help text for
+       'cheap option (which is now obsolete).
+
+       * api-evaluation.texi (Loading): Document custom reader.
+
+2005-12-06  Marius Vollmer  <mvo@zagadka.de>
+
+       * api-init.texi, api-scheduling.texi, libguile-concepts.texi:
+       Removed scm_leave_guile, scm_enter_guile and all references to
+       them since they are no longer in the API.
+
+       From Stephen Compall:
+
+       * api-control.texi (if cond case): Describe SRFI 61 cond.
+
+       * srfi-modules.texi (SRFI-61): New section.
+       (SRFI Support): Add SRFI-61 to menu.
+
+2005-11-19  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (Retrieving Alist Entries): Revise for clarity and
+       brevity.
+
+2005-11-06  Kevin Ryde  <user42@zip.com.au>
+
+       From Ludovic Courtès, partial rework by me:
+       * doc/ref/api-modules.texi (Creating Guile Modules): In define-module,
+       describe #:re-export, #:export-syntax, #:re-export-syntax, #:replace
+       and #:duplicates.  Add re-export.
+
+2005-11-01  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Time): In strftime, note systems vary for %Z.
+
+2005-10-29  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Network Socket Address): Add scm_make_socket_address,
+       scm_c_make_socket_address, scm_from_sockaddr, scm_to_sockaddr.  This
+       change by Ludovic Courtès and revised a bit by me.
+
+2005-10-27  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Network Address Conversion): Move INADDR_ANY to here.
+       (Network Socket Address): New section, move sockaddr bits to here, add
+       new make-socket-address.
+       (Network Sockets and Communication): In connect, bind, and sendto, now
+       take socket address object.  In bind, leave INADDR constants for
+       "Network Address Conversion" node.  In those plus accept, getsockname,
+       getpeername, reword a bit for clarity.
+
+2005-10-24  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Network Sockets and Communication): Combine and revise
+       getsockopt and setsockopt.  Add OPTNAME constants, including new
+       IP_ADD_MEMBERSHIP and IP_DROP_MEMBERSHIP.
+
+       * posix.texi (Time): Revise strftime for clarity, cross reference man
+       3 strftime (suggested by Greg Troxel), note locale character set when
+       setlocale has been called.
+
+2005-10-15  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-debug.texi (Source Properties): Add text describing/advising
+       limited use of source properties.
+
+       * api-debug.texi (Source Properties): Documentation of source
+       property procedures moved here from ...
+
+       * api-procedures.texi (Procedure Properties): ... where it didn't
+       belong.
+
+2005-10-05  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Regexp Functions): Notes on zero bytes and locale
+       character set.
+
+       * misc-modules.texi (Formatted Output): Show modifiers like ~:d
+       instead of in words.
+       
+2005-08-06  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (List Modification): In filter, return may share a
+       tail with the input, as per docstring.  In filter!, fix chopped off
+       note of modifying input.
+
+       * api-control.texi (Error Reporting): In strerror, note message is in
+       locale language and charset.
+
+2005-07-12  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (String Selection): In string-pad, don't say anything
+       about sharing strings, decided against doing that.
+       (Miscellaneous String Operations): Ditto in string-filter and
+       string-delete.
+
+       * api-data.texi (String Selection): Merge descriptions of string-trim,
+       string-trim-right and string-trim-both for brevity.
+
+2005-06-24  Kevin Ryde  <user42@zip.com.au>
+
+       * api-options.texi (Debugger options): Cross reference new Tail Calls
+       node rather than R5RS on tail recursion.
+
+2005-06-23  Kevin Ryde  <user42@zip.com.au>
+
+       * guile.texi, libguile-concepts.texi, libguile-extensions.texi,
+       libguile-linking.texi, libguile-smobs.texi: Spelling errors reported
+       by hyperdivision.
+
+       * api-compound.texi (Pairs, List Syntax): Cross reference Expression
+       Syntax for quoting.
+       * api-control.texi (Lazy Catch): Cross ref for with-fluids.
+       * libguile-linking.texi (A Sample Guile Main Program): Cross reference
+       automake manual for aclocal.
+       * libguile-program.texi (Extending Dia): URL for Dia home page.
+       (Dia Primitives): Cross ref for scm_c_define_gsubr.
+
+2005-06-12  Marius Vollmer  <mvo@zagadka.de>
+
+       * gh.texi: More stuff about transitioning away from GH.
+
+2005-06-11  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Miscellaneous String Operations): In string-filter
+       and string-delete, note result may share with input string (as allowed
+       by srfi spec).
+
+2005-06-06  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (Array Procedures): In array-in-bounds?,
+       correction to example result.
+
+       * api-init.texi (Initialization), api-scheduling.texi (Blocking):
+       {} groups around "void*" C return types.
+
+2005-05-04  Kevin Ryde  <user42@zip.com.au>
+
+       * srfi-modules.texi (SRFI-1 Selectors): In drop-right, note always a
+       new list.  In take-right, note result shares common tail.  Per spec.
+
+2005-05-03  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (String Constructors): Clarify string, list->string
+       and reverse-list->string a bit.
+
+2005-04-30  Kevin Ryde  <user42@zip.com.au>
+
+       * api-io.texi (Default Ports): Describe buffering on standard ports.
+
+2005-04-23  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Regexp Functions): Add list-matches and fold-matches.
+
+       * data-rep.texi (Subrs): Note that subr must not modify its rest list.
+
+2005-04-19  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Regexp Functions): Clarity flags parameter.
+
+       * misc-modules.texi, guile.texi (Rx Regexps): Remove this section, Rx
+       is not in the core and we don't want to confuse anyone with it and the
+       builtin posix regexps.
+
+2005-04-04  Han-Wen Nienhuys  <hanwen@xs4all.nl>
+
+       * srfi-modules.texi (SRFI-1 Set Operations): use @cross iso. @times.
+
+       * guile.texi: add @cross for @tex
+
+2005-04-02  Kevin Ryde  <user42@zip.com.au>
+
+       * guile.texi (@times): New macro.
+
+       * repl-modules.texi (Readline Support): Cross ref readline manual.
+       (Loading Readline Support): Add GUILE_HISTORY and .inputrc Guile
+       configurables.
+
+       * srfi-modules.texi (SRFI-1 Association Lists): In alist-cons, clarify
+       a bit and cross reference core acons.
+
+       * srfi-modules.texi (SRFI-1 Set Operations): Revise and expand.
+       (SRFI-1 Deleting): In delete, cross reference lset-difference.
+
+       * srfi-modules.texi (SRFI-19): Note Gregorian leap year rules
+       incorrectly extended back prior to 1582.
+
+2005-03-29  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
+
+       * api-compound.texi: Fixed some typos and added some docs.  Talk
+       about concrete and abstract hash tables.
+
+2005-03-14  Kevin Ryde  <user42@zip.com.au>
+
+       * srfi-modules.texi (SRFI-55): New section.
+       (SRFI-60): New section.
+
+2005-03-01  Kevin Ryde  <user42@zip.com.au>
+
+       * api-compound.texi (Shared Arrays): New section.  Rewrite
+       make-shared-array for clarity, adding examples.
+
+       * libguile-concepts.texi (Control Flow): Cross reference Tail Calls.
+
+2005-02-17  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Reals and Rationals): Use tex for sqrt2 and pi.
+       (Complex Numbers): Add polar form read syntax.
+
+2005-02-15  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (File System): In tmpnam, clarify security and use of
+       O_EXCL.  In mkstemp!, in fact posix doesn't specify permissions.
+
+       * scheme-ideas.texi (Tail Calls): New section.
+
+2005-02-12  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (String Selection): In string-pad and
+       string-pad-right, clarify which end the padding goes on, and merge
+       descriptions.
+
+       * api-data.texi (Integer Operations): In gcd and lcm, show args.
+       (Arithmetic): In truncate, add missing arg.
+
+       * srfi-modules.texi (SRFI-1 Fold and Map): Rewrite fold, pair-fold and
+       reduce for clarity.
+
+2005-02-05  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (File System): In mkstemp!, in fact posix doesn't specify
+       the permissions mode.  Add an example setting 666 less umask.
+
+2005-02-04  Kevin Ryde  <user42@zip.com.au>
+
+       * api-io.texi (File Ports): In port-filename, cannot use after close.
+
+       * posix.texi (Time): In mktime, clarify fields of sbd-time used, and
+       the handling of tm:isdst.
+
+       * srfi-modules.texi (SRFI-0): Add srfi-4, srfi-13 and srfi-14 now in
+       the core.
+
+2005-01-29  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Signals): In sigaction, add SA_NOCLDSTOP, make it
+       clearer SA_RESTART is a variable.
+
+2005-01-28  Kevin Ryde  <user42@zip.com.au>
+
+       * srfi-modules.texi (SRFI-1 Predicates): Clarify proper-list?,
+       circular-list? and dotted-list?, note any object passes exactly one of
+       those.
+
+       * srfi-modules.texi (SRFI-19 Time/Date conversions): In default
+       tz-offset, note restrictions on a 32-bit system.
+
 2005-01-24  Kevin Ryde  <user42@zip.com.au>
 
        * api-i18n.texi (Internationalization): Expand and revise a bit for