1 2003-11-09 Kevin Ryde <user42@zip.com.au>
3 * scheme-data.texi (Random): In random, use @code for *random-state*.
4 Reported by Stephen Compall.
6 2003-11-03 Kevin Ryde <user42@zip.com.au>
8 * misc-modules.texi (File Tree Walk): New chapter.
11 2003-10-18 Kevin Ryde <user42@zip.com.au>
13 * gh.texi (Calling Scheme procedures from C, scm transition summary):
14 Refer to scm_list_n, not the old name scm_listify.
15 (scm transition summary): For gh_apply, recommend scm_apply_0, which
18 * gh.texi (Defining new Scheme procedures in C): Don't use
19 @strong{Note:}, latest makeinfo will complain it looks like a cross
22 * posix.texi (Time): Correction to strftime glibc cross reference
23 node, now "Formatting Calendar Time".
25 * srfi-modules.texi (SRFI-1 Searching): In break, note conflict with
26 binding established by `while'.
28 2003-10-09 Kevin Ryde <user42@zip.com.au>
30 * scheme-compound.texi (Hash Table Reference): Decribe rehashing, note
31 no hashx-remove!, describe make-hash-table size parameter.
33 2003-10-06 Marius Vollmer <mvo@zagadka.de>
35 * scheme-memory.texi: Added a short explanation of the GC and the
36 conservative stack scanning.
37 (scm_gc_protect_object, scm_gc_unprotect_object,
38 scm_permanent_object): New.
40 * data-rep.texi, scheme-memory.texi (scm_remember_upto_here_1,
41 scm_remember_upto_here_2): Moved from data-rep.texi to
44 2003-10-02 Kevin Ryde <user42@zip.com.au>
46 * scheme-io.texi (String Ports): In call-with-output-string, note proc
47 should not close the port. In get-output-string, note string must be
48 gotten before closing the port.
50 2003-09-21 Kevin Ryde <user42@zip.com.au>
52 * posix.texi (File System): In access?, reword a bit, clarify real
53 versus effective ID handling, cross reference glibc on that, and
54 recommend against access tests in library functions.
56 2003-09-13 Kevin Ryde <user42@zip.com.au>
58 * posix.texi (File System): In stat:dev and stat:mode, clarify that
61 * posix.texi (Network Address Conversion): Under IPv4, describe
62 numeric representation in Guile, add INADDR_LOOPBACK and
63 INADDR_BROADCAST, add commented-out INADDR_NONE.
65 * scheme-compound.texi (Append/Reverse): Merge reverse and reverse!,
66 describe newtail parameter for reverse!, remove confusing caveat about
67 head becoming tail for reverse!.
69 * scheme-io.texi (Reading): In port-column, port-line,
70 set-port-column! and set-port-line!, port parameter must be given,
71 there's no default to current input.
73 * scheme-io.texi (Reading): Add scm_c_read.
74 (Writing): Add scm_c_write.
76 * srfi-modules.texi (SRFI-1 Constructors): Add list-copy.
78 * srfi-modules.texi (SRFI-19): Rewrite, adding descriptions of all
79 functions, and a bit of an introduction.
81 2003-09-03 Kevin Ryde <user42@zip.com.au>
83 * scheme-data.texi (Keyword Primitives): Add examples to
84 make-keyword-from-dash-symbol and keyword-dash-symbol. Add
87 * scheme-data.texi (Symbol Primitives): In gensym, cross reference
88 uninterned symbols, use @w{} on " g" prefix to avoid any chance of a
89 line break obscuring it.
91 2003-08-30 Kevin Ryde <user42@zip.com.au>
93 * data-rep.texi (Remembering During Operations): Note
94 scm_remember_upto_here_1 applies only to C automatic variables.
96 * guile.texi: Move @contents to usual place after title page, and
97 after first menu since that looks nice in html.
99 * posix.texi (Ports and File Descriptors): In pipe PIPE_BUF, use
100 @defvar, reword a bit for clarity, cross reference glibc.
102 * posix.texi (Network Sockets and Communication): In socket, use
103 @defvar for protocol variables, cross reference for getprotobyname,
104 note it's usually connect and accept that establishes communication.
106 * posix.texi (Network Sockets and Communication): In socketpair,
107 clarify the return is a pair with ports in car and cdr, note
108 connection is full duplex, refer to socket for parameters, refer to
109 PF_UNIX rather than AF_UNIX.
111 * scheme-compound.texi (Append/Reverse): Merge append and append!,
112 shown parameters as lst1 ... lstN, describe list argument for
113 scm_append and scm_append_x and note that it's unmodified.
115 * scheme-compound.texi (Hash Table Reference): Add hashx- case
116 insensitive string example, add cross references to symbol-hash,
117 string-hash, string-hash-ci, and char-set-hash.
119 * scheme-control.texi (Multiple Values): In values, show args as "arg1
120 ... argN". In scm_values, note args is a list and returned object
121 shares structure with it.
123 * scheme-control.texi (Catch): Add scm_internal_catch.
124 (Lazy Catch): Add scm_internal_lazy_catch.
126 * scheme-data.texi (Arithmetic): Use a table for scheme to C libm
127 equivalences, add C99 trunc.
129 * scheme-procedures.texi (Lambda): Note ". rest" list argument is
130 always newly created.
132 * srfi-modules.texi (SRFI-1 Association Lists): In alist-delete and
133 alist-delete!, note argument order for the equality calls per SRFI-1
136 2003-08-26 Kevin Ryde <user42@zip.com.au>
138 * scheme-data.texi (Scientific): Add two-argument atan.
140 * tools.texi (How guile-snarf works): Need @@ for texinfo in example.
142 2003-08-17 Kevin Ryde <user42@zip.com.au>
144 * scheme-compound.texi (Hash Table Reference): Collect up groups of
145 functions to avoid duplication. Revise notes on hashx functions and
146 on vector implementation. In make-hash-table, size is now optional.
147 Add hash-map and hash-for-each.
149 2003-08-14 Kevin Ryde <user42@zip.com.au>
151 * scheme-control.texi (while do): Update `while' for code rewrite, in
152 particular describe break and continue.
154 2003-08-09 Kevin Ryde <user42@zip.com.au>
156 * scheme-memory.texi (Memory Blocks): Add index entries for deprecated
157 scm_must_malloc and friends.
159 2003-07-29 Kevin Ryde <user42@zip.com.au>
161 * scheme-compound.texi (List Constructors): Remove scm_cons_star,
162 since it's not very helpful.
164 * scheme-utility.texi (Property Primitives): In primitive-property-ref,
165 note parameters to not-found-proc, use hyphens rather than underscores
166 for that parameter name.
167 In primitive-property-set!, VAL is the value parameter not CODE.
169 2003-07-24 Kevin Ryde <user42@zip.com.au>
171 * scheme-control.texi (Dynamic Wind): Untabify.
172 (Multiple Values): Use @result.
173 Reported by Stephen Compall <s11@member.fsf.org>.
175 * scheme-control.texi (Continuations): Rewrite with more detail.
177 * scheme-scheduling.texi (System asyncs): Add index entries for C
180 * scheme-scheduling.texi (Parallel Forms): New section.
182 2003-07-18 Kevin Ryde <user42@zip.com.au>
184 * scheme-compound.texi (List Constructors): In list, use "elem1
185 ... elemN". Add scm_list_1, scm_list_2, scm_list_3, scm_list_4,
186 scm_list_5, scm_list_n. Remove scm_list, since it's a no-op.
187 * guile.texi (nicode): New macro.
189 * scheme-evaluation.texi (Fly Evaluation): In apply, reword for
190 clarity, drop the "append" example. Add scm_apply, scm_apply_0,
191 scm_apply_1, scm_apply_2, scm_apply_3.
192 Add scm_call_0, scm_call_1, scm_call_2, scm_call_3.
193 In apply:nconc2last, move down after "apply", reword for clarity, note
194 correspondence to apply params.
196 * srfi-modules.texi (SRFI-0): Add cond-expand index entry.
197 (SRFI-9): Add define-record-type index entry.
199 2003-07-12 Kevin Ryde <user42@zip.com.au>
201 * srfi-modules.texi (SRFI-1 Constructors): In iota, reword a bit for
202 clarity and add a couple of examples.
204 2003-07-10 Kevin Ryde <user42@zip.com.au>
206 * deprecated.texi (Deprecated): Add scm_remember.
208 2003-06-22 Kevin Ryde <user42@zip.com.au>
210 * data-rep.texi (Remembering During Operations): Refer to all "Guile
211 library functions" as provoking gc.
213 2003-06-19 Kevin Ryde <user42@zip.com.au>
215 * scheme-io.texi (File Ports): Describe call-with-input-file and
216 call-with-output-file together. Describe with-input-from-file,
217 with-output-to-file and with-error-to-file together, and add that they
218 use dynamic-wind on the current port setting and keep the port open in
219 support of captured continuations.
220 (Closing): Describe close-input-port and close-output-port together,
221 tweak the wording slightly.
223 2003-06-14 Kevin Ryde <user42@zip.com.au>
225 * data-rep.texi (Vector Data): For SCM_VECTOR_BASE, SCM_STRING_CHARS
226 and SCM_SYMBOL_CHARS, cross reference "Remembering During Operations".
228 * scheme-data.texi (Arithmetic): round is to nearest even.
230 2003-06-12 Kevin Ryde <user42@zip.com.au>
232 * data-rep.texi (Remembering During Operations): New section.
234 * scheme-data.texi (Primitive Numerics): Add atan2, pow, asinh, acosh
235 and atanh to scheme<->C table. Note asinh, acosh and atanh are C99,
236 and scm_asinh, scm_acosh and scm_atanh are equivalents. Cross ref
237 glibc "Mathematics". Reword this end part for clarity.
239 * scheme-memory.texi (Memory Blocks): Use {} around types for
240 @deftypefn, for correct name in indexes.
241 * scheme-utility.texi (C Hooks): Ditto.
242 * gh.texi (Scheme to C): Ditto.
244 * gh.texi (Scheme to C): In gh_scm2newstr, lenp is size_t* not int*.
245 This changed in guile 1.6, the docs weren't updated.
247 2003-06-09 Marius Vollmer <mvo@zagadka.de>
249 From Mike Gran <spikegran@earthlink.net>. Thanks!
251 * preface.texi: Minor punctuation mistakes. Hyphens should link
252 compound adjectives. Commas should be placed after a "therefore"
253 that begins a sentence. Commas should not be used to separate a
254 list of only 2 dependent clauses.
256 2003-06-07 Kevin Ryde <user42@zip.com.au>
258 * scheme-data.texi (Arithmetic): Cross reference glibc floor and ceil.
260 2003-06-05 Kevin Ryde <user42@zip.com.au>
262 * posix.texi (File System): stat:rdev and stat:blocks can return #f,
263 stat:blksize returns a sensible size if the field is not available.
265 * scheme-compound.texi (Array Mapping): Reword for clarity, and in
266 particular have the same parameter names in the text and prototypes.
268 * scheme-evaluation.texi (Delayed Evaluation): Add delay, reword
269 promise? and force a bit, describe recursive forcing of a promise by
272 * scheme-io.texi (Ports): Add notes on garbage collection, and on
273 explicitly closing file ports.
274 (File Ports): Cross reference Ports node on explicit closing.
276 * posix.texi (Network Sockets and Communication): Cross reference
277 Ports node on explicit closing.
279 * scheme-scheduling.texi (Futures): New section.
281 * srfi-modules.texi (SRFI-13 Miscellaneous): In string-replace, note
282 that start1 and end1 optional is a Guile extension.
284 2003-05-30 Kevin Ryde <user42@zip.com.au>
286 * deprecated.texi: Add substring-move-left! and substring-move-right!.
288 * scheme-io.texi (Default Ports): Remove duplicate descriptions of
289 set-current-output-port and set-current-error-port.
291 2003-05-27 Dirk Herrmann <D.Herrmann@tu-bs.de>
293 * scheme-compound.texi: Clarified that vectors need to be quoted.
295 2003-05-26 Kevin Ryde <user42@zip.com.au>
297 * posix.texi (Locales): Clarify setlocale a bit, list all categories,
298 cross reference to libc.
300 2003-05-24 Kevin Ryde <user42@zip.com.au>
302 * scheme-procedures.texi: Add index entries lambda, optargs, syncase.
304 * scsh.texi (The Scheme shell (scsh)): Add index entries.
306 2003-05-22 Kevin Ryde <user42@zip.com.au>
308 * srfi-modules.texi (SRFI-2): Rewrite and-let*, describing plain
309 expression clauses and improving the examples.
311 2003-05-17 Marius Vollmer <mvo@zagadka.de>
313 * posix.texi (socket): Use PF_ instead of AF_ prefix.
315 2003-05-16 Kevin Ryde <user42@zip.com.au>
317 * guile.texi: Use @copying, show copyright and permissions at start of
320 * srfi-modules.texi (SRFI-1 Deleting): Rewrite delete and
321 delete-duplicates, adding behaviour details specified by srfi-1.
323 2003-05-12 Kevin Ryde <user42@zip.com.au>
325 * preface.texi (Guile License): Refer to COPYING.LIB.
327 * repl-modules.texi (Loading Readline Support, Readline Options):
328 Index entries for readline functions.
330 * scheme-control.texi (Handling Errors): Fix regexp error key, should
331 be `regular-expression-syntax'.
333 * scheme-data.texi (Complex): Show z argument in prototypes.
335 2003-05-10 Kevin Ryde <user42@zip.com.au>
337 * scheme-data.texi (Reals and Rationals): Fix typo @result{#f}, and
338 put @result outside @code.
340 * scheme-data.texi (Bitwise Operations): Note negatives are treated as
341 infinite precision twos complement. Revise `ash' to emphasise this
342 for right shifts of negatives. Describe integer-length behaviour on
343 negatives. Add `...' to logand, logior, logxor since they take
345 * guile.texi (m): New macro.
347 * scheme-control.texi (Handling Errors): Revise C support section to
348 get index entries, and clarify parameters. Remove scm_regex_error, no
349 longer exists and wasn't available to applications.
351 * scheme-control.texi (Handling Errors): Index entries for error keys.
353 2003-05-08 Kevin Ryde <user42@zip.com.au>
355 * scheme-data.texi (Bitwise Operations): Fix lognot to ones-complement.
357 * slib.texi (JACAL): Fix @ref title.
358 Add index entries, use @file and @code variously.
360 2003-05-06 Kevin Ryde <user42@zip.com.au>
362 * scheme-scheduling.texi (C level thread interface): Use @deftypefn
363 not @deftypefun, to get function names (not types) indexed.
365 * scheme-options.texi (Build Config): Add index entries for
366 %guile-build-info keys.
368 2003-05-04 Kevin Ryde <user42@zip.com.au>
370 * scheme-data.texi (Integer Operations): Describe how quotient,
371 remainder and modulo round their results.
373 * scheme-io.texi (Reading): In read-char and peek-char, fix typos "?"
374 in @rnindex. In port-column, use @: after i.e.
375 (Writing): In get-print-state, two spaces after full stop. Add write,
378 * srfi-modules.texi (SRFI-1 Length Append etc): Add count.
379 (SRFI-1 Fold and Map): In reduce, fix typo "... variant of fold", add
380 "f" to fold call shown. In reduce-right, use @code on "reduce".
382 * data-rep.texi, gh.texi: Add spaces after some @defun names.
383 * posix.texi (Processes): Fix typo "hhhh".
385 2003-05-01 Neil Jerram <neil@ossau.uklinux.net>
387 * posix.texi: Add index entries for many variables and functions,
388 either using @defvar/@deffn or @vindex/@pindex. (Patch supplied
391 2003-04-30 Marius Vollmer <marius.vollmer@uni-dortmund.de>
393 * posix.texi (scm_c_port_for_each): Added.
395 2003-04-26 Neil Jerram <neil@ossau.uklinux.net>
397 * scheme-data.texi (Symbol Primitives): Document scm_str2symbol
400 * data-rep.texi (Describing a New Type): Clarify that
401 scm_make_smob_type_mfpe is deprecated. (Thanks to
404 * scheme-control.texi (Handling Errors): Remove scm_sysmissing,
405 long since gone from libguile. (Thanks to Kevin Ryde.)
407 2003-04-05 Marius Vollmer <mvo@zagadka.de>
409 * preface.texi: Reflect change to LGPL.
411 2003-03-27 Rob Browning <rlb@defaultvalue.org>
413 * scheme-io.texi (Reading): clarify character ordering in port for
416 2003-03-07 Rob Browning <rlb@defaultvalue.org>
418 * guile.texi: change MANUAL_EDITION to MANUAL-EDITION so we don't
419 choke TeX (thanks to Dale P. Smith).
421 * preface.texi: change MANUAL_EDITION to MANUAL-EDITION so we
422 don't choke TeX (thanks to Dale P. Smith).
424 2003-01-02 Mikael Djurfeldt <djurfeldt@nada.kth.se>
426 * scheme-scheduling.texi (Low level thread primitives): Fixed typo
427 in broadcast-condition-variable.
429 2002-12-08 Rob Browning <rlb@defaultvalue.org>
431 * scheme-options.texi (Build Config): add effective-version docs.
433 2002-11-17 Neil Jerram <neil@ossau.uklinux.net>
435 Applied patches from Stephen Compall as follows. (Thanks!)
437 2002-11-06 Stephen Compall <rushing@sigecom.net>
439 * posix.texi: Changed quotes to match Texinfo expectations.
441 Added references to the glibc manual.
443 Used proper Texinfo text marking for many keywords, such as @code,
446 Fixed argument metasyntactic variable references in
447 file-manipulation section so the usage in the descriptions matches
448 the usage in the declarations.
450 2002-10-26 Stephen Compall <rushing@sigecom.net>
452 * scheme-data.texi: Addition and change of many Texinfo tags,
453 particularly usage of @var and @samp, as well as reformatting of
454 some lists into tables and usage of @result.
456 Notes about some things I didn't understand, as well as a
457 missing section on non-control characters.
459 2002-10-27 Gary Houston <ghouston@arglist.com>
461 * scheme-modules.texi (Environments): only available when
462 (ice-9 r5rs) is used.
463 * scsh.texi (The Scheme shell (scsh)): current url is www.scsh.net.
465 2002-10-27 Marius Vollmer <mvo@zagadka.ping.de>
467 * scheme-scheduling.texi: Updated mutex and condition varable
470 2002-10-27 Neil Jerram <neil@ossau.uklinux.net>
472 * debugging.texi (Debugging Features): Rewritten.
474 2002-10-19 Neil Jerram <neil@ossau.uklinux.net>
476 * new-docstrings.texi, scheme-binding.texi, scheme-io.texi,
477 scheme-scheduling.texi, posix.texi: Automatic docstring updates.
479 2002-10-14 Marius Vollmer <mvo@zagadka.ping.de>
481 * intro.texi (Whirlwind Tour): Added pointer to examples
484 2002-10-10 Marius Vollmer <mvo@zagadka.ping.de>
486 * scheme-scheduling.texi (System Asyncs): Updated.
488 2002-10-07 Marius Vollmer <mvo@zagadka.ping.de>
490 * scheme-scheduling.texi (Asyncs): Updated.
491 * posix.texi (sigaction): Updated.
493 2002-10-03 Neil Jerram <neil@ossau.uklinux.net>
495 * posix.texi (Processes), scheme-options.texi (Common Feature
496 Symbols): Refer to provided? rather than deprecated feature?.
498 2002-10-03 Marius Vollmer <mvo@zagadka.ping.de>
500 * tools.texi (How guile-snarf works): Updated.
501 (Writing your own snarfing macros): New.
503 2002-09-25 Neil Jerram <neil@ossau.uklinux.net>
505 * scheme-debug.texi (Debugging): Make sections into nodes.
506 (Debugging Options): Node removed.
508 * scheme-options.texi (Feature Tracking): Brought forward before
510 (Runtime Options): New section, to group options-related nodes.
512 2002-09-24 Neil Jerram <neil@ossau.uklinux.net>
514 * scheme-options.texi (Options and Config): Chapter name changed,
515 and intro text improved.
516 (Install Config): Brought forward, and renamed Build
519 The following doc updates are from Ian Sheldon - thanks!
521 * scheme-data.texi (Appending Strings, Regexp Functions, Match
522 Structures): Add examples.
523 (Regular Expressions): Add instruction to use (ice-9 regex)
526 * slib.texi (SLIB): Remove duplicate `the'.
528 2002-09-22 Neil Jerram <neil@ossau.uklinux.net>
530 * scheme-options.texi (General option interface): Mention
531 eval-options-interface and debug-options-interface.
533 * scheme-debug.texi (Debugging): New node describing source
536 2002-09-19 Neil Jerram <neil@ossau.uklinux.net>
538 * scheme-utility.texi (Hook Reference): Improvements to hook docs.
539 Thanks to Thien-Thi Nguyen for the patches.
541 2002-09-16 Marius Vollmer <mvo@zagadka.ping.de>
543 * scheme-data.texi (Symbol Props): It's "set-symbol-property!",
544 not "set-symbol-property". Thanks to Pieter Pareit!
546 2002-09-15 Marius Vollmer <mvo@zagadka.ping.de>
548 * scheme-data.texi: Tell them to use 'provided?' instead of
551 2002-09-09 Marius Vollmer <mvo@zagadka.ping.de>
553 * scheme-ideas.texi (Creating a Procedure): Fixed typo. Thanks to
556 * intro.texi: Updated GNu ftp server name. Use "-lguile" instead
557 of "libguile.a". Some small fixes/improvements.
559 * scheme-reading.texi: Added www.schemers.org. Removed foldoc,
560 it's too generic. Updated 'teach yourself ...' URL.
562 2002-08-27 Marius Vollmer <mvo@zagadka.ping.de>
564 * scheme-modules.texi: Markup fixes and removal of gh_ references.
565 Thanks to Dale Smith!
567 2002-08-14 Marius Vollmer <mvo@zagadka.ping.de>
569 * scheme-evaluation.texi (eval-string): Updated.
571 * scheme-scheduling.texi (Fluids): Touched up a bit, added
574 2002-08-13 Marius Vollmer <mvo@zagadka.ping.de>
576 * scheme-modules.texi (More Modules Procedures): Removed.
577 (Accessing Modules from C): New.
579 2002-08-10 Gary Houston <ghouston@arglist.com>
581 * scheme-procedures.texi: new section Primitive Procedures,
582 documentation for scm_c_make_gsubr and scm_c_define_gsubr.
583 * scheme-modules.texi (Compiled Code Modules): replace
584 gh_new_procedure with scm_c_define_gsubr.
586 2002-08-08 Neil Jerram <neil@ossau.uklinux.net>
588 * gh.texi (Data types and constants defined by gh): Avoid
589 generating index entry for SCM.
591 * posix.texi (Runtime Environment): Remove duplicate doc for
594 * data-rep.texi, scheme-memory.texi, scheme-modules.texi: Merge
595 recent updates from stable branch.
597 * posix.texi (File System, Time, Pipes, Network Databases,
598 Internet Socket Examples): Add examples provided by Ian Sheldon.
600 2002-08-08 Marius Vollmer <marius.vollmer@uni-dortmund.de>
602 * scheme-binding.texi: Don't talk about 'bound?' which is gone.
603 Thanks to Christopher Cramer.
605 2002-08-06 Han-Wen Nienhuys <hanwen@cs.uu.nl>
607 * scheme-memory.texi (Memory Blocks): add scm_calloc, scm_gc_calloc.
610 2002-08-05 Marius Vollmer <marius.vollmer@uni-dortmund.de>
612 * intro.texi, srfi-modules.texi: Added (use-modules (ice-9
613 rdelim)) to an example that uses read-line. Thanks to Ralf
616 * scheme-memory.texi: Added an introductory blurb about GC that I
619 2002-08-02 Gary Houston <ghouston@arglist.com>
621 * scheme-modules.texi: split "Scheme and modules" into
622 "provide and require" and "Environments". Mention R5RS
625 2002-07-16 Neil Jerram <neil@ossau.uklinux.net>
627 * scheme-options.texi (Debugger options): New subsection
628 describing stack overflow and what to do about it.
630 2002-07-10 Gary Houston <ghouston@arglist.com>
632 * scheme-modules.texi (Compiled Code Modules): Removed description
633 of scm_register_module_xxx, which no longer exists. A description
634 of current techniques is needed.
636 2002-05-09 Marius Vollmer <mvo@zagadka.ping.de>
638 * scheme-data.texi (Numbers): Added description of the new values
639 +inf.0, -inf.0 and +nan.0.
641 * posix.texi (Runtime Environment): Added entries for 'setenv' and
644 2002-04-28 Marius Vollmer <mvo@zagadka.ping.de>
646 * gh.texi, data-rep.texi: Moved `@deftyp {Data type} SCM' line
647 from gh.texi to data-rep.texi. Both files already had similar
648 descriptions for SCM. Given that gh.texi is deprecated, looking
649 up `SCM' in the index should take one to the primary location
650 rather than deprecated section. Hence this change. Added
651 `@deftp' for scm_t_bits data type so that a proper index entry is
652 added for this. Thanks to Richard Y. Kim!
654 * data-rep.texi (Subrs): Changed scm_make_gsubr to
655 scm_c_define_gsubr. Thanks to Richard Y. Kim!
657 2002-04-24 Marius Vollmer <mvo@zagadka.ping.de>
659 * srfi-modules.texi (SRFI-13 Miscellaneous): Updated docs of
662 2002-04-20 Neil Jerram <neil@ossau.uklinux.net>
664 * scheme-intro.texi (Scheme Layout), scm.texi (Reference Layout):
665 Node moved from a to b.
667 * guile.texi (Scheme Intro, Basic Ideas, Guile Scripting, Command
668 Line Handling, Debugging Features, Autoconf Support, Miscellaneous
669 Tools, Further Reading): Moved to new Part II.
671 * preface.texi (Manual Layout): Part numbers updated accordingly.
673 * guile.texi (Top): Move API Overview node to beginning of Guile
675 (Part II: Writing and Running Guile Scheme): New part; will
676 contain content from `Programming with Guile' that pertains to
677 writing and using Guile on the Scheme level.
679 * scm.texi (API Overview): Renamed from `Guile API'.
681 * guile.texi (Top), scheme-modules.texi (Included Guile Modules):
682 Debugger User Interface node renamed Debugging Features.
684 * debugging.texi (Stacks and Frames): Node deleted; non-duplicated
685 material moved to scheme-debug.texi.
686 (Debugging Features): Renamed from `Debugger User Interface'.
688 * scheme-debug.texi (Debugging): Rename chapter `Debugging
689 Infrastructure' and reorganize its contents.
691 * scheme-debug.texi (Debugging), scheme-control.texi (Handling
692 Errors): Move display-error to error-focussed section.
694 * scheme-debug.texi (Debugging), debugging.texi (Backtrace): Move
695 backtrace to user-level debugging chapter.
697 * scheme-debug.texi (Debugging), scheme-procedures.texi (Procedure
698 Properties): Move procedure-name, procedure-source and
699 procedure-environment to procedures chapter.
701 * scheme-debug.texi (Debugging), scheme-memory.texi (Memory
702 Blocks): Move malloc-stats to memory management chapter.
704 * scheme-procedures.texi (Syntax Rules): Remove mention of
705 use-modules for loading syncase; only use-syntax really works.
706 Thanks to Panagiotis Vossos for spotting this.
708 * program.texi (Scheme vs C): New node, with existing material
709 taken from chapter intro.
710 (Programming Overview): New intro para to introduce example of
712 (Extending Dia): New node.
714 2002-04-17 Marius Vollmer <mvo@zagadka.ping.de>
716 * Makefile.am (CLEANFILES): Added guile.cps, guile.fns, guile.rns,
717 guile.tps, guile.vrs, guile.tmp.
719 2002-04-01 Neil Jerram <neil@ossau.uklinux.net>
721 * scheme-intro.texi (Scheme Layout): Remove reference to defunct
722 Guile Extensions index.
724 * guile.texi: Removed Guile Extensions index.
726 * scheme-indices.texi (Guile Extensions Index): Removed.
728 * guile.texi: Remove vgone, vdeprecated, vchanged and vnote
729 macros; they're not actually useful after all. Update copyright
732 * scheme-compound.texi (Vectors): Make subsections into nodes.
733 (Vectors): Review, slightly reorg and clarify docs in this
736 * scheme-data.texi (Symbols): Reorganized node substructure and
737 added lots of explanatory text around the @deffn's.
739 2002-03-29 Neil Jerram <neil@ossau.uklinux.net>
741 * scheme-modules.texi (Variables): Mention obarrays.
743 * scheme-data.texi (Symbol Tables, Symbol Props): Remove vgone
744 markers for deprecated symbol items.
745 (Symbol Props): Remove doc for obsolete 2 arg version of
747 (String Miscellanea): Removed, since it only contained duplicate
748 doc for string-ci->symbol.
749 (Symbol Tables): Move doc for gensym to Symbol Primitives; rest of
752 * posix.texi (Ports and File Descriptors), scheme-evaluation.texi
753 (Fly Evaluation): Remove vgone markers for close-all-ports-except,
754 eval2 and read-and-eval!.
756 * data-rep.texi (Describing a New Type), scheme-compound.texi
757 (Append/Reverse), scheme-procedures.texi (Internal Macros):
758 Trivial updates to sync with stable branch.
760 2002-03-27 Neil Jerram <neil@ossau.uklinux.net>
762 * scheme-compound.texi (List Searching): Remove docs for
763 `scm_sloppy_mem*', which no longer exist.
765 2002-03-24 Neil Jerram <neil@ossau.uklinux.net>
767 * guile.texi (Top), intro.texi (What is Guile?, The Basic Guile
768 Package): Use @ifnottex instead of @ifinfo, so that HTML
769 generation works correctly.
771 2002-03-24 Marius Vollmer <mvo@zagadka.ping.de>
773 * tools.texi: Updated to reflect changes to the guile-snarf tool.
775 2002-03-16 Neil Jerram <neil@ossau.uklinux.net>
777 * scheme-utility.texi (Hooks): Further updates. New material on
780 * scheme-evaluation.texi (Fly Evaluation): Note disappearance of
781 eval2 and read-and-eval!.
783 * deprecated.texi (Deprecated): Remove docs about previously
784 deprecated items that have now been removed.
786 2002-03-15 Thien-Thi Nguyen <ttn@giblet.glug.org>
788 * tools.texi (guile-1.4 guile-snarf): Remove this node.
789 (How guile-snarf works): Update usage and description to
790 no longer mention "--compat=1.4" and instead "-d" and "-D".
791 (Macros guile-snarf recognizes): Add list of deprecated macros
792 and blurb. Add cindex for deprecated macros.
794 2002-03-15 Neil Jerram <neil@ossau.uklinux.net>
796 * scheme-utility.texi (Hooks): Reviewed and updated.
798 * scheme-options.texi (Feature Tracking): New section.
800 * scheme-data.texi (Arithmetic, Primitive Numerics): Add
801 description of corresponding C functions.
803 * scheme-utility.texi (Object Properties): Revamp documentation on
806 * scheme-memory.texi (Weak References): Update reference to Object
809 * guile.texi: Add macros for describing version information.
811 * scheme-data.texi, scheme-debug.texi, scheme-io.texi,
812 scheme-procedures.texi: Automatic updates from snarfed libguile
815 2002-03-13 Thien-Thi Nguyen <ttn@giblet.glug.org>
817 * Makefile.am (guile_toc.html): Look for guile.texi in $(srcdir).
819 * tools.texi (How guile-snarf works): Mention "--compat=1.4", and
820 new processing steps. Update usage example, makefile frag.
822 (guile-1.4 guile-snarf): New subsubsection under
823 "Init Snarfing with guile-snarf".
825 2002-03-12 Neil Jerram <neil@ossau.uklinux.net>
827 * scheme-compound.texi, scheme-data.texi, new-docstrings.texi:
828 Automatic updates from snarfed libguile docstrings.
830 * data-rep.texi, guile.texi, scheme-evaluation.texi,
831 scheme-options.texi, scheme-translation.texi: Various minor
832 enhancements ported from the stable CVS branch.
834 2002-03-08 Thien-Thi Nguyen <ttn@giblet.glug.org>
836 * tools.texi (Miscellaneous Tools): New node/chapter.
837 (Snarfing, Init Snarfing with guile-snarf, How guile-snarf works,
838 Macros guile-snarf recognizes, Doc Snarfing): New nodes/(sub)sections.
839 (Executable Modules): Now a section under "Miscellaneous Tools".
841 * guile.texi (Miscellaneous Tools): Add under "Part II".
842 Implement by including tools.texi.
844 * Makefile.am (guile_TEXINFOS): Add tools.texi.
846 2002-03-07 Thien-Thi Nguyen <ttn@giblet.glug.org>
848 * tools.texi: New file.
850 2002-03-03 Neil Jerram <neil@ossau.uklinux.net>
852 * autoconf.texi (Autoconf Background): Insert missing `of'.
854 2002-03-01 Dirk Herrmann <D.Herrmann@tu-bs.de>
856 * api.txt, data-rep.texi: Renamed the struct scm_cell to
859 * data-rep.texi: Renamed scm_alloc_cell to scm_cell and
860 scm_alloc_double_cell to scm_double_cell.
862 2002-03-01 Marius Vollmer <mvo@zagadka.ping.de>
864 * scheme-memory.texi (Upgrading from scm_must_malloc et al): New
867 2002-02-28 Marius Vollmer <mvo@zagadka.ping.de>
869 * data-rep.texi: Use scm_gc_malloc and scm_gc_free instead of
870 scm_must_malloc and free in example code. Updated text for the
871 new memory management functions.
873 * scheme-debug.texi (malloc-stats): Refer to scm_gc_malloc instead
874 of to scm_must_malloc.
876 2002-02-27 Stefan Jahn <stefan@lkcc.org>
878 * gh.texi (scm transition summary): Documented some more
879 gh equivalents and removed appropriate FIXME's.
881 2002-02-26 Thien-Thi Nguyen <ttn@giblet.glug.org>
883 * Makefile.am: Update path to pre-inst-guile automake frag.
885 2002-02-24 Rob Browning <rlb@defaultvalue.org>
887 * .cvsignore: add autoconf-macros.texi.
889 * Makefile.am (CLEANFILES): add autoconf-macros.texi.
891 2002-02-19 Marius Vollmer <mvo@zagadka.ping.de>
893 * scheme-memory.texi (Memory Blocks): New section.
895 2002-02-05 Thien-Thi Nguyen <ttn@giblet.glug.org>
897 * Makefile.am: Include $(top_srcdir)/pre-inst-guile.am.
900 (autoconf-macros.texi): Use $(preinstguiletool).
902 2002-02-04 Thien-Thi Nguyen <ttn@giblet.glug.org>
904 * autoconf.texi (Autofrisk, Using Autofrisk): New sections.
905 (Autoconf Support): Add new sections to menu.
907 2002-02-04 Marius Vollmer <marius.vollmer@uni-dortmund.de>
909 * scheme-data.texi (Symbol Uninterned): Added node.
911 2002-01-29 Stefan Jahn <stefan@lkcc.org>
913 * gh.texi (scm transition summary): Documented gh equivalents
914 `scm_c_string2str', `scm_c_substring2str' and `scm_c_symbol2str'
915 and removed the appropriate FIXME's.
917 2002-01-14 Marius Vollmer <marius.vollmer@uni-dortmund.de>
919 * Makefile.am (autoconf-macros.texi): Also set GUILE_LOAD_PATH
920 when invoking the uninstalled guile executable.
922 2002-01-09 Thien-Thi Nguyen <ttn@giblet.glug.org>
924 * Makefile.am (autoconf-macros.texi): Fix build bug:
925 Write this file to srcdir. Thanks to I. N. Golubev.
927 2002-01-08 Gary Houston <ghouston@arglist.com>
929 * Makefile.am: attempt to use guile from $(top_builddir)/libguile
930 when building autoconf-macros.texi. There are still problems with
931 modules and running makeinfo when builddir != srcdir.
933 2002-01-08 Thien-Thi Nguyen <ttn@giblet.glug.org>
935 * data-rep.texi, gh.texi, guile.texi, intro.texi,
936 misc-modules.texi, new-docstrings.texi, posix.texi, program.texi,
937 repl-modules.texi, scheme-binding.texi, scheme-compound.texi,
938 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
939 scheme-ideas.texi, scheme-io.texi, scheme-memory.texi,
940 scheme-modules.texi, scheme-procedures.texi,
941 scheme-translation.texi, scheme-utility.texi, scm.texi, slib.texi,
942 srfi-modules.texi: Spell check. Thanks to Fabrice Bauzac.
944 2002-01-07 Neil Jerram <neil@ossau.uklinux.net>
946 * intro.texi (Linking Programs With Guile): Fix typo (superfluous
947 `do'). Thanks to Fabrice Bauzac.
949 2002-01-05 Thien-Thi Nguyen <ttn@giblet.glug.org>
951 * intro.texi: Spell check. Thanks to Fabrice Bauzac.
953 2002-01-02 Thien-Thi Nguyen <ttn@giblet.glug.org>
955 * guile.texi (Part II): Add "Autoconf Support"; include
958 * Makefile.am (guile_TEXINFOS): Add autoconf.texi and
959 autoconf-macros.texi.
960 (autoconf.texi, autoconf-macros.texi): New rules.
962 * autoconf.texi: New file.
964 2001-12-22 Marius Vollmer <mvo@zagadka.ping.de>
966 * scheme-compound.texi (Alist Example): Changed "Bismarck" to
967 "Pierre". Thanks to Ron Peterson!
969 2001-12-22 Neil Jerram <neil@ossau.uklinux.net>
971 * program.texi (Programming Overview): Chapter renamed from
972 `Programming Options'; some new material added.
974 2001-12-07 Neil Jerram <neil@ossau.uklinux.net>
976 * scm.texi (Guile API): Renamed from `Scheme Primitives' and
977 broadened so that this chapter discusses the Guile API as a whole.
979 * program.texi (Available Functionality): Revise so that text
982 * guile.texi (Programming Intro): New introductory text.
984 * scheme-ideas.texi (Definition): Reorder reference bullets in
985 ascending page number order.
987 2001-12-04 Martin Grabmueller <mg@glug.org>
989 * scheme-procedures.texi (Optional Arguments): Typo fix: wither ->
992 2001-12-01 Neil Jerram <neil@ossau.uklinux.net>
994 * scheme-data.texi (Hooks): Moved into scheme-utility.texi.
996 * Makefile.am (guile_TEXINFOS): Added scheme-compound.texi.
998 * scheme-data.texi (Variables): Node moved to modules chapter.
999 (Symbol Read Syntax): New node, with syntax-related material taken
1000 from old Symbols node.
1001 (Symbol Primitives): Renamed from `Symbols'.
1002 (Symbols and Variables): Renamed to `Symbols'.
1003 (Symbol Props): Renamed from `Symbol Tables'.
1004 (Symbols): General review, improvements and additional material
1005 throughout this section.
1006 (Other Data Types): New material: links to object types documented
1007 elsewhere. Also renamed node to `Other Types'.
1008 (Data Types): Split into two: `Simple Data Types' and `Compound
1009 Data Types'. Introductory blurbs rewritten accordingly.
1011 * guile.texi: Updated Notes comment.
1013 * scheme-data.texi (Rx Interface): Node moved to Guile Modules
1014 part, as the Rx interface is not core Guile.
1016 2001-11-30 Neil Jerram <neil@ossau.uklinux.net>
1018 * scheme-data.texi (String Miscellanea): Removed, moving doc for
1019 string-ci->symbol into the node on Symbols.
1021 * Makefile.am (ETAGS_ARGS): Added.
1023 * scheme-data.texi (Symbol Tables): Removed doc for gentemp,
1024 intern-symbol, string->obarray-symbol, symbol-binding,
1025 symbol-bound?, symbol-set!, unintern-symbol, symbol-interned?; all
1026 of which no longer exist.
1028 2001-11-25 Thien-Thi Nguyen <ttn@glug.org>
1030 * posix.texi: Fix spelling. Thanks to Chris Cramer.
1031 Reword `getpass' intro blurb.
1033 2001-11-23 Neil Jerram <neil@ossau.uklinux.net>
1035 * program.texi (Program Control): Remove spurious placeholder
1038 2001-11-20 Thien-Thi Nguyen <ttn@glug.org>
1040 * scheme-options.texi (Install Config):
1041 Tweak `%load-path' verb to not imply it's a proc.
1042 Add documentation for `%guile-build-info'.
1044 2001-11-19 Neil Jerram <neil@ossau.uklinux.net>
1046 * scheme-data.texi (Symbol Tables), new-docstrings.texi: Removed
1047 doc for builtin-bindings (no longer exists).
1048 (Variables): Expanded existing description of variables. Removed
1049 doc for builtin-variable (no longer exists).
1051 * scheme-binding.texi (Top Level): New docs for define, scm_define
1052 and scm_c_define. Also clarified point about interchangeability
1055 2001-11-18 Neil Jerram <neil@ossau.uklinux.net>
1057 * scheme-data.texi (Vectors): Autoupdate docs for
1058 vector-move-left! and vector-move-right!.
1060 2001-11-16 Neil Jerram <neil@ossau.uklinux.net>
1062 * debugging.texi, deprecated.texi, intro.texi, misc-modules.texi,
1063 new-docstrings.texi, posix.texi, scheme-binding.texi,
1064 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
1065 scheme-evaluation.texi, scheme-io.texi, scheme-memory.texi,
1066 scheme-modules.texi, scheme-options.texi, scheme-procedures.texi,
1067 scheme-scheduling.texi, scheme-translation.texi,
1068 scheme-utility.texi, script-getopt.texi, srfi-modules.texi: Change
1069 category for "primitive" and "procedure" @deffn's to {Scheme
1070 Procedure}; add @deffnx lines for {C Function}s; automatic updates
1071 from libguile docstring changes.
1073 * scheme-memory.texi (Garbage Collection): Removed doc for removed
1076 2001-11-14 Thien-Thi Nguyen <ttn@glug.org>
1078 * scheme-procedures.texi: Spell "library" correctly.
1080 2001-11-13 Neil Jerram <neil@ossau.uklinux.net>
1082 * new-docstrings.texi, scheme-data.texi: Merge recent doc
1083 improvements from stable branch.
1085 * scheme-options.texi: Automatic updates from docstring changes in
1086 libguile's C source code.
1088 2001-11-12 Neil Jerram <neil@ossau.uklinux.net>
1090 * scheme-data.texi (Vtables, Structure Basics): Automatic doc
1091 updates for struct? and struct-vtable?.
1092 (String Searching): Add missing "for". Thanks to Scott Lenser.
1094 2001-11-08 Neil Jerram <neil@ossau.uklinux.net>
1096 * guile.texi (Top): Added new chapter `Programming Options'.
1098 * program.texi: New file.
1100 * Makefile.am (guile_TEXINFOS): Added program.texi.
1102 2001-11-07 Neil Jerram <neil@ossau.uklinux.net>
1104 * scheme-memory.texi, scheme-io.texi, scheme-debug.texi,
1105 scheme-data.texi, scheme-binding.texi, posix.texi,
1106 new-docstrings.texi: Automatic updates from improved libguile
1109 2001-11-04 Neil Jerram <neil@ossau.uklinux.net>
1111 * preface.texi: Use MANUAL_EDITION variable.
1112 (Manual Layout): Updated to reflect reorg.
1114 * guile.texi (MANUAL_EDITION): New variable, with value
1115 incremented from 1.0 to 1.1 to reflect the reorg described here.
1116 (Top): Use MANUAL_EDITION variable.
1118 * scheme-indices.texi (R5RS Index, Guile Extensions Index): Use
1119 @unnumbered rather than @chapter for these indices.
1121 * guile.texi (Top): A little top-level reshuffling, with the aims
1122 that: (1) the `Guile Scheme' (reference) part of the manual
1123 becomes the `Guile API Reference', and covers both Scheme and C
1124 interfaces; (2) non-API-reference material such as the `Basic
1125 Ideas in Scheme' chapter is collected together to form a new part
1126 `Programming with Guile'. This new part will contain general
1127 documentation on using and programming Guile in both Scheme and C,
1128 including - for example - awareness of GC when C programming, how
1129 to use the snarf macros, how to debug ...
1130 (Top): Move inclusion of scheme-indices.texi so that all indices
1131 appear together in the printed manual.
1133 * Makefile.am (guile_TEXINFOS): Removed appendices.texi, added
1136 * appendices.texi: Removed.
1138 * debugging.texi (Debugger User Interface): New file, same as the
1139 material that used to be in appendices.texi, but now a chapter in
1140 Part II rather than an appendix.
1142 * appendices.texi (Obtaining and Installing Guile): Moved to
1143 become a chapter in ...
1144 * intro.texi: ... Part I: Introduction to Guile.
1146 * scm.texi (I/O Extensions): Moved to become a section of ...
1147 * scheme-io.texi (Input and Output): ... this chapter.
1149 * scm.texi (Handling Errors): Moved to become a section of ...
1150 * scheme-control.texi (Control Mechanisms): ... this chapter.
1152 2001-11-06 Thien-Thi Nguyen <ttn@glug.org>
1154 * srfi-modules.texi (SRFI-19, SRFI-19 Constants, SRFI-19 Current
1155 time and clock resolution, SRFI-19 Time object and accessors,
1156 SRFI-19 Time comparison procedures, SRFI-19 Time arithmetic
1157 procedures, SRFI-19 Date object and accessors, SRFI-19
1158 Time/Date/Julian Day/Modified Julian Day converters, SRFI-19 Date
1159 to string/string to date converters): New nodes.
1160 (SRFI Support): Add "SRFI-19" to menu.
1162 2001-11-06 Marius Vollmer <mvo@zagadka.ping.de>
1164 * scripts.texi: Document `--debug' and `--no-debug'.
1166 2001-10-27 Gary Houston <ghouston@arglist.com>
1168 * guile.texi, scsh.texi: removed obsolete guile-scsh material
1169 and updated links (I don't know if it should remain in the
1170 main menu. It's like slib I think.)
1172 * minor updates to the slib installation notes.
1174 2001-10-05 Neil Jerram <neil@ossau.uklinux.net>
1176 * scheme-evaluation.texi (Fly Evaluation): Removed documentation
1177 for `read-and-eval!' and `eval2'. (Thanks to Alex Schroeder for
1178 noticing that they'd disappeared!)
1180 2001-10-05 Thien-Thi Nguyen <ttn@glug.org>
1182 * scheme-io.texi (Writing): Add entry for `display'.
1183 Include in R5RS Index. Thanks to Alex Schroeder for suggestion.
1185 2001-09-26 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
1187 * srfi-modules.texi (SRFI-13): Tyop fix.
1188 (SRFI-13): Changed paragraph about bindings both in the code and
1191 * misc-modules.texi (Formatted Output): Tyop fix.
1192 (Formatted Output): Document ~g properly.
1194 Thanks to Alex Schroeder for pointing out the typos and sending
1197 2001-09-25 Thien-Thi Nguyen <ttn@glug.org>
1199 * scheme-procedures.texi (Syntax Rules): Add `cindex' directive.
1200 Thanks to suggestion by Alex Schroeder.
1202 2001-08-30 Neil Jerram <neil@ossau.uklinux.net>
1204 * guile.texi (Top): Group all index nodes together so that
1205 `Info-index' works more effectively in Info. Thanks to Eric
1206 Hanchrow for the report and fix.
1208 * scheme-data.texi (Random, String Syntax, String Modification,
1209 Regular Expressions), scheme-ideas.texi (Definition),
1210 scheme-modules.texi (Dynamic Linking and Compiled Code Modules),
1211 scm.texi (Transforming Scheme name to C name, Port
1212 Implementation): Various typo fixes and clarifications merged from
1213 the stable CVS branch.
1215 2001-08-27 Neil Jerram <neil@ossau.uklinux.net>
1217 * intro.texi: Merged wording fixes from stable CVS branch.
1219 * Makefile.am (guile_TEXINFOS): Remove ../AUTHORS.
1221 * guile.texi: Incorporate text previously in separate AUTHORS
1224 2001-08-27 Neil Jerram <neil@ossau.uklinux.net>
1226 The change log for files in this directory continues backwards
1227 from 2001-08-27 in ../ChangeLog, as all the Guile documentation
1228 prior to this date was contained in a single directory.