1 2005-01-08 Kevin Ryde <user42@zip.com.au>
3 * api-modules.texi (Creating Guile Modules): Expand define-modules
4 #:autoload, clarify that it's a list of symbols.
6 * api-modules.texi (Included Guile Modules): Add expect, format, ftw,
7 getop-long, history, popen, pretty-print, q, readline, receive, regex,
8 streams, syncase, srfi-16, srfi-19 and srfi-31. Remove ice-9 jacal,
11 * posix.texi (File System): In mkstemp!, note 0600 creation mode.
13 2005-01-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
15 * api-compound.texi: Finished(?) the new array API docs.
17 2005-01-02 Kevin Ryde <user42@zip.com.au>
19 * posix.texi (Pipes): Expand and clarify a bit. Describe port
20 inheritance. Caution against waitpid WAIT_ANY.
22 2004-12-29 Marius Vollmer <mvo@zagadka.de>
24 * api-compound.texi (Arrays): Updated for the new 'typed' approach
27 2004-12-28 Kevin Ryde <user42@zip.com.au>
29 * api-data.texi (String Predicates): For string-any and string-every,
30 last chars are now tail calls per srfi, and reinstate char_pred can be
31 character or character set (somehow lost in cut and paste).
33 * srfi-modules.texi (SRFI-1 Searching): In any and every, revise for
34 clarity, note last call in each is a tail call.
36 2004-12-27 Marius Vollmer <mvo@zagadka.de>
38 * api-compound.texi (Vectors, Bit Vectors, Uniform Numeric
39 Vectors): Updated for the distinction between read-only and write
40 access to storage locations.
42 2004-12-22 Marius Vollmer <marius.vollmer@uni-dortmund.de>
44 * api-compound.texi (Arrays): Reorganized and 'modernized'.
46 2004-12-20 Mikael Djurfeldt <djurfeldt@nada.kth.se>
48 * expect.texi (Expect): Removed backslash escapes of regexp
49 operators ( and ) in code example for expect-strings.
51 2004-12-14 Kevin Ryde <user42@zip.com.au>
53 * api-data.texi (Regexp Functions): Revise regex-substitute and
54 regex-substitute/global for clarity, add some examples.
56 * api-procedures.texi (lambda* Reference): Revise for clarity, note
57 how #:rest works with #:key, note previous bindings available to
60 2004-12-05 Kevin Ryde <user42@zip.com.au>
62 * srfi-modules.texi (SRFI-1 Length Append etc): In concatenate, note
63 equivalence to "apply append".
65 2004-11-09 Marius Vollmer <marius.vollmer@uni-dortmund.de>
67 * api-compound.texi (Generalized Vectors): New.
68 (Bit Vectors): More docs.
69 (Uniform Vectors): Call them Uniform numeric vectors.
71 2004-10-29 Marius Vollmer <marius.vollmer@uni-dortmund.de>
73 * api-compound.texi (Uniform Vectors): Added c32 and c64 docs.
75 2004-10-27 Marius Vollmer <marius.vollmer@uni-dortmund.de>
77 * srfi-modules.texi, api-compound.texi: Moved SRFI-4 docs into
78 main part. Moved bit vectors out of array section to make them
81 2004-10-19 Marius Vollmer <marius.vollmer@uni-dortmund.de>
83 * api-smobs.texi (smob mark function): List admissible functions
86 2004-10-04 Marius Vollmer <marius.vollmer@uni-dortmund.de>
88 * api-data.texi: Removed primitive keyword section, updated
91 * api-undocumented.texi: Moved keyword dash-symbol docs here.
93 2004-09-26 Kevin Ryde <user42@zip.com.au>
95 * api-data.texi (Conversion to/from C): Braces {} around char* return.
96 * api-evaluation.texi (Block Comments): More cindex entries.
98 * guile.texi, misc-modules.texi (Streams): New section.
100 2004-09-25 Marius Vollmer <mvo@zagadka.de>
102 * libguile-smobs.texi, api-smobs.texi: More words abot what a free
103 function is allowed to do.
105 2004-09-24 Marius Vollmer <mvo@zagadka.de>
107 * libguile-smobs.texi: Bugfix in example code, use SCM_NEWSMOB
108 correctly. Use scm_assert_smob_type instead of SCM_ASSERT
111 2004-09-23 Marius Vollmer <mvo@zagadka.de>
113 * api-i18n.texi: New file.
114 * Makefile.am (guile_TEXINFOS): Added it.
115 * guile.texi: Include it.
117 2004-09-16 Kevin Ryde <user42@zip.com.au>
119 * api-utility.texi (Equality): Revise for clarity.
121 2004-09-08 Marius Vollmer <marius.vollmer@uni-dortmund.de>
123 * api-data.texi (integer-expt): Updated from docstring.
125 * Makefile.am (CLEANFILES, MAINTAINERCLEANFILES): Moved
126 autoconf-macros.texi to MAINTAINERCLEANFILES. It is in the
127 tarball and we shouldn't clean it, then.
129 2004-09-07 Kevin Ryde <user42@zip.com.au>
131 * api-procedures.texi (let-keywords Reference): Typo, should be
132 let-keywords* @defunx.
134 * api-scheduling.texi (Parallel Forms): In parallel, letpar, par-map,
135 n-par-map and n-for-each-par-map, describe each form as being in its
136 own thread, not a new thread, since for instance the calling thread is
137 used when only one form. Plus typo in n-for-each-par-map example
138 equivalent for-each + n-par-map.
140 * posix.texi (Locales): Use @var for category arg.
142 * posix.texi (System Identification): Remove software-type, it doesn't
143 exist in the guile core.
145 * srfi-modules.texi (SRFI-10): Revise and expand.
147 2004-09-02 Kevin Ryde <user42@zip.com.au>
149 * misc-modules.texi (Formatted Output): Excess arguments are ignored.
150 In ~*, correction N parameter cannot be negative. In ~t, note
153 2004-08-29 Kevin Ryde <user42@zip.com.au>
155 * srfi-modules.texi (SRFI-2): Note empty body is #t.
157 2004-08-25 Marius Vollmer <marius.vollmer@uni-dortmund.de>
159 * api-data.texi, srfi-modules.texi: Moved docs for SRFI-14 into
160 main API chapter. Updated docstrings from libguile/.
162 2004-08-25 Marius Vollmer <mvo@zagadka.de>
164 * api-data.texi, srfi-modules.texi: Moved docs for SRFI-14 into
165 main API chapter. Updated docstrings from libguile/.
167 2004-08-24 Marius Vollmer <marius.vollmer@uni-dortmund.de>
169 Ran a (docstring-process-module "(guile)") and moved entries from
170 new-docstrings.texi to their appropriate place.
172 * api-undocumented.texi: New file.
174 2004-08-21 Marius Vollmer <mvo@zagadka.de>
176 From Richard Todd, Thanks!
178 * scheme-scripts.texi (Invoking Guile): documented new '-L'
181 2004-08-20 Marius Vollmer <mvo@zagadka.de>
183 * gh.texi: Updated transition section with new recommended things.
185 2004-08-19 Marius Vollmer <marius.vollmer@uni-dortmund.de>
187 * api-data.texi (Strings): Document copy-on-write behavior and
188 mutation-sharing substrings.
189 (Symbols): Document scm_from_locale_symbol and
190 scm_from_locale_symboln.
192 2004-08-18 Kevin Ryde <user42@zip.com.au>
194 * posix.texi (Network Sockets and Communication): Add SOCK_RDM and
197 * posix.texi (Internet Socket Examples): Correction to socket calls,
198 should be PF_INET not AF_INET (though generally the two are the same
201 2004-08-14 Kevin Ryde <user42@zip.com.au>
203 * api-scheduling.texi (Mutexes): New datatype-centric section, adding
204 fair mutexes and collecting up material from ...
205 (Low level thread primitives, Higher level thread procedures, C level
206 thread interface): ... these nodes.
208 * srfi-modules.texi (SRFI-13 Predicates): Add string-any and
209 string-every support for char and charset predicates.
211 2004-08-11 Marius Vollmer <mvo@zagadka.de>
213 * api-data.texi (scm_c_round, scm_c_truncate): Docs for'em.
215 2004-08-10 Marius Vollmer <marius.vollmer@uni-dortmund.de>
217 * api-control.texi: Updated example to use scm_to_locale_string
218 instead of roll-your-own scm_to_string. Also showcase
221 * api-data.texi: Docs for scm_is_string, scm_to_locale_string*,
222 and scm_from_locale_string*.
224 * api-memory.texi: Docs for scm_frame_free.
226 2004-08-09 Kevin Ryde <user42@zip.com.au>
228 * api-io.texi (File Ports): In open-file, describe the "b" binary flag.
230 * slib.texi (SLIB): Add notes on delete-file, provided? and open-file
231 overridden by ice-9 slib module.
233 2004-08-05 Kevin Ryde <user42@zip.com.au>
235 * api-scheduling.texi (Arbiters): Tweak wording for clarity, note any
236 thread can unlock not just the one which locked.
238 * posix.texi (Conventions): Describe system-error args, use @defun for
239 system-error-errno instead of just words.
241 * srfi-modules.texi (SRFI-13 Predicates): Tweak wording for clarity.
242 For string-every, note return is #t when no characters. For
243 string-any and string-every, note last pred call is not currently a
244 tail call, contrary to SRFI-13 spec.
246 2004-08-03 Marius Vollmer <marius.vollmer@uni-dortmund.de>
248 * api-data.texi: Added scm_is_real, scm_is_rational,
249 scm_to_double, scm_from_double, numerator, and denominator. Added
250 scm_is_complex, scm_is_number, scm_c_make_rectangular,
251 scm_c_make_polar, scm_c_real_part, scm_c_imag_part,
252 scm_c_magnitude, and scm_c_angle.
254 2004-08-02 Marius Vollmer <marius.vollmer@uni-dortmund.de>
256 * gh.texi: Replaced references to scm_num2* with scm_to_* and
257 references to scm_*2num with scm_from_*.
259 Renamed many file to make the structure of the manual more evident
260 in the names. Changed all references.
262 * scheme-binding.texi: Renamed to api-binding.texi.
263 * scheme-compound.texi: Renamed to api-compound.texi.
264 * scheme-control.texi: Renamed to api-control.texi.
265 * scheme-data.texi: Renamed to api-data.texi.
266 * scheme-debug.texi: Renamed to api-debug.texi.
267 * deprecated.texi: Renamed to api-deprecated.texi.
268 * scheme-evaluation.texi: Renamed to api-evaluation.texi.
269 * ref-init.texi: Renamed to api-init.texi.
270 * scheme-io.texi: Renamed to api-io.texi.
271 * scheme-memory.texi: Renamed to api-memory.texi.
272 * scheme-modules.texi: Renamed to api-modules.texi.
273 * scheme-options.texi: Renamed to api-options.texi.
274 * scm.texi: Renamed to api-overview.texi.
275 * scheme-procedures.texi: Renamed to api-procedures.texi.
276 * scheme-scheduling.texi: Renamed to api-scheduling.texi.
277 * scheme-scm.texi: Renamed to api-scm.texi.
278 * scheme-smobs.texi: Renamed to api-smobs.texi.
279 * scheme-snarf.texi: Renamed to api-snarf.texi.
280 * scheme-translation.texi: Renamed to api-translation.texi.
281 * scheme-utility.texi: Renamed to api-utility.texi.
282 * debugging.texi: Renamed to scheme-debugging.texi.
283 * scripts.texi: Renamed to scheme-scripts.texi.
284 * program.texi: Renamed to libguile-program.texi.
286 * api-deprecated.texi: Removed.
287 * intro.texi (Discouraged and Deprecated): General information
288 about deprecation, etc.
290 2004-07-30 Marius Vollmer <marius.vollmer@uni-dortmund.de>
292 * misc-modules.texi (Formatted Output): Changed @w to @w{} in
293 itemize. The former doesn't work for some reason...
295 2004-07-28 Kevin Ryde <user42@zip.com.au>
297 * misc-modules.texi (Formatted Output): Rewrite, describing escapes
298 and parameters in detail.
299 * guile.texi (@le, @ge): New macros for ifnottex.
301 2004-07-24 Kevin Ryde <user42@zip.com.au>
303 * guile.texi (@nicode): Use @alias instead of @macro, for correct
304 handling of backslashes.
306 * scheme-control.texi (Frames): Add @vindex for SCM_F_WIND_EXPLICITLY.
308 * scheme-data.texi (String Syntax): Add all backslash forms accepted.
309 (Regexp Functions): Use @defvar for regexp/icase etc, to emphasise
310 that they're variables not symbols etc.
312 * scheme-smobs.texi (Smobs): In SCM_SMOB_OBJECT_LOC,
313 SCM_SMOB_OBJECT_2_LOC, SCM_SMOB_OBJECT_3_LOC, use {} to avoid "*"
314 getting into the index as part of the macro name.
316 * srfi-modules.texi (SRFI-0): Revise for clarity, drop BNF in favour
317 of plain description, emphasise this is just for portable programs.
319 2004-07-10 Marius Vollmer <marius.vollmer@uni-dortmund.de>
321 * scheme-data.texi (Integers): Talk more about inexact and exact
324 2004-07-10 Kevin Ryde <user42@zip.com.au>
326 * srfi-modules.texi (SRFI-0): Add srfi-6 to the identifiers provided
329 2004-07-07 Marius Vollmer <marius.vollmer@uni-dortmund.de>
331 * scheme-data.texi (Integers): Added docs for the new scm_is_,
332 scm_to_ and scm_from_ functions for integers.
334 * data-rep.texi (How Guile does it): Mark as being in limbo. All
335 the real documentation will be in the nodes "Programming in C" and
337 (Boolean Data): Just refer to node "Booleans".
339 * gh.texi: Replace references to SCM_NFALSEP, etc with
342 * scheme-data.texi (Booleans): Flag all function-like definitions
345 2004-07-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
347 * scheme-data.texi: Remove non-R5RS stuff from the 'rn' index.
349 * scheme-utility.texi: Added scm_is_eq, scm_eq_p, scm_eqv_p, and
352 2004-07-05 Marius Vollmer <marius.vollmer@uni-dortmund.de>
354 * scheme-data.texi (Booleans): Added reference entries for
355 scm_is_true, scm_is_false, scm_is_bool, scm_from_bool, and
358 2004-06-28 Marius Vollmer <marius.vollmer@uni-dortmund.de>
360 * Makefile.am: Removed home-grown code for HTML generation.
361 Automake does it for us now.
363 * guile.texi, scheme-scm.texi: Do not use TeXinfo markup in
364 section or node names.
366 2004-06-20 Rob Browning <rlb@defaultvalue.org>
368 * srfi-modules.texi (SRFI-31): add documentation for srfi-31.
370 2004-05-19 Kevin Ryde <user42@zip.com.au>
372 * Makefile.am (CLEANFILES): Remove guile.cps guile.fns guile.rns
373 guile.tps guile.vrs guile.tmp, cleaned by automake these days.
375 2004-05-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
377 * scheme-smobs.texi: Updated for new SCM_SMOB_* macros.
379 * preface.texi: Moved around the sections so that the manual
380 overview comes first.
382 * libguile-smobs.texi: Updated for the new role of scm_t_bits.
384 2004-04-21 Marius Vollmer <marius.vollmer@uni-dortmund.de>
386 * Big reorganization of the whole manual to give it a simpler
389 2004-03-25 Kevin Ryde <user42@zip.com.au>
391 * slib.texi (SLIB): Amend `require' cross reference node name, is
392 called "Require" in slib 3a1.
394 2004-03-23 Kevin Ryde <user42@zip.com.au>
396 * scheme-data.texi (Reals and Rationals): Typo in `rationalize'.
398 2004-03-04 Kevin Ryde <user42@zip.com.au>
400 * posix.texi (Processes): Add setgroups.
402 * srfi-modules.texi (SRFI-26): New section.
404 2004-02-21 Kevin Ryde <user42@zip.com.au>
406 * scheme-evaluation.texi (Expression Syntax): Add @findex entries for
407 quote and quasiquote no longer using @deffn.
409 2004-02-20 Marius Vollmer <marius.vollmer@uni-dortmund.de>
411 * scheme-evaluation.texi (Expression Syntax): Turned syntax
412 description into a table, @deffn is not really up to the task.
414 2004-02-18 Marius Vollmer <mvo@zagadka.de>
416 * guile.texi: Replaced list of authors with "The Guile
419 * preface.texi (Contributors to the Manual): New section.
421 * scheme-evaluation.texi (Expression Syntax): Use an empty name
422 for the function call syntax definition. Otherwise, TeX complains
423 about unbalanced parenthesis.
425 2004-02-18 Kevin Ryde <user42@zip.com.au>
427 * scheme-evaluation.texi (Expression Syntax): Fill section with
428 function calling etc, and quote and quasiquote.
430 * srfi-modules.texi (SRFI-9): Revise for detail and clarity. Don't
431 use ":foo" for example type name, since that depends on the keyword
434 2004-02-15 Mikael Djurfeldt <mdj@chunk.mit.edu>
436 * scheme-compound.texi (Hash Table Reference): Wrote a new entry
437 for hash-for-each-handle.
439 2004-02-16 Kevin Ryde <user42@zip.com.au>
441 * scheme-compound.texi (Sloppy Alist Functions): Amend error messages
442 shown to match current guile output.
444 2004-02-15 Mikael Djurfeldt <mdj@chunk.mit.edu>
446 * scheme-compound.texi (Hash Table Reference): Renamed hash-map
449 2004-02-15 Kevin Ryde <user42@zip.com.au>
451 * scheme-compound.texi (Hash Table Reference): In scm_hash_ref etc,
452 remove note that dflt must be given, it can be SCM_UNSPECIFIED.
454 * scheme-control.texi (while do): Expand and clarify `do', in
455 particular note iteration binds fresh locations, rather than values
458 * srfi-modules.texi (SRFI-4): Revise for clarity, give each function
459 explicitly rather than showing TAG so Emacs info-look can find them,
460 merge "SRFI-4 - Read Syntax" and "SRFI-4 - Procedures" into just one
463 2004-02-12 Kevin Ryde <user42@zip.com.au>
465 * scheme-compound.texi (Conventional Arrays): Revise for clarity.
466 In array-equal?, show multiple arguments allowed.
467 (Uniform Arrays): Remove duplicate array?.
468 * guile.texi (cross): New macro.
470 * scheme-compound.texi (Uniform Arrays): Note 1/3 prototype for
471 doubles is now an exact fraction.
473 * slib.texi (SLIB): Index entry for replacement `system'.
475 2004-01-28 Mikael Djurfeldt <mdj@chunk.mit.edu>
477 * scheme-compound.texi (Uniform Arrays): Added a FIXME warning
478 that the 1/3 prototype no longer works.
480 2004-01-23 Marius Vollmer <mvo@zagadka.de>
482 * Makefile.am (guile_TEXINFOS): Added fdl.texi.
484 2004-01-21 Marius Vollmer <mvo@zagadka.de>
486 Added copyright notices to all TeXinfo files.
489 * guile.texi: Include it as an appendix.
490 * preface.texi: State that the manual is FDL.
492 2004-01-20 Kevin Ryde <user42@zip.com.au>
494 * preface.texi (Guile License): Note readline is GPL and manual has
495 its own copying terms. Describe briefly what the licenses mean in
498 * scheme-scheduling.texi (Higher level thread procedures): In monitor,
499 don't let "newly created" suggest a mutex created on every evaluation.
500 Note what "monitor" means.
502 * slib.texi (SLIB): Note `system' redefined by (ice-9 slib). Tweak
505 2004-01-11 Kevin Ryde <user42@zip.com.au>
507 * misc-modules.texi (Queues): New chapter.
508 * guile.texi (Top): Add it.
510 2004-01-09 Kevin Ryde <user42@zip.com.au>
512 * scheme-compound.texi (Bit Vectors): Revise for clarity, following
513 report by Rouben Rostamian. Remove #b() example, that syntax is not
516 2004-01-07 Marius Vollmer <marius.vollmer@uni-dortmund.de>
518 * scheme-control.texi, scheme-io.tex, scheme-scheduling.texi:
519 Adapt to new 'frame' names. Document scm_c_with_fluid,
520 scm_c_with_fluids, and scm_frame_fluid.
522 2004-01-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
524 * scheme-control.texi: Document scm_on_unwind_with_scm and
525 scm_on_rewind_with_scm.
527 2004-01-05 Marius Vollmer <mvo@zagadka.de>
529 * scheme-scheduling.texi: Document scm_with_[un]blocked_asyncs.
531 * scheme-io.texi: Document scm_with_current_<foo>_port.
533 2004-01-03 Marius Vollmer <mvo@zagadka.de>
535 * scheme-control.texi: Document the frames stuff and other random
538 2004-01-04 Kevin Ryde <user42@zip.com.au>
540 * scheme-scheduling.texi (Threads): Note Guile uses POSIX threads, for
541 concurrency and preemption.
542 (C level thread interface): Note periodic libguile call required for C
543 code in threads, add commented out reminders for SCM_TICK and
544 guile-mode, for when those features are ready.
546 * srfi-modules.texi (SRFI-1 Filtering and Partitioning): For partition
547 and partition!, emphasise the multi-value return, note partition may
548 share a tail with the given list.
550 * srfi-modules.texi (SRFI-1 Searching, SRFI-1 Deleting, SRFI-1
551 Association Lists): Note how member, delete, delete! and assoc extend
552 the corresponding core functions.
554 2003-11-25 Kevin Ryde <user42@zip.com.au>
556 * tools.texi (Macros guile-snarf recognizes): Correction to GOOPS
559 2003-11-19 Marius Vollmer <mvo@zagadka.de>
561 * scheme-data.texi: Include exact rationals.
563 From Stephen Compall. Thanks!
565 * intro.texi (What is Guile?): Add @acronym for POSIX, R5RS, GUI,
566 and HTTP. Conclude linking libguile. Say what one can find *for*.
568 * preface.texi (Manual Conventions): Double-quote some statements
569 formerly single-quoted. Remove some redundant quotes around code.
570 Clarify meaning of `iff' further for those that didn't get it the
571 first time 'round (like me). Make graphical indicators samples,
572 not code. Put results of evaluation on the same line as @result
573 symbols. Use @print example as example of total usage, and remind
574 readers not to forget the difference.
576 2003-11-17 Marius Vollmer <mvo@zagadka.de>
578 * scheme-modules.texi: Document '@' and '@@'.
580 * scripts.texi: Mention that "-e (@ ...)" also works.
582 2003-11-15 Kevin Ryde <user42@zip.com.au>
584 * scheme-data.texi (Random): Add *random-state* variable, put note at
585 the top of the node about it being the default, rather than just in
586 the description of random.
588 2003-11-13 Marius Vollmer <mvo@zagadka.de>
590 * preface.texi (Manual Layout): Wrap POSIX, API, and SLIB in
591 @acronym. Change from paragraph format (somewhat clumsy-looking
592 on paper, at least) to @table format, with headers @strong. Made
593 example modules complete sentences. From Stephen Compall, thanks!
595 2003-11-09 Kevin Ryde <user42@zip.com.au>
597 * misc-modules.texi (Pretty Printing): Add new keyword options, break
598 example to avoid long line.
600 * scheme-data.texi (Random): In random, use @code for *random-state*.
601 Reported by Stephen Compall.
603 * srfi-modules.texi (SRFI-1 Filtering and Partitioning): Move filter
605 * scheme-compound.texi (List Modification): ... to here, now that
606 they're implemented in the core.
608 2003-11-03 Kevin Ryde <user42@zip.com.au>
610 * misc-modules.texi (File Tree Walk): New chapter.
611 * guile.texi: Add it.
613 2003-10-18 Kevin Ryde <user42@zip.com.au>
615 * gh.texi (Calling Scheme procedures from C, scm transition summary):
616 Refer to scm_list_n, not the old name scm_listify.
617 (scm transition summary): For gh_apply, recommend scm_apply_0, which
620 * gh.texi (Defining new Scheme procedures in C): Don't use
621 @strong{Note:}, latest makeinfo will complain it looks like a cross
624 * posix.texi (Time): Correction to strftime glibc cross reference
625 node, now "Formatting Calendar Time".
627 * srfi-modules.texi (SRFI-1 Searching): In break, note conflict with
628 binding established by `while'.
630 2003-10-09 Kevin Ryde <user42@zip.com.au>
632 * scheme-compound.texi (Hash Table Reference): Decribe rehashing, note
633 no hashx-remove!, describe make-hash-table size parameter.
635 2003-10-06 Marius Vollmer <mvo@zagadka.de>
637 * scheme-memory.texi: Added a short explanation of the GC and the
638 conservative stack scanning.
639 (scm_gc_protect_object, scm_gc_unprotect_object,
640 scm_permanent_object): New.
642 * data-rep.texi, scheme-memory.texi (scm_remember_upto_here_1,
643 scm_remember_upto_here_2): Moved from data-rep.texi to
646 2003-10-02 Kevin Ryde <user42@zip.com.au>
648 * scheme-io.texi (String Ports): In call-with-output-string, note proc
649 should not close the port. In get-output-string, note string must be
650 gotten before closing the port.
652 2003-09-21 Kevin Ryde <user42@zip.com.au>
654 * posix.texi (File System): In access?, reword a bit, clarify real
655 versus effective ID handling, cross reference glibc on that, and
656 recommend against access tests in library functions.
658 2003-09-13 Kevin Ryde <user42@zip.com.au>
660 * posix.texi (File System): In stat:dev and stat:mode, clarify that
663 * posix.texi (Network Address Conversion): Under IPv4, describe
664 numeric representation in Guile, add INADDR_LOOPBACK and
665 INADDR_BROADCAST, add commented-out INADDR_NONE.
667 * scheme-compound.texi (Append/Reverse): Merge reverse and reverse!,
668 describe newtail parameter for reverse!, remove confusing caveat about
669 head becoming tail for reverse!.
671 * scheme-io.texi (Reading): In port-column, port-line,
672 set-port-column! and set-port-line!, port parameter must be given,
673 there's no default to current input.
675 * scheme-io.texi (Reading): Add scm_c_read.
676 (Writing): Add scm_c_write.
678 * srfi-modules.texi (SRFI-1 Constructors): Add list-copy.
680 * srfi-modules.texi (SRFI-19): Rewrite, adding descriptions of all
681 functions, and a bit of an introduction.
683 2003-09-03 Kevin Ryde <user42@zip.com.au>
685 * scheme-data.texi (Keyword Primitives): Add examples to
686 make-keyword-from-dash-symbol and keyword-dash-symbol. Add
689 * scheme-data.texi (Symbol Primitives): In gensym, cross reference
690 uninterned symbols, use @w{} on " g" prefix to avoid any chance of a
691 line break obscuring it.
693 2003-08-30 Kevin Ryde <user42@zip.com.au>
695 * data-rep.texi (Remembering During Operations): Note
696 scm_remember_upto_here_1 applies only to C automatic variables.
698 * guile.texi: Move @contents to usual place after title page, and
699 after first menu since that looks nice in html.
701 * posix.texi (Ports and File Descriptors): In pipe PIPE_BUF, use
702 @defvar, reword a bit for clarity, cross reference glibc.
704 * posix.texi (Network Sockets and Communication): In socket, use
705 @defvar for protocol variables, cross reference for getprotobyname,
706 note it's usually connect and accept that establishes communication.
708 * posix.texi (Network Sockets and Communication): In socketpair,
709 clarify the return is a pair with ports in car and cdr, note
710 connection is full duplex, refer to socket for parameters, refer to
711 PF_UNIX rather than AF_UNIX.
713 * scheme-compound.texi (Append/Reverse): Merge append and append!,
714 shown parameters as lst1 ... lstN, describe list argument for
715 scm_append and scm_append_x and note that it's unmodified.
717 * scheme-compound.texi (Hash Table Reference): Add hashx- case
718 insensitive string example, add cross references to symbol-hash,
719 string-hash, string-hash-ci, and char-set-hash.
721 * scheme-control.texi (Multiple Values): In values, show args as "arg1
722 ... argN". In scm_values, note args is a list and returned object
723 shares structure with it.
725 * scheme-control.texi (Catch): Add scm_internal_catch.
726 (Lazy Catch): Add scm_internal_lazy_catch.
728 * scheme-data.texi (Arithmetic): Use a table for scheme to C libm
729 equivalences, add C99 trunc.
731 * scheme-procedures.texi (Lambda): Note ". rest" list argument is
732 always newly created.
734 * srfi-modules.texi (SRFI-1 Association Lists): In alist-delete and
735 alist-delete!, note argument order for the equality calls per SRFI-1
738 2003-08-26 Kevin Ryde <user42@zip.com.au>
740 * scheme-data.texi (Scientific): Add two-argument atan.
742 * tools.texi (How guile-snarf works): Need @@ for texinfo in example.
744 2003-08-17 Kevin Ryde <user42@zip.com.au>
746 * scheme-compound.texi (Hash Table Reference): Collect up groups of
747 functions to avoid duplication. Revise notes on hashx functions and
748 on vector implementation. In make-hash-table, size is now optional.
749 Add hash-map and hash-for-each.
751 2003-08-14 Kevin Ryde <user42@zip.com.au>
753 * scheme-control.texi (while do): Update `while' for code rewrite, in
754 particular describe break and continue.
756 2003-08-09 Kevin Ryde <user42@zip.com.au>
758 * scheme-memory.texi (Memory Blocks): Add index entries for deprecated
759 scm_must_malloc and friends.
761 2003-07-29 Kevin Ryde <user42@zip.com.au>
763 * scheme-compound.texi (List Constructors): Remove scm_cons_star,
764 since it's not very helpful.
766 * scheme-utility.texi (Property Primitives): In primitive-property-ref,
767 note parameters to not-found-proc, use hyphens rather than underscores
768 for that parameter name.
769 In primitive-property-set!, VAL is the value parameter not CODE.
771 2003-07-24 Kevin Ryde <user42@zip.com.au>
773 * scheme-control.texi (Dynamic Wind): Untabify.
774 (Multiple Values): Use @result.
775 Reported by Stephen Compall <s11@member.fsf.org>.
777 * scheme-control.texi (Continuations): Rewrite with more detail.
779 * scheme-scheduling.texi (System asyncs): Add index entries for C
782 * scheme-scheduling.texi (Parallel Forms): New section.
784 2003-07-18 Kevin Ryde <user42@zip.com.au>
786 * scheme-compound.texi (List Constructors): In list, use "elem1
787 ... elemN". Add scm_list_1, scm_list_2, scm_list_3, scm_list_4,
788 scm_list_5, scm_list_n. Remove scm_list, since it's a no-op.
789 * guile.texi (nicode): New macro.
791 * scheme-evaluation.texi (Fly Evaluation): In apply, reword for
792 clarity, drop the "append" example. Add scm_apply, scm_apply_0,
793 scm_apply_1, scm_apply_2, scm_apply_3.
794 Add scm_call_0, scm_call_1, scm_call_2, scm_call_3.
795 In apply:nconc2last, move down after "apply", reword for clarity, note
796 correspondence to apply params.
798 * srfi-modules.texi (SRFI-0): Add cond-expand index entry.
799 (SRFI-9): Add define-record-type index entry.
801 2003-07-12 Kevin Ryde <user42@zip.com.au>
803 * srfi-modules.texi (SRFI-1 Constructors): In iota, reword a bit for
804 clarity and add a couple of examples.
806 2003-07-10 Kevin Ryde <user42@zip.com.au>
808 * deprecated.texi (Deprecated): Add scm_remember.
810 2003-06-22 Kevin Ryde <user42@zip.com.au>
812 * data-rep.texi (Remembering During Operations): Refer to all "Guile
813 library functions" as provoking gc.
815 2003-06-19 Kevin Ryde <user42@zip.com.au>
817 * scheme-io.texi (File Ports): Describe call-with-input-file and
818 call-with-output-file together. Describe with-input-from-file,
819 with-output-to-file and with-error-to-file together, and add that they
820 use dynamic-wind on the current port setting and keep the port open in
821 support of captured continuations.
822 (Closing): Describe close-input-port and close-output-port together,
823 tweak the wording slightly.
825 2003-06-14 Kevin Ryde <user42@zip.com.au>
827 * data-rep.texi (Vector Data): For SCM_VECTOR_BASE, SCM_STRING_CHARS
828 and SCM_SYMBOL_CHARS, cross reference "Remembering During Operations".
830 * scheme-data.texi (Arithmetic): round is to nearest even.
832 2003-06-12 Kevin Ryde <user42@zip.com.au>
834 * data-rep.texi (Remembering During Operations): New section.
836 * scheme-data.texi (Primitive Numerics): Add atan2, pow, asinh, acosh
837 and atanh to scheme<->C table. Note asinh, acosh and atanh are C99,
838 and scm_asinh, scm_acosh and scm_atanh are equivalents. Cross ref
839 glibc "Mathematics". Reword this end part for clarity.
841 * scheme-memory.texi (Memory Blocks): Use {} around types for
842 @deftypefn, for correct name in indexes.
843 * scheme-utility.texi (C Hooks): Ditto.
844 * gh.texi (Scheme to C): Ditto.
846 * gh.texi (Scheme to C): In gh_scm2newstr, lenp is size_t* not int*.
847 This changed in guile 1.6, the docs weren't updated.
849 2003-06-09 Marius Vollmer <mvo@zagadka.de>
851 From Mike Gran <spikegran@earthlink.net>. Thanks!
853 * preface.texi: Minor punctuation mistakes. Hyphens should link
854 compound adjectives. Commas should be placed after a "therefore"
855 that begins a sentence. Commas should not be used to separate a
856 list of only 2 dependent clauses.
858 2003-06-07 Kevin Ryde <user42@zip.com.au>
860 * scheme-data.texi (Arithmetic): Cross reference glibc floor and ceil.
862 2003-06-05 Kevin Ryde <user42@zip.com.au>
864 * posix.texi (File System): stat:rdev and stat:blocks can return #f,
865 stat:blksize returns a sensible size if the field is not available.
867 * scheme-compound.texi (Array Mapping): Reword for clarity, and in
868 particular have the same parameter names in the text and prototypes.
870 * scheme-evaluation.texi (Delayed Evaluation): Add delay, reword
871 promise? and force a bit, describe recursive forcing of a promise by
874 * scheme-io.texi (Ports): Add notes on garbage collection, and on
875 explicitly closing file ports.
876 (File Ports): Cross reference Ports node on explicit closing.
878 * posix.texi (Network Sockets and Communication): Cross reference
879 Ports node on explicit closing.
881 * scheme-scheduling.texi (Futures): New section.
883 * srfi-modules.texi (SRFI-13 Miscellaneous): In string-replace, note
884 that start1 and end1 optional is a Guile extension.
886 2003-05-30 Kevin Ryde <user42@zip.com.au>
888 * deprecated.texi: Add substring-move-left! and substring-move-right!.
890 * scheme-io.texi (Default Ports): Remove duplicate descriptions of
891 set-current-output-port and set-current-error-port.
893 2003-05-27 Dirk Herrmann <D.Herrmann@tu-bs.de>
895 * scheme-compound.texi: Clarified that vectors need to be quoted.
897 2003-05-26 Kevin Ryde <user42@zip.com.au>
899 * posix.texi (Locales): Clarify setlocale a bit, list all categories,
900 cross reference to libc.
902 2003-05-24 Kevin Ryde <user42@zip.com.au>
904 * scheme-procedures.texi: Add index entries lambda, optargs, syncase.
906 * scsh.texi (The Scheme shell (scsh)): Add index entries.
908 2003-05-22 Kevin Ryde <user42@zip.com.au>
910 * srfi-modules.texi (SRFI-2): Rewrite and-let*, describing plain
911 expression clauses and improving the examples.
913 2003-05-17 Marius Vollmer <mvo@zagadka.de>
915 * posix.texi (socket): Use PF_ instead of AF_ prefix.
917 2003-05-16 Kevin Ryde <user42@zip.com.au>
919 * guile.texi: Use @copying, show copyright and permissions at start of
922 * srfi-modules.texi (SRFI-1 Deleting): Rewrite delete and
923 delete-duplicates, adding behaviour details specified by srfi-1.
925 2003-05-12 Kevin Ryde <user42@zip.com.au>
927 * preface.texi (Guile License): Refer to COPYING.LIB.
929 * repl-modules.texi (Loading Readline Support, Readline Options):
930 Index entries for readline functions.
932 * scheme-control.texi (Handling Errors): Fix regexp error key, should
933 be `regular-expression-syntax'.
935 * scheme-data.texi (Complex): Show z argument in prototypes.
937 2003-05-10 Kevin Ryde <user42@zip.com.au>
939 * scheme-data.texi (Reals and Rationals): Fix typo @result{#f}, and
940 put @result outside @code.
942 * scheme-data.texi (Bitwise Operations): Note negatives are treated as
943 infinite precision twos complement. Revise `ash' to emphasise this
944 for right shifts of negatives. Describe integer-length behaviour on
945 negatives. Add `...' to logand, logior, logxor since they take
947 * guile.texi (m): New macro.
949 * scheme-control.texi (Handling Errors): Revise C support section to
950 get index entries, and clarify parameters. Remove scm_regex_error, no
951 longer exists and wasn't available to applications.
953 * scheme-control.texi (Handling Errors): Index entries for error keys.
955 2003-05-08 Kevin Ryde <user42@zip.com.au>
957 * scheme-data.texi (Bitwise Operations): Fix lognot to ones-complement.
959 * slib.texi (JACAL): Fix @ref title.
960 Add index entries, use @file and @code variously.
962 2003-05-06 Kevin Ryde <user42@zip.com.au>
964 * scheme-scheduling.texi (C level thread interface): Use @deftypefn
965 not @deftypefun, to get function names (not types) indexed.
967 * scheme-options.texi (Build Config): Add index entries for
968 %guile-build-info keys.
970 2003-05-04 Kevin Ryde <user42@zip.com.au>
972 * scheme-data.texi (Integer Operations): Describe how quotient,
973 remainder and modulo round their results.
975 * scheme-io.texi (Reading): In read-char and peek-char, fix typos "?"
976 in @rnindex. In port-column, use @: after i.e.
977 (Writing): In get-print-state, two spaces after full stop. Add write,
980 * srfi-modules.texi (SRFI-1 Length Append etc): Add count.
981 (SRFI-1 Fold and Map): In reduce, fix typo "... variant of fold", add
982 "f" to fold call shown. In reduce-right, use @code on "reduce".
984 * data-rep.texi, gh.texi: Add spaces after some @defun names.
985 * posix.texi (Processes): Fix typo "hhhh".
987 2003-05-01 Neil Jerram <neil@ossau.uklinux.net>
989 * posix.texi: Add index entries for many variables and functions,
990 either using @defvar/@deffn or @vindex/@pindex. (Patch supplied
993 2003-04-30 Marius Vollmer <marius.vollmer@uni-dortmund.de>
995 * posix.texi (scm_c_port_for_each): Added.
997 2003-04-26 Neil Jerram <neil@ossau.uklinux.net>
999 * scheme-data.texi (Symbol Primitives): Document scm_str2symbol
1002 * data-rep.texi (Describing a New Type): Clarify that
1003 scm_make_smob_type_mfpe is deprecated. (Thanks to
1006 * scheme-control.texi (Handling Errors): Remove scm_sysmissing,
1007 long since gone from libguile. (Thanks to Kevin Ryde.)
1009 2003-04-23 Rob Browning <rlb@defaultvalue.org>
1011 * posix.texi (Processes): add documentation for system*.
1013 2003-04-05 Marius Vollmer <mvo@zagadka.de>
1015 * preface.texi: Reflect change to LGPL.
1017 2003-03-27 Rob Browning <rlb@defaultvalue.org>
1019 * scheme-io.texi (Reading): clarify character ordering in port for
1022 2003-03-07 Rob Browning <rlb@defaultvalue.org>
1024 * guile.texi: change MANUAL_EDITION to MANUAL-EDITION so we don't
1025 choke TeX (thanks to Dale P. Smith).
1027 * preface.texi: change MANUAL_EDITION to MANUAL-EDITION so we
1028 don't choke TeX (thanks to Dale P. Smith).
1030 2003-01-02 Mikael Djurfeldt <djurfeldt@nada.kth.se>
1032 * scheme-scheduling.texi (Low level thread primitives): Fixed typo
1033 in broadcast-condition-variable.
1035 2002-12-08 Rob Browning <rlb@defaultvalue.org>
1037 * scheme-options.texi (Build Config): add effective-version docs.
1039 2002-11-17 Neil Jerram <neil@ossau.uklinux.net>
1041 Applied patches from Stephen Compall as follows. (Thanks!)
1043 2002-11-06 Stephen Compall <rushing@sigecom.net>
1045 * posix.texi: Changed quotes to match Texinfo expectations.
1047 Added references to the glibc manual.
1049 Used proper Texinfo text marking for many keywords, such as @code,
1052 Fixed argument metasyntactic variable references in
1053 file-manipulation section so the usage in the descriptions matches
1054 the usage in the declarations.
1056 2002-10-26 Stephen Compall <rushing@sigecom.net>
1058 * scheme-data.texi: Addition and change of many Texinfo tags,
1059 particularly usage of @var and @samp, as well as reformatting of
1060 some lists into tables and usage of @result.
1062 Notes about some things I didn't understand, as well as a
1063 missing section on non-control characters.
1065 2002-10-27 Gary Houston <ghouston@arglist.com>
1067 * scheme-modules.texi (Environments): only available when
1068 (ice-9 r5rs) is used.
1069 * scsh.texi (The Scheme shell (scsh)): current url is www.scsh.net.
1071 2002-10-27 Marius Vollmer <mvo@zagadka.ping.de>
1073 * scheme-scheduling.texi: Updated mutex and condition varable
1076 2002-10-27 Neil Jerram <neil@ossau.uklinux.net>
1078 * debugging.texi (Debugging Features): Rewritten.
1080 2002-10-19 Neil Jerram <neil@ossau.uklinux.net>
1082 * new-docstrings.texi, scheme-binding.texi, scheme-io.texi,
1083 scheme-scheduling.texi, posix.texi: Automatic docstring updates.
1085 2002-10-14 Marius Vollmer <mvo@zagadka.ping.de>
1087 * intro.texi (Whirlwind Tour): Added pointer to examples
1090 2002-10-10 Marius Vollmer <mvo@zagadka.ping.de>
1092 * scheme-scheduling.texi (System Asyncs): Updated.
1094 2002-10-07 Marius Vollmer <mvo@zagadka.ping.de>
1096 * scheme-scheduling.texi (Asyncs): Updated.
1097 * posix.texi (sigaction): Updated.
1099 2002-10-03 Neil Jerram <neil@ossau.uklinux.net>
1101 * posix.texi (Processes), scheme-options.texi (Common Feature
1102 Symbols): Refer to provided? rather than deprecated feature?.
1104 2002-10-03 Marius Vollmer <mvo@zagadka.ping.de>
1106 * tools.texi (How guile-snarf works): Updated.
1107 (Writing your own snarfing macros): New.
1109 2002-09-25 Neil Jerram <neil@ossau.uklinux.net>
1111 * scheme-debug.texi (Debugging): Make sections into nodes.
1112 (Debugging Options): Node removed.
1114 * scheme-options.texi (Feature Tracking): Brought forward before
1115 sections on options.
1116 (Runtime Options): New section, to group options-related nodes.
1118 2002-09-24 Neil Jerram <neil@ossau.uklinux.net>
1120 * scheme-options.texi (Options and Config): Chapter name changed,
1121 and intro text improved.
1122 (Install Config): Brought forward, and renamed Build
1125 The following doc updates are from Ian Sheldon - thanks!
1127 * scheme-data.texi (Appending Strings, Regexp Functions, Match
1128 Structures): Add examples.
1129 (Regular Expressions): Add instruction to use (ice-9 regex)
1132 * slib.texi (SLIB): Remove duplicate `the'.
1134 2002-09-22 Neil Jerram <neil@ossau.uklinux.net>
1136 * scheme-options.texi (General option interface): Mention
1137 eval-options-interface and debug-options-interface.
1139 * scheme-debug.texi (Debugging): New node describing source
1142 2002-09-19 Neil Jerram <neil@ossau.uklinux.net>
1144 * scheme-utility.texi (Hook Reference): Improvements to hook docs.
1145 Thanks to Thien-Thi Nguyen for the patches.
1147 2002-09-16 Marius Vollmer <mvo@zagadka.ping.de>
1149 * scheme-data.texi (Symbol Props): It's "set-symbol-property!",
1150 not "set-symbol-property". Thanks to Pieter Pareit!
1152 2002-09-15 Marius Vollmer <mvo@zagadka.ping.de>
1154 * scheme-data.texi: Tell them to use 'provided?' instead of
1157 2002-09-09 Marius Vollmer <mvo@zagadka.ping.de>
1159 * scheme-ideas.texi (Creating a Procedure): Fixed typo. Thanks to
1162 * intro.texi: Updated GNu ftp server name. Use "-lguile" instead
1163 of "libguile.a". Some small fixes/improvements.
1165 * scheme-reading.texi: Added www.schemers.org. Removed foldoc,
1166 it's too generic. Updated 'teach yourself ...' URL.
1168 2002-08-27 Marius Vollmer <mvo@zagadka.ping.de>
1170 * scheme-modules.texi: Markup fixes and removal of gh_ references.
1171 Thanks to Dale Smith!
1173 2002-08-14 Marius Vollmer <mvo@zagadka.ping.de>
1175 * scheme-evaluation.texi (eval-string): Updated.
1177 * scheme-scheduling.texi (Fluids): Touched up a bit, added
1180 2002-08-13 Marius Vollmer <mvo@zagadka.ping.de>
1182 * scheme-modules.texi (More Modules Procedures): Removed.
1183 (Accessing Modules from C): New.
1185 2002-08-10 Gary Houston <ghouston@arglist.com>
1187 * scheme-procedures.texi: new section Primitive Procedures,
1188 documentation for scm_c_make_gsubr and scm_c_define_gsubr.
1189 * scheme-modules.texi (Compiled Code Modules): replace
1190 gh_new_procedure with scm_c_define_gsubr.
1192 2002-08-08 Neil Jerram <neil@ossau.uklinux.net>
1194 * gh.texi (Data types and constants defined by gh): Avoid
1195 generating index entry for SCM.
1197 * posix.texi (Runtime Environment): Remove duplicate doc for
1200 * data-rep.texi, scheme-memory.texi, scheme-modules.texi: Merge
1201 recent updates from stable branch.
1203 * posix.texi (File System, Time, Pipes, Network Databases,
1204 Internet Socket Examples): Add examples provided by Ian Sheldon.
1206 2002-08-08 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1208 * scheme-binding.texi: Don't talk about 'bound?' which is gone.
1209 Thanks to Christopher Cramer.
1211 2002-08-06 Han-Wen Nienhuys <hanwen@cs.uu.nl>
1213 * scheme-memory.texi (Memory Blocks): add scm_calloc, scm_gc_calloc.
1216 2002-08-05 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1218 * intro.texi, srfi-modules.texi: Added (use-modules (ice-9
1219 rdelim)) to an example that uses read-line. Thanks to Ralf
1222 * scheme-memory.texi: Added an introductory blurb about GC that I
1225 2002-08-02 Gary Houston <ghouston@arglist.com>
1227 * scheme-modules.texi: split "Scheme and modules" into
1228 "provide and require" and "Environments". Mention R5RS
1231 2002-07-16 Neil Jerram <neil@ossau.uklinux.net>
1233 * scheme-options.texi (Debugger options): New subsection
1234 describing stack overflow and what to do about it.
1236 2002-07-10 Gary Houston <ghouston@arglist.com>
1238 * scheme-modules.texi (Compiled Code Modules): Removed description
1239 of scm_register_module_xxx, which no longer exists. A description
1240 of current techniques is needed.
1242 2002-05-09 Marius Vollmer <mvo@zagadka.ping.de>
1244 * scheme-data.texi (Numbers): Added description of the new values
1245 +inf.0, -inf.0 and +nan.0.
1247 * posix.texi (Runtime Environment): Added entries for 'setenv' and
1250 2002-04-28 Marius Vollmer <mvo@zagadka.ping.de>
1252 * gh.texi, data-rep.texi: Moved `@deftyp {Data type} SCM' line
1253 from gh.texi to data-rep.texi. Both files already had similar
1254 descriptions for SCM. Given that gh.texi is deprecated, looking
1255 up `SCM' in the index should take one to the primary location
1256 rather than deprecated section. Hence this change. Added
1257 `@deftp' for scm_t_bits data type so that a proper index entry is
1258 added for this. Thanks to Richard Y. Kim!
1260 * data-rep.texi (Subrs): Changed scm_make_gsubr to
1261 scm_c_define_gsubr. Thanks to Richard Y. Kim!
1263 2002-04-24 Marius Vollmer <mvo@zagadka.ping.de>
1265 * srfi-modules.texi (SRFI-13 Miscellaneous): Updated docs of
1268 2002-04-20 Neil Jerram <neil@ossau.uklinux.net>
1270 * scheme-intro.texi (Scheme Layout), scm.texi (Reference Layout):
1271 Node moved from a to b.
1273 * guile.texi (Scheme Intro, Basic Ideas, Guile Scripting, Command
1274 Line Handling, Debugging Features, Autoconf Support, Miscellaneous
1275 Tools, Further Reading): Moved to new Part II.
1277 * preface.texi (Manual Layout): Part numbers updated accordingly.
1279 * guile.texi (Top): Move API Overview node to beginning of Guile
1281 (Part II: Writing and Running Guile Scheme): New part; will
1282 contain content from `Programming with Guile' that pertains to
1283 writing and using Guile on the Scheme level.
1285 * scm.texi (API Overview): Renamed from `Guile API'.
1287 * guile.texi (Top), scheme-modules.texi (Included Guile Modules):
1288 Debugger User Interface node renamed Debugging Features.
1290 * debugging.texi (Stacks and Frames): Node deleted; non-duplicated
1291 material moved to scheme-debug.texi.
1292 (Debugging Features): Renamed from `Debugger User Interface'.
1294 * scheme-debug.texi (Debugging): Rename chapter `Debugging
1295 Infrastructure' and reorganize its contents.
1297 * scheme-debug.texi (Debugging), scheme-control.texi (Handling
1298 Errors): Move display-error to error-focussed section.
1300 * scheme-debug.texi (Debugging), debugging.texi (Backtrace): Move
1301 backtrace to user-level debugging chapter.
1303 * scheme-debug.texi (Debugging), scheme-procedures.texi (Procedure
1304 Properties): Move procedure-name, procedure-source and
1305 procedure-environment to procedures chapter.
1307 * scheme-debug.texi (Debugging), scheme-memory.texi (Memory
1308 Blocks): Move malloc-stats to memory management chapter.
1310 * scheme-procedures.texi (Syntax Rules): Remove mention of
1311 use-modules for loading syncase; only use-syntax really works.
1312 Thanks to Panagiotis Vossos for spotting this.
1314 * program.texi (Scheme vs C): New node, with existing material
1315 taken from chapter intro.
1316 (Programming Overview): New intro para to introduce example of
1318 (Extending Dia): New node.
1320 2002-04-17 Marius Vollmer <mvo@zagadka.ping.de>
1322 * Makefile.am (CLEANFILES): Added guile.cps, guile.fns, guile.rns,
1323 guile.tps, guile.vrs, guile.tmp.
1325 2002-04-01 Neil Jerram <neil@ossau.uklinux.net>
1327 * scheme-intro.texi (Scheme Layout): Remove reference to defunct
1328 Guile Extensions index.
1330 * guile.texi: Removed Guile Extensions index.
1332 * scheme-indices.texi (Guile Extensions Index): Removed.
1334 * guile.texi: Remove vgone, vdeprecated, vchanged and vnote
1335 macros; they're not actually useful after all. Update copyright
1338 * scheme-compound.texi (Vectors): Make subsections into nodes.
1339 (Vectors): Review, slightly reorg and clarify docs in this
1342 * scheme-data.texi (Symbols): Reorganized node substructure and
1343 added lots of explanatory text around the @deffn's.
1345 2002-03-29 Neil Jerram <neil@ossau.uklinux.net>
1347 * scheme-modules.texi (Variables): Mention obarrays.
1349 * scheme-data.texi (Symbol Tables, Symbol Props): Remove vgone
1350 markers for deprecated symbol items.
1351 (Symbol Props): Remove doc for obsolete 2 arg version of
1353 (String Miscellanea): Removed, since it only contained duplicate
1354 doc for string-ci->symbol.
1355 (Symbol Tables): Move doc for gensym to Symbol Primitives; rest of
1358 * posix.texi (Ports and File Descriptors), scheme-evaluation.texi
1359 (Fly Evaluation): Remove vgone markers for close-all-ports-except,
1360 eval2 and read-and-eval!.
1362 * data-rep.texi (Describing a New Type), scheme-compound.texi
1363 (Append/Reverse), scheme-procedures.texi (Internal Macros):
1364 Trivial updates to sync with stable branch.
1366 2002-03-27 Neil Jerram <neil@ossau.uklinux.net>
1368 * scheme-compound.texi (List Searching): Remove docs for
1369 `scm_sloppy_mem*', which no longer exist.
1371 2002-03-24 Neil Jerram <neil@ossau.uklinux.net>
1373 * guile.texi (Top), intro.texi (What is Guile?, The Basic Guile
1374 Package): Use @ifnottex instead of @ifinfo, so that HTML
1375 generation works correctly.
1377 2002-03-24 Marius Vollmer <mvo@zagadka.ping.de>
1379 * tools.texi: Updated to reflect changes to the guile-snarf tool.
1381 2002-03-16 Neil Jerram <neil@ossau.uklinux.net>
1383 * scheme-utility.texi (Hooks): Further updates. New material on
1386 * scheme-evaluation.texi (Fly Evaluation): Note disappearance of
1387 eval2 and read-and-eval!.
1389 * deprecated.texi (Deprecated): Remove docs about previously
1390 deprecated items that have now been removed.
1392 2002-03-15 Thien-Thi Nguyen <ttn@giblet.glug.org>
1394 * tools.texi (guile-1.4 guile-snarf): Remove this node.
1395 (How guile-snarf works): Update usage and description to
1396 no longer mention "--compat=1.4" and instead "-d" and "-D".
1397 (Macros guile-snarf recognizes): Add list of deprecated macros
1398 and blurb. Add cindex for deprecated macros.
1400 2002-03-15 Neil Jerram <neil@ossau.uklinux.net>
1402 * scheme-utility.texi (Hooks): Reviewed and updated.
1404 * scheme-options.texi (Feature Tracking): New section.
1406 * scheme-data.texi (Arithmetic, Primitive Numerics): Add
1407 description of corresponding C functions.
1409 * scheme-utility.texi (Object Properties): Revamp documentation on
1412 * scheme-memory.texi (Weak References): Update reference to Object
1415 * guile.texi: Add macros for describing version information.
1417 * scheme-data.texi, scheme-debug.texi, scheme-io.texi,
1418 scheme-procedures.texi: Automatic updates from snarfed libguile
1421 2002-03-13 Thien-Thi Nguyen <ttn@giblet.glug.org>
1423 * Makefile.am (guile_toc.html): Look for guile.texi in $(srcdir).
1425 * tools.texi (How guile-snarf works): Mention "--compat=1.4", and
1426 new processing steps. Update usage example, makefile frag.
1428 (guile-1.4 guile-snarf): New subsubsection under
1429 "Init Snarfing with guile-snarf".
1431 2002-03-12 Neil Jerram <neil@ossau.uklinux.net>
1433 * scheme-compound.texi, scheme-data.texi, new-docstrings.texi:
1434 Automatic updates from snarfed libguile docstrings.
1436 * data-rep.texi, guile.texi, scheme-evaluation.texi,
1437 scheme-options.texi, scheme-translation.texi: Various minor
1438 enhancements ported from the stable CVS branch.
1440 2002-03-08 Thien-Thi Nguyen <ttn@giblet.glug.org>
1442 * tools.texi (Miscellaneous Tools): New node/chapter.
1443 (Snarfing, Init Snarfing with guile-snarf, How guile-snarf works,
1444 Macros guile-snarf recognizes, Doc Snarfing): New nodes/(sub)sections.
1445 (Executable Modules): Now a section under "Miscellaneous Tools".
1447 * guile.texi (Miscellaneous Tools): Add under "Part II".
1448 Implement by including tools.texi.
1450 * Makefile.am (guile_TEXINFOS): Add tools.texi.
1452 2002-03-07 Thien-Thi Nguyen <ttn@giblet.glug.org>
1454 * tools.texi: New file.
1456 2002-03-03 Neil Jerram <neil@ossau.uklinux.net>
1458 * autoconf.texi (Autoconf Background): Insert missing `of'.
1460 2002-03-01 Dirk Herrmann <D.Herrmann@tu-bs.de>
1462 * api.txt, data-rep.texi: Renamed the struct scm_cell to
1465 * data-rep.texi: Renamed scm_alloc_cell to scm_cell and
1466 scm_alloc_double_cell to scm_double_cell.
1468 2002-03-01 Marius Vollmer <mvo@zagadka.ping.de>
1470 * scheme-memory.texi (Upgrading from scm_must_malloc et al): New
1473 2002-02-28 Marius Vollmer <mvo@zagadka.ping.de>
1475 * data-rep.texi: Use scm_gc_malloc and scm_gc_free instead of
1476 scm_must_malloc and free in example code. Updated text for the
1477 new memory management functions.
1479 * scheme-debug.texi (malloc-stats): Refer to scm_gc_malloc instead
1480 of to scm_must_malloc.
1482 2002-02-27 Stefan Jahn <stefan@lkcc.org>
1484 * gh.texi (scm transition summary): Documented some more
1485 gh equivalents and removed appropriate FIXME's.
1487 2002-02-26 Thien-Thi Nguyen <ttn@giblet.glug.org>
1489 * Makefile.am: Update path to pre-inst-guile automake frag.
1491 2002-02-24 Rob Browning <rlb@defaultvalue.org>
1493 * .cvsignore: add autoconf-macros.texi.
1495 * Makefile.am (CLEANFILES): add autoconf-macros.texi.
1497 2002-02-19 Marius Vollmer <mvo@zagadka.ping.de>
1499 * scheme-memory.texi (Memory Blocks): New section.
1501 2002-02-05 Thien-Thi Nguyen <ttn@giblet.glug.org>
1503 * Makefile.am: Include $(top_srcdir)/pre-inst-guile.am.
1505 (GUILE): Delete var.
1506 (autoconf-macros.texi): Use $(preinstguiletool).
1508 2002-02-04 Thien-Thi Nguyen <ttn@giblet.glug.org>
1510 * autoconf.texi (Autofrisk, Using Autofrisk): New sections.
1511 (Autoconf Support): Add new sections to menu.
1513 2002-02-04 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1515 * scheme-data.texi (Symbol Uninterned): Added node.
1517 2002-01-29 Stefan Jahn <stefan@lkcc.org>
1519 * gh.texi (scm transition summary): Documented gh equivalents
1520 `scm_c_string2str', `scm_c_substring2str' and `scm_c_symbol2str'
1521 and removed the appropriate FIXME's.
1523 2002-01-14 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1525 * Makefile.am (autoconf-macros.texi): Also set GUILE_LOAD_PATH
1526 when invoking the uninstalled guile executable.
1528 2002-01-09 Thien-Thi Nguyen <ttn@giblet.glug.org>
1530 * Makefile.am (autoconf-macros.texi): Fix build bug:
1531 Write this file to srcdir. Thanks to I. N. Golubev.
1533 2002-01-08 Gary Houston <ghouston@arglist.com>
1535 * Makefile.am: attempt to use guile from $(top_builddir)/libguile
1536 when building autoconf-macros.texi. There are still problems with
1537 modules and running makeinfo when builddir != srcdir.
1539 2002-01-08 Thien-Thi Nguyen <ttn@giblet.glug.org>
1541 * data-rep.texi, gh.texi, guile.texi, intro.texi,
1542 misc-modules.texi, new-docstrings.texi, posix.texi, program.texi,
1543 repl-modules.texi, scheme-binding.texi, scheme-compound.texi,
1544 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
1545 scheme-ideas.texi, scheme-io.texi, scheme-memory.texi,
1546 scheme-modules.texi, scheme-procedures.texi,
1547 scheme-translation.texi, scheme-utility.texi, scm.texi, slib.texi,
1548 srfi-modules.texi: Spell check. Thanks to Fabrice Bauzac.
1550 2002-01-07 Neil Jerram <neil@ossau.uklinux.net>
1552 * intro.texi (Linking Programs With Guile): Fix typo (superfluous
1553 `do'). Thanks to Fabrice Bauzac.
1555 2002-01-05 Thien-Thi Nguyen <ttn@giblet.glug.org>
1557 * intro.texi: Spell check. Thanks to Fabrice Bauzac.
1559 2002-01-02 Thien-Thi Nguyen <ttn@giblet.glug.org>
1561 * guile.texi (Part II): Add "Autoconf Support"; include
1564 * Makefile.am (guile_TEXINFOS): Add autoconf.texi and
1565 autoconf-macros.texi.
1566 (autoconf.texi, autoconf-macros.texi): New rules.
1568 * autoconf.texi: New file.
1570 2001-12-22 Marius Vollmer <mvo@zagadka.ping.de>
1572 * scheme-compound.texi (Alist Example): Changed "Bismarck" to
1573 "Pierre". Thanks to Ron Peterson!
1575 2001-12-22 Neil Jerram <neil@ossau.uklinux.net>
1577 * program.texi (Programming Overview): Chapter renamed from
1578 `Programming Options'; some new material added.
1580 2001-12-07 Neil Jerram <neil@ossau.uklinux.net>
1582 * scm.texi (Guile API): Renamed from `Scheme Primitives' and
1583 broadened so that this chapter discusses the Guile API as a whole.
1585 * program.texi (Available Functionality): Revise so that text
1588 * guile.texi (Programming Intro): New introductory text.
1590 * scheme-ideas.texi (Definition): Reorder reference bullets in
1591 ascending page number order.
1593 2001-12-04 Martin Grabmueller <mg@glug.org>
1595 * scheme-procedures.texi (Optional Arguments): Typo fix: wither ->
1598 2001-12-01 Neil Jerram <neil@ossau.uklinux.net>
1600 * scheme-data.texi (Hooks): Moved into scheme-utility.texi.
1602 * Makefile.am (guile_TEXINFOS): Added scheme-compound.texi.
1604 * scheme-data.texi (Variables): Node moved to modules chapter.
1605 (Symbol Read Syntax): New node, with syntax-related material taken
1606 from old Symbols node.
1607 (Symbol Primitives): Renamed from `Symbols'.
1608 (Symbols and Variables): Renamed to `Symbols'.
1609 (Symbol Props): Renamed from `Symbol Tables'.
1610 (Symbols): General review, improvements and additional material
1611 throughout this section.
1612 (Other Data Types): New material: links to object types documented
1613 elsewhere. Also renamed node to `Other Types'.
1614 (Data Types): Split into two: `Simple Data Types' and `Compound
1615 Data Types'. Introductory blurbs rewritten accordingly.
1617 * guile.texi: Updated Notes comment.
1619 * scheme-data.texi (Rx Interface): Node moved to Guile Modules
1620 part, as the Rx interface is not core Guile.
1622 2001-11-30 Neil Jerram <neil@ossau.uklinux.net>
1624 * scheme-data.texi (String Miscellanea): Removed, moving doc for
1625 string-ci->symbol into the node on Symbols.
1627 * Makefile.am (ETAGS_ARGS): Added.
1629 * scheme-data.texi (Symbol Tables): Removed doc for gentemp,
1630 intern-symbol, string->obarray-symbol, symbol-binding,
1631 symbol-bound?, symbol-set!, unintern-symbol, symbol-interned?; all
1632 of which no longer exist.
1634 2001-11-25 Thien-Thi Nguyen <ttn@glug.org>
1636 * posix.texi: Fix spelling. Thanks to Chris Cramer.
1637 Reword `getpass' intro blurb.
1639 2001-11-23 Neil Jerram <neil@ossau.uklinux.net>
1641 * program.texi (Program Control): Remove spurious placeholder
1644 2001-11-20 Thien-Thi Nguyen <ttn@glug.org>
1646 * scheme-options.texi (Install Config):
1647 Tweak `%load-path' verb to not imply it's a proc.
1648 Add documentation for `%guile-build-info'.
1650 2001-11-19 Neil Jerram <neil@ossau.uklinux.net>
1652 * scheme-data.texi (Symbol Tables), new-docstrings.texi: Removed
1653 doc for builtin-bindings (no longer exists).
1654 (Variables): Expanded existing description of variables. Removed
1655 doc for builtin-variable (no longer exists).
1657 * scheme-binding.texi (Top Level): New docs for define, scm_define
1658 and scm_c_define. Also clarified point about interchangeability
1661 2001-11-18 Neil Jerram <neil@ossau.uklinux.net>
1663 * scheme-data.texi (Vectors): Autoupdate docs for
1664 vector-move-left! and vector-move-right!.
1666 2001-11-16 Neil Jerram <neil@ossau.uklinux.net>
1668 * debugging.texi, deprecated.texi, intro.texi, misc-modules.texi,
1669 new-docstrings.texi, posix.texi, scheme-binding.texi,
1670 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
1671 scheme-evaluation.texi, scheme-io.texi, scheme-memory.texi,
1672 scheme-modules.texi, scheme-options.texi, scheme-procedures.texi,
1673 scheme-scheduling.texi, scheme-translation.texi,
1674 scheme-utility.texi, script-getopt.texi, srfi-modules.texi: Change
1675 category for "primitive" and "procedure" @deffn's to {Scheme
1676 Procedure}; add @deffnx lines for {C Function}s; automatic updates
1677 from libguile docstring changes.
1679 * scheme-memory.texi (Garbage Collection): Removed doc for removed
1682 2001-11-14 Thien-Thi Nguyen <ttn@glug.org>
1684 * scheme-procedures.texi: Spell "library" correctly.
1686 2001-11-13 Neil Jerram <neil@ossau.uklinux.net>
1688 * new-docstrings.texi, scheme-data.texi: Merge recent doc
1689 improvements from stable branch.
1691 * scheme-options.texi: Automatic updates from docstring changes in
1692 libguile's C source code.
1694 2001-11-12 Neil Jerram <neil@ossau.uklinux.net>
1696 * scheme-data.texi (Vtables, Structure Basics): Automatic doc
1697 updates for struct? and struct-vtable?.
1698 (String Searching): Add missing "for". Thanks to Scott Lenser.
1700 2001-11-08 Neil Jerram <neil@ossau.uklinux.net>
1702 * guile.texi (Top): Added new chapter `Programming Options'.
1704 * program.texi: New file.
1706 * Makefile.am (guile_TEXINFOS): Added program.texi.
1708 2001-11-07 Neil Jerram <neil@ossau.uklinux.net>
1710 * scheme-memory.texi, scheme-io.texi, scheme-debug.texi,
1711 scheme-data.texi, scheme-binding.texi, posix.texi,
1712 new-docstrings.texi: Automatic updates from improved libguile
1715 2001-11-04 Neil Jerram <neil@ossau.uklinux.net>
1717 * preface.texi: Use MANUAL_EDITION variable.
1718 (Manual Layout): Updated to reflect reorg.
1720 * guile.texi (MANUAL_EDITION): New variable, with value
1721 incremented from 1.0 to 1.1 to reflect the reorg described here.
1722 (Top): Use MANUAL_EDITION variable.
1724 * scheme-indices.texi (R5RS Index, Guile Extensions Index): Use
1725 @unnumbered rather than @chapter for these indices.
1727 * guile.texi (Top): A little top-level reshuffling, with the aims
1728 that: (1) the `Guile Scheme' (reference) part of the manual
1729 becomes the `Guile API Reference', and covers both Scheme and C
1730 interfaces; (2) non-API-reference material such as the `Basic
1731 Ideas in Scheme' chapter is collected together to form a new part
1732 `Programming with Guile'. This new part will contain general
1733 documentation on using and programming Guile in both Scheme and C,
1734 including - for example - awareness of GC when C programming, how
1735 to use the snarf macros, how to debug ...
1736 (Top): Move inclusion of scheme-indices.texi so that all indices
1737 appear together in the printed manual.
1739 * Makefile.am (guile_TEXINFOS): Removed appendices.texi, added
1742 * appendices.texi: Removed.
1744 * debugging.texi (Debugger User Interface): New file, same as the
1745 material that used to be in appendices.texi, but now a chapter in
1746 Part II rather than an appendix.
1748 * appendices.texi (Obtaining and Installing Guile): Moved to
1749 become a chapter in ...
1750 * intro.texi: ... Part I: Introduction to Guile.
1752 * scm.texi (I/O Extensions): Moved to become a section of ...
1753 * scheme-io.texi (Input and Output): ... this chapter.
1755 * scm.texi (Handling Errors): Moved to become a section of ...
1756 * scheme-control.texi (Control Mechanisms): ... this chapter.
1758 2001-11-06 Thien-Thi Nguyen <ttn@glug.org>
1760 * srfi-modules.texi (SRFI-19, SRFI-19 Constants, SRFI-19 Current
1761 time and clock resolution, SRFI-19 Time object and accessors,
1762 SRFI-19 Time comparison procedures, SRFI-19 Time arithmetic
1763 procedures, SRFI-19 Date object and accessors, SRFI-19
1764 Time/Date/Julian Day/Modified Julian Day converters, SRFI-19 Date
1765 to string/string to date converters): New nodes.
1766 (SRFI Support): Add "SRFI-19" to menu.
1768 2001-11-06 Marius Vollmer <mvo@zagadka.ping.de>
1770 * scripts.texi: Document `--debug' and `--no-debug'.
1772 2001-10-27 Gary Houston <ghouston@arglist.com>
1774 * guile.texi, scsh.texi: removed obsolete guile-scsh material
1775 and updated links (I don't know if it should remain in the
1776 main menu. It's like slib I think.)
1778 * minor updates to the slib installation notes.
1780 2001-10-05 Neil Jerram <neil@ossau.uklinux.net>
1782 * scheme-evaluation.texi (Fly Evaluation): Removed documentation
1783 for `read-and-eval!' and `eval2'. (Thanks to Alex Schroeder for
1784 noticing that they'd disappeared!)
1786 2001-10-05 Thien-Thi Nguyen <ttn@glug.org>
1788 * scheme-io.texi (Writing): Add entry for `display'.
1789 Include in R5RS Index. Thanks to Alex Schroeder for suggestion.
1791 2001-09-26 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
1793 * srfi-modules.texi (SRFI-13): Tyop fix.
1794 (SRFI-13): Changed paragraph about bindings both in the code and
1797 * misc-modules.texi (Formatted Output): Tyop fix.
1798 (Formatted Output): Document ~g properly.
1800 Thanks to Alex Schroeder for pointing out the typos and sending
1803 2001-09-25 Thien-Thi Nguyen <ttn@glug.org>
1805 * scheme-procedures.texi (Syntax Rules): Add `cindex' directive.
1806 Thanks to suggestion by Alex Schroeder.
1808 2001-08-30 Neil Jerram <neil@ossau.uklinux.net>
1810 * guile.texi (Top): Group all index nodes together so that
1811 `Info-index' works more effectively in Info. Thanks to Eric
1812 Hanchrow for the report and fix.
1814 * scheme-data.texi (Random, String Syntax, String Modification,
1815 Regular Expressions), scheme-ideas.texi (Definition),
1816 scheme-modules.texi (Dynamic Linking and Compiled Code Modules),
1817 scm.texi (Transforming Scheme name to C name, Port
1818 Implementation): Various typo fixes and clarifications merged from
1819 the stable CVS branch.
1821 2001-08-27 Neil Jerram <neil@ossau.uklinux.net>
1823 * intro.texi: Merged wording fixes from stable CVS branch.
1825 * Makefile.am (guile_TEXINFOS): Remove ../AUTHORS.
1827 * guile.texi: Incorporate text previously in separate AUTHORS
1830 2001-08-27 Neil Jerram <neil@ossau.uklinux.net>
1832 The change log for files in this directory continues backwards
1833 from 2001-08-27 in ../ChangeLog, as all the Guile documentation
1834 prior to this date was contained in a single directory.