Changes from arch/CVS synchronization
[bpt/guile.git] / doc / ref / ChangeLog
index 7ed1eb7..c09bc96 100644 (file)
@@ -1,9 +1,297 @@
-2006-06-16  Ludovic Courtès  <ludovic.courtes@laas.fr>
+2007-01-31  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+       * api-data.texi (Conversion): Made cross refs point to `Number
+       Input and Output' rather than `The ice-9 i18n Module'.
+       (String Comparison): Likewise for `Text Collation'.
+       * api-i18n.texi (Internationalization): Re-organized the whole
+       section, documented new i18n features.  Added the following
+       subsections: `i18n Introduction', `Text Collation', `Character
+       Case Mapping', `Number Input and Output', `Accessing Locale
+       Information'.  Removed `The ice-9 i18n Module'.
+       * posix.texi (Locales): Updated cross-ref formerly pointing to
+       `The ice-9 i18n Module'.
+       * srfi-modules.texi (SRFI-19 String to date): Mention the
+       internationalization of `string->date'.
+
+2007-01-19  Han-Wen Nienhuys  <hanwen@lilypond.org>
+
+       * api-options.texi (Evaluator trap options): document
+       memoize-symbol-handler
+
+       * api-evaluation.texi (Evaluator Behaviour): link to the Evaluator
+       trap options node in trap-enable/trap-set! doco.
+
+2007-01-16  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Mapping Folding and Unfolding): In string-unfold,
+       ssay make_final default is nothing extra.  The `(lambda (x) )' shown
+       was not quite right, it would have been `(lambda (x) "")' if anything.
+
+       * api-init.texi (Initialization): Cross reference Runtime Environment
+       for scm_set_program_arguments.
+
+       * posix.texi (Runtime Environment): Expand program-arguments
+       description, add set-program-arguments, add scm_set_program_arguments,
+       note args are per-thread.
+
+2006-12-14  Kevin Ryde  <user42@zip.com.au>
+
+       * api-procedures.texi (let-keywords Reference): Expand variously to
+       make it clear what's actually taken and done.  Shortfalls reported by
+       Han-Wen Nienhuys.
+
+2006-12-13  Kevin Ryde  <user42@zip.com.au>
+
+       * api-control.texi (Handling Errors): Cross reference "Error
+       Reporting" for `scm-error', not just "above".
+
+       * posix.texi (Encryption): Cross reference crypt in the glibc manual.
+       Clarify that key and salt are strings.
+
+       * srfi-modules.texi (SRFI-17): Expand variously.
+
+2006-11-18  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+       * Makefile.am (BUILT_SOURCES): New variable.
+       (lib-version.texi): New target.
+
+       * guile.texi: Include `lib-version.texi'.
+       
+       * api-data.texi (Conversion): Link to `The ice-9 i18n Module' when
+       describing `string->number'.
+       (String Comparison): Likewise.
+
+       * api-i18n.texi (Internationalization)[The ice-9 i18n Module]: New
+       node.
+       [Gettext Support]: New node; contains text formerly in
+       `Internationalization'.
+
+       * posix.texi (Locales): Added a link to the glibc manual
+       describing the various locale categories.  Mention locale objects
+       and link to `The ice-9 i18n Module' when describing `setlocale'.
+
+2006-11-17  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * intro.texi (Reporting Bugs): Note need for subscription to
+       bug-guile@gnu.org.
+
+2006-10-10  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Setting and Managing Breakpoints): New text
+       about what happens when a breakpoint is created.
+       (Listing and Deleting Breakpoints, Moving and Losing Breakpoints):
+       New.
+
+2006-10-08  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Working with GDS in Scheme Buffers): New
+       subsection, to group (Access to Guile Help and Completion, Setting
+       and Managing Breakpoints, Evaluating Scheme Code) together.
+       (GDS Getting Started): Editorial updates.
+
+2006-10-06  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Using Guile in Emacs): Subnodes reordered,
+       from (Displaying the Scheme Stack, Continuing Execution,
+       Evaluating Scheme Code, Setting and Managing Breakpoints, Access
+       to Guile Help and Completion) to (Access to Guile Help and
+       Completion, Setting and Managing Breakpoints, Evaluating Scheme
+       Code, Displaying the Scheme Stack, Continuing Execution).
+       (Access to Guile Help and Completion): Mention where keys are
+       defined.
+       (Setting and Managing Breakpoints): Update text on how to set
+       breakpoints.
+
+2006-10-05  Kevin Ryde  <user42@zip.com.au>
+
+       * misc-modules.texi (File Tree Walk): Corrections to BASE parameter
+       and symlink vs stale-symlink types in nftw.
+       * misc-modules.texi, guile.texi (Buffered Input): New section,
+       describing (ice-9 buffered-input).
+
+       * posix.texi (User Information): Clarify getpwent returns #f at end of
+       file.
+
+       * repl-modules.texi (Readline Functions): New section on how to call
+       readline from scheme code.
+
+2006-10-03  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (GDS Getting Started): Editorial updates.
+
+2006-09-28  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (GDS Introduction, GDS Getting Started): Minor
+       edits.
+
+       * api-data.texi (Symbol Props): Remove unnecessarily specific
+       parenthesis about Guile 1.6's use of extra symbol slots.
+
+2006-09-26  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Using Guile in Emacs, GDS Introduction):
+       Editorial updates.
+       (GDS Architecture): Moved earlier in containing section; editorial
+       updates.
+       (GDS Getting Started, How to Use GDS): Merged; editorial updates;
+       subsections reordered.
+
+2006-09-26  Kevin Ryde  <user42@zip.com.au>
+
+       * api-io.texi (Random Access): In truncate-file, tweak wording for
+       clarity, note cannot always extend file this way.
+       (Ports): File access uses LFS.
+
+2006-09-25  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Error Handling, Interactive Debugger): Minor
+       editorial improvements.
+       (Leave Debugger): Removed.
+       (Display Backtrace): Minor updates.
+       (Frame Selection, Frame Information, Frame Evaluation) : Minor
+       editorial improvements.
+       (Stepping and Continuing): Merged from three previous nodes; plus
+       minor improvements.  Removed doc for `trace-finish', which no
+       longer exists.
+
+2006-09-22  Kevin Ryde  <user42@zip.com.au>
+
+       * api-data.texi (Scientific): In sqrt, note it's the positive root
+       which is returned (as per R5RS).
+
+2006-09-20  Ludovic Courtès  <ludovic.courtes@laas.fr>
+
+       * api-data.texi (Standard Character Sets): Documented the
+       charset recomputation upon successful `setlocale'.
+
+2006-09-08  Kevin Ryde  <user42@zip.com.au>
+
+       * misc-modules.texi (Formatted Output): Show ":@" rather than "@:",
+       because ":@" is traditional common lisp, though either way works.
+       Break a couple of example lines to avoid overflowing DVI page width.
+
+       * scheme-debugging.texi (Debug Last Error): Line break in "Type
+       (backtrace) to get ..." which overflowed the line in both info and
+       DVI.  Reported by Percy Tiglao.
+
+2006-09-05  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Network Sockets and Communication): Tweak description,
+       note not multi-threading.
+
+2006-09-04  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-control.texi (Dynamic Wind): Doc for scm_dynwind_free.
+
+       * api-modules.texi (The Guile module system), api-data.texi
+       (Integers, Numerical Tower), api-compound.texi (Uniform Numeric
+       Vectors): Fix typos.  (Patch sent in by Marco Maggi.)
+
+2006-08-29  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-debug.texi (Debug on Error): Added paragraph on need to use
+       debugging evaluator.  Added text on what the Guile REPL code does.
+
+2006-08-29  Kevin Ryde  <user42@zip.com.au>
+
+       * api-control.texi (Dynamic Wind): Reformat example a bit to avoid
+       going off the right edge of the paper.  Reported by Percy Tiglao.
+
+2006-08-28  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-debug.texi (Examining the Stack): Minor improvements to
+       display-backtrace doc.
+       (Debug on Error): More new text on catching the error stack.
+
+2006-08-27  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * api-debug.texi (Debug on Error): New text on how to catch errors
+       and the error stack.
+
+2006-08-23  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Using Guile in Emacs): New text about
+       available Emacs libraries.
+       (GDS Introduction): New node, containing GDS-specific introductory
+       text.
+
+2006-08-22  Kevin Ryde  <user42@zip.com.au>
+
+       * api-i18n.texi (Internationalization): Cross reference gettext manual
+       on plural forms.
+
+2006-08-18  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Using Guile in Emacs): Unignore extra GDS
+       intro text.  (I will edit this down later.  For now it's
+       convenient to have it all appearing, so it's visible on paper.)
+
+2006-08-11  Neil Jerram  <neil@ossau.uklinux.net>
+
+       * scheme-using.texi (Run To Frame Exit): Improved doc for finish.
+       (Continue Execution): Improved doc for continue.
+       (Using Guile in Emacs): Lots of new docs about the Emacs
+       interface.
+
+       * api-debug.texi (Low Level Trap Calls): New.
+       (Using Traps): Removed, material incorporated into Low Level Trap
+       Calls.
+       (High Level Traps): New.
+       (Breakpoints): New.
+
+       * scheme-using.texi (Single Stepping): Improve doc for step and
+       next.
+
+       * api-debug.texi (Debug on Error): Note need to handling of errors
+       in C.
+       
+       * api-debug.texi (Debugging): New intro text.  New subsection
+       "Evaluation Model".  Moved existing subsections "Capturing the
+       Stack or Innermost Stack Frame", "Examining the Stack", "Examining
+       Stack Frames", "Source Properties", "Decoding Memoized Source
+       Expressions" and "Starting a New Stack" under "Evaluation Model".
+       (Capturing the Stack or Innermost Stack Frame): Some new text, and
+       correction to doc for last-stack-frame.
+       (Debug on Error): Renamed from "Interactive Debugging".
+
+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-07-24  Kevin Ryde  <user42@zip.com.au>
+
+       * api-evaluation.texi (Fly Evaluation): Add scm_c_eval_string.
+       (Loading): Add scm_c_primitive_load.
+       Reported by Jon Wilson.
+       
+2006-06-25  Kevin Ryde  <user42@zip.com.au>
+
+       * posix.texi (Time): In tm:gmtoff, give example values, note not the
+       same as C tm_gmtoff.
+
+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>
+2006-06-13  Ludovic Courtès  <ludovic.courtes@laas.fr>
 
        * api-compound.texi (Structure Concepts): Mentioned the behavior
        of `equal?' for structures.
        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>
+2006-03-21  Ludovic Courtès  <ludovic.courtes@laas.fr>
 
        * api-data.texi (Conversion): Add scm_c_locale_stringn_to_number.
 
        contexts.  Renamed all functions from scm_frame_ to scm_dynwind_.
        Updated documentation.
 
-2005-12-19  Ludovic Courtès  <ludovic.courtes@laas.fr>
+2005-12-19  Ludovic Courtès  <ludovic.courtes@laas.fr>
 
         * api-data.texi (Operations Related to Symbols):
         Documented `scm_take_locale_symbol ()'.
 
 2005-11-06  Kevin Ryde  <user42@zip.com.au>
 
-       From Ludovic Courtès, partial rework by me:
+       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.
 
        * 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.
+       change by Ludovic Courtès and revised a bit by me.
 
 2005-10-27  Kevin Ryde  <user42@zip.com.au>
 
        The change log for files in this directory continues backwards
        from 2001-08-27 in ../ChangeLog, as all the Guile documentation
        prior to this date was contained in a single directory.
+
+
+;; Local Variables:
+;; coding: utf-8
+;; End: