X-Git-Url: https://git.hcoop.net/bpt/guile.git/blobdiff_plain/d27d4bf7a71ed7a7151f4094ac9bb490e6c1c813..a2f00b9b36930797bf9e19c4a00fd089b0be3c9b:/doc/ref/ChangeLog diff --git a/doc/ref/ChangeLog b/doc/ref/ChangeLog index 90cf6d7cb..c09bc96d0 100644 --- a/doc/ref/ChangeLog +++ b/doc/ref/ChangeLog @@ -1,5 +1,693 @@ +2007-01-31 Ludovic Courtès + + * 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 + + * 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 + + * 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 + + * 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 + + * 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 + + * 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 + + * intro.texi (Reporting Bugs): Note need for subscription to + bug-guile@gnu.org. + +2006-10-10 Neil Jerram + + * 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 + + * 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 + + * 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 + + * 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 + + * scheme-using.texi (GDS Getting Started): Editorial updates. + +2006-09-28 Neil Jerram + + * 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 + + * 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 + + * 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 + + * 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 + + * api-data.texi (Scientific): In sqrt, note it's the positive root + which is returned (as per R5RS). + +2006-09-20 Ludovic Courtès + + * api-data.texi (Standard Character Sets): Documented the + charset recomputation upon successful `setlocale'. + +2006-09-08 Kevin Ryde + + * 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 + + * posix.texi (Network Sockets and Communication): Tweak description, + note not multi-threading. + +2006-09-04 Neil Jerram + + * 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 + + * 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 + + * 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 + + * 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 + + * api-debug.texi (Debug on Error): New text on how to catch errors + and the error stack. + +2006-08-23 Neil Jerram + + * 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 + + * api-i18n.texi (Internationalization): Cross reference gettext manual + on plural forms. + +2006-08-18 Neil Jerram + + * 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 + + * 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 + + * 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 + + * 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 + + * posix.texi (Time): In tm:gmtoff, give example values, note not the + same as C tm_gmtoff. + +2006-06-16 Ludovic Courtès + + * api-utility.texi (Equality): Mentioned the behavior of `equal?' + for structures (as suggested by Kevin Ryde). + +2006-06-13 Ludovic Courtès + + * api-compound.texi (Structure Concepts): Mentioned the behavior + of `equal?' for structures. + +2006-05-28 Kevin Ryde + + * srfi-modules.texi (SRFI-1 Length Append etc): Add an append-reverse + example. + +2006-05-20 Kevin Ryde + + * 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 + + * posix.texi (Processes): Add primitive-_exit. + +2006-05-10 Kevin Ryde + + * 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 + + * 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 + + * api-scheduling.texi (Threads): In call-with-new-thread, handler arg + is optional (as of 1.8.0). + +2006-04-15 Kevin Ryde + + * api-scheduling.texi (System asyncs): "{void *}" in @deffnx to keep + the "*" out of the name in the index. + +2006-04-06 Kevin Ryde + + * 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 + + * 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 + + * api-data.texi (Conversion): Add scm_c_locale_stringn_to_number. + +2006-03-05 Kevin Ryde + + * 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 + + * api-utility.texi (Object Properties): Removed confusing + paragraph about 'name' property. + +2006-02-07 Kevin Ryde + + * api-modules.texi (Compiled Code Installation): Revise, in particular + @libdir@ needs to go via the makefile. + +2006-02-04 Neil Jerram + + * 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 + + * 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 + + * 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 + + * api-data.texi (Operations Related to Symbols): + Documented `scm_take_locale_symbol ()'. + +2005-12-15 Kevin Ryde + + * 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 + + * 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 + + * 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 + + * api-compound.texi (Retrieving Alist Entries): Revise for clarity and + brevity. + +2005-11-06 Kevin Ryde + + 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 + + * posix.texi (Time): In strftime, note systems vary for %Z. + +2005-10-29 Kevin Ryde + + * 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 + + * 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 + + * 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 + + * 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 + + * 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 + + * 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 + + * 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 + + * api-options.texi (Debugger options): Cross reference new Tail Calls + node rather than R5RS on tail recursion. + +2005-06-23 Kevin Ryde + + * 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 + + * gh.texi: More stuff about transitioning away from GH. + +2005-06-11 Kevin Ryde + + * 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 + + * 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 + + * 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 + + * api-data.texi (String Constructors): Clarify string, list->string + and reverse-list->string a bit. + +2005-04-30 Kevin Ryde + + * api-io.texi (Default Ports): Describe buffering on standard ports. + +2005-04-23 Kevin Ryde + + * 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 + + * 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 + + * srfi-modules.texi (SRFI-1 Set Operations): use @cross iso. @times. + + * guile.texi: add @cross for @tex + +2005-04-02 Kevin Ryde + + * 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 + + * api-compound.texi: Fixed some typos and added some docs. Talk + about concrete and abstract hash tables. + +2005-03-14 Kevin Ryde + + * srfi-modules.texi (SRFI-55): New section. + (SRFI-60): New section. + +2005-03-01 Kevin Ryde + + * 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 + + * api-data.texi (Reals and Rationals): Use tex for sqrt2 and pi. + (Complex Numbers): Add polar form read syntax. + +2005-02-15 Kevin Ryde + + * 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 + + * 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 + + * 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 + + * 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 + + * posix.texi (Signals): In sigaction, add SA_NOCLDSTOP, make it + clearer SA_RESTART is a variable. + +2005-01-28 Kevin Ryde + + * 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 + * api-i18n.texi (Internationalization): Expand and revise a bit for + clarity. + * srfi-modules.texi (SRFI-1 Searching): In member, note `=' called arg order. (SRFI-1 Set Operations): Remove lset-adjoin!, doesn't exist in the @@ -1883,3 +2571,8 @@ 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: