doc/ref/ChangeLog

   1 2008-06-28  Ludovic Courtès  <ludo@gnu.org>
   2
   3         * api-modules.texi (Using Guile Modules): Substitute "syntax
   4         transformer" to "system transformer".  Reported by Sebastian
   5         Tennant <sebyte@smolny.plus.com>.
   6
   7 2008-06-01  Ludovic Courtès  <ludo@gnu.org>
   8
   9         * srfi-modules.texi (SRFI-88): Fix URL.
  10
  11 2008-05-14  Julian Graham  <joolean@gmail.com>
  12
  13         * api-scheduling.texi (Mutexes and Condition Variables): Add
  14         documentation for new functions "scm_mutex_owner",
  15         "scm_mutex_level", and "scm_mutex_locked_p".  Update
  16         documentation for function "scm_lock_mutex_timed" to reflect
  17         addition of optional ownership argument.
  18
  19 2008-05-07  Ludovic Courtès  <ludo@gnu.org>
  20
  21         * Makefile.am (autoconf-macros.texi): Avoid use of GNU Make
  22         specific `$<' variable.  This broke with BSD Make as found on
  23         FreeBSD 6.2.
  24
  25 2008-05-05  Neil Jerram  <neil@ossau.uklinux.net>
  26
  27         * scheme-using.texi (Using Guile in Emacs): Add concept index
  28         entries `GDS' and `Emacs'.
  29
  30         * api-debug.texi (Debugging): Add concept index entry `Debugging'.
  31
  32 2008-05-04  Ludovic Courtès  <ludo@gnu.org>
  33
  34         * guile.texi (Guile Modules): Include `autoconf.texi'.
  35         * autoconf.texi (Autoconf Support): Mention `pkg-config'.
  36         (Autoconf Macros): Document `pkg-config' support.
  37
  38 2008-04-26  Ludovic Courtès  <ludo@gnu.org>
  39
  40         * srfi-modules.texi (SRFI-88): New section.
  41         * api-data.texi (Keyword Read Syntax): Add reference to
  42         `SRFI-88'.
  43
  44 2008-04-17  Neil Jerram  <neil@ossau.uklinux.net>
  45
  46         * posix.texi (File System): New doc for file-exists?.
  47
  48 2008-04-15  Ludovic Courtès  <ludo@gnu.org>
  49
  50         * api-data.texi (Keywords): Mention postfix syntax.
  51         (Keyword Read Syntax): Document `postfix' read option.
  52         * api-options.texi (Reader options): Update examples.
  53         (Examples of option use): Likewise.
  54
  55 2008-03-28  Neil Jerram  <neil@ossau.uklinux.net>
  56
  57         * libguile-concepts.texi (Multi-Threading): Fix typo.
  58
  59 2008-03-24  Neil Jerram  <neil@ossau.uklinux.net>
  60
  61         Applying patch from Julian Graham, containing minor fixes to his
  62         thread enhancements:
  63
  64         * api-scheduling.texi (Mutexes and Condition Variables): Change
  65         `flag' to `flags' in docstring.
  66
  67 2008-03-19  Neil Jerram  <neil@ossau.uklinux.net>
  68
  69         * api-debug.texi (Low Level Trap Calls): Removed (material
  70         duplicated elsewhere); doc for with-traps and debug-object? moved
  71         to section on evaluator trap options.
  72         (High Level Traps): Renamed just `Traps'.  Add references to
  73         evaluator trap options and debug options.  Make language
  74         appropriate for core Guile (as opposed to previously separate
  75         package).
  76         (Location Traps): Corrected to reflect that location traps now
  77         specify a specific position, not a range of positions.
  78         (Debugging Examples): New (content moved here from
  79         scheme-debugging.texi, and updated to use traps instead of
  80         breakpoints).
  81
  82         * api-modules.texi (Included Guile Modules): Change `Debugging
  83         Features' reference to `Tracing'.
  84
  85         * api-options.texi (Evaluator trap options): Doc for with-traps
  86         and debug-object? is now here.
  87
  88         * guile.texi, scheme-debugging.texi: Move the `Tracing' content of
  89         scheme-debugging.texi to the Modules section.
  90
  91         * scheme-using.texi (Using Guile in Emacs, GDS Getting Started):
  92         Minor edits.
  93
  94         * scheme-debugging.texi (Debugging Features, Intro to
  95         Breakpoints): Removed.
  96         (Examples): Moved to api-debug.texi.
  97         (Tracing, Old Tracing): Promoted one level.
  98         (New Tracing, Tracing Compared): Removed.
  99
 100 2008-03-08  Julian Graham  <joolean@gmail.com>
 101
 102         * api-scheduling.texi (Threads): Add documentation for new
 103         functions "scm_thread_p" and new "scm_join_thread_timed".
 104         (Mutexes and Condition Variables): Add documentation for new
 105         functions "scm_make_mutex_with_flags", "scm_mutex_p",
 106         "scm_lock_mutex_timed", "scm_unlock_mutex_timed", and
 107         "scm_condition_variable_p".
 108
 109 2008-02-11  Neil Jerram  <neil@ossau.uklinux.net>
 110
 111         * api-data.texi (Random): New text about the default random state,
 112         following suggestions by Stephen Uitti.
 113
 114 2008-02-01  Neil Jerram  <neil@ossau.uklinux.net>
 115
 116         * api-scheduling.texi (Threads): Add "C Function scm_join_thread"
 117         to doc for join-thread.  Thanks to Antoine Mathys for reporting
 118         that scm_join_thread was missing.
 119
 120 2007-12-09  Stephen Compall  <s11@member.fsf.org>
 121
 122         * srfi-modules.texi (SRFI-69): Avoid use of the first person.
 123
 124 2007-12-03  Stephen Compall  <s11@member.fsf.org>
 125
 126         * srfi-modules.texi: Describe SRFI-69 in a new subsection.
 127
 128 2007-10-29  Julian Graham  <joolean@gmail.com>
 129
 130         * api-scheduling.texi (Threads): Document `cancel-thread',
 131         `set-thread-cleanup!' and `thread-cleanup'.
 132
 133 2007-10-24  Neil Jerram  <neil@ossau.uklinux.net>
 134
 135         * .cvsignore: Add lib-version.texi.
 136
 137 2007-10-02  Ludovic Courtès  <ludo@gnu.org>
 138
 139         * slib.texi (SLIB installation): Don't recommend using the site
 140         directory for the symlink; instead, suggest either adding a
 141         symlink in `/.../share/guile/1.8' (because slib will look for
 142         its files in the implementation vicinity by default) or defining
 143         `SCHEME_LIBRARY_PATH'.  Mention `new-catalog'.
 144
 145 2007-08-11  Ludovic Courtès  <ludo@gnu.org>
 146
 147         * srfi-modules.texi (SRFI-34): New node.
 148         (SRFI-35): New node.
 149
 150 2007-07-18  Stephen Compall  <s11@member.fsf.org>
 151
 152         * srfi-modules.texi: Describe SRFI-37 in a new subsection.
 153
 154 2007-07-10  Ludovic Courtès  <ludo@gnu.org>
 155
 156         * api-data.texi (Arithmetic): Documented `1+' and `1-'.
 157         Suggested by Jon Wilson <j85wilson@fastmail.fm>.
 158
 159         * api-modules.texi (Module System Reflection): Documented
 160         `save-module-excursion', by Jon Wilson <jsw@wilsonjc.us>.
 161
 162 2007-06-07  Ludovic Courtès  <ludovic.courtes@laas.fr>
 163
 164         * api-control.texi (Dynamic Wind): Fixed typo.  Reported by
 165         Norman Hardy.
 166
 167 2007-05-16  Ludovic Courtès  <ludovic.courtes@laas.fr>
 168
 169         * posix.texi (Network Sockets and Communication): Fixed typo:
 170         `make-socket-object' instead of `make-socket-address'.
 171
 172 2007-03-08  Kevin Ryde  <user42@zip.com.au>
 173
 174         * api-compound.texi (Structures): Revise and expand variously, add
 175         make-vtable.
 176
 177         * api-io.texi: Add various @cindex entries.
 178
 179         * slib.texi (SLIB): Shorten the bit about core funcs overridden.
 180         Don't want to duplicate the SLIB specs, and the set of modified bits
 181         is likely to change over time and don't want to have to keep up with
 182         that.
 183
 184 2007-02-22  Kevin Ryde  <user42@zip.com.au>
 185
 186         * posix.texi (Signals): Merge sleep and usleep, note usleep not
 187         actually microsecond accurate, remove warning usleep not always
 188         available (guile has own code for it now, it's not the system call).
 189         Cross reference scm_std_sleep / scm_std_usleep.
 190
 191         * posix.texi (Signals): Merge getitimer and setitimer, describe what
 192         each timer does, use @defvar to get them indexed, caution may not
 193         actually be microsecond accurate.
 194
 195 2007-02-20  Neil Jerram  <neil@ossau.uklinux.net>
 196
 197         * Makefile.am (EXTRA_DIST): Add lib-version.texi to the
 198         distribution.
 199
 200 2007-02-16  Kevin Ryde  <user42@zip.com.au>
 201
 202         * api-compound.texi (Records): In make-record-type, describe optional
 203         print function argument.
 204
 205 2007-01-31  Ludovic Courtès  <ludovic.courtes@laas.fr>
 206
 207         * api-data.texi (Conversion): Made cross refs point to `Number
 208         Input and Output' rather than `The ice-9 i18n Module'.
 209         (String Comparison): Likewise for `Text Collation'.
 210         * api-i18n.texi (Internationalization): Re-organized the whole
 211         section, documented new i18n features.  Added the following
 212         subsections: `i18n Introduction', `Text Collation', `Character
 213         Case Mapping', `Number Input and Output', `Accessing Locale
 214         Information'.  Removed `The ice-9 i18n Module'.
 215         * posix.texi (Locales): Updated cross-ref formerly pointing to
 216         `The ice-9 i18n Module'.
 217         * srfi-modules.texi (SRFI-19 String to date): Mention the
 218         internationalization of `string->date'.
 219
 220 2007-01-25  Kevin Ryde  <user42@zip.com.au>
 221
 222         * posix.texi (Signals): Note signal handlers run via system async and
 223         can hence be delayed quite a while.  Struck by William Xu.
 224
 225 2007-01-19  Han-Wen Nienhuys  <hanwen@lilypond.org>
 226
 227         * api-options.texi (Evaluator trap options): document
 228         memoize-symbol-handler
 229
 230         * api-evaluation.texi (Evaluator Behaviour): link to the Evaluator
 231         trap options node in trap-enable/trap-set! doco.
 232
 233 2007-01-16  Kevin Ryde  <user42@zip.com.au>
 234
 235         * api-data.texi (Mapping Folding and Unfolding): In string-unfold,
 236         ssay make_final default is nothing extra.  The `(lambda (x) )' shown
 237         was not quite right, it would have been `(lambda (x) "")' if anything.
 238
 239         * api-init.texi (Initialization): Cross reference Runtime Environment
 240         for scm_set_program_arguments.
 241
 242         * posix.texi (Runtime Environment): Expand program-arguments
 243         description, add set-program-arguments, add scm_set_program_arguments,
 244         note args are per-thread.
 245
 246 2006-12-14  Kevin Ryde  <user42@zip.com.au>
 247
 248         * api-procedures.texi (let-keywords Reference): Expand variously to
 249         make it clear what's actually taken and done.  Shortfalls reported by
 250         Han-Wen Nienhuys.
 251
 252 2006-12-13  Kevin Ryde  <user42@zip.com.au>
 253
 254         * api-control.texi (Handling Errors): Cross reference "Error
 255         Reporting" for `scm-error', not just "above".
 256
 257         * posix.texi (Encryption): Cross reference crypt in the glibc manual.
 258         Clarify that key and salt are strings.
 259
 260         * srfi-modules.texi (SRFI-17): Expand variously.
 261
 262 2006-11-18  Ludovic Courtès  <ludovic.courtes@laas.fr>
 263
 264         * Makefile.am (BUILT_SOURCES): New variable.
 265         (lib-version.texi): New target.
 266
 267         * guile.texi: Include `lib-version.texi'.
 268
 269         * api-data.texi (Conversion): Link to `The ice-9 i18n Module' when
 270         describing `string->number'.
 271         (String Comparison): Likewise.
 272
 273         * api-i18n.texi (Internationalization)[The ice-9 i18n Module]: New
 274         node.
 275         [Gettext Support]: New node; contains text formerly in
 276         `Internationalization'.
 277
 278         * posix.texi (Locales): Added a link to the glibc manual
 279         describing the various locale categories.  Mention locale objects
 280         and link to `The ice-9 i18n Module' when describing `setlocale'.
 281
 282 2006-11-17  Neil Jerram  <neil@ossau.uklinux.net>
 283
 284         * intro.texi (Reporting Bugs): Note need for subscription to
 285         bug-guile@gnu.org.
 286
 287 2006-10-10  Neil Jerram  <neil@ossau.uklinux.net>
 288
 289         * scheme-using.texi (Setting and Managing Breakpoints): New text
 290         about what happens when a breakpoint is created.
 291         (Listing and Deleting Breakpoints, Moving and Losing Breakpoints):
 292         New.
 293
 294 2006-10-08  Neil Jerram  <neil@ossau.uklinux.net>
 295
 296         * scheme-using.texi (Working with GDS in Scheme Buffers): New
 297         subsection, to group (Access to Guile Help and Completion, Setting
 298         and Managing Breakpoints, Evaluating Scheme Code) together.
 299         (GDS Getting Started): Editorial updates.
 300
 301 2006-10-06  Neil Jerram  <neil@ossau.uklinux.net>
 302
 303         * scheme-using.texi (Using Guile in Emacs): Subnodes reordered,
 304         from (Displaying the Scheme Stack, Continuing Execution,
 305         Evaluating Scheme Code, Setting and Managing Breakpoints, Access
 306         to Guile Help and Completion) to (Access to Guile Help and
 307         Completion, Setting and Managing Breakpoints, Evaluating Scheme
 308         Code, Displaying the Scheme Stack, Continuing Execution).
 309         (Access to Guile Help and Completion): Mention where keys are
 310         defined.
 311         (Setting and Managing Breakpoints): Update text on how to set
 312         breakpoints.
 313
 314 2006-10-05  Kevin Ryde  <user42@zip.com.au>
 315
 316         * misc-modules.texi (File Tree Walk): Corrections to BASE parameter
 317         and symlink vs stale-symlink types in nftw.
 318         * misc-modules.texi, guile.texi (Buffered Input): New section,
 319         describing (ice-9 buffered-input).
 320
 321         * posix.texi (User Information): Clarify getpwent returns #f at end of
 322         file.
 323
 324         * repl-modules.texi (Readline Functions): New section on how to call
 325         readline from scheme code.
 326
 327 2006-10-03  Neil Jerram  <neil@ossau.uklinux.net>
 328
 329         * scheme-using.texi (GDS Getting Started): Editorial updates.
 330
 331 2006-09-28  Neil Jerram  <neil@ossau.uklinux.net>
 332
 333         * scheme-using.texi (GDS Introduction, GDS Getting Started): Minor
 334         edits.
 335
 336         * api-data.texi (Symbol Props): Remove unnecessarily specific
 337         parenthesis about Guile 1.6's use of extra symbol slots.
 338
 339 2006-09-26  Neil Jerram  <neil@ossau.uklinux.net>
 340
 341         * scheme-using.texi (Using Guile in Emacs, GDS Introduction):
 342         Editorial updates.
 343         (GDS Architecture): Moved earlier in containing section; editorial
 344         updates.
 345         (GDS Getting Started, How to Use GDS): Merged; editorial updates;
 346         subsections reordered.
 347
 348 2006-09-26  Kevin Ryde  <user42@zip.com.au>
 349
 350         * api-io.texi (Random Access): In truncate-file, tweak wording for
 351         clarity, note cannot always extend file this way.
 352         (Ports): File access uses LFS.
 353
 354 2006-09-25  Neil Jerram  <neil@ossau.uklinux.net>
 355
 356         * scheme-using.texi (Error Handling, Interactive Debugger): Minor
 357         editorial improvements.
 358         (Leave Debugger): Removed.
 359         (Display Backtrace): Minor updates.
 360         (Frame Selection, Frame Information, Frame Evaluation) : Minor
 361         editorial improvements.
 362         (Stepping and Continuing): Merged from three previous nodes; plus
 363         minor improvements.  Removed doc for `trace-finish', which no
 364         longer exists.
 365
 366 2006-09-22  Kevin Ryde  <user42@zip.com.au>
 367
 368         * api-data.texi (Scientific): In sqrt, note it's the positive root
 369         which is returned (as per R5RS).
 370
 371 2006-09-20  Ludovic Courtès  <ludovic.courtes@laas.fr>
 372
 373         * api-data.texi (Standard Character Sets): Documented the
 374         charset recomputation upon successful `setlocale'.
 375
 376 2006-09-08  Kevin Ryde  <user42@zip.com.au>
 377
 378         * misc-modules.texi (Formatted Output): Show ":@" rather than "@:",
 379         because ":@" is traditional common lisp, though either way works.
 380         Break a couple of example lines to avoid overflowing DVI page width.
 381
 382         * scheme-debugging.texi (Debug Last Error): Line break in "Type
 383         (backtrace) to get ..." which overflowed the line in both info and
 384         DVI.  Reported by Percy Tiglao.
 385
 386 2006-09-05  Kevin Ryde  <user42@zip.com.au>
 387
 388         * posix.texi (Network Sockets and Communication): Tweak description,
 389         note not multi-threading.
 390
 391 2006-09-04  Neil Jerram  <neil@ossau.uklinux.net>
 392
 393         * api-control.texi (Dynamic Wind): Doc for scm_dynwind_free.
 394
 395         * api-modules.texi (The Guile module system), api-data.texi
 396         (Integers, Numerical Tower), api-compound.texi (Uniform Numeric
 397         Vectors): Fix typos.  (Patch sent in by Marco Maggi.)
 398
 399 2006-08-29  Neil Jerram  <neil@ossau.uklinux.net>
 400
 401         * api-debug.texi (Debug on Error): Added paragraph on need to use
 402         debugging evaluator.  Added text on what the Guile REPL code does.
 403
 404 2006-08-29  Kevin Ryde  <user42@zip.com.au>
 405
 406         * api-control.texi (Dynamic Wind): Reformat example a bit to avoid
 407         going off the right edge of the paper.  Reported by Percy Tiglao.
 408
 409 2006-08-28  Neil Jerram  <neil@ossau.uklinux.net>
 410
 411         * api-debug.texi (Examining the Stack): Minor improvements to
 412         display-backtrace doc.
 413         (Debug on Error): More new text on catching the error stack.
 414
 415 2006-08-27  Neil Jerram  <neil@ossau.uklinux.net>
 416
 417         * api-debug.texi (Debug on Error): New text on how to catch errors
 418         and the error stack.
 419
 420 2006-08-23  Neil Jerram  <neil@ossau.uklinux.net>
 421
 422         * scheme-using.texi (Using Guile in Emacs): New text about
 423         available Emacs libraries.
 424         (GDS Introduction): New node, containing GDS-specific introductory
 425         text.
 426
 427 2006-08-22  Kevin Ryde  <user42@zip.com.au>
 428
 429         * api-i18n.texi (Internationalization): Cross reference gettext manual
 430         on plural forms.
 431
 432 2006-08-18  Neil Jerram  <neil@ossau.uklinux.net>
 433
 434         * scheme-using.texi (Using Guile in Emacs): Unignore extra GDS
 435         intro text.  (I will edit this down later.  For now it's
 436         convenient to have it all appearing, so it's visible on paper.)
 437
 438 2006-08-11  Neil Jerram  <neil@ossau.uklinux.net>
 439
 440         * scheme-using.texi (Run To Frame Exit): Improved doc for finish.
 441         (Continue Execution): Improved doc for continue.
 442         (Using Guile in Emacs): Lots of new docs about the Emacs
 443         interface.
 444
 445         * api-debug.texi (Low Level Trap Calls): New.
 446         (Using Traps): Removed, material incorporated into Low Level Trap
 447         Calls.
 448         (High Level Traps): New.
 449         (Breakpoints): New.
 450
 451         * scheme-using.texi (Single Stepping): Improve doc for step and
 452         next.
 453
 454         * api-debug.texi (Debug on Error): Note need to handling of errors
 455         in C.
 456
 457         * api-debug.texi (Debugging): New intro text.  New subsection
 458         "Evaluation Model".  Moved existing subsections "Capturing the
 459         Stack or Innermost Stack Frame", "Examining the Stack", "Examining
 460         Stack Frames", "Source Properties", "Decoding Memoized Source
 461         Expressions" and "Starting a New Stack" under "Evaluation Model".
 462         (Capturing the Stack or Innermost Stack Frame): Some new text, and
 463         correction to doc for last-stack-frame.
 464         (Debug on Error): Renamed from "Interactive Debugging".
 465
 466 2006-08-01  Neil Jerram  <neil@ossau.uklinux.net>
 467
 468         * api-debug.texi (Breakpoints): Removed (all wrong).
 469
 470         * guile.texi (API Reference): Improved summary for "Debugging"
 471         menu item.
 472
 473         * scheme-debugging.texi (Debug Last Error, Interactive Debugger):
 474         Moved/merged to scheme-using.texi, as REPL features.
 475         (Examples): New.
 476         (Intro to Breakpoints): New introductory text here.  Removed all
 477         subnodes except for Breakpoints Overview.
 478
 479         * scheme-using.texi: New.
 480
 481         * guile.texi (Programming in Scheme): Include new
 482         scheme-using.texi file.
 483
 484         * Makefile.am (guile_TEXINFOS): Include new scheme-using.texi
 485         file.
 486
 487 2006-07-24  Kevin Ryde  <user42@zip.com.au>
 488
 489         * api-evaluation.texi (Fly Evaluation): Add scm_c_eval_string.
 490         (Loading): Add scm_c_primitive_load.
 491         Reported by Jon Wilson.
 492
 493 2006-06-25  Kevin Ryde  <user42@zip.com.au>
 494
 495         * posix.texi (Time): In tm:gmtoff, give example values, note not the
 496         same as C tm_gmtoff.
 497
 498 2006-06-16  Ludovic Courtès  <ludovic.courtes@laas.fr>
 499
 500         * api-utility.texi (Equality): Mentioned the behavior of `equal?'
 501         for structures (as suggested by Kevin Ryde).
 502
 503 2006-06-13  Ludovic Courtès  <ludovic.courtes@laas.fr>
 504
 505         * api-compound.texi (Structure Concepts): Mentioned the behavior
 506         of `equal?' for structures.
 507
 508 2006-05-28  Kevin Ryde  <user42@zip.com.au>
 509
 510         * srfi-modules.texi (SRFI-1 Length Append etc): Add an append-reverse
 511         example.
 512
 513 2006-05-20  Kevin Ryde  <user42@zip.com.au>
 514
 515         * api-compound.texi (Pairs): Cross reference SRFI-1 second, third,
 516         fourth.
 517         (List Modification): Cross reference SRFI-1 delete and lset-difference.
 518         (List Searching): Cross reference SRFI-1 member.
 519         (List Mapping): Cross reference SRFI-1 map etc.
 520         (Retrieving Alist Entries): Cross reference SRFI-1 assoc.
 521
 522         * srfi-modules.texi (SRFI-1 Association Lists): Describe argument
 523         order for "=" procedure.
 524
 525 2006-05-15  Kevin Ryde  <user42@zip.com.au>
 526
 527         * posix.texi (Processes): Add primitive-_exit.
 528
 529 2006-05-10  Kevin Ryde  <user42@zip.com.au>
 530
 531         * intro.texi (Linking Guile into Programs): Enhance example program,
 532         change scm_str2string to scm_from_locale_string, since scm_str2string
 533         is "discouraged".  And check for NULL from getenv since neither
 534         scm_str2string nor scm_from_locale_string can cope with that.
 535         Reported by Frithjof.
 536
 537 2006-05-09  Kevin Ryde  <user42@zip.com.au>
 538
 539         * api-control.texi (Multiple Values): In `receive', add an example,
 540         cross ref SRFI-8, tweak wording.
 541
 542         * api-io.texi (Port Implementation): @defun style for
 543         scm_make_port_type and the various set functions.
 544
 545         * posix.texi (Ports and File Descriptors): Tweaks to fcntl.
 546
 547 2006-04-29  Kevin Ryde  <user42@zip.com.au>
 548
 549         * api-scheduling.texi (Threads): In call-with-new-thread, handler arg
 550         is optional (as of 1.8.0).
 551
 552 2006-04-15  Kevin Ryde  <user42@zip.com.au>
 553
 554         * api-scheduling.texi (System asyncs): "{void *}" in @deffnx to keep
 555         the "*" out of the name in the index.
 556
 557 2006-04-06  Kevin Ryde  <user42@zip.com.au>
 558
 559         * posix.texi (Ports and File Descriptors): Clarify fcntl a bit,
 560         and correction FD_CLOEXEC goes with FD_SETFD not FD_SETFL.
 561         (Network Sockets and Communication): In accept, cross-reference to
 562         fcntl on O_NONBLOCK.
 563
 564 2006-03-28  Kevin Ryde  <user42@zip.com.au>
 565
 566         * api-compound.texi (Vector Accessing from C): Show
 567         SCM_SIMPLE_VECTOR_SET not SCM_SIMPLE_VECTOR_SET_X, the former is
 568         what's in vector.h.
 569
 570 2006-03-21  Ludovic Courtès  <ludovic.courtes@laas.fr>
 571
 572         * api-data.texi (Conversion): Add scm_c_locale_stringn_to_number.
 573
 574 2006-03-05  Kevin Ryde  <user42@zip.com.au>
 575
 576         * api-compound.texi (Array Procedures): @pxref for `equal?'.
 577         (Shared Arrays): Correction to make-shared-array stride example, need
 578         `list' on the mapper return value.
 579
 580 2006-02-13  Marius Vollmer  <mvo@zagadka.de>
 581
 582         * api-utility.texi (Object Properties): Removed confusing
 583         paragraph about 'name' property.
 584
 585 2006-02-07  Kevin Ryde  <user42@zip.com.au>
 586
 587         * api-modules.texi (Compiled Code Installation): Revise, in particular
 588         @libdir@ needs to go via the makefile.
 589
 590 2006-02-04  Neil Jerram  <neil@ossau.uklinux.net>
 591
 592         * api-control.texi (Throw Handlers): New node.
 593         (Throw): Moved to after the Lazy Catch node.
 594         (Catch): Enhance to cover the optional pre-unwind handler, and new
 595         APIs scm_c_catch, scm_catch_with_pre_unwind_handler.
 596         (Lazy Catch): Describe relationship to with-throw-handler.
 597         Document that the handler may return, and what happens if it does.
 598         (Throw): Mention that a throw can be handled by a throw handler as
 599         well as by a catch.
 600
 601 2006-02-04  Kevin Ryde  <user42@zip.com.au>
 602
 603         * api-options.texi (Build Config): pxref libtool on libguileinterface
 604         version info.
 605         * intro.texi (Writing Guile Extensions), libguile-extensions.texi (A
 606         Sample Guile Extension): pxref libtool manual.
 607
 608         * api-modules.texi (Compiled Code Installation): New section.
 609
 610         * posix.texi (Network Address Conversion, Network Databases)
 611         (Network Sockets and Communication, Internet Socket Examples): Misc
 612         tweaks.
 613
 614 2006-01-29  Marius Vollmer  <mvo@zagadka.de>
 615
 616         * api-scheduling.texi: Removed "Futures" node.
 617
 618         Renamed the "frames" that are related to dynamic-wind to "dynamic
 619         contexts.  Renamed all functions from scm_frame_ to scm_dynwind_.
 620         Updated documentation.
 621
 622 2005-12-19  Ludovic Courtès  <ludovic.courtes@laas.fr>
 623
 624         * api-data.texi (Operations Related to Symbols):
 625         Documented `scm_take_locale_symbol ()'.
 626
 627 2005-12-15  Kevin Ryde  <user42@zip.com.au>
 628
 629         * api-evaluation.texi (Fly Evaluation): Add scm_call_4, suggested by
 630         Bruce Korb.
 631
 632         * misc-modules.texi (Streams): In stream->list&length and
 633         stream->reversed-list&length, make the two values clearer.
 634
 635 2005-12-14  Neil Jerram  <neil@ossau.uklinux.net>
 636
 637         * api-options.texi (Evaluator trap options): Trap calls now always
 638         use a debug object rather than a continuation.
 639         (Debugger options, Examples of option use): Update help text for
 640         'cheap option (which is now obsolete).
 641
 642         * api-evaluation.texi (Loading): Document custom reader.
 643
 644 2005-12-06  Marius Vollmer  <mvo@zagadka.de>
 645
 646         * api-init.texi, api-scheduling.texi, libguile-concepts.texi:
 647         Removed scm_leave_guile, scm_enter_guile and all references to
 648         them since they are no longer in the API.
 649
 650         From Stephen Compall:
 651
 652         * api-control.texi (if cond case): Describe SRFI 61 cond.
 653
 654         * srfi-modules.texi (SRFI-61): New section.
 655         (SRFI Support): Add SRFI-61 to menu.
 656
 657 2005-11-19  Kevin Ryde  <user42@zip.com.au>
 658
 659         * api-compound.texi (Retrieving Alist Entries): Revise for clarity and
 660         brevity.
 661
 662 2005-11-06  Kevin Ryde  <user42@zip.com.au>
 663
 664         From Ludovic Courtès, partial rework by me:
 665         * doc/ref/api-modules.texi (Creating Guile Modules): In define-module,
 666         describe #:re-export, #:export-syntax, #:re-export-syntax, #:replace
 667         and #:duplicates.  Add re-export.
 668
 669 2005-11-01  Kevin Ryde  <user42@zip.com.au>
 670
 671         * posix.texi (Time): In strftime, note systems vary for %Z.
 672
 673 2005-10-29  Kevin Ryde  <user42@zip.com.au>
 674
 675         * posix.texi (Network Socket Address): Add scm_make_socket_address,
 676         scm_c_make_socket_address, scm_from_sockaddr, scm_to_sockaddr.  This
 677         change by Ludovic Courtès and revised a bit by me.
 678
 679 2005-10-27  Kevin Ryde  <user42@zip.com.au>
 680
 681         * posix.texi (Network Address Conversion): Move INADDR_ANY to here.
 682         (Network Socket Address): New section, move sockaddr bits to here, add
 683         new make-socket-address.
 684         (Network Sockets and Communication): In connect, bind, and sendto, now
 685         take socket address object.  In bind, leave INADDR constants for
 686         "Network Address Conversion" node.  In those plus accept, getsockname,
 687         getpeername, reword a bit for clarity.
 688
 689 2005-10-24  Kevin Ryde  <user42@zip.com.au>
 690
 691         * posix.texi (Network Sockets and Communication): Combine and revise
 692         getsockopt and setsockopt.  Add OPTNAME constants, including new
 693         IP_ADD_MEMBERSHIP and IP_DROP_MEMBERSHIP.
 694
 695         * posix.texi (Time): Revise strftime for clarity, cross reference man
 696         3 strftime (suggested by Greg Troxel), note locale character set when
 697         setlocale has been called.
 698
 699 2005-10-15  Neil Jerram  <neil@ossau.uklinux.net>
 700
 701         * api-debug.texi (Source Properties): Add text describing/advising
 702         limited use of source properties.
 703
 704         * api-debug.texi (Source Properties): Documentation of source
 705         property procedures moved here from ...
 706
 707         * api-procedures.texi (Procedure Properties): ... where it didn't
 708         belong.
 709
 710 2005-10-05  Kevin Ryde  <user42@zip.com.au>
 711
 712         * api-data.texi (Regexp Functions): Notes on zero bytes and locale
 713         character set.
 714
 715         * misc-modules.texi (Formatted Output): Show modifiers like ~:d
 716         instead of in words.
 717
 718 2005-08-06  Kevin Ryde  <user42@zip.com.au>
 719
 720         * api-compound.texi (List Modification): In filter, return may share a
 721         tail with the input, as per docstring.  In filter!, fix chopped off
 722         note of modifying input.
 723
 724         * api-control.texi (Error Reporting): In strerror, note message is in
 725         locale language and charset.
 726
 727 2005-07-12  Kevin Ryde  <user42@zip.com.au>
 728
 729         * api-data.texi (String Selection): In string-pad, don't say anything
 730         about sharing strings, decided against doing that.
 731         (Miscellaneous String Operations): Ditto in string-filter and
 732         string-delete.
 733
 734         * api-data.texi (String Selection): Merge descriptions of string-trim,
 735         string-trim-right and string-trim-both for brevity.
 736
 737 2005-06-24  Kevin Ryde  <user42@zip.com.au>
 738
 739         * api-options.texi (Debugger options): Cross reference new Tail Calls
 740         node rather than R5RS on tail recursion.
 741
 742 2005-06-23  Kevin Ryde  <user42@zip.com.au>
 743
 744         * guile.texi, libguile-concepts.texi, libguile-extensions.texi,
 745         libguile-linking.texi, libguile-smobs.texi: Spelling errors reported
 746         by hyperdivision.
 747
 748         * api-compound.texi (Pairs, List Syntax): Cross reference Expression
 749         Syntax for quoting.
 750         * api-control.texi (Lazy Catch): Cross ref for with-fluids.
 751         * libguile-linking.texi (A Sample Guile Main Program): Cross reference
 752         automake manual for aclocal.
 753         * libguile-program.texi (Extending Dia): URL for Dia home page.
 754         (Dia Primitives): Cross ref for scm_c_define_gsubr.
 755
 756 2005-06-12  Marius Vollmer  <mvo@zagadka.de>
 757
 758         * gh.texi: More stuff about transitioning away from GH.
 759
 760 2005-06-11  Kevin Ryde  <user42@zip.com.au>
 761
 762         * api-data.texi (Miscellaneous String Operations): In string-filter
 763         and string-delete, note result may share with input string (as allowed
 764         by srfi spec).
 765
 766 2005-06-06  Kevin Ryde  <user42@zip.com.au>
 767
 768         * api-compound.texi (Array Procedures): In array-in-bounds?,
 769         correction to example result.
 770
 771         * api-init.texi (Initialization), api-scheduling.texi (Blocking):
 772         {} groups around "void*" C return types.
 773
 774 2005-05-04  Kevin Ryde  <user42@zip.com.au>
 775
 776         * srfi-modules.texi (SRFI-1 Selectors): In drop-right, note always a
 777         new list.  In take-right, note result shares common tail.  Per spec.
 778
 779 2005-05-03  Kevin Ryde  <user42@zip.com.au>
 780
 781         * api-data.texi (String Constructors): Clarify string, list->string
 782         and reverse-list->string a bit.
 783
 784 2005-04-30  Kevin Ryde  <user42@zip.com.au>
 785
 786         * api-io.texi (Default Ports): Describe buffering on standard ports.
 787
 788 2005-04-23  Kevin Ryde  <user42@zip.com.au>
 789
 790         * api-data.texi (Regexp Functions): Add list-matches and fold-matches.
 791
 792         * data-rep.texi (Subrs): Note that subr must not modify its rest list.
 793
 794 2005-04-19  Kevin Ryde  <user42@zip.com.au>
 795
 796         * api-data.texi (Regexp Functions): Clarity flags parameter.
 797
 798         * misc-modules.texi, guile.texi (Rx Regexps): Remove this section, Rx
 799         is not in the core and we don't want to confuse anyone with it and the
 800         builtin posix regexps.
 801
 802 2005-04-04  Han-Wen Nienhuys  <hanwen@xs4all.nl>
 803
 804         * srfi-modules.texi (SRFI-1 Set Operations): use @cross iso. @times.
 805
 806         * guile.texi: add @cross for @tex
 807
 808 2005-04-02  Kevin Ryde  <user42@zip.com.au>
 809
 810         * guile.texi (@times): New macro.
 811
 812         * repl-modules.texi (Readline Support): Cross ref readline manual.
 813         (Loading Readline Support): Add GUILE_HISTORY and .inputrc Guile
 814         configurables.
 815
 816         * srfi-modules.texi (SRFI-1 Association Lists): In alist-cons, clarify
 817         a bit and cross reference core acons.
 818
 819         * srfi-modules.texi (SRFI-1 Set Operations): Revise and expand.
 820         (SRFI-1 Deleting): In delete, cross reference lset-difference.
 821
 822         * srfi-modules.texi (SRFI-19): Note Gregorian leap year rules
 823         incorrectly extended back prior to 1582.
 824
 825 2005-03-29  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
 826
 827         * api-compound.texi: Fixed some typos and added some docs.  Talk
 828         about concrete and abstract hash tables.
 829
 830 2005-03-14  Kevin Ryde  <user42@zip.com.au>
 831
 832         * srfi-modules.texi (SRFI-55): New section.
 833         (SRFI-60): New section.
 834
 835 2005-03-01  Kevin Ryde  <user42@zip.com.au>
 836
 837         * api-compound.texi (Shared Arrays): New section.  Rewrite
 838         make-shared-array for clarity, adding examples.
 839
 840         * libguile-concepts.texi (Control Flow): Cross reference Tail Calls.
 841
 842 2005-02-17  Kevin Ryde  <user42@zip.com.au>
 843
 844         * api-data.texi (Reals and Rationals): Use tex for sqrt2 and pi.
 845         (Complex Numbers): Add polar form read syntax.
 846
 847 2005-02-15  Kevin Ryde  <user42@zip.com.au>
 848
 849         * posix.texi (File System): In tmpnam, clarify security and use of
 850         O_EXCL.  In mkstemp!, in fact posix doesn't specify permissions.
 851
 852         * scheme-ideas.texi (Tail Calls): New section.
 853
 854 2005-02-12  Kevin Ryde  <user42@zip.com.au>
 855
 856         * api-data.texi (String Selection): In string-pad and
 857         string-pad-right, clarify which end the padding goes on, and merge
 858         descriptions.
 859
 860         * api-data.texi (Integer Operations): In gcd and lcm, show args.
 861         (Arithmetic): In truncate, add missing arg.
 862
 863         * srfi-modules.texi (SRFI-1 Fold and Map): Rewrite fold, pair-fold and
 864         reduce for clarity.
 865
 866 2005-02-05  Kevin Ryde  <user42@zip.com.au>
 867
 868         * posix.texi (File System): In mkstemp!, in fact posix doesn't specify
 869         the permissions mode.  Add an example setting 666 less umask.
 870
 871 2005-02-04  Kevin Ryde  <user42@zip.com.au>
 872
 873         * api-io.texi (File Ports): In port-filename, cannot use after close.
 874
 875         * posix.texi (Time): In mktime, clarify fields of sbd-time used, and
 876         the handling of tm:isdst.
 877
 878         * srfi-modules.texi (SRFI-0): Add srfi-4, srfi-13 and srfi-14 now in
 879         the core.
 880
 881 2005-01-29  Kevin Ryde  <user42@zip.com.au>
 882
 883         * posix.texi (Signals): In sigaction, add SA_NOCLDSTOP, make it
 884         clearer SA_RESTART is a variable.
 885
 886 2005-01-28  Kevin Ryde  <user42@zip.com.au>
 887
 888         * srfi-modules.texi (SRFI-1 Predicates): Clarify proper-list?,
 889         circular-list? and dotted-list?, note any object passes exactly one of
 890         those.
 891
 892         * srfi-modules.texi (SRFI-19 Time/Date conversions): In default
 893         tz-offset, note restrictions on a 32-bit system.
 894
 895 2005-01-24  Kevin Ryde  <user42@zip.com.au>
 896
 897         * api-i18n.texi (Internationalization): Expand and revise a bit for
 898         clarity.
 899
 900         * srfi-modules.texi (SRFI-1 Searching): In member, note `=' called arg
 901         order.
 902         (SRFI-1 Set Operations): Remove lset-adjoin!, doesn't exist in the
 903         code or the srfi spec.
 904
 905 2005-01-20  Kevin Ryde  <user42@zip.com.au>
 906
 907         * posix.texi (Ports and File Descriptors): In flock, for LOCK_NB note
 908         logior for LOCK_NB and EWOULDBLOCK error, and note flock doesn't work
 909         over NFS.
 910
 911         * srfi-modules.texi (SRFI-1 Searching): In list-index, note 0 based
 912         index and #f for not found.
 913
 914 2005-01-15  Kevin Ryde  <user42@zip.com.au>
 915
 916         * api-data.texi (Bitwise Operations): In logtest and logbit?, describe
 917         operations in words, not just equivalent expressions.  In
 918         integer-expt, clarify a bit and note negative k allowed and 0^0==1.
 919
 920         * api-data.texi (Random): In random:solid-sphere!, there is no return
 921         value.
 922
 923         * api-evaluation.texi (Loading): In %load-hook, need to use set!, and
 924         describe #f.
 925
 926 2005-01-14  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
 927
 928         * scheme-scripts.texi: Describe new 1.4 compatability behavior of
 929         -e option.
 930
 931 2005-01-14  Kevin Ryde  <user42@zip.com.au>
 932
 933         * api-data.texi (Mapping Folding and Unfolding): In
 934         string-for-each-index, make it clear iteration is over indices.
 935
 936         * posix.texi (User Information): Note cuserid gone from POSIX.
 937         Prompted by Roland Besserer.
 938
 939         * srfi-modules.texi (SRFI-39): New section.
 940
 941 2005-01-10  Kevin Ryde  <user42@zip.com.au>
 942
 943         * srfi-modules.texi: Various index entries.
 944         (SRFI-19 Introduction): Note MJD basis is 2400000.5.
 945         (SRFI-19 Date): In date-second, clarify leap second usage.  In
 946         date-year, note negatives for B.C. and no zero.  In current-date,
 947         don't let it read like it's just UTC which is returned.
 948
 949 2005-01-08  Kevin Ryde  <user42@zip.com.au>
 950
 951         * api-modules.texi (Creating Guile Modules): Expand define-modules
 952         #:autoload, clarify that it's a list of symbols.
 953
 954         * api-modules.texi (Included Guile Modules): Add expect, format, ftw,
 955         getop-long, history, popen, pretty-print, q, readline, receive, regex,
 956         streams, syncase, srfi-16, srfi-19 and srfi-31.  Remove ice-9 jacal,
 957         no such module.
 958
 959         * posix.texi (File System): In mkstemp!, note 0600 creation mode.
 960
 961 2005-01-06  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
 962
 963         * api-compound.texi: Finished(?) the new array API docs.
 964
 965 2005-01-02  Kevin Ryde  <user42@zip.com.au>
 966
 967         * posix.texi (Pipes): Expand and clarify a bit.  Describe port
 968         inheritance.  Caution against waitpid WAIT_ANY.
 969
 970 2004-12-29  Marius Vollmer  <mvo@zagadka.de>
 971
 972         * api-compound.texi (Arrays): Updated for the new 'typed' approach
 973         at creating arrays.
 974
 975 2004-12-28  Kevin Ryde  <user42@zip.com.au>
 976
 977         * api-data.texi (String Predicates): For string-any and string-every,
 978         last chars are now tail calls per srfi, and reinstate char_pred can be
 979         character or character set (somehow lost in cut and paste).
 980
 981         * srfi-modules.texi (SRFI-1 Searching): In any and every, revise for
 982         clarity, note last call in each is a tail call.
 983
 984 2004-12-27  Marius Vollmer  <mvo@zagadka.de>
 985
 986         * api-compound.texi (Vectors, Bit Vectors, Uniform Numeric
 987         Vectors): Updated for the distinction between read-only and write
 988         access to storage locations.
 989
 990 2004-12-22  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
 991
 992         * api-compound.texi (Arrays): Reorganized and 'modernized'.
 993
 994 2004-12-20  Mikael Djurfeldt  <djurfeldt@nada.kth.se>
 995
 996         * expect.texi (Expect): Removed backslash escapes of regexp
 997         operators ( and ) in code example for expect-strings.
 998
 999 2004-12-14  Kevin Ryde  <user42@zip.com.au>
1000
1001         * api-data.texi (Regexp Functions): Revise regex-substitute and
1002         regex-substitute/global for clarity, add some examples.
1003
1004         * api-procedures.texi (lambda* Reference): Revise for clarity, note
1005         how #:rest works with #:key, note previous bindings available to
1006         default expressions.
1007
1008 2004-12-05  Kevin Ryde  <user42@zip.com.au>
1009
1010         * srfi-modules.texi (SRFI-1 Length Append etc): In concatenate, note
1011         equivalence to "apply append".
1012
1013 2004-11-09  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1014
1015         * api-compound.texi (Generalized Vectors): New.
1016         (Bit Vectors): More docs.
1017         (Uniform Vectors): Call them Uniform numeric vectors.
1018
1019 2004-10-29  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1020
1021         * api-compound.texi (Uniform Vectors): Added c32 and c64 docs.
1022
1023 2004-10-27  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1024
1025         * srfi-modules.texi, api-compound.texi: Moved SRFI-4 docs into
1026         main part.  Moved bit vectors out of array section to make them
1027         more visible.
1028
1029 2004-10-19  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1030
1031         * api-smobs.texi (smob mark function): List admissible functions
1032         to call.
1033
1034 2004-10-04  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1035
1036         * api-data.texi: Removed primitive keyword section, updated
1037         keyword docs.
1038
1039         * api-undocumented.texi: Moved keyword dash-symbol docs here.
1040
1041 2004-09-26  Kevin Ryde  <user42@zip.com.au>
1042
1043         * api-data.texi (Conversion to/from C): Braces {} around char* return.
1044         * api-evaluation.texi (Block Comments): More cindex entries.
1045
1046         * guile.texi, misc-modules.texi (Streams): New section.
1047
1048 2004-09-25  Marius Vollmer  <mvo@zagadka.de>
1049
1050         * libguile-smobs.texi, api-smobs.texi: More words abot what a free
1051         function is allowed to do.
1052
1053 2004-09-24  Marius Vollmer  <mvo@zagadka.de>
1054
1055         * libguile-smobs.texi: Bugfix in example code, use SCM_NEWSMOB
1056         correctly.  Use scm_assert_smob_type instead of SCM_ASSERT
1057         baroqueness.
1058
1059 2004-09-23  Marius Vollmer  <mvo@zagadka.de>
1060
1061         * api-i18n.texi: New file.
1062         * Makefile.am (guile_TEXINFOS): Added it.
1063         * guile.texi: Include it.
1064
1065 2004-09-16  Kevin Ryde  <user42@zip.com.au>
1066
1067         * api-utility.texi (Equality): Revise for clarity.
1068
1069 2004-09-08  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1070
1071         * api-data.texi (integer-expt): Updated from docstring.
1072
1073         * Makefile.am (CLEANFILES, MAINTAINERCLEANFILES): Moved
1074         autoconf-macros.texi to MAINTAINERCLEANFILES.  It is in the
1075         tarball and we shouldn't clean it, then.
1076
1077 2004-09-07  Kevin Ryde  <user42@zip.com.au>
1078
1079         * api-procedures.texi (let-keywords Reference): Typo, should be
1080         let-keywords* @defunx.
1081
1082         * api-scheduling.texi (Parallel Forms): In parallel, letpar, par-map,
1083         n-par-map and n-for-each-par-map, describe each form as being in its
1084         own thread, not a new thread, since for instance the calling thread is
1085         used when only one form.  Plus typo in n-for-each-par-map example
1086         equivalent for-each + n-par-map.
1087
1088         * posix.texi (Locales): Use @var for category arg.
1089
1090         * posix.texi (System Identification): Remove software-type, it doesn't
1091         exist in the guile core.
1092
1093         * srfi-modules.texi (SRFI-10): Revise and expand.
1094
1095 2004-09-02  Kevin Ryde  <user42@zip.com.au>
1096
1097         * misc-modules.texi (Formatted Output): Excess arguments are ignored.
1098         In ~*, correction N parameter cannot be negative.  In ~t, note
1099         port-column used.
1100
1101 2004-08-29  Kevin Ryde  <user42@zip.com.au>
1102
1103         * srfi-modules.texi (SRFI-2): Note empty body is #t.
1104
1105 2004-08-25  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1106
1107         * api-data.texi, srfi-modules.texi: Moved docs for SRFI-14 into
1108         main API chapter.  Updated docstrings from libguile/.
1109
1110 2004-08-25  Marius Vollmer  <mvo@zagadka.de>
1111
1112         * api-data.texi, srfi-modules.texi: Moved docs for SRFI-14 into
1113         main API chapter.  Updated docstrings from libguile/.
1114
1115 2004-08-24  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1116
1117         Ran a (docstring-process-module "(guile)") and moved entries from
1118         new-docstrings.texi to their appropriate place.
1119
1120         * api-undocumented.texi: New file.
1121
1122 2004-08-21  Marius Vollmer  <mvo@zagadka.de>
1123
1124         From Richard Todd, Thanks!
1125
1126         * scheme-scripts.texi (Invoking Guile): documented new '-L'
1127         switch.
1128
1129 2004-08-20  Marius Vollmer  <mvo@zagadka.de>
1130
1131         * gh.texi: Updated transition section with new recommended things.
1132
1133 2004-08-19  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1134
1135         * api-data.texi (Strings): Document copy-on-write behavior and
1136         mutation-sharing substrings.
1137         (Symbols): Document scm_from_locale_symbol and
1138         scm_from_locale_symboln.
1139
1140 2004-08-18  Kevin Ryde  <user42@zip.com.au>
1141
1142         * posix.texi (Network Sockets and Communication): Add SOCK_RDM and
1143         SOCK_SEQPACKET.
1144
1145         * posix.texi (Internet Socket Examples): Correction to socket calls,
1146         should be PF_INET not AF_INET (though generally the two are the same
1147         value).
1148
1149 2004-08-14  Kevin Ryde  <user42@zip.com.au>
1150
1151         * api-scheduling.texi (Mutexes): New datatype-centric section, adding
1152         fair mutexes and collecting up material from ...
1153         (Low level thread primitives, Higher level thread procedures, C level
1154         thread interface): ... these nodes.
1155
1156         * srfi-modules.texi (SRFI-13 Predicates): Add string-any and
1157         string-every support for char and charset predicates.
1158
1159 2004-08-11  Marius Vollmer  <mvo@zagadka.de>
1160
1161         * api-data.texi (scm_c_round, scm_c_truncate): Docs for'em.
1162
1163 2004-08-10  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1164
1165         * api-control.texi: Updated example to use scm_to_locale_string
1166         instead of roll-your-own scm_to_string.  Also showcase
1167         scm_frame_free.
1168
1169         * api-data.texi: Docs for scm_is_string, scm_to_locale_string*,
1170         and scm_from_locale_string*.
1171
1172         * api-memory.texi: Docs for scm_frame_free.
1173
1174 2004-08-09  Kevin Ryde  <user42@zip.com.au>
1175
1176         * api-io.texi (File Ports): In open-file, describe the "b" binary flag.
1177
1178         * slib.texi (SLIB): Add notes on delete-file, provided? and open-file
1179         overridden by ice-9 slib module.
1180
1181 2004-08-05  Kevin Ryde  <user42@zip.com.au>
1182
1183         * api-scheduling.texi (Arbiters): Tweak wording for clarity, note any
1184         thread can unlock not just the one which locked.
1185
1186         * posix.texi (Conventions): Describe system-error args, use @defun for
1187         system-error-errno instead of just words.
1188
1189         * srfi-modules.texi (SRFI-13 Predicates): Tweak wording for clarity.
1190         For string-every, note return is #t when no characters.  For
1191         string-any and string-every, note last pred call is not currently a
1192         tail call, contrary to SRFI-13 spec.
1193
1194 2004-08-03  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1195
1196         * api-data.texi: Added scm_is_real, scm_is_rational,
1197         scm_to_double, scm_from_double, numerator, and denominator.  Added
1198         scm_is_complex, scm_is_number, scm_c_make_rectangular,
1199         scm_c_make_polar, scm_c_real_part, scm_c_imag_part,
1200         scm_c_magnitude, and scm_c_angle.
1201
1202 2004-08-02  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1203
1204         * gh.texi: Replaced references to scm_num2* with scm_to_* and
1205         references to scm_*2num with scm_from_*.
1206
1207         Renamed many file to make the structure of the manual more evident
1208         in the names.  Changed all references.
1209
1210         * scheme-binding.texi: Renamed to api-binding.texi.
1211         * scheme-compound.texi: Renamed to api-compound.texi.
1212         * scheme-control.texi: Renamed to api-control.texi.
1213         * scheme-data.texi: Renamed to api-data.texi.
1214         * scheme-debug.texi: Renamed to api-debug.texi.
1215         * deprecated.texi: Renamed to api-deprecated.texi.
1216         * scheme-evaluation.texi: Renamed to api-evaluation.texi.
1217         * ref-init.texi: Renamed to api-init.texi.
1218         * scheme-io.texi: Renamed to api-io.texi.
1219         * scheme-memory.texi: Renamed to api-memory.texi.
1220         * scheme-modules.texi: Renamed to api-modules.texi.
1221         * scheme-options.texi: Renamed to api-options.texi.
1222         * scm.texi: Renamed to api-overview.texi.
1223         * scheme-procedures.texi: Renamed to api-procedures.texi.
1224         * scheme-scheduling.texi: Renamed to api-scheduling.texi.
1225         * scheme-scm.texi: Renamed to api-scm.texi.
1226         * scheme-smobs.texi: Renamed to api-smobs.texi.
1227         * scheme-snarf.texi: Renamed to api-snarf.texi.
1228         * scheme-translation.texi: Renamed to api-translation.texi.
1229         * scheme-utility.texi: Renamed to api-utility.texi.
1230         * debugging.texi: Renamed to scheme-debugging.texi.
1231         * scripts.texi: Renamed to scheme-scripts.texi.
1232         * program.texi: Renamed to libguile-program.texi.
1233
1234         * api-deprecated.texi: Removed.
1235         * intro.texi (Discouraged and Deprecated): General information
1236         about deprecation, etc.
1237
1238 2004-07-30  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1239
1240         * misc-modules.texi (Formatted Output): Changed @w to @w{} in
1241         itemize.  The former doesn't work for some reason...
1242
1243 2004-07-28  Kevin Ryde  <user42@zip.com.au>
1244
1245         * misc-modules.texi (Formatted Output): Rewrite, describing escapes
1246         and parameters in detail.
1247         * guile.texi (@le, @ge): New macros for ifnottex.
1248
1249 2004-07-24  Kevin Ryde  <user42@zip.com.au>
1250
1251         * guile.texi (@nicode): Use @alias instead of @macro, for correct
1252         handling of backslashes.
1253
1254         * scheme-control.texi (Frames): Add @vindex for SCM_F_WIND_EXPLICITLY.
1255
1256         * scheme-data.texi (String Syntax): Add all backslash forms accepted.
1257         (Regexp Functions): Use @defvar for regexp/icase etc, to emphasise
1258         that they're variables not symbols etc.
1259
1260         * scheme-smobs.texi (Smobs): In SCM_SMOB_OBJECT_LOC,
1261         SCM_SMOB_OBJECT_2_LOC, SCM_SMOB_OBJECT_3_LOC, use {} to avoid "*"
1262         getting into the index as part of the macro name.
1263
1264         * srfi-modules.texi (SRFI-0): Revise for clarity, drop BNF in favour
1265         of plain description, emphasise this is just for portable programs.
1266
1267 2004-07-10  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1268
1269         * scheme-data.texi (Integers): Talk more about inexact and exact
1270         integers.
1271
1272 2004-07-10  Kevin Ryde  <user42@zip.com.au>
1273
1274         * srfi-modules.texi (SRFI-0): Add srfi-6 to the identifiers provided
1275         by default.
1276
1277 2004-07-07  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1278
1279         * scheme-data.texi (Integers): Added docs for the new scm_is_,
1280         scm_to_ and scm_from_ functions for integers.
1281
1282         * data-rep.texi (How Guile does it): Mark as being in limbo.  All
1283         the real documentation will be in the nodes "Programming in C" and
1284         "API Reference".
1285         (Boolean Data): Just refer to node "Booleans".
1286
1287         * gh.texi: Replace references to SCM_NFALSEP, etc with
1288         scm_is_true, etc.
1289
1290         * scheme-data.texi (Booleans): Flag all function-like definitions
1291         as "C Functions".
1292
1293 2004-07-06  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1294
1295         * scheme-data.texi: Remove non-R5RS stuff from the 'rn' index.
1296
1297         * scheme-utility.texi: Added scm_is_eq, scm_eq_p, scm_eqv_p, and
1298         scm_equal_p.
1299
1300 2004-07-05  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1301
1302         * scheme-data.texi (Booleans): Added reference entries for
1303         scm_is_true, scm_is_false, scm_is_bool, scm_from_bool, and
1304         scm_to_bool.
1305
1306 2004-06-28  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1307
1308         * Makefile.am: Removed home-grown code for HTML generation.
1309         Automake does it for us now.
1310
1311         * guile.texi, scheme-scm.texi: Do not use TeXinfo markup in
1312         section or node names.
1313
1314 2004-06-20  Rob Browning  <rlb@defaultvalue.org>
1315
1316         * srfi-modules.texi (SRFI-31): add documentation for srfi-31.
1317
1318 2004-05-19  Kevin Ryde  <user42@zip.com.au>
1319
1320         * Makefile.am (CLEANFILES): Remove guile.cps guile.fns guile.rns
1321         guile.tps guile.vrs guile.tmp, cleaned by automake these days.
1322
1323 2004-05-06  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1324
1325         * scheme-smobs.texi: Updated for new SCM_SMOB_* macros.
1326
1327         * preface.texi: Moved around the sections so that the manual
1328         overview comes first.
1329
1330         * libguile-smobs.texi: Updated for the new role of scm_t_bits.
1331
1332 2004-04-21  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1333
1334         * Big reorganization of the whole manual to give it a simpler
1335         structure.
1336
1337 2004-03-25  Kevin Ryde  <user42@zip.com.au>
1338
1339         * slib.texi (SLIB): Amend `require' cross reference node name, is
1340         called "Require" in slib 3a1.
1341
1342 2004-03-23  Kevin Ryde  <user42@zip.com.au>
1343
1344         * scheme-data.texi (Reals and Rationals): Typo in `rationalize'.
1345
1346 2004-03-04  Kevin Ryde  <user42@zip.com.au>
1347
1348         * posix.texi (Processes): Add setgroups.
1349
1350         * srfi-modules.texi (SRFI-26): New section.
1351
1352 2004-02-21  Kevin Ryde  <user42@zip.com.au>
1353
1354         * scheme-evaluation.texi (Expression Syntax): Add @findex entries for
1355         quote and quasiquote no longer using @deffn.
1356
1357 2004-02-20  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1358
1359         * scheme-evaluation.texi (Expression Syntax): Turned syntax
1360         description into a table, @deffn is not really up to the task.
1361
1362 2004-02-18  Marius Vollmer  <mvo@zagadka.de>
1363
1364         * guile.texi: Replaced list of authors with "The Guile
1365         Developers".
1366
1367         * preface.texi (Contributors to the Manual): New section.
1368
1369         * scheme-evaluation.texi (Expression Syntax): Use an empty name
1370         for the function call syntax definition.  Otherwise, TeX complains
1371         about unbalanced parenthesis.
1372
1373 2004-02-18  Kevin Ryde  <user42@zip.com.au>
1374
1375         * scheme-evaluation.texi (Expression Syntax): Fill section with
1376         function calling etc, and quote and quasiquote.
1377
1378         * srfi-modules.texi (SRFI-9): Revise for detail and clarity.  Don't
1379         use ":foo" for example type name, since that depends on the keyword
1380         reading option.
1381
1382 2004-02-15  Mikael Djurfeldt  <mdj@chunk.mit.edu>
1383
1384         * scheme-compound.texi (Hash Table Reference): Wrote a new entry
1385         for hash-for-each-handle.
1386
1387 2004-02-16  Kevin Ryde  <user42@zip.com.au>
1388
1389         * scheme-compound.texi (Sloppy Alist Functions): Amend error messages
1390         shown to match current guile output.
1391
1392 2004-02-15  Mikael Djurfeldt  <mdj@chunk.mit.edu>
1393
1394         * scheme-compound.texi (Hash Table Reference): Renamed hash-map
1395         --> hash-map->list.
1396
1397 2004-02-15  Kevin Ryde  <user42@zip.com.au>
1398
1399         * scheme-compound.texi (Hash Table Reference): In scm_hash_ref etc,
1400         remove note that dflt must be given, it can be SCM_UNSPECIFIED.
1401
1402         * scheme-control.texi (while do): Expand and clarify `do', in
1403         particular note iteration binds fresh locations, rather than values
1404         "stored".
1405
1406         * srfi-modules.texi (SRFI-4): Revise for clarity, give each function
1407         explicitly rather than showing TAG so Emacs info-look can find them,
1408         merge "SRFI-4 - Read Syntax" and "SRFI-4 - Procedures" into just one
1409         node.
1410
1411 2004-02-12  Kevin Ryde  <user42@zip.com.au>
1412
1413         * scheme-compound.texi (Conventional Arrays): Revise for clarity.
1414         In array-equal?, show multiple arguments allowed.
1415         (Uniform Arrays): Remove duplicate array?.
1416         * guile.texi (cross): New macro.
1417
1418         * scheme-compound.texi (Uniform Arrays): Note 1/3 prototype for
1419         doubles is now an exact fraction.
1420
1421         * slib.texi (SLIB): Index entry for replacement `system'.
1422
1423 2004-01-28  Mikael Djurfeldt  <mdj@chunk.mit.edu>
1424
1425         * scheme-compound.texi (Uniform Arrays): Added a FIXME warning
1426         that the 1/3 prototype no longer works.
1427
1428 2004-01-23  Marius Vollmer  <mvo@zagadka.de>
1429
1430         * Makefile.am (guile_TEXINFOS): Added fdl.texi.
1431
1432 2004-01-21  Marius Vollmer  <mvo@zagadka.de>
1433
1434         Added copyright notices to all TeXinfo files.
1435
1436         * fdl.texi: New.
1437         * guile.texi: Include it as an appendix.
1438         * preface.texi: State that the manual is FDL.
1439
1440 2004-01-20  Kevin Ryde  <user42@zip.com.au>
1441
1442         * preface.texi (Guile License): Note readline is GPL and manual has
1443         its own copying terms.  Describe briefly what the licenses mean in
1444         practice.
1445
1446         * scheme-scheduling.texi (Higher level thread procedures): In monitor,
1447         don't let "newly created" suggest a mutex created on every evaluation.
1448         Note what "monitor" means.
1449
1450         * slib.texi (SLIB): Note `system' redefined by (ice-9 slib).  Tweak
1451         `require' example.
1452
1453 2004-01-11  Kevin Ryde  <user42@zip.com.au>
1454
1455         * misc-modules.texi (Queues): New chapter.
1456         * guile.texi (Top): Add it.
1457
1458 2004-01-09  Kevin Ryde  <user42@zip.com.au>
1459
1460         * scheme-compound.texi (Bit Vectors): Revise for clarity, following
1461         report by Rouben Rostamian.  Remove #b() example, that syntax is not
1462         accepted.
1463
1464 2004-01-07  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1465
1466         * scheme-control.texi, scheme-io.tex, scheme-scheduling.texi:
1467         Adapt to new 'frame' names.  Document scm_c_with_fluid,
1468         scm_c_with_fluids, and scm_frame_fluid.
1469
1470 2004-01-06  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1471
1472         * scheme-control.texi: Document scm_on_unwind_with_scm and
1473         scm_on_rewind_with_scm.
1474
1475 2004-01-05  Marius Vollmer  <mvo@zagadka.de>
1476
1477         * scheme-scheduling.texi: Document scm_with_[un]blocked_asyncs.
1478
1479         * scheme-io.texi: Document scm_with_current_<foo>_port.
1480
1481 2004-01-03  Marius Vollmer  <mvo@zagadka.de>
1482
1483         * scheme-control.texi: Document the frames stuff and other random
1484         changes.
1485
1486 2004-01-04  Kevin Ryde  <user42@zip.com.au>
1487
1488         * scheme-scheduling.texi (Threads): Note Guile uses POSIX threads, for
1489         concurrency and preemption.
1490         (C level thread interface): Note periodic libguile call required for C
1491         code in threads, add commented out reminders for SCM_TICK and
1492         guile-mode, for when those features are ready.
1493
1494         * srfi-modules.texi (SRFI-1 Filtering and Partitioning): For partition
1495         and partition!, emphasise the multi-value return, note partition may
1496         share a tail with the given list.
1497
1498         * srfi-modules.texi (SRFI-1 Searching, SRFI-1 Deleting, SRFI-1
1499         Association Lists): Note how member, delete, delete! and assoc extend
1500         the corresponding core functions.
1501
1502 2003-11-25  Kevin Ryde  <user42@zip.com.au>
1503
1504         * tools.texi (Macros guile-snarf recognizes): Correction to GOOPS
1505         cross reference.
1506
1507 2003-11-19  Marius Vollmer  <mvo@zagadka.de>
1508
1509         * scheme-data.texi: Include exact rationals.
1510
1511         From Stephen Compall.  Thanks!
1512
1513         * intro.texi (What is Guile?): Add @acronym for POSIX, R5RS, GUI,
1514         and HTTP.  Conclude linking libguile.  Say what one can find *for*.
1515
1516         * preface.texi (Manual Conventions): Double-quote some statements
1517         formerly single-quoted.  Remove some redundant quotes around code.
1518         Clarify meaning of `iff' further for those that didn't get it the
1519         first time 'round (like me).  Make graphical indicators samples,
1520         not code.  Put results of evaluation on the same line as @result
1521         symbols.  Use @print example as example of total usage, and remind
1522         readers not to forget the difference.
1523
1524 2003-11-17  Marius Vollmer  <mvo@zagadka.de>
1525
1526         * scheme-modules.texi: Document '@' and '@@'.
1527
1528         * scripts.texi: Mention that "-e (@ ...)" also works.
1529
1530 2003-11-15  Kevin Ryde  <user42@zip.com.au>
1531
1532         * scheme-data.texi (Random): Add *random-state* variable, put note at
1533         the top of the node about it being the default, rather than just in
1534         the description of random.
1535
1536 2003-11-13  Marius Vollmer  <mvo@zagadka.de>
1537
1538         * preface.texi (Manual Layout): Wrap POSIX, API, and SLIB in
1539         @acronym.  Change from paragraph format (somewhat clumsy-looking
1540         on paper, at least) to @table format, with headers @strong.  Made
1541         example modules complete sentences.  From Stephen Compall, thanks!
1542
1543 2003-11-09  Kevin Ryde  <user42@zip.com.au>
1544
1545         * misc-modules.texi (Pretty Printing): Add new keyword options, break
1546         example to avoid long line.
1547
1548         * scheme-data.texi (Random): In random, use @code for *random-state*.
1549         Reported by Stephen Compall.
1550
1551         * srfi-modules.texi (SRFI-1 Filtering and Partitioning): Move filter
1552         and filter! ...
1553         * scheme-compound.texi (List Modification): ... to here, now that
1554         they're implemented in the core.
1555
1556 2003-11-03  Kevin Ryde  <user42@zip.com.au>
1557
1558         * misc-modules.texi (File Tree Walk): New chapter.
1559         * guile.texi: Add it.
1560
1561 2003-10-18  Kevin Ryde  <user42@zip.com.au>
1562
1563         * gh.texi (Calling Scheme procedures from C, scm transition summary):
1564         Refer to scm_list_n, not the old name scm_listify.
1565         (scm transition summary): For gh_apply, recommend scm_apply_0, which
1566         is now documented.
1567
1568         * gh.texi (Defining new Scheme procedures in C): Don't use
1569         @strong{Note:}, latest makeinfo will complain it looks like a cross
1570         reference.
1571
1572         * posix.texi (Time): Correction to strftime glibc cross reference
1573         node, now "Formatting Calendar Time".
1574
1575         * srfi-modules.texi (SRFI-1 Searching): In break, note conflict with
1576         binding established by `while'.
1577
1578 2003-10-09  Kevin Ryde  <user42@zip.com.au>
1579
1580         * scheme-compound.texi (Hash Table Reference): Decribe rehashing, note
1581         no hashx-remove!, describe make-hash-table size parameter.
1582
1583 2003-10-06  Marius Vollmer  <mvo@zagadka.de>
1584
1585         * scheme-memory.texi: Added a short explanation of the GC and the
1586         conservative stack scanning.
1587         (scm_gc_protect_object, scm_gc_unprotect_object,
1588         scm_permanent_object): New.
1589
1590         * data-rep.texi, scheme-memory.texi (scm_remember_upto_here_1,
1591         scm_remember_upto_here_2): Moved from data-rep.texi to
1592         scheme-memory.texi.
1593
1594 2003-10-02  Kevin Ryde  <user42@zip.com.au>
1595
1596         * scheme-io.texi (String Ports): In call-with-output-string, note proc
1597         should not close the port.  In get-output-string, note string must be
1598         gotten before closing the port.
1599
1600 2003-09-21  Kevin Ryde  <user42@zip.com.au>
1601
1602         * posix.texi (File System): In access?, reword a bit, clarify real
1603         versus effective ID handling, cross reference glibc on that, and
1604         recommend against access tests in library functions.
1605
1606 2003-09-13  Kevin Ryde  <user42@zip.com.au>
1607
1608         * posix.texi (File System): In stat:dev and stat:mode, clarify that
1609         both are numbers.
1610
1611         * posix.texi (Network Address Conversion): Under IPv4, describe
1612         numeric representation in Guile, add INADDR_LOOPBACK and
1613         INADDR_BROADCAST, add commented-out INADDR_NONE.
1614
1615         * scheme-compound.texi (Append/Reverse): Merge reverse and reverse!,
1616         describe newtail parameter for reverse!, remove confusing caveat about
1617         head becoming tail for reverse!.
1618
1619         * scheme-io.texi (Reading): In port-column, port-line,
1620         set-port-column! and set-port-line!, port parameter must be given,
1621         there's no default to current input.
1622
1623         * scheme-io.texi (Reading): Add scm_c_read.
1624         (Writing): Add scm_c_write.
1625
1626         * srfi-modules.texi (SRFI-1 Constructors): Add list-copy.
1627
1628         * srfi-modules.texi (SRFI-19): Rewrite, adding descriptions of all
1629         functions, and a bit of an introduction.
1630
1631 2003-09-03  Kevin Ryde  <user42@zip.com.au>
1632
1633         * scheme-data.texi (Keyword Primitives): Add examples to
1634         make-keyword-from-dash-symbol and keyword-dash-symbol.  Add
1635         scm_c_make_keyword.
1636
1637         * scheme-data.texi (Symbol Primitives): In gensym, cross reference
1638         uninterned symbols, use @w{} on " g" prefix to avoid any chance of a
1639         line break obscuring it.
1640
1641 2003-08-30  Kevin Ryde  <user42@zip.com.au>
1642
1643         * data-rep.texi (Remembering During Operations): Note
1644         scm_remember_upto_here_1 applies only to C automatic variables.
1645
1646         * guile.texi: Move @contents to usual place after title page, and
1647         after first menu since that looks nice in html.
1648
1649         * posix.texi (Ports and File Descriptors): In pipe PIPE_BUF, use
1650         @defvar, reword a bit for clarity, cross reference glibc.
1651
1652         * posix.texi (Network Sockets and Communication): In socket, use
1653         @defvar for protocol variables, cross reference for getprotobyname,
1654         note it's usually connect and accept that establishes communication.
1655
1656         * posix.texi (Network Sockets and Communication): In socketpair,
1657         clarify the return is a pair with ports in car and cdr, note
1658         connection is full duplex, refer to socket for parameters, refer to
1659         PF_UNIX rather than AF_UNIX.
1660
1661         * scheme-compound.texi (Append/Reverse): Merge append and append!,
1662         shown parameters as lst1 ... lstN, describe list argument for
1663         scm_append and scm_append_x and note that it's unmodified.
1664
1665         * scheme-compound.texi (Hash Table Reference): Add hashx- case
1666         insensitive string example, add cross references to symbol-hash,
1667         string-hash, string-hash-ci, and char-set-hash.
1668
1669         * scheme-control.texi (Multiple Values): In values, show args as "arg1
1670         ... argN".  In scm_values, note args is a list and returned object
1671         shares structure with it.
1672
1673         * scheme-control.texi (Catch): Add scm_internal_catch.
1674         (Lazy Catch): Add scm_internal_lazy_catch.
1675
1676         * scheme-data.texi (Arithmetic): Use a table for scheme to C libm
1677         equivalences, add C99 trunc.
1678
1679         * scheme-procedures.texi (Lambda): Note ". rest" list argument is
1680         always newly created.
1681
1682         * srfi-modules.texi (SRFI-1 Association Lists): In alist-delete and
1683         alist-delete!, note argument order for the equality calls per SRFI-1
1684         spec.
1685
1686 2003-08-26  Kevin Ryde  <user42@zip.com.au>
1687
1688         * scheme-data.texi (Scientific): Add two-argument atan.
1689
1690         * tools.texi (How guile-snarf works): Need @@ for texinfo in example.
1691
1692 2003-08-17  Kevin Ryde  <user42@zip.com.au>
1693
1694         * scheme-compound.texi (Hash Table Reference): Collect up groups of
1695         functions to avoid duplication.  Revise notes on hashx functions and
1696         on vector implementation.  In make-hash-table, size is now optional.
1697         Add hash-map and hash-for-each.
1698
1699 2003-08-14  Kevin Ryde  <user42@zip.com.au>
1700
1701         * scheme-control.texi (while do): Update `while' for code rewrite, in
1702         particular describe break and continue.
1703
1704 2003-08-09  Kevin Ryde  <user42@zip.com.au>
1705
1706         * scheme-memory.texi (Memory Blocks): Add index entries for deprecated
1707         scm_must_malloc and friends.
1708
1709 2003-07-29  Kevin Ryde  <user42@zip.com.au>
1710
1711         * scheme-compound.texi (List Constructors): Remove scm_cons_star,
1712         since it's not very helpful.
1713
1714         * scheme-utility.texi (Property Primitives): In primitive-property-ref,
1715         note parameters to not-found-proc, use hyphens rather than underscores
1716         for that parameter name.
1717         In primitive-property-set!, VAL is the value parameter not CODE.
1718
1719 2003-07-24  Kevin Ryde  <user42@zip.com.au>
1720
1721         * scheme-control.texi (Dynamic Wind): Untabify.
1722         (Multiple Values): Use @result.
1723         Reported by Stephen Compall <s11@member.fsf.org>.
1724
1725         * scheme-control.texi (Continuations): Rewrite with more detail.
1726
1727         * scheme-scheduling.texi (System asyncs): Add index entries for C
1728         functions.
1729
1730         * scheme-scheduling.texi (Parallel Forms): New section.
1731
1732 2003-07-18  Kevin Ryde  <user42@zip.com.au>
1733
1734         * scheme-compound.texi (List Constructors): In list, use "elem1
1735         ... elemN".  Add scm_list_1, scm_list_2, scm_list_3, scm_list_4,
1736         scm_list_5, scm_list_n.  Remove scm_list, since it's a no-op.
1737         * guile.texi (nicode): New macro.
1738
1739         * scheme-evaluation.texi (Fly Evaluation): In apply, reword for
1740         clarity, drop the "append" example.  Add scm_apply, scm_apply_0,
1741         scm_apply_1, scm_apply_2, scm_apply_3.
1742         Add scm_call_0, scm_call_1, scm_call_2, scm_call_3.
1743         In apply:nconc2last, move down after "apply", reword for clarity, note
1744         correspondence to apply params.
1745
1746         * srfi-modules.texi (SRFI-0): Add cond-expand index entry.
1747         (SRFI-9): Add define-record-type index entry.
1748
1749 2003-07-12  Kevin Ryde  <user42@zip.com.au>
1750
1751         * srfi-modules.texi (SRFI-1 Constructors): In iota, reword a bit for
1752         clarity and add a couple of examples.
1753
1754 2003-07-10  Kevin Ryde  <user42@zip.com.au>
1755
1756         * deprecated.texi (Deprecated): Add scm_remember.
1757
1758 2003-06-22  Kevin Ryde  <user42@zip.com.au>
1759
1760         * data-rep.texi (Remembering During Operations): Refer to all "Guile
1761         library functions" as provoking gc.
1762
1763 2003-06-19  Kevin Ryde  <user42@zip.com.au>
1764
1765         * scheme-io.texi (File Ports): Describe call-with-input-file and
1766         call-with-output-file together.  Describe with-input-from-file,
1767         with-output-to-file and with-error-to-file together, and add that they
1768         use dynamic-wind on the current port setting and keep the port open in
1769         support of captured continuations.
1770         (Closing): Describe close-input-port and close-output-port together,
1771         tweak the wording slightly.
1772
1773 2003-06-14  Kevin Ryde  <user42@zip.com.au>
1774
1775         * data-rep.texi (Vector Data): For SCM_VECTOR_BASE, SCM_STRING_CHARS
1776         and SCM_SYMBOL_CHARS, cross reference "Remembering During Operations".
1777
1778         * scheme-data.texi (Arithmetic): round is to nearest even.
1779
1780 2003-06-12  Kevin Ryde  <user42@zip.com.au>
1781
1782         * data-rep.texi (Remembering During Operations): New section.
1783
1784         * scheme-data.texi (Primitive Numerics): Add atan2, pow, asinh, acosh
1785         and atanh to scheme<->C table.  Note asinh, acosh and atanh are C99,
1786         and scm_asinh, scm_acosh and scm_atanh are equivalents.  Cross ref
1787         glibc "Mathematics".  Reword this end part for clarity.
1788
1789         * scheme-memory.texi (Memory Blocks): Use {} around types for
1790         @deftypefn, for correct name in indexes.
1791         * scheme-utility.texi (C Hooks): Ditto.
1792         * gh.texi (Scheme to C): Ditto.
1793
1794         * gh.texi (Scheme to C): In gh_scm2newstr, lenp is size_t* not int*.
1795         This changed in guile 1.6, the docs weren't updated.
1796
1797 2003-06-09  Marius Vollmer  <mvo@zagadka.de>
1798
1799         From Mike Gran <spikegran@earthlink.net>.  Thanks!
1800
1801         * preface.texi: Minor punctuation mistakes.  Hyphens should link
1802         compound adjectives.  Commas should be placed after a "therefore"
1803         that begins a sentence.  Commas should not be used to separate a
1804         list of only 2 dependent clauses.
1805
1806 2003-06-07  Kevin Ryde  <user42@zip.com.au>
1807
1808         * scheme-data.texi (Arithmetic): Cross reference glibc floor and ceil.
1809
1810 2003-06-05  Kevin Ryde  <user42@zip.com.au>
1811
1812         * posix.texi (File System): stat:rdev and stat:blocks can return #f,
1813         stat:blksize returns a sensible size if the field is not available.
1814
1815         * scheme-compound.texi (Array Mapping): Reword for clarity, and in
1816         particular have the same parameter names in the text and prototypes.
1817
1818         * scheme-evaluation.texi (Delayed Evaluation): Add delay, reword
1819         promise? and force a bit, describe recursive forcing of a promise by
1820         its own code.
1821
1822         * scheme-io.texi (Ports): Add notes on garbage collection, and on
1823         explicitly closing file ports.
1824         (File Ports): Cross reference Ports node on explicit closing.
1825
1826         * posix.texi (Network Sockets and Communication): Cross reference
1827         Ports node on explicit closing.
1828
1829         * scheme-scheduling.texi (Futures): New section.
1830
1831         * srfi-modules.texi (SRFI-13 Miscellaneous): In string-replace, note
1832         that start1 and end1 optional is a Guile extension.
1833
1834 2003-05-30  Kevin Ryde  <user42@zip.com.au>
1835
1836         * deprecated.texi: Add substring-move-left! and substring-move-right!.
1837
1838         * scheme-io.texi (Default Ports): Remove duplicate descriptions of
1839         set-current-output-port and set-current-error-port.
1840
1841 2003-05-27  Dirk Herrmann  <D.Herrmann@tu-bs.de>
1842
1843         * scheme-compound.texi: Clarified that vectors need to be quoted.
1844
1845 2003-05-26  Kevin Ryde  <user42@zip.com.au>
1846
1847         * posix.texi (Locales): Clarify setlocale a bit, list all categories,
1848         cross reference to libc.
1849
1850 2003-05-24  Kevin Ryde  <user42@zip.com.au>
1851
1852         * scheme-procedures.texi: Add index entries lambda, optargs, syncase.
1853
1854         * scsh.texi (The Scheme shell (scsh)): Add index entries.
1855
1856 2003-05-22  Kevin Ryde  <user42@zip.com.au>
1857
1858         * srfi-modules.texi (SRFI-2): Rewrite and-let*, describing plain
1859         expression clauses and improving the examples.
1860
1861 2003-05-17  Marius Vollmer  <mvo@zagadka.de>
1862
1863         * posix.texi (socket): Use PF_ instead of AF_ prefix.
1864
1865 2003-05-16  Kevin Ryde  <user42@zip.com.au>
1866
1867         * guile.texi: Use @copying, show copyright and permissions at start of
1868         info and html.
1869
1870         * srfi-modules.texi (SRFI-1 Deleting): Rewrite delete and
1871         delete-duplicates, adding behaviour details specified by srfi-1.
1872
1873 2003-05-12  Kevin Ryde  <user42@zip.com.au>
1874
1875         * preface.texi (Guile License): Refer to COPYING.LIB.
1876
1877         * repl-modules.texi (Loading Readline Support, Readline Options):
1878         Index entries for readline functions.
1879
1880         * scheme-control.texi (Handling Errors): Fix regexp error key, should
1881         be `regular-expression-syntax'.
1882
1883         * scheme-data.texi (Complex): Show z argument in prototypes.
1884
1885 2003-05-10  Kevin Ryde  <user42@zip.com.au>
1886
1887         * scheme-data.texi (Reals and Rationals): Fix typo @result{#f}, and
1888         put @result outside @code.
1889
1890         * scheme-data.texi (Bitwise Operations): Note negatives are treated as
1891         infinite precision twos complement.  Revise `ash' to emphasise this
1892         for right shifts of negatives.  Describe integer-length behaviour on
1893         negatives.  Add `...' to logand, logior, logxor since they take
1894         multiple parameters.
1895         * guile.texi (m): New macro.
1896
1897         * scheme-control.texi (Handling Errors): Revise C support section to
1898         get index entries, and clarify parameters.  Remove scm_regex_error, no
1899         longer exists and wasn't available to applications.
1900
1901         * scheme-control.texi (Handling Errors): Index entries for error keys.
1902
1903 2003-05-08  Kevin Ryde  <user42@zip.com.au>
1904
1905         * scheme-data.texi (Bitwise Operations): Fix lognot to ones-complement.
1906
1907         * slib.texi (JACAL): Fix @ref title.
1908         Add index entries, use @file and @code variously.
1909
1910 2003-05-06  Kevin Ryde  <user42@zip.com.au>
1911
1912         * scheme-scheduling.texi (C level thread interface): Use @deftypefn
1913         not @deftypefun, to get function names (not types) indexed.
1914
1915         * scheme-options.texi (Build Config): Add index entries for
1916         %guile-build-info keys.
1917
1918 2003-05-04  Kevin Ryde  <user42@zip.com.au>
1919
1920         * scheme-data.texi (Integer Operations): Describe how quotient,
1921         remainder and modulo round their results.
1922
1923         * scheme-io.texi (Reading): In read-char and peek-char, fix typos "?"
1924         in @rnindex.  In port-column, use @: after i.e.
1925         (Writing): In get-print-state, two spaces after full stop.  Add write,
1926         revise display.
1927
1928         * srfi-modules.texi (SRFI-1 Length Append etc): Add count.
1929         (SRFI-1 Fold and Map): In reduce, fix typo "... variant of fold", add
1930         "f" to fold call shown.  In reduce-right, use @code on "reduce".
1931
1932         * data-rep.texi, gh.texi: Add spaces after some @defun names.
1933         * posix.texi (Processes): Fix typo "hhhh".
1934
1935 2003-05-01  Neil Jerram  <neil@ossau.uklinux.net>
1936
1937         * posix.texi: Add index entries for many variables and functions,
1938         either using @defvar/@deffn or @vindex/@pindex.  (Patch supplied
1939         by Kevin Ryde.)
1940
1941 2003-04-30  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
1942
1943         * posix.texi (scm_c_port_for_each): Added.
1944
1945 2003-04-26  Neil Jerram  <neil@ossau.uklinux.net>
1946
1947         * scheme-data.texi (Symbol Primitives): Document scm_str2symbol
1948         and scm_mem2symbol.
1949
1950         * data-rep.texi (Describing a New Type): Clarify that
1951         scm_make_smob_type_mfpe is deprecated.  (Thanks to
1952         tomas@fabula.de.)
1953
1954         * scheme-control.texi (Handling Errors): Remove scm_sysmissing,
1955         long since gone from libguile.  (Thanks to Kevin Ryde.)
1956
1957 2003-04-23  Rob Browning  <rlb@defaultvalue.org>
1958
1959         * posix.texi (Processes): add documentation for system*.
1960
1961 2003-04-05  Marius Vollmer  <mvo@zagadka.de>
1962
1963         * preface.texi: Reflect change to LGPL.
1964
1965 2003-03-27  Rob Browning  <rlb@defaultvalue.org>
1966
1967         * scheme-io.texi (Reading): clarify character ordering in port for
1968         unread-string.
1969
1970 2003-03-07  Rob Browning  <rlb@defaultvalue.org>
1971
1972         * guile.texi: change MANUAL_EDITION to MANUAL-EDITION so we don't
1973         choke TeX (thanks to Dale P. Smith).
1974
1975         * preface.texi: change MANUAL_EDITION to MANUAL-EDITION so we
1976         don't choke TeX (thanks to Dale P. Smith).
1977
1978 2003-01-02  Mikael Djurfeldt  <djurfeldt@nada.kth.se>
1979
1980         * scheme-scheduling.texi (Low level thread primitives): Fixed typo
1981         in broadcast-condition-variable.
1982
1983 2002-12-08  Rob Browning  <rlb@defaultvalue.org>
1984
1985         * scheme-options.texi (Build Config): add effective-version docs.
1986
1987 2002-11-17  Neil Jerram  <neil@ossau.uklinux.net>
1988
1989         Applied patches from Stephen Compall as follows.  (Thanks!)
1990
1991         2002-11-06  Stephen Compall  <rushing@sigecom.net>
1992
1993         * posix.texi: Changed quotes to match Texinfo expectations.
1994
1995         Added references to the glibc manual.
1996
1997         Used proper Texinfo text marking for many keywords, such as @code,
1998         @samp, @env, @var.
1999
2000         Fixed argument metasyntactic variable references in
2001         file-manipulation section so the usage in the descriptions matches
2002         the usage in the declarations.
2003
2004         2002-10-26  Stephen Compall  <rushing@sigecom.net>
2005
2006         * scheme-data.texi: Addition and change of many Texinfo tags,
2007         particularly usage of @var and @samp, as well as reformatting of
2008         some lists into tables and usage of @result.
2009
2010         Notes about some things I didn't understand, as well as a
2011         missing section on non-control characters.
2012
2013 2002-10-27  Gary Houston  <ghouston@arglist.com>
2014
2015         * scheme-modules.texi (Environments): only available when
2016         (ice-9 r5rs) is used.
2017         * scsh.texi (The Scheme shell (scsh)): current url is www.scsh.net.
2018
2019 2002-10-27  Marius Vollmer  <mvo@zagadka.ping.de>
2020
2021         * scheme-scheduling.texi: Updated mutex and condition varable
2022         functions.
2023
2024 2002-10-27  Neil Jerram  <neil@ossau.uklinux.net>
2025
2026         * debugging.texi (Debugging Features): Rewritten.
2027
2028 2002-10-19  Neil Jerram  <neil@ossau.uklinux.net>
2029
2030         * new-docstrings.texi, scheme-binding.texi, scheme-io.texi,
2031         scheme-scheduling.texi, posix.texi: Automatic docstring updates.
2032
2033 2002-10-14  Marius Vollmer  <mvo@zagadka.ping.de>
2034
2035         * intro.texi (Whirlwind Tour): Added pointer to examples
2036         directory.
2037
2038 2002-10-10  Marius Vollmer  <mvo@zagadka.ping.de>
2039
2040         * scheme-scheduling.texi (System Asyncs): Updated.
2041
2042 2002-10-07  Marius Vollmer  <mvo@zagadka.ping.de>
2043
2044         * scheme-scheduling.texi (Asyncs): Updated.
2045         * posix.texi (sigaction): Updated.
2046
2047 2002-10-03  Neil Jerram  <neil@ossau.uklinux.net>
2048
2049         * posix.texi (Processes), scheme-options.texi (Common Feature
2050         Symbols): Refer to provided?  rather than deprecated feature?.
2051
2052 2002-10-03  Marius Vollmer  <mvo@zagadka.ping.de>
2053
2054         * tools.texi (How guile-snarf works): Updated.
2055         (Writing your own snarfing macros): New.
2056
2057 2002-09-25  Neil Jerram  <neil@ossau.uklinux.net>
2058
2059         * scheme-debug.texi (Debugging): Make sections into nodes.
2060         (Debugging Options): Node removed.
2061
2062         * scheme-options.texi (Feature Tracking): Brought forward before
2063         sections on options.
2064         (Runtime Options): New section, to group options-related nodes.
2065
2066 2002-09-24  Neil Jerram  <neil@ossau.uklinux.net>
2067
2068         * scheme-options.texi (Options and Config): Chapter name changed,
2069         and intro text improved.
2070         (Install Config): Brought forward, and renamed Build
2071         Configuration.
2072
2073         The following doc updates are from Ian Sheldon - thanks!
2074
2075         * scheme-data.texi (Appending Strings, Regexp Functions, Match
2076         Structures): Add examples.
2077         (Regular Expressions): Add instruction to use (ice-9 regex)
2078         module.
2079
2080         * slib.texi (SLIB): Remove duplicate `the'.
2081
2082 2002-09-22  Neil Jerram  <neil@ossau.uklinux.net>
2083
2084         * scheme-options.texi (General option interface): Mention
2085         eval-options-interface and debug-options-interface.
2086
2087         * scheme-debug.texi (Debugging): New node describing source
2088         properties.
2089
2090 2002-09-19  Neil Jerram  <neil@ossau.uklinux.net>
2091
2092         * scheme-utility.texi (Hook Reference): Improvements to hook docs.
2093         Thanks to Thien-Thi Nguyen for the patches.
2094
2095 2002-09-16  Marius Vollmer  <mvo@zagadka.ping.de>
2096
2097         * scheme-data.texi (Symbol Props): It's "set-symbol-property!",
2098         not "set-symbol-property".  Thanks to Pieter Pareit!
2099
2100 2002-09-15  Marius Vollmer  <mvo@zagadka.ping.de>
2101
2102         * scheme-data.texi: Tell them to use 'provided?' instead of
2103         '*feaures*'.
2104
2105 2002-09-09  Marius Vollmer  <mvo@zagadka.ping.de>
2106
2107         * scheme-ideas.texi (Creating a Procedure): Fixed typo.  Thanks to
2108         Pieter Pareit!
2109
2110         * intro.texi: Updated GNu ftp server name.  Use "-lguile" instead
2111         of "libguile.a".  Some small fixes/improvements.
2112
2113         * scheme-reading.texi: Added www.schemers.org.  Removed foldoc,
2114         it's too generic.  Updated 'teach yourself ...' URL.
2115
2116 2002-08-27  Marius Vollmer  <mvo@zagadka.ping.de>
2117
2118         * scheme-modules.texi: Markup fixes and removal of gh_ references.
2119         Thanks to Dale Smith!
2120
2121 2002-08-14  Marius Vollmer  <mvo@zagadka.ping.de>
2122
2123         * scheme-evaluation.texi (eval-string): Updated.
2124
2125         * scheme-scheduling.texi (Fluids): Touched up a bit, added
2126         with-fluids.
2127
2128 2002-08-13  Marius Vollmer  <mvo@zagadka.ping.de>
2129
2130         * scheme-modules.texi (More Modules Procedures): Removed.
2131         (Accessing Modules from C): New.
2132
2133 2002-08-10  Gary Houston  <ghouston@arglist.com>
2134
2135         * scheme-procedures.texi: new section Primitive Procedures,
2136         documentation for scm_c_make_gsubr and scm_c_define_gsubr.
2137         * scheme-modules.texi (Compiled Code Modules): replace
2138         gh_new_procedure with scm_c_define_gsubr.
2139
2140 2002-08-08  Neil Jerram  <neil@ossau.uklinux.net>
2141
2142         * gh.texi (Data types and constants defined by gh): Avoid
2143         generating index entry for SCM.
2144
2145         * posix.texi (Runtime Environment): Remove duplicate doc for
2146         setenv.
2147
2148         * data-rep.texi, scheme-memory.texi, scheme-modules.texi: Merge
2149         recent updates from stable branch.
2150
2151         * posix.texi (File System, Time, Pipes, Network Databases,
2152         Internet Socket Examples): Add examples provided by Ian Sheldon.
2153
2154 2002-08-08  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
2155
2156         * scheme-binding.texi: Don't talk about 'bound?' which is gone.
2157         Thanks to Christopher Cramer.
2158
2159 2002-08-06  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
2160
2161         * scheme-memory.texi (Memory Blocks): add scm_calloc, scm_gc_calloc.
2162         correct typos.
2163
2164 2002-08-05  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
2165
2166         * intro.texi, srfi-modules.texi: Added (use-modules (ice-9
2167         rdelim)) to an example that uses read-line.  Thanks to Ralf
2168         Mattes!
2169
2170         * scheme-memory.texi: Added an introductory blurb about GC that I
2171         had lying around.
2172
2173 2002-08-02  Gary Houston  <ghouston@arglist.com>
2174
2175         * scheme-modules.texi: split "Scheme and modules" into
2176         "provide and require" and "Environments".  Mention R5RS
2177         environments.
2178
2179 2002-07-16  Neil Jerram  <neil@ossau.uklinux.net>
2180
2181         * scheme-options.texi (Debugger options): New subsection
2182         describing stack overflow and what to do about it.
2183
2184 2002-07-10  Gary Houston  <ghouston@arglist.com>
2185
2186         * scheme-modules.texi (Compiled Code Modules): Removed description
2187         of scm_register_module_xxx, which no longer exists.  A description
2188         of current techniques is needed.
2189
2190 2002-05-09  Marius Vollmer  <mvo@zagadka.ping.de>
2191
2192         * scheme-data.texi (Numbers): Added description of the new values
2193         +inf.0, -inf.0 and +nan.0.
2194
2195         * posix.texi (Runtime Environment): Added entries for 'setenv' and
2196         'unsetenv'.
2197
2198 2002-04-28  Marius Vollmer  <mvo@zagadka.ping.de>
2199
2200         * gh.texi, data-rep.texi: Moved `@deftyp {Data type} SCM' line
2201         from gh.texi to data-rep.texi.  Both files already had similar
2202         descriptions for SCM.  Given that gh.texi is deprecated, looking
2203         up `SCM' in the index should take one to the primary location
2204         rather than deprecated section.  Hence this change.  Added
2205         `@deftp' for scm_t_bits data type so that a proper index entry is
2206         added for this.  Thanks to Richard Y. Kim!
2207
2208         * data-rep.texi (Subrs): Changed scm_make_gsubr to
2209         scm_c_define_gsubr.  Thanks to Richard Y. Kim!
2210
2211 2002-04-24  Marius Vollmer  <mvo@zagadka.ping.de>
2212
2213         * srfi-modules.texi (SRFI-13 Miscellaneous): Updated docs of
2214         string-tokenize.
2215
2216 2002-04-20  Neil Jerram  <neil@ossau.uklinux.net>
2217
2218         * scheme-intro.texi (Scheme Layout), scm.texi (Reference Layout):
2219         Node moved from a to b.
2220
2221         * guile.texi (Scheme Intro, Basic Ideas, Guile Scripting, Command
2222         Line Handling, Debugging Features, Autoconf Support, Miscellaneous
2223         Tools, Further Reading): Moved to new Part II.
2224
2225         * preface.texi (Manual Layout): Part numbers updated accordingly.
2226
2227         * guile.texi (Top): Move API Overview node to beginning of Guile
2228         API Reference part.
2229         (Part II: Writing and Running Guile Scheme): New part; will
2230         contain content from `Programming with Guile' that pertains to
2231         writing and using Guile on the Scheme level.
2232
2233         * scm.texi (API Overview): Renamed from `Guile API'.
2234
2235         * guile.texi (Top), scheme-modules.texi (Included Guile Modules):
2236         Debugger User Interface node renamed Debugging Features.
2237
2238         * debugging.texi (Stacks and Frames): Node deleted; non-duplicated
2239         material moved to scheme-debug.texi.
2240         (Debugging Features): Renamed from `Debugger User Interface'.
2241
2242         * scheme-debug.texi (Debugging): Rename chapter `Debugging
2243         Infrastructure' and reorganize its contents.
2244
2245         * scheme-debug.texi (Debugging), scheme-control.texi (Handling
2246         Errors): Move display-error to error-focussed section.
2247
2248         * scheme-debug.texi (Debugging), debugging.texi (Backtrace): Move
2249         backtrace to user-level debugging chapter.
2250
2251         * scheme-debug.texi (Debugging), scheme-procedures.texi (Procedure
2252         Properties): Move procedure-name, procedure-source and
2253         procedure-environment to procedures chapter.
2254
2255         * scheme-debug.texi (Debugging), scheme-memory.texi (Memory
2256         Blocks): Move malloc-stats to memory management chapter.
2257
2258         * scheme-procedures.texi (Syntax Rules): Remove mention of
2259         use-modules for loading syncase; only use-syntax really works.
2260         Thanks to Panagiotis Vossos for spotting this.
2261
2262         * program.texi (Scheme vs C): New node, with existing material
2263         taken from chapter intro.
2264         (Programming Overview): New intro para to introduce example of
2265         Guile integration:
2266         (Extending Dia): New node.
2267
2268 2002-04-17  Marius Vollmer  <mvo@zagadka.ping.de>
2269
2270         * Makefile.am (CLEANFILES): Added guile.cps, guile.fns, guile.rns,
2271         guile.tps, guile.vrs, guile.tmp.
2272
2273 2002-04-01  Neil Jerram  <neil@ossau.uklinux.net>
2274
2275         * scheme-intro.texi (Scheme Layout): Remove reference to defunct
2276         Guile Extensions index.
2277
2278         * guile.texi: Removed Guile Extensions index.
2279
2280         * scheme-indices.texi (Guile Extensions Index): Removed.
2281
2282         * guile.texi: Remove vgone, vdeprecated, vchanged and vnote
2283         macros; they're not actually useful after all.  Update copyright
2284         years.
2285
2286         * scheme-compound.texi (Vectors): Make subsections into nodes.
2287         (Vectors): Review, slightly reorg and clarify docs in this
2288         section.
2289
2290         * scheme-data.texi (Symbols): Reorganized node substructure and
2291         added lots of explanatory text around the @deffn's.
2292
2293 2002-03-29  Neil Jerram  <neil@ossau.uklinux.net>
2294
2295         * scheme-modules.texi (Variables): Mention obarrays.
2296
2297         * scheme-data.texi (Symbol Tables, Symbol Props): Remove vgone
2298         markers for deprecated symbol items.
2299         (Symbol Props): Remove doc for obsolete 2 arg version of
2300         symbol-interned?.
2301         (String Miscellanea): Removed, since it only contained duplicate
2302         doc for string-ci->symbol.
2303         (Symbol Tables): Move doc for gensym to Symbol Primitives; rest of
2304         section removed.
2305
2306         * posix.texi (Ports and File Descriptors), scheme-evaluation.texi
2307         (Fly Evaluation): Remove vgone markers for close-all-ports-except,
2308         eval2 and read-and-eval!.
2309
2310         * data-rep.texi (Describing a New Type), scheme-compound.texi
2311         (Append/Reverse), scheme-procedures.texi (Internal Macros):
2312         Trivial updates to sync with stable branch.
2313
2314 2002-03-27  Neil Jerram  <neil@ossau.uklinux.net>
2315
2316         * scheme-compound.texi (List Searching): Remove docs for
2317         `scm_sloppy_mem*', which no longer exist.
2318
2319 2002-03-24  Neil Jerram  <neil@ossau.uklinux.net>
2320
2321         * guile.texi (Top), intro.texi (What is Guile?, The Basic Guile
2322         Package): Use @ifnottex instead of @ifinfo, so that HTML
2323         generation works correctly.
2324
2325 2002-03-24  Marius Vollmer  <mvo@zagadka.ping.de>
2326
2327         * tools.texi: Updated to reflect changes to the guile-snarf tool.
2328
2329 2002-03-16  Neil Jerram  <neil@ossau.uklinux.net>
2330
2331         * scheme-utility.texi (Hooks): Further updates.  New material on
2332         GC hooks.
2333
2334         * scheme-evaluation.texi (Fly Evaluation): Note disappearance of
2335         eval2 and read-and-eval!.
2336
2337         * deprecated.texi (Deprecated): Remove docs about previously
2338         deprecated items that have now been removed.
2339
2340 2002-03-15  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2341
2342         * tools.texi (guile-1.4 guile-snarf): Remove this node.
2343         (How guile-snarf works): Update usage and description to
2344         no longer mention "--compat=1.4" and instead "-d" and "-D".
2345         (Macros guile-snarf recognizes): Add list of deprecated macros
2346         and blurb.  Add cindex for deprecated macros.
2347
2348 2002-03-15  Neil Jerram  <neil@ossau.uklinux.net>
2349
2350         * scheme-utility.texi (Hooks): Reviewed and updated.
2351
2352         * scheme-options.texi (Feature Tracking): New section.
2353
2354         * scheme-data.texi (Arithmetic, Primitive Numerics): Add
2355         description of corresponding C functions.
2356
2357         * scheme-utility.texi (Object Properties): Revamp documentation on
2358         object properties.
2359
2360         * scheme-memory.texi (Weak References): Update reference to Object
2361         Properties node.
2362
2363         * guile.texi: Add macros for describing version information.
2364
2365         * scheme-data.texi, scheme-debug.texi, scheme-io.texi,
2366         scheme-procedures.texi: Automatic updates from snarfed libguile
2367         docstrings.
2368
2369 2002-03-13  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2370
2371         * Makefile.am (guile_toc.html): Look for guile.texi in $(srcdir).
2372
2373         * tools.texi (How guile-snarf works): Mention "--compat=1.4", and
2374         new processing steps.  Update usage example, makefile frag.
2375
2376         (guile-1.4 guile-snarf): New subsubsection under
2377         "Init Snarfing with guile-snarf".
2378
2379 2002-03-12  Neil Jerram  <neil@ossau.uklinux.net>
2380
2381         * scheme-compound.texi, scheme-data.texi, new-docstrings.texi:
2382         Automatic updates from snarfed libguile docstrings.
2383
2384         * data-rep.texi, guile.texi, scheme-evaluation.texi,
2385         scheme-options.texi, scheme-translation.texi: Various minor
2386         enhancements ported from the stable CVS branch.
2387
2388 2002-03-08  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2389
2390         * tools.texi (Miscellaneous Tools): New node/chapter.
2391         (Snarfing, Init Snarfing with guile-snarf, How guile-snarf works,
2392         Macros guile-snarf recognizes, Doc Snarfing): New nodes/(sub)sections.
2393         (Executable Modules): Now a section under "Miscellaneous Tools".
2394
2395         * guile.texi (Miscellaneous Tools): Add under "Part II".
2396         Implement by including tools.texi.
2397
2398         * Makefile.am (guile_TEXINFOS): Add tools.texi.
2399
2400 2002-03-07  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2401
2402         * tools.texi: New file.
2403
2404 2002-03-03  Neil Jerram  <neil@ossau.uklinux.net>
2405
2406         * autoconf.texi (Autoconf Background): Insert missing `of'.
2407
2408 2002-03-01  Dirk Herrmann  <D.Herrmann@tu-bs.de>
2409
2410         * api.txt, data-rep.texi: Renamed the struct scm_cell to
2411         scm_t_cell.
2412
2413         * data-rep.texi: Renamed scm_alloc_cell to scm_cell and
2414         scm_alloc_double_cell to scm_double_cell.
2415
2416 2002-03-01  Marius Vollmer  <mvo@zagadka.ping.de>
2417
2418         * scheme-memory.texi (Upgrading from scm_must_malloc et al): New
2419         section.
2420
2421 2002-02-28  Marius Vollmer  <mvo@zagadka.ping.de>
2422
2423         * data-rep.texi: Use scm_gc_malloc and scm_gc_free instead of
2424         scm_must_malloc and free in example code.  Updated text for the
2425         new memory management functions.
2426
2427         * scheme-debug.texi (malloc-stats): Refer to scm_gc_malloc instead
2428         of to scm_must_malloc.
2429
2430 2002-02-27  Stefan Jahn  <stefan@lkcc.org>
2431
2432         * gh.texi (scm transition summary): Documented some more
2433         gh equivalents and removed appropriate FIXME's.
2434
2435 2002-02-26  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2436
2437         * Makefile.am: Update path to pre-inst-guile automake frag.
2438
2439 2002-02-24  Rob Browning  <rlb@defaultvalue.org>
2440
2441         * .cvsignore: add autoconf-macros.texi.
2442
2443         * Makefile.am (CLEANFILES): add autoconf-macros.texi.
2444
2445 2002-02-19  Marius Vollmer  <mvo@zagadka.ping.de>
2446
2447         * scheme-memory.texi (Memory Blocks): New section.
2448
2449 2002-02-05  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2450
2451         * Makefile.am: Include $(top_srcdir)/pre-inst-guile.am.
2452
2453         (GUILE): Delete var.
2454         (autoconf-macros.texi): Use $(preinstguiletool).
2455
2456 2002-02-04  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2457
2458         * autoconf.texi (Autofrisk, Using Autofrisk): New sections.
2459         (Autoconf Support): Add new sections to menu.
2460
2461 2002-02-04  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
2462
2463         * scheme-data.texi (Symbol Uninterned): Added node.
2464
2465 2002-01-29  Stefan Jahn  <stefan@lkcc.org>
2466
2467         * gh.texi (scm transition summary): Documented gh equivalents
2468         `scm_c_string2str', `scm_c_substring2str' and `scm_c_symbol2str'
2469         and removed the appropriate FIXME's.
2470
2471 2002-01-14  Marius Vollmer  <marius.vollmer@uni-dortmund.de>
2472
2473         * Makefile.am (autoconf-macros.texi):  Also set GUILE_LOAD_PATH
2474         when invoking the uninstalled guile executable.
2475
2476 2002-01-09  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2477
2478         * Makefile.am (autoconf-macros.texi): Fix build bug:
2479         Write this file to srcdir.  Thanks to I. N. Golubev.
2480
2481 2002-01-08  Gary Houston  <ghouston@arglist.com>
2482
2483         * Makefile.am: attempt to use guile from $(top_builddir)/libguile
2484         when building autoconf-macros.texi.  There are still problems with
2485         modules and running makeinfo when builddir != srcdir.
2486
2487 2002-01-08  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2488
2489         * data-rep.texi, gh.texi, guile.texi, intro.texi,
2490         misc-modules.texi, new-docstrings.texi, posix.texi, program.texi,
2491         repl-modules.texi, scheme-binding.texi, scheme-compound.texi,
2492         scheme-control.texi, scheme-data.texi, scheme-debug.texi,
2493         scheme-ideas.texi, scheme-io.texi, scheme-memory.texi,
2494         scheme-modules.texi, scheme-procedures.texi,
2495         scheme-translation.texi, scheme-utility.texi, scm.texi, slib.texi,
2496         srfi-modules.texi: Spell check.  Thanks to Fabrice Bauzac.
2497
2498 2002-01-07  Neil Jerram  <neil@ossau.uklinux.net>
2499
2500         * intro.texi (Linking Programs With Guile): Fix typo (superfluous
2501         `do').  Thanks to Fabrice Bauzac.
2502
2503 2002-01-05  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2504
2505         * intro.texi: Spell check.  Thanks to Fabrice Bauzac.
2506
2507 2002-01-02  Thien-Thi Nguyen  <ttn@giblet.glug.org>
2508
2509         * guile.texi (Part II): Add "Autoconf Support"; include
2510         autoconf.texi.
2511
2512         * Makefile.am (guile_TEXINFOS): Add autoconf.texi and
2513         autoconf-macros.texi.
2514         (autoconf.texi, autoconf-macros.texi): New rules.
2515
2516         * autoconf.texi: New file.
2517
2518 2001-12-22  Marius Vollmer  <mvo@zagadka.ping.de>
2519
2520         * scheme-compound.texi (Alist Example): Changed "Bismarck" to
2521         "Pierre".  Thanks to Ron Peterson!
2522
2523 2001-12-22  Neil Jerram  <neil@ossau.uklinux.net>
2524
2525         * program.texi (Programming Overview): Chapter renamed from
2526         `Programming Options'; some new material added.
2527
2528 2001-12-07  Neil Jerram  <neil@ossau.uklinux.net>
2529
2530         * scm.texi (Guile API): Renamed from `Scheme Primitives' and
2531         broadened so that this chapter discusses the Guile API as a whole.
2532
2533         * program.texi (Available Functionality): Revise so that text
2534         reads better.
2535
2536         * guile.texi (Programming Intro): New introductory text.
2537
2538         * scheme-ideas.texi (Definition): Reorder reference bullets in
2539         ascending page number order.
2540
2541 2001-12-04  Martin Grabmueller  <mg@glug.org>
2542
2543         * scheme-procedures.texi (Optional Arguments): Typo fix: wither ->
2544         either.
2545
2546 2001-12-01  Neil Jerram  <neil@ossau.uklinux.net>
2547
2548         * scheme-data.texi (Hooks): Moved into scheme-utility.texi.
2549
2550         * Makefile.am (guile_TEXINFOS): Added scheme-compound.texi.
2551
2552         * scheme-data.texi (Variables): Node moved to modules chapter.
2553         (Symbol Read Syntax): New node, with syntax-related material taken
2554         from old Symbols node.
2555         (Symbol Primitives): Renamed from `Symbols'.
2556         (Symbols and Variables): Renamed to `Symbols'.
2557         (Symbol Props): Renamed from `Symbol Tables'.
2558         (Symbols): General review, improvements and additional material
2559         throughout this section.
2560         (Other Data Types): New material: links to object types documented
2561         elsewhere.  Also renamed node to `Other Types'.
2562         (Data Types): Split into two: `Simple Data Types' and `Compound
2563         Data Types'.  Introductory blurbs rewritten accordingly.
2564
2565         * guile.texi: Updated Notes comment.
2566
2567         * scheme-data.texi (Rx Interface): Node moved to Guile Modules
2568         part, as the Rx interface is not core Guile.
2569
2570 2001-11-30  Neil Jerram  <neil@ossau.uklinux.net>
2571
2572         * scheme-data.texi (String Miscellanea): Removed, moving doc for
2573         string-ci->symbol into the node on Symbols.
2574
2575         * Makefile.am (ETAGS_ARGS): Added.
2576
2577         * scheme-data.texi (Symbol Tables): Removed doc for gentemp,
2578         intern-symbol, string->obarray-symbol, symbol-binding,
2579         symbol-bound?, symbol-set!, unintern-symbol, symbol-interned?; all
2580         of which no longer exist.
2581
2582 2001-11-25  Thien-Thi Nguyen  <ttn@glug.org>
2583
2584         * posix.texi: Fix spelling.  Thanks to Chris Cramer.
2585         Reword `getpass' intro blurb.
2586
2587 2001-11-23  Neil Jerram  <neil@ossau.uklinux.net>
2588
2589         * program.texi (Program Control): Remove spurious placeholder
2590         text.
2591
2592 2001-11-20  Thien-Thi Nguyen  <ttn@glug.org>
2593
2594         * scheme-options.texi (Install Config):
2595         Tweak `%load-path' verb to not imply it's a proc.
2596         Add documentation for `%guile-build-info'.
2597
2598 2001-11-19  Neil Jerram  <neil@ossau.uklinux.net>
2599
2600         * scheme-data.texi (Symbol Tables), new-docstrings.texi: Removed
2601         doc for builtin-bindings (no longer exists).
2602         (Variables): Expanded existing description of variables.  Removed
2603         doc for builtin-variable (no longer exists).
2604
2605         * scheme-binding.texi (Top Level): New docs for define, scm_define
2606         and scm_c_define.  Also clarified point about interchangeability
2607         of define and set!.
2608
2609 2001-11-18  Neil Jerram  <neil@ossau.uklinux.net>
2610
2611         * scheme-data.texi (Vectors): Autoupdate docs for
2612         vector-move-left! and vector-move-right!.
2613
2614 2001-11-16  Neil Jerram  <neil@ossau.uklinux.net>
2615
2616         * debugging.texi, deprecated.texi, intro.texi, misc-modules.texi,
2617         new-docstrings.texi, posix.texi, scheme-binding.texi,
2618         scheme-control.texi, scheme-data.texi, scheme-debug.texi,
2619         scheme-evaluation.texi, scheme-io.texi, scheme-memory.texi,
2620         scheme-modules.texi, scheme-options.texi, scheme-procedures.texi,
2621         scheme-scheduling.texi, scheme-translation.texi,
2622         scheme-utility.texi, script-getopt.texi, srfi-modules.texi: Change
2623         category for "primitive" and "procedure" @deffn's to {Scheme
2624         Procedure}; add @deffnx lines for {C Function}s; automatic updates
2625         from libguile docstring changes.
2626
2627         * scheme-memory.texi (Garbage Collection): Removed doc for removed
2628         `unhash-name'.
2629
2630 2001-11-14  Thien-Thi Nguyen  <ttn@glug.org>
2631
2632         * scheme-procedures.texi: Spell "library" correctly.
2633
2634 2001-11-13  Neil Jerram  <neil@ossau.uklinux.net>
2635
2636         * new-docstrings.texi, scheme-data.texi: Merge recent doc
2637         improvements from stable branch.
2638
2639         * scheme-options.texi: Automatic updates from docstring changes in
2640         libguile's C source code.
2641
2642 2001-11-12  Neil Jerram  <neil@ossau.uklinux.net>
2643
2644         * scheme-data.texi (Vtables, Structure Basics): Automatic doc
2645         updates for struct? and struct-vtable?.
2646         (String Searching): Add missing "for".  Thanks to Scott Lenser.
2647
2648 2001-11-08  Neil Jerram  <neil@ossau.uklinux.net>
2649
2650         * guile.texi (Top): Added new chapter `Programming Options'.
2651
2652         * program.texi: New file.
2653
2654         * Makefile.am (guile_TEXINFOS): Added program.texi.
2655
2656 2001-11-07  Neil Jerram  <neil@ossau.uklinux.net>
2657
2658         * scheme-memory.texi, scheme-io.texi, scheme-debug.texi,
2659         scheme-data.texi, scheme-binding.texi, posix.texi,
2660         new-docstrings.texi: Automatic updates from improved libguile
2661         docstrings.
2662
2663 2001-11-04  Neil Jerram  <neil@ossau.uklinux.net>
2664
2665         * preface.texi: Use MANUAL_EDITION variable.
2666         (Manual Layout): Updated to reflect reorg.
2667
2668         * guile.texi (MANUAL_EDITION): New variable, with value
2669         incremented from 1.0 to 1.1 to reflect the reorg described here.
2670         (Top): Use MANUAL_EDITION variable.
2671
2672         * scheme-indices.texi (R5RS Index, Guile Extensions Index): Use
2673         @unnumbered rather than @chapter for these indices.
2674
2675         * guile.texi (Top): A little top-level reshuffling, with the aims
2676         that: (1) the `Guile Scheme' (reference) part of the manual
2677         becomes the `Guile API Reference', and covers both Scheme and C
2678         interfaces; (2) non-API-reference material such as the `Basic
2679         Ideas in Scheme' chapter is collected together to form a new part
2680         `Programming with Guile'.  This new part will contain general
2681         documentation on using and programming Guile in both Scheme and C,
2682         including - for example - awareness of GC when C programming, how
2683         to use the snarf macros, how to debug ...
2684         (Top): Move inclusion of scheme-indices.texi so that all indices
2685         appear together in the printed manual.
2686
2687         * Makefile.am (guile_TEXINFOS): Removed appendices.texi, added
2688         debugging.texi.
2689
2690         * appendices.texi: Removed.
2691
2692         * debugging.texi (Debugger User Interface): New file, same as the
2693         material that used to be in appendices.texi, but now a chapter in
2694         Part II rather than an appendix.
2695
2696         * appendices.texi (Obtaining and Installing Guile): Moved to
2697         become a chapter in ...
2698         * intro.texi: ... Part I: Introduction to Guile.
2699
2700         * scm.texi (I/O Extensions): Moved to become a section of ...
2701         * scheme-io.texi (Input and Output): ... this chapter.
2702
2703         * scm.texi (Handling Errors): Moved to become a section of ...
2704         * scheme-control.texi (Control Mechanisms): ... this chapter.
2705
2706 2001-11-06  Thien-Thi Nguyen  <ttn@glug.org>
2707
2708         * srfi-modules.texi (SRFI-19, SRFI-19 Constants, SRFI-19 Current
2709         time and clock resolution, SRFI-19 Time object and accessors,
2710         SRFI-19 Time comparison procedures, SRFI-19 Time arithmetic
2711         procedures, SRFI-19 Date object and accessors, SRFI-19
2712         Time/Date/Julian Day/Modified Julian Day converters, SRFI-19 Date
2713         to string/string to date converters): New nodes.
2714         (SRFI Support): Add "SRFI-19" to menu.
2715
2716 2001-11-06  Marius Vollmer  <mvo@zagadka.ping.de>
2717
2718         * scripts.texi: Document `--debug' and `--no-debug'.
2719
2720 2001-10-27  Gary Houston  <ghouston@arglist.com>
2721
2722         * guile.texi, scsh.texi: removed obsolete guile-scsh material
2723         and updated links (I don't know if it should remain in the
2724         main menu.  It's like slib I think.)
2725
2726         * minor updates to the slib installation notes.
2727
2728 2001-10-05  Neil Jerram  <neil@ossau.uklinux.net>
2729
2730         * scheme-evaluation.texi (Fly Evaluation): Removed documentation
2731         for `read-and-eval!' and `eval2'.  (Thanks to Alex Schroeder for
2732         noticing that they'd disappeared!)
2733
2734 2001-10-05  Thien-Thi Nguyen  <ttn@glug.org>
2735
2736         * scheme-io.texi (Writing): Add entry for `display'.
2737         Include in R5RS Index.  Thanks to Alex Schroeder for suggestion.
2738
2739 2001-09-26  Martin Grabmueller  <mgrabmue@cs.tu-berlin.de>
2740
2741         * srfi-modules.texi (SRFI-13): Tyop fix.
2742         (SRFI-13): Changed paragraph about bindings both in the code and
2743         in SRFI-13.
2744
2745         * misc-modules.texi (Formatted Output): Tyop fix.
2746         (Formatted Output): Document ~g properly.
2747
2748         Thanks to Alex Schroeder for pointing out the typos and sending
2749         suggestions.
2750
2751 2001-09-25  Thien-Thi Nguyen  <ttn@glug.org>
2752
2753         * scheme-procedures.texi (Syntax Rules): Add `cindex' directive.
2754         Thanks to suggestion by Alex Schroeder.
2755
2756 2001-08-30  Neil Jerram  <neil@ossau.uklinux.net>
2757
2758         * guile.texi (Top): Group all index nodes together so that
2759         `Info-index' works more effectively in Info.  Thanks to Eric
2760         Hanchrow for the report and fix.
2761
2762         * scheme-data.texi (Random, String Syntax, String Modification,
2763         Regular Expressions), scheme-ideas.texi (Definition),
2764         scheme-modules.texi (Dynamic Linking and Compiled Code Modules),
2765         scm.texi (Transforming Scheme name to C name, Port
2766         Implementation): Various typo fixes and clarifications merged from
2767         the stable CVS branch.
2768
2769 2001-08-27  Neil Jerram  <neil@ossau.uklinux.net>
2770
2771         * intro.texi: Merged wording fixes from stable CVS branch.
2772
2773         * Makefile.am (guile_TEXINFOS): Remove ../AUTHORS.
2774
2775         * guile.texi: Incorporate text previously in separate AUTHORS
2776         file.
2777
2778 2001-08-27  Neil Jerram  <neil@ossau.uklinux.net>
2779
2780         The change log for files in this directory continues backwards
2781         from 2001-08-27 in ../ChangeLog, as all the Guile documentation
2782         prior to this date was contained in a single directory.
2783
2784
2785 ;; Local Variables:
2786 ;; coding: utf-8
2787 ;; End: