doc/ref/ChangeLog

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