1 2006-08-01 Neil Jerram <neil@ossau.uklinux.net>
3 * scheme-debugging.texi (Debug Last Error, Interactive Debugger):
4 Moved/merged to scheme-using.texi, as REPL features.
6 (Intro to Breakpoints): New introductory text here. Removed all
7 subnodes except for Breakpoints Overview.
9 * scheme-using.texi: New.
11 * guile.texi (Programming in Scheme): Include new
12 scheme-using.texi file.
14 * Makefile.am (guile_TEXINFOS): Include new scheme-using.texi
17 2006-06-16 Ludovic Courtès <ludovic.courtes@laas.fr>
19 * api-utility.texi (Equality): Mentioned the behavior of `equal?'
20 for structures (as suggested by Kevin Ryde).
22 2006-06-13 Ludovic Courtès <ludovic.courtes@laas.fr>
24 * api-compound.texi (Structure Concepts): Mentioned the behavior
25 of `equal?' for structures.
27 2006-05-28 Kevin Ryde <user42@zip.com.au>
29 * srfi-modules.texi (SRFI-1 Length Append etc): Add an append-reverse
32 2006-05-20 Kevin Ryde <user42@zip.com.au>
34 * api-compound.texi (Pairs): Cross reference SRFI-1 second, third,
36 (List Modification): Cross reference SRFI-1 delete and lset-difference.
37 (List Searching): Cross reference SRFI-1 member.
38 (List Mapping): Cross reference SRFI-1 map etc.
39 (Retrieving Alist Entries): Cross reference SRFI-1 assoc.
41 * srfi-modules.texi (SRFI-1 Association Lists): Describe argument
42 order for "=" procedure.
44 2006-05-15 Kevin Ryde <user42@zip.com.au>
46 * posix.texi (Processes): Add primitive-_exit.
48 2006-05-10 Kevin Ryde <user42@zip.com.au>
50 * intro.texi (Linking Guile into Programs): Enhance example program,
51 change scm_str2string to scm_from_locale_string, since scm_str2string
52 is "discouraged". And check for NULL from getenv since neither
53 scm_str2string nor scm_from_locale_string can cope with that.
56 2006-05-09 Kevin Ryde <user42@zip.com.au>
58 * api-control.texi (Multiple Values): In `receive', add an example,
59 cross ref SRFI-8, tweak wording.
61 * api-io.texi (Port Implementation): @defun style for
62 scm_make_port_type and the various set functions.
64 * posix.texi (Ports and File Descriptors): Tweaks to fcntl.
66 2006-04-29 Kevin Ryde <user42@zip.com.au>
68 * api-scheduling.texi (Threads): In call-with-new-thread, handler arg
69 is optional (as of 1.8.0).
71 2006-04-15 Kevin Ryde <user42@zip.com.au>
73 * api-scheduling.texi (System asyncs): "{void *}" in @deffnx to keep
74 the "*" out of the name in the index.
76 2006-04-06 Kevin Ryde <user42@zip.com.au>
78 * posix.texi (Ports and File Descriptors): Clarify fcntl a bit,
79 and correction FD_CLOEXEC goes with FD_SETFD not FD_SETFL.
80 (Network Sockets and Communication): In accept, cross-reference to
83 2006-03-28 Kevin Ryde <user42@zip.com.au>
85 * api-compound.texi (Vector Accessing from C): Show
86 SCM_SIMPLE_VECTOR_SET not SCM_SIMPLE_VECTOR_SET_X, the former is
89 2006-03-21 Ludovic Courtès <ludovic.courtes@laas.fr>
91 * api-data.texi (Conversion): Add scm_c_locale_stringn_to_number.
93 2006-03-05 Kevin Ryde <user42@zip.com.au>
95 * api-compound.texi (Array Procedures): @pxref for `equal?'.
96 (Shared Arrays): Correction to make-shared-array stride example, need
97 `list' on the mapper return value.
99 2006-02-13 Marius Vollmer <mvo@zagadka.de>
101 * api-utility.texi (Object Properties): Removed confusing
102 paragraph about 'name' property.
104 2006-02-07 Kevin Ryde <user42@zip.com.au>
106 * api-modules.texi (Compiled Code Installation): Revise, in particular
107 @libdir@ needs to go via the makefile.
109 2006-02-04 Neil Jerram <neil@ossau.uklinux.net>
111 * api-control.texi (Throw Handlers): New node.
112 (Throw): Moved to after the Lazy Catch node.
113 (Catch): Enhance to cover the optional pre-unwind handler, and new
114 APIs scm_c_catch, scm_catch_with_pre_unwind_handler.
115 (Lazy Catch): Describe relationship to with-throw-handler.
116 Document that the handler may return, and what happens if it does.
117 (Throw): Mention that a throw can be handled by a throw handler as
120 2006-02-04 Kevin Ryde <user42@zip.com.au>
122 * api-options.texi (Build Config): pxref libtool on libguileinterface
124 * intro.texi (Writing Guile Extensions), libguile-extensions.texi (A
125 Sample Guile Extension): pxref libtool manual.
127 * api-modules.texi (Compiled Code Installation): New section.
129 * posix.texi (Network Address Conversion, Network Databases)
130 (Network Sockets and Communication, Internet Socket Examples): Misc
133 2006-01-29 Marius Vollmer <mvo@zagadka.de>
135 * api-scheduling.texi: Removed "Futures" node.
137 Renamed the "frames" that are related to dynamic-wind to "dynamic
138 contexts. Renamed all functions from scm_frame_ to scm_dynwind_.
139 Updated documentation.
141 2005-12-19 Ludovic Courtès <ludovic.courtes@laas.fr>
143 * api-data.texi (Operations Related to Symbols):
144 Documented `scm_take_locale_symbol ()'.
146 2005-12-15 Kevin Ryde <user42@zip.com.au>
148 * api-evaluation.texi (Fly Evaluation): Add scm_call_4, suggested by
151 * misc-modules.texi (Streams): In stream->list&length and
152 stream->reversed-list&length, make the two values clearer.
154 2005-12-14 Neil Jerram <neil@ossau.uklinux.net>
156 * api-options.texi (Evaluator trap options): Trap calls now always
157 use a debug object rather than a continuation.
158 (Debugger options, Examples of option use): Update help text for
159 'cheap option (which is now obsolete).
161 * api-evaluation.texi (Loading): Document custom reader.
163 2005-12-06 Marius Vollmer <mvo@zagadka.de>
165 * api-init.texi, api-scheduling.texi, libguile-concepts.texi:
166 Removed scm_leave_guile, scm_enter_guile and all references to
167 them since they are no longer in the API.
169 From Stephen Compall:
171 * api-control.texi (if cond case): Describe SRFI 61 cond.
173 * srfi-modules.texi (SRFI-61): New section.
174 (SRFI Support): Add SRFI-61 to menu.
176 2005-11-19 Kevin Ryde <user42@zip.com.au>
178 * api-compound.texi (Retrieving Alist Entries): Revise for clarity and
181 2005-11-06 Kevin Ryde <user42@zip.com.au>
183 From Ludovic Courtès, partial rework by me:
184 * doc/ref/api-modules.texi (Creating Guile Modules): In define-module,
185 describe #:re-export, #:export-syntax, #:re-export-syntax, #:replace
186 and #:duplicates. Add re-export.
188 2005-11-01 Kevin Ryde <user42@zip.com.au>
190 * posix.texi (Time): In strftime, note systems vary for %Z.
192 2005-10-29 Kevin Ryde <user42@zip.com.au>
194 * posix.texi (Network Socket Address): Add scm_make_socket_address,
195 scm_c_make_socket_address, scm_from_sockaddr, scm_to_sockaddr. This
196 change by Ludovic Courtès and revised a bit by me.
198 2005-10-27 Kevin Ryde <user42@zip.com.au>
200 * posix.texi (Network Address Conversion): Move INADDR_ANY to here.
201 (Network Socket Address): New section, move sockaddr bits to here, add
202 new make-socket-address.
203 (Network Sockets and Communication): In connect, bind, and sendto, now
204 take socket address object. In bind, leave INADDR constants for
205 "Network Address Conversion" node. In those plus accept, getsockname,
206 getpeername, reword a bit for clarity.
208 2005-10-24 Kevin Ryde <user42@zip.com.au>
210 * posix.texi (Network Sockets and Communication): Combine and revise
211 getsockopt and setsockopt. Add OPTNAME constants, including new
212 IP_ADD_MEMBERSHIP and IP_DROP_MEMBERSHIP.
214 * posix.texi (Time): Revise strftime for clarity, cross reference man
215 3 strftime (suggested by Greg Troxel), note locale character set when
216 setlocale has been called.
218 2005-10-15 Neil Jerram <neil@ossau.uklinux.net>
220 * api-debug.texi (Source Properties): Add text describing/advising
221 limited use of source properties.
223 * api-debug.texi (Source Properties): Documentation of source
224 property procedures moved here from ...
226 * api-procedures.texi (Procedure Properties): ... where it didn't
229 2005-10-05 Kevin Ryde <user42@zip.com.au>
231 * api-data.texi (Regexp Functions): Notes on zero bytes and locale
234 * misc-modules.texi (Formatted Output): Show modifiers like ~:d
237 2005-08-06 Kevin Ryde <user42@zip.com.au>
239 * api-compound.texi (List Modification): In filter, return may share a
240 tail with the input, as per docstring. In filter!, fix chopped off
241 note of modifying input.
243 * api-control.texi (Error Reporting): In strerror, note message is in
244 locale language and charset.
246 2005-07-12 Kevin Ryde <user42@zip.com.au>
248 * api-data.texi (String Selection): In string-pad, don't say anything
249 about sharing strings, decided against doing that.
250 (Miscellaneous String Operations): Ditto in string-filter and
253 * api-data.texi (String Selection): Merge descriptions of string-trim,
254 string-trim-right and string-trim-both for brevity.
256 2005-06-24 Kevin Ryde <user42@zip.com.au>
258 * api-options.texi (Debugger options): Cross reference new Tail Calls
259 node rather than R5RS on tail recursion.
261 2005-06-23 Kevin Ryde <user42@zip.com.au>
263 * guile.texi, libguile-concepts.texi, libguile-extensions.texi,
264 libguile-linking.texi, libguile-smobs.texi: Spelling errors reported
267 * api-compound.texi (Pairs, List Syntax): Cross reference Expression
269 * api-control.texi (Lazy Catch): Cross ref for with-fluids.
270 * libguile-linking.texi (A Sample Guile Main Program): Cross reference
271 automake manual for aclocal.
272 * libguile-program.texi (Extending Dia): URL for Dia home page.
273 (Dia Primitives): Cross ref for scm_c_define_gsubr.
275 2005-06-12 Marius Vollmer <mvo@zagadka.de>
277 * gh.texi: More stuff about transitioning away from GH.
279 2005-06-11 Kevin Ryde <user42@zip.com.au>
281 * api-data.texi (Miscellaneous String Operations): In string-filter
282 and string-delete, note result may share with input string (as allowed
285 2005-06-06 Kevin Ryde <user42@zip.com.au>
287 * api-compound.texi (Array Procedures): In array-in-bounds?,
288 correction to example result.
290 * api-init.texi (Initialization), api-scheduling.texi (Blocking):
291 {} groups around "void*" C return types.
293 2005-05-04 Kevin Ryde <user42@zip.com.au>
295 * srfi-modules.texi (SRFI-1 Selectors): In drop-right, note always a
296 new list. In take-right, note result shares common tail. Per spec.
298 2005-05-03 Kevin Ryde <user42@zip.com.au>
300 * api-data.texi (String Constructors): Clarify string, list->string
301 and reverse-list->string a bit.
303 2005-04-30 Kevin Ryde <user42@zip.com.au>
305 * api-io.texi (Default Ports): Describe buffering on standard ports.
307 2005-04-23 Kevin Ryde <user42@zip.com.au>
309 * api-data.texi (Regexp Functions): Add list-matches and fold-matches.
311 * data-rep.texi (Subrs): Note that subr must not modify its rest list.
313 2005-04-19 Kevin Ryde <user42@zip.com.au>
315 * api-data.texi (Regexp Functions): Clarity flags parameter.
317 * misc-modules.texi, guile.texi (Rx Regexps): Remove this section, Rx
318 is not in the core and we don't want to confuse anyone with it and the
319 builtin posix regexps.
321 2005-04-04 Han-Wen Nienhuys <hanwen@xs4all.nl>
323 * srfi-modules.texi (SRFI-1 Set Operations): use @cross iso. @times.
325 * guile.texi: add @cross for @tex
327 2005-04-02 Kevin Ryde <user42@zip.com.au>
329 * guile.texi (@times): New macro.
331 * repl-modules.texi (Readline Support): Cross ref readline manual.
332 (Loading Readline Support): Add GUILE_HISTORY and .inputrc Guile
335 * srfi-modules.texi (SRFI-1 Association Lists): In alist-cons, clarify
336 a bit and cross reference core acons.
338 * srfi-modules.texi (SRFI-1 Set Operations): Revise and expand.
339 (SRFI-1 Deleting): In delete, cross reference lset-difference.
341 * srfi-modules.texi (SRFI-19): Note Gregorian leap year rules
342 incorrectly extended back prior to 1582.
344 2005-03-29 Marius Vollmer <marius.vollmer@uni-dortmund.de>
346 * api-compound.texi: Fixed some typos and added some docs. Talk
347 about concrete and abstract hash tables.
349 2005-03-14 Kevin Ryde <user42@zip.com.au>
351 * srfi-modules.texi (SRFI-55): New section.
352 (SRFI-60): New section.
354 2005-03-01 Kevin Ryde <user42@zip.com.au>
356 * api-compound.texi (Shared Arrays): New section. Rewrite
357 make-shared-array for clarity, adding examples.
359 * libguile-concepts.texi (Control Flow): Cross reference Tail Calls.
361 2005-02-17 Kevin Ryde <user42@zip.com.au>
363 * api-data.texi (Reals and Rationals): Use tex for sqrt2 and pi.
364 (Complex Numbers): Add polar form read syntax.
366 2005-02-15 Kevin Ryde <user42@zip.com.au>
368 * posix.texi (File System): In tmpnam, clarify security and use of
369 O_EXCL. In mkstemp!, in fact posix doesn't specify permissions.
371 * scheme-ideas.texi (Tail Calls): New section.
373 2005-02-12 Kevin Ryde <user42@zip.com.au>
375 * api-data.texi (String Selection): In string-pad and
376 string-pad-right, clarify which end the padding goes on, and merge
379 * api-data.texi (Integer Operations): In gcd and lcm, show args.
380 (Arithmetic): In truncate, add missing arg.
382 * srfi-modules.texi (SRFI-1 Fold and Map): Rewrite fold, pair-fold and
385 2005-02-05 Kevin Ryde <user42@zip.com.au>
387 * posix.texi (File System): In mkstemp!, in fact posix doesn't specify
388 the permissions mode. Add an example setting 666 less umask.
390 2005-02-04 Kevin Ryde <user42@zip.com.au>
392 * api-io.texi (File Ports): In port-filename, cannot use after close.
394 * posix.texi (Time): In mktime, clarify fields of sbd-time used, and
395 the handling of tm:isdst.
397 * srfi-modules.texi (SRFI-0): Add srfi-4, srfi-13 and srfi-14 now in
400 2005-01-29 Kevin Ryde <user42@zip.com.au>
402 * posix.texi (Signals): In sigaction, add SA_NOCLDSTOP, make it
403 clearer SA_RESTART is a variable.
405 2005-01-28 Kevin Ryde <user42@zip.com.au>
407 * srfi-modules.texi (SRFI-1 Predicates): Clarify proper-list?,
408 circular-list? and dotted-list?, note any object passes exactly one of
411 * srfi-modules.texi (SRFI-19 Time/Date conversions): In default
412 tz-offset, note restrictions on a 32-bit system.
414 2005-01-24 Kevin Ryde <user42@zip.com.au>
416 * api-i18n.texi (Internationalization): Expand and revise a bit for
419 * srfi-modules.texi (SRFI-1 Searching): In member, note `=' called arg
421 (SRFI-1 Set Operations): Remove lset-adjoin!, doesn't exist in the
422 code or the srfi spec.
424 2005-01-20 Kevin Ryde <user42@zip.com.au>
426 * posix.texi (Ports and File Descriptors): In flock, for LOCK_NB note
427 logior for LOCK_NB and EWOULDBLOCK error, and note flock doesn't work
430 * srfi-modules.texi (SRFI-1 Searching): In list-index, note 0 based
431 index and #f for not found.
433 2005-01-15 Kevin Ryde <user42@zip.com.au>
435 * api-data.texi (Bitwise Operations): In logtest and logbit?, describe
436 operations in words, not just equivalent expressions. In
437 integer-expt, clarify a bit and note negative k allowed and 0^0==1.
439 * api-data.texi (Random): In random:solid-sphere!, there is no return
442 * api-evaluation.texi (Loading): In %load-hook, need to use set!, and
445 2005-01-14 Marius Vollmer <marius.vollmer@uni-dortmund.de>
447 * scheme-scripts.texi: Describe new 1.4 compatability behavior of
450 2005-01-14 Kevin Ryde <user42@zip.com.au>
452 * api-data.texi (Mapping Folding and Unfolding): In
453 string-for-each-index, make it clear iteration is over indices.
455 * posix.texi (User Information): Note cuserid gone from POSIX.
456 Prompted by Roland Besserer.
458 * srfi-modules.texi (SRFI-39): New section.
460 2005-01-10 Kevin Ryde <user42@zip.com.au>
462 * srfi-modules.texi: Various index entries.
463 (SRFI-19 Introduction): Note MJD basis is 2400000.5.
464 (SRFI-19 Date): In date-second, clarify leap second usage. In
465 date-year, note negatives for B.C. and no zero. In current-date,
466 don't let it read like it's just UTC which is returned.
468 2005-01-08 Kevin Ryde <user42@zip.com.au>
470 * api-modules.texi (Creating Guile Modules): Expand define-modules
471 #:autoload, clarify that it's a list of symbols.
473 * api-modules.texi (Included Guile Modules): Add expect, format, ftw,
474 getop-long, history, popen, pretty-print, q, readline, receive, regex,
475 streams, syncase, srfi-16, srfi-19 and srfi-31. Remove ice-9 jacal,
478 * posix.texi (File System): In mkstemp!, note 0600 creation mode.
480 2005-01-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
482 * api-compound.texi: Finished(?) the new array API docs.
484 2005-01-02 Kevin Ryde <user42@zip.com.au>
486 * posix.texi (Pipes): Expand and clarify a bit. Describe port
487 inheritance. Caution against waitpid WAIT_ANY.
489 2004-12-29 Marius Vollmer <mvo@zagadka.de>
491 * api-compound.texi (Arrays): Updated for the new 'typed' approach
494 2004-12-28 Kevin Ryde <user42@zip.com.au>
496 * api-data.texi (String Predicates): For string-any and string-every,
497 last chars are now tail calls per srfi, and reinstate char_pred can be
498 character or character set (somehow lost in cut and paste).
500 * srfi-modules.texi (SRFI-1 Searching): In any and every, revise for
501 clarity, note last call in each is a tail call.
503 2004-12-27 Marius Vollmer <mvo@zagadka.de>
505 * api-compound.texi (Vectors, Bit Vectors, Uniform Numeric
506 Vectors): Updated for the distinction between read-only and write
507 access to storage locations.
509 2004-12-22 Marius Vollmer <marius.vollmer@uni-dortmund.de>
511 * api-compound.texi (Arrays): Reorganized and 'modernized'.
513 2004-12-20 Mikael Djurfeldt <djurfeldt@nada.kth.se>
515 * expect.texi (Expect): Removed backslash escapes of regexp
516 operators ( and ) in code example for expect-strings.
518 2004-12-14 Kevin Ryde <user42@zip.com.au>
520 * api-data.texi (Regexp Functions): Revise regex-substitute and
521 regex-substitute/global for clarity, add some examples.
523 * api-procedures.texi (lambda* Reference): Revise for clarity, note
524 how #:rest works with #:key, note previous bindings available to
527 2004-12-05 Kevin Ryde <user42@zip.com.au>
529 * srfi-modules.texi (SRFI-1 Length Append etc): In concatenate, note
530 equivalence to "apply append".
532 2004-11-09 Marius Vollmer <marius.vollmer@uni-dortmund.de>
534 * api-compound.texi (Generalized Vectors): New.
535 (Bit Vectors): More docs.
536 (Uniform Vectors): Call them Uniform numeric vectors.
538 2004-10-29 Marius Vollmer <marius.vollmer@uni-dortmund.de>
540 * api-compound.texi (Uniform Vectors): Added c32 and c64 docs.
542 2004-10-27 Marius Vollmer <marius.vollmer@uni-dortmund.de>
544 * srfi-modules.texi, api-compound.texi: Moved SRFI-4 docs into
545 main part. Moved bit vectors out of array section to make them
548 2004-10-19 Marius Vollmer <marius.vollmer@uni-dortmund.de>
550 * api-smobs.texi (smob mark function): List admissible functions
553 2004-10-04 Marius Vollmer <marius.vollmer@uni-dortmund.de>
555 * api-data.texi: Removed primitive keyword section, updated
558 * api-undocumented.texi: Moved keyword dash-symbol docs here.
560 2004-09-26 Kevin Ryde <user42@zip.com.au>
562 * api-data.texi (Conversion to/from C): Braces {} around char* return.
563 * api-evaluation.texi (Block Comments): More cindex entries.
565 * guile.texi, misc-modules.texi (Streams): New section.
567 2004-09-25 Marius Vollmer <mvo@zagadka.de>
569 * libguile-smobs.texi, api-smobs.texi: More words abot what a free
570 function is allowed to do.
572 2004-09-24 Marius Vollmer <mvo@zagadka.de>
574 * libguile-smobs.texi: Bugfix in example code, use SCM_NEWSMOB
575 correctly. Use scm_assert_smob_type instead of SCM_ASSERT
578 2004-09-23 Marius Vollmer <mvo@zagadka.de>
580 * api-i18n.texi: New file.
581 * Makefile.am (guile_TEXINFOS): Added it.
582 * guile.texi: Include it.
584 2004-09-16 Kevin Ryde <user42@zip.com.au>
586 * api-utility.texi (Equality): Revise for clarity.
588 2004-09-08 Marius Vollmer <marius.vollmer@uni-dortmund.de>
590 * api-data.texi (integer-expt): Updated from docstring.
592 * Makefile.am (CLEANFILES, MAINTAINERCLEANFILES): Moved
593 autoconf-macros.texi to MAINTAINERCLEANFILES. It is in the
594 tarball and we shouldn't clean it, then.
596 2004-09-07 Kevin Ryde <user42@zip.com.au>
598 * api-procedures.texi (let-keywords Reference): Typo, should be
599 let-keywords* @defunx.
601 * api-scheduling.texi (Parallel Forms): In parallel, letpar, par-map,
602 n-par-map and n-for-each-par-map, describe each form as being in its
603 own thread, not a new thread, since for instance the calling thread is
604 used when only one form. Plus typo in n-for-each-par-map example
605 equivalent for-each + n-par-map.
607 * posix.texi (Locales): Use @var for category arg.
609 * posix.texi (System Identification): Remove software-type, it doesn't
610 exist in the guile core.
612 * srfi-modules.texi (SRFI-10): Revise and expand.
614 2004-09-02 Kevin Ryde <user42@zip.com.au>
616 * misc-modules.texi (Formatted Output): Excess arguments are ignored.
617 In ~*, correction N parameter cannot be negative. In ~t, note
620 2004-08-29 Kevin Ryde <user42@zip.com.au>
622 * srfi-modules.texi (SRFI-2): Note empty body is #t.
624 2004-08-25 Marius Vollmer <marius.vollmer@uni-dortmund.de>
626 * api-data.texi, srfi-modules.texi: Moved docs for SRFI-14 into
627 main API chapter. Updated docstrings from libguile/.
629 2004-08-25 Marius Vollmer <mvo@zagadka.de>
631 * api-data.texi, srfi-modules.texi: Moved docs for SRFI-14 into
632 main API chapter. Updated docstrings from libguile/.
634 2004-08-24 Marius Vollmer <marius.vollmer@uni-dortmund.de>
636 Ran a (docstring-process-module "(guile)") and moved entries from
637 new-docstrings.texi to their appropriate place.
639 * api-undocumented.texi: New file.
641 2004-08-21 Marius Vollmer <mvo@zagadka.de>
643 From Richard Todd, Thanks!
645 * scheme-scripts.texi (Invoking Guile): documented new '-L'
648 2004-08-20 Marius Vollmer <mvo@zagadka.de>
650 * gh.texi: Updated transition section with new recommended things.
652 2004-08-19 Marius Vollmer <marius.vollmer@uni-dortmund.de>
654 * api-data.texi (Strings): Document copy-on-write behavior and
655 mutation-sharing substrings.
656 (Symbols): Document scm_from_locale_symbol and
657 scm_from_locale_symboln.
659 2004-08-18 Kevin Ryde <user42@zip.com.au>
661 * posix.texi (Network Sockets and Communication): Add SOCK_RDM and
664 * posix.texi (Internet Socket Examples): Correction to socket calls,
665 should be PF_INET not AF_INET (though generally the two are the same
668 2004-08-14 Kevin Ryde <user42@zip.com.au>
670 * api-scheduling.texi (Mutexes): New datatype-centric section, adding
671 fair mutexes and collecting up material from ...
672 (Low level thread primitives, Higher level thread procedures, C level
673 thread interface): ... these nodes.
675 * srfi-modules.texi (SRFI-13 Predicates): Add string-any and
676 string-every support for char and charset predicates.
678 2004-08-11 Marius Vollmer <mvo@zagadka.de>
680 * api-data.texi (scm_c_round, scm_c_truncate): Docs for'em.
682 2004-08-10 Marius Vollmer <marius.vollmer@uni-dortmund.de>
684 * api-control.texi: Updated example to use scm_to_locale_string
685 instead of roll-your-own scm_to_string. Also showcase
688 * api-data.texi: Docs for scm_is_string, scm_to_locale_string*,
689 and scm_from_locale_string*.
691 * api-memory.texi: Docs for scm_frame_free.
693 2004-08-09 Kevin Ryde <user42@zip.com.au>
695 * api-io.texi (File Ports): In open-file, describe the "b" binary flag.
697 * slib.texi (SLIB): Add notes on delete-file, provided? and open-file
698 overridden by ice-9 slib module.
700 2004-08-05 Kevin Ryde <user42@zip.com.au>
702 * api-scheduling.texi (Arbiters): Tweak wording for clarity, note any
703 thread can unlock not just the one which locked.
705 * posix.texi (Conventions): Describe system-error args, use @defun for
706 system-error-errno instead of just words.
708 * srfi-modules.texi (SRFI-13 Predicates): Tweak wording for clarity.
709 For string-every, note return is #t when no characters. For
710 string-any and string-every, note last pred call is not currently a
711 tail call, contrary to SRFI-13 spec.
713 2004-08-03 Marius Vollmer <marius.vollmer@uni-dortmund.de>
715 * api-data.texi: Added scm_is_real, scm_is_rational,
716 scm_to_double, scm_from_double, numerator, and denominator. Added
717 scm_is_complex, scm_is_number, scm_c_make_rectangular,
718 scm_c_make_polar, scm_c_real_part, scm_c_imag_part,
719 scm_c_magnitude, and scm_c_angle.
721 2004-08-02 Marius Vollmer <marius.vollmer@uni-dortmund.de>
723 * gh.texi: Replaced references to scm_num2* with scm_to_* and
724 references to scm_*2num with scm_from_*.
726 Renamed many file to make the structure of the manual more evident
727 in the names. Changed all references.
729 * scheme-binding.texi: Renamed to api-binding.texi.
730 * scheme-compound.texi: Renamed to api-compound.texi.
731 * scheme-control.texi: Renamed to api-control.texi.
732 * scheme-data.texi: Renamed to api-data.texi.
733 * scheme-debug.texi: Renamed to api-debug.texi.
734 * deprecated.texi: Renamed to api-deprecated.texi.
735 * scheme-evaluation.texi: Renamed to api-evaluation.texi.
736 * ref-init.texi: Renamed to api-init.texi.
737 * scheme-io.texi: Renamed to api-io.texi.
738 * scheme-memory.texi: Renamed to api-memory.texi.
739 * scheme-modules.texi: Renamed to api-modules.texi.
740 * scheme-options.texi: Renamed to api-options.texi.
741 * scm.texi: Renamed to api-overview.texi.
742 * scheme-procedures.texi: Renamed to api-procedures.texi.
743 * scheme-scheduling.texi: Renamed to api-scheduling.texi.
744 * scheme-scm.texi: Renamed to api-scm.texi.
745 * scheme-smobs.texi: Renamed to api-smobs.texi.
746 * scheme-snarf.texi: Renamed to api-snarf.texi.
747 * scheme-translation.texi: Renamed to api-translation.texi.
748 * scheme-utility.texi: Renamed to api-utility.texi.
749 * debugging.texi: Renamed to scheme-debugging.texi.
750 * scripts.texi: Renamed to scheme-scripts.texi.
751 * program.texi: Renamed to libguile-program.texi.
753 * api-deprecated.texi: Removed.
754 * intro.texi (Discouraged and Deprecated): General information
755 about deprecation, etc.
757 2004-07-30 Marius Vollmer <marius.vollmer@uni-dortmund.de>
759 * misc-modules.texi (Formatted Output): Changed @w to @w{} in
760 itemize. The former doesn't work for some reason...
762 2004-07-28 Kevin Ryde <user42@zip.com.au>
764 * misc-modules.texi (Formatted Output): Rewrite, describing escapes
765 and parameters in detail.
766 * guile.texi (@le, @ge): New macros for ifnottex.
768 2004-07-24 Kevin Ryde <user42@zip.com.au>
770 * guile.texi (@nicode): Use @alias instead of @macro, for correct
771 handling of backslashes.
773 * scheme-control.texi (Frames): Add @vindex for SCM_F_WIND_EXPLICITLY.
775 * scheme-data.texi (String Syntax): Add all backslash forms accepted.
776 (Regexp Functions): Use @defvar for regexp/icase etc, to emphasise
777 that they're variables not symbols etc.
779 * scheme-smobs.texi (Smobs): In SCM_SMOB_OBJECT_LOC,
780 SCM_SMOB_OBJECT_2_LOC, SCM_SMOB_OBJECT_3_LOC, use {} to avoid "*"
781 getting into the index as part of the macro name.
783 * srfi-modules.texi (SRFI-0): Revise for clarity, drop BNF in favour
784 of plain description, emphasise this is just for portable programs.
786 2004-07-10 Marius Vollmer <marius.vollmer@uni-dortmund.de>
788 * scheme-data.texi (Integers): Talk more about inexact and exact
791 2004-07-10 Kevin Ryde <user42@zip.com.au>
793 * srfi-modules.texi (SRFI-0): Add srfi-6 to the identifiers provided
796 2004-07-07 Marius Vollmer <marius.vollmer@uni-dortmund.de>
798 * scheme-data.texi (Integers): Added docs for the new scm_is_,
799 scm_to_ and scm_from_ functions for integers.
801 * data-rep.texi (How Guile does it): Mark as being in limbo. All
802 the real documentation will be in the nodes "Programming in C" and
804 (Boolean Data): Just refer to node "Booleans".
806 * gh.texi: Replace references to SCM_NFALSEP, etc with
809 * scheme-data.texi (Booleans): Flag all function-like definitions
812 2004-07-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
814 * scheme-data.texi: Remove non-R5RS stuff from the 'rn' index.
816 * scheme-utility.texi: Added scm_is_eq, scm_eq_p, scm_eqv_p, and
819 2004-07-05 Marius Vollmer <marius.vollmer@uni-dortmund.de>
821 * scheme-data.texi (Booleans): Added reference entries for
822 scm_is_true, scm_is_false, scm_is_bool, scm_from_bool, and
825 2004-06-28 Marius Vollmer <marius.vollmer@uni-dortmund.de>
827 * Makefile.am: Removed home-grown code for HTML generation.
828 Automake does it for us now.
830 * guile.texi, scheme-scm.texi: Do not use TeXinfo markup in
831 section or node names.
833 2004-06-20 Rob Browning <rlb@defaultvalue.org>
835 * srfi-modules.texi (SRFI-31): add documentation for srfi-31.
837 2004-05-19 Kevin Ryde <user42@zip.com.au>
839 * Makefile.am (CLEANFILES): Remove guile.cps guile.fns guile.rns
840 guile.tps guile.vrs guile.tmp, cleaned by automake these days.
842 2004-05-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
844 * scheme-smobs.texi: Updated for new SCM_SMOB_* macros.
846 * preface.texi: Moved around the sections so that the manual
847 overview comes first.
849 * libguile-smobs.texi: Updated for the new role of scm_t_bits.
851 2004-04-21 Marius Vollmer <marius.vollmer@uni-dortmund.de>
853 * Big reorganization of the whole manual to give it a simpler
856 2004-03-25 Kevin Ryde <user42@zip.com.au>
858 * slib.texi (SLIB): Amend `require' cross reference node name, is
859 called "Require" in slib 3a1.
861 2004-03-23 Kevin Ryde <user42@zip.com.au>
863 * scheme-data.texi (Reals and Rationals): Typo in `rationalize'.
865 2004-03-04 Kevin Ryde <user42@zip.com.au>
867 * posix.texi (Processes): Add setgroups.
869 * srfi-modules.texi (SRFI-26): New section.
871 2004-02-21 Kevin Ryde <user42@zip.com.au>
873 * scheme-evaluation.texi (Expression Syntax): Add @findex entries for
874 quote and quasiquote no longer using @deffn.
876 2004-02-20 Marius Vollmer <marius.vollmer@uni-dortmund.de>
878 * scheme-evaluation.texi (Expression Syntax): Turned syntax
879 description into a table, @deffn is not really up to the task.
881 2004-02-18 Marius Vollmer <mvo@zagadka.de>
883 * guile.texi: Replaced list of authors with "The Guile
886 * preface.texi (Contributors to the Manual): New section.
888 * scheme-evaluation.texi (Expression Syntax): Use an empty name
889 for the function call syntax definition. Otherwise, TeX complains
890 about unbalanced parenthesis.
892 2004-02-18 Kevin Ryde <user42@zip.com.au>
894 * scheme-evaluation.texi (Expression Syntax): Fill section with
895 function calling etc, and quote and quasiquote.
897 * srfi-modules.texi (SRFI-9): Revise for detail and clarity. Don't
898 use ":foo" for example type name, since that depends on the keyword
901 2004-02-15 Mikael Djurfeldt <mdj@chunk.mit.edu>
903 * scheme-compound.texi (Hash Table Reference): Wrote a new entry
904 for hash-for-each-handle.
906 2004-02-16 Kevin Ryde <user42@zip.com.au>
908 * scheme-compound.texi (Sloppy Alist Functions): Amend error messages
909 shown to match current guile output.
911 2004-02-15 Mikael Djurfeldt <mdj@chunk.mit.edu>
913 * scheme-compound.texi (Hash Table Reference): Renamed hash-map
916 2004-02-15 Kevin Ryde <user42@zip.com.au>
918 * scheme-compound.texi (Hash Table Reference): In scm_hash_ref etc,
919 remove note that dflt must be given, it can be SCM_UNSPECIFIED.
921 * scheme-control.texi (while do): Expand and clarify `do', in
922 particular note iteration binds fresh locations, rather than values
925 * srfi-modules.texi (SRFI-4): Revise for clarity, give each function
926 explicitly rather than showing TAG so Emacs info-look can find them,
927 merge "SRFI-4 - Read Syntax" and "SRFI-4 - Procedures" into just one
930 2004-02-12 Kevin Ryde <user42@zip.com.au>
932 * scheme-compound.texi (Conventional Arrays): Revise for clarity.
933 In array-equal?, show multiple arguments allowed.
934 (Uniform Arrays): Remove duplicate array?.
935 * guile.texi (cross): New macro.
937 * scheme-compound.texi (Uniform Arrays): Note 1/3 prototype for
938 doubles is now an exact fraction.
940 * slib.texi (SLIB): Index entry for replacement `system'.
942 2004-01-28 Mikael Djurfeldt <mdj@chunk.mit.edu>
944 * scheme-compound.texi (Uniform Arrays): Added a FIXME warning
945 that the 1/3 prototype no longer works.
947 2004-01-23 Marius Vollmer <mvo@zagadka.de>
949 * Makefile.am (guile_TEXINFOS): Added fdl.texi.
951 2004-01-21 Marius Vollmer <mvo@zagadka.de>
953 Added copyright notices to all TeXinfo files.
956 * guile.texi: Include it as an appendix.
957 * preface.texi: State that the manual is FDL.
959 2004-01-20 Kevin Ryde <user42@zip.com.au>
961 * preface.texi (Guile License): Note readline is GPL and manual has
962 its own copying terms. Describe briefly what the licenses mean in
965 * scheme-scheduling.texi (Higher level thread procedures): In monitor,
966 don't let "newly created" suggest a mutex created on every evaluation.
967 Note what "monitor" means.
969 * slib.texi (SLIB): Note `system' redefined by (ice-9 slib). Tweak
972 2004-01-11 Kevin Ryde <user42@zip.com.au>
974 * misc-modules.texi (Queues): New chapter.
975 * guile.texi (Top): Add it.
977 2004-01-09 Kevin Ryde <user42@zip.com.au>
979 * scheme-compound.texi (Bit Vectors): Revise for clarity, following
980 report by Rouben Rostamian. Remove #b() example, that syntax is not
983 2004-01-07 Marius Vollmer <marius.vollmer@uni-dortmund.de>
985 * scheme-control.texi, scheme-io.tex, scheme-scheduling.texi:
986 Adapt to new 'frame' names. Document scm_c_with_fluid,
987 scm_c_with_fluids, and scm_frame_fluid.
989 2004-01-06 Marius Vollmer <marius.vollmer@uni-dortmund.de>
991 * scheme-control.texi: Document scm_on_unwind_with_scm and
992 scm_on_rewind_with_scm.
994 2004-01-05 Marius Vollmer <mvo@zagadka.de>
996 * scheme-scheduling.texi: Document scm_with_[un]blocked_asyncs.
998 * scheme-io.texi: Document scm_with_current_<foo>_port.
1000 2004-01-03 Marius Vollmer <mvo@zagadka.de>
1002 * scheme-control.texi: Document the frames stuff and other random
1005 2004-01-04 Kevin Ryde <user42@zip.com.au>
1007 * scheme-scheduling.texi (Threads): Note Guile uses POSIX threads, for
1008 concurrency and preemption.
1009 (C level thread interface): Note periodic libguile call required for C
1010 code in threads, add commented out reminders for SCM_TICK and
1011 guile-mode, for when those features are ready.
1013 * srfi-modules.texi (SRFI-1 Filtering and Partitioning): For partition
1014 and partition!, emphasise the multi-value return, note partition may
1015 share a tail with the given list.
1017 * srfi-modules.texi (SRFI-1 Searching, SRFI-1 Deleting, SRFI-1
1018 Association Lists): Note how member, delete, delete! and assoc extend
1019 the corresponding core functions.
1021 2003-11-25 Kevin Ryde <user42@zip.com.au>
1023 * tools.texi (Macros guile-snarf recognizes): Correction to GOOPS
1026 2003-11-19 Marius Vollmer <mvo@zagadka.de>
1028 * scheme-data.texi: Include exact rationals.
1030 From Stephen Compall. Thanks!
1032 * intro.texi (What is Guile?): Add @acronym for POSIX, R5RS, GUI,
1033 and HTTP. Conclude linking libguile. Say what one can find *for*.
1035 * preface.texi (Manual Conventions): Double-quote some statements
1036 formerly single-quoted. Remove some redundant quotes around code.
1037 Clarify meaning of `iff' further for those that didn't get it the
1038 first time 'round (like me). Make graphical indicators samples,
1039 not code. Put results of evaluation on the same line as @result
1040 symbols. Use @print example as example of total usage, and remind
1041 readers not to forget the difference.
1043 2003-11-17 Marius Vollmer <mvo@zagadka.de>
1045 * scheme-modules.texi: Document '@' and '@@'.
1047 * scripts.texi: Mention that "-e (@ ...)" also works.
1049 2003-11-15 Kevin Ryde <user42@zip.com.au>
1051 * scheme-data.texi (Random): Add *random-state* variable, put note at
1052 the top of the node about it being the default, rather than just in
1053 the description of random.
1055 2003-11-13 Marius Vollmer <mvo@zagadka.de>
1057 * preface.texi (Manual Layout): Wrap POSIX, API, and SLIB in
1058 @acronym. Change from paragraph format (somewhat clumsy-looking
1059 on paper, at least) to @table format, with headers @strong. Made
1060 example modules complete sentences. From Stephen Compall, thanks!
1062 2003-11-09 Kevin Ryde <user42@zip.com.au>
1064 * misc-modules.texi (Pretty Printing): Add new keyword options, break
1065 example to avoid long line.
1067 * scheme-data.texi (Random): In random, use @code for *random-state*.
1068 Reported by Stephen Compall.
1070 * srfi-modules.texi (SRFI-1 Filtering and Partitioning): Move filter
1072 * scheme-compound.texi (List Modification): ... to here, now that
1073 they're implemented in the core.
1075 2003-11-03 Kevin Ryde <user42@zip.com.au>
1077 * misc-modules.texi (File Tree Walk): New chapter.
1078 * guile.texi: Add it.
1080 2003-10-18 Kevin Ryde <user42@zip.com.au>
1082 * gh.texi (Calling Scheme procedures from C, scm transition summary):
1083 Refer to scm_list_n, not the old name scm_listify.
1084 (scm transition summary): For gh_apply, recommend scm_apply_0, which
1087 * gh.texi (Defining new Scheme procedures in C): Don't use
1088 @strong{Note:}, latest makeinfo will complain it looks like a cross
1091 * posix.texi (Time): Correction to strftime glibc cross reference
1092 node, now "Formatting Calendar Time".
1094 * srfi-modules.texi (SRFI-1 Searching): In break, note conflict with
1095 binding established by `while'.
1097 2003-10-09 Kevin Ryde <user42@zip.com.au>
1099 * scheme-compound.texi (Hash Table Reference): Decribe rehashing, note
1100 no hashx-remove!, describe make-hash-table size parameter.
1102 2003-10-06 Marius Vollmer <mvo@zagadka.de>
1104 * scheme-memory.texi: Added a short explanation of the GC and the
1105 conservative stack scanning.
1106 (scm_gc_protect_object, scm_gc_unprotect_object,
1107 scm_permanent_object): New.
1109 * data-rep.texi, scheme-memory.texi (scm_remember_upto_here_1,
1110 scm_remember_upto_here_2): Moved from data-rep.texi to
1113 2003-10-02 Kevin Ryde <user42@zip.com.au>
1115 * scheme-io.texi (String Ports): In call-with-output-string, note proc
1116 should not close the port. In get-output-string, note string must be
1117 gotten before closing the port.
1119 2003-09-21 Kevin Ryde <user42@zip.com.au>
1121 * posix.texi (File System): In access?, reword a bit, clarify real
1122 versus effective ID handling, cross reference glibc on that, and
1123 recommend against access tests in library functions.
1125 2003-09-13 Kevin Ryde <user42@zip.com.au>
1127 * posix.texi (File System): In stat:dev and stat:mode, clarify that
1130 * posix.texi (Network Address Conversion): Under IPv4, describe
1131 numeric representation in Guile, add INADDR_LOOPBACK and
1132 INADDR_BROADCAST, add commented-out INADDR_NONE.
1134 * scheme-compound.texi (Append/Reverse): Merge reverse and reverse!,
1135 describe newtail parameter for reverse!, remove confusing caveat about
1136 head becoming tail for reverse!.
1138 * scheme-io.texi (Reading): In port-column, port-line,
1139 set-port-column! and set-port-line!, port parameter must be given,
1140 there's no default to current input.
1142 * scheme-io.texi (Reading): Add scm_c_read.
1143 (Writing): Add scm_c_write.
1145 * srfi-modules.texi (SRFI-1 Constructors): Add list-copy.
1147 * srfi-modules.texi (SRFI-19): Rewrite, adding descriptions of all
1148 functions, and a bit of an introduction.
1150 2003-09-03 Kevin Ryde <user42@zip.com.au>
1152 * scheme-data.texi (Keyword Primitives): Add examples to
1153 make-keyword-from-dash-symbol and keyword-dash-symbol. Add
1156 * scheme-data.texi (Symbol Primitives): In gensym, cross reference
1157 uninterned symbols, use @w{} on " g" prefix to avoid any chance of a
1158 line break obscuring it.
1160 2003-08-30 Kevin Ryde <user42@zip.com.au>
1162 * data-rep.texi (Remembering During Operations): Note
1163 scm_remember_upto_here_1 applies only to C automatic variables.
1165 * guile.texi: Move @contents to usual place after title page, and
1166 after first menu since that looks nice in html.
1168 * posix.texi (Ports and File Descriptors): In pipe PIPE_BUF, use
1169 @defvar, reword a bit for clarity, cross reference glibc.
1171 * posix.texi (Network Sockets and Communication): In socket, use
1172 @defvar for protocol variables, cross reference for getprotobyname,
1173 note it's usually connect and accept that establishes communication.
1175 * posix.texi (Network Sockets and Communication): In socketpair,
1176 clarify the return is a pair with ports in car and cdr, note
1177 connection is full duplex, refer to socket for parameters, refer to
1178 PF_UNIX rather than AF_UNIX.
1180 * scheme-compound.texi (Append/Reverse): Merge append and append!,
1181 shown parameters as lst1 ... lstN, describe list argument for
1182 scm_append and scm_append_x and note that it's unmodified.
1184 * scheme-compound.texi (Hash Table Reference): Add hashx- case
1185 insensitive string example, add cross references to symbol-hash,
1186 string-hash, string-hash-ci, and char-set-hash.
1188 * scheme-control.texi (Multiple Values): In values, show args as "arg1
1189 ... argN". In scm_values, note args is a list and returned object
1190 shares structure with it.
1192 * scheme-control.texi (Catch): Add scm_internal_catch.
1193 (Lazy Catch): Add scm_internal_lazy_catch.
1195 * scheme-data.texi (Arithmetic): Use a table for scheme to C libm
1196 equivalences, add C99 trunc.
1198 * scheme-procedures.texi (Lambda): Note ". rest" list argument is
1199 always newly created.
1201 * srfi-modules.texi (SRFI-1 Association Lists): In alist-delete and
1202 alist-delete!, note argument order for the equality calls per SRFI-1
1205 2003-08-26 Kevin Ryde <user42@zip.com.au>
1207 * scheme-data.texi (Scientific): Add two-argument atan.
1209 * tools.texi (How guile-snarf works): Need @@ for texinfo in example.
1211 2003-08-17 Kevin Ryde <user42@zip.com.au>
1213 * scheme-compound.texi (Hash Table Reference): Collect up groups of
1214 functions to avoid duplication. Revise notes on hashx functions and
1215 on vector implementation. In make-hash-table, size is now optional.
1216 Add hash-map and hash-for-each.
1218 2003-08-14 Kevin Ryde <user42@zip.com.au>
1220 * scheme-control.texi (while do): Update `while' for code rewrite, in
1221 particular describe break and continue.
1223 2003-08-09 Kevin Ryde <user42@zip.com.au>
1225 * scheme-memory.texi (Memory Blocks): Add index entries for deprecated
1226 scm_must_malloc and friends.
1228 2003-07-29 Kevin Ryde <user42@zip.com.au>
1230 * scheme-compound.texi (List Constructors): Remove scm_cons_star,
1231 since it's not very helpful.
1233 * scheme-utility.texi (Property Primitives): In primitive-property-ref,
1234 note parameters to not-found-proc, use hyphens rather than underscores
1235 for that parameter name.
1236 In primitive-property-set!, VAL is the value parameter not CODE.
1238 2003-07-24 Kevin Ryde <user42@zip.com.au>
1240 * scheme-control.texi (Dynamic Wind): Untabify.
1241 (Multiple Values): Use @result.
1242 Reported by Stephen Compall <s11@member.fsf.org>.
1244 * scheme-control.texi (Continuations): Rewrite with more detail.
1246 * scheme-scheduling.texi (System asyncs): Add index entries for C
1249 * scheme-scheduling.texi (Parallel Forms): New section.
1251 2003-07-18 Kevin Ryde <user42@zip.com.au>
1253 * scheme-compound.texi (List Constructors): In list, use "elem1
1254 ... elemN". Add scm_list_1, scm_list_2, scm_list_3, scm_list_4,
1255 scm_list_5, scm_list_n. Remove scm_list, since it's a no-op.
1256 * guile.texi (nicode): New macro.
1258 * scheme-evaluation.texi (Fly Evaluation): In apply, reword for
1259 clarity, drop the "append" example. Add scm_apply, scm_apply_0,
1260 scm_apply_1, scm_apply_2, scm_apply_3.
1261 Add scm_call_0, scm_call_1, scm_call_2, scm_call_3.
1262 In apply:nconc2last, move down after "apply", reword for clarity, note
1263 correspondence to apply params.
1265 * srfi-modules.texi (SRFI-0): Add cond-expand index entry.
1266 (SRFI-9): Add define-record-type index entry.
1268 2003-07-12 Kevin Ryde <user42@zip.com.au>
1270 * srfi-modules.texi (SRFI-1 Constructors): In iota, reword a bit for
1271 clarity and add a couple of examples.
1273 2003-07-10 Kevin Ryde <user42@zip.com.au>
1275 * deprecated.texi (Deprecated): Add scm_remember.
1277 2003-06-22 Kevin Ryde <user42@zip.com.au>
1279 * data-rep.texi (Remembering During Operations): Refer to all "Guile
1280 library functions" as provoking gc.
1282 2003-06-19 Kevin Ryde <user42@zip.com.au>
1284 * scheme-io.texi (File Ports): Describe call-with-input-file and
1285 call-with-output-file together. Describe with-input-from-file,
1286 with-output-to-file and with-error-to-file together, and add that they
1287 use dynamic-wind on the current port setting and keep the port open in
1288 support of captured continuations.
1289 (Closing): Describe close-input-port and close-output-port together,
1290 tweak the wording slightly.
1292 2003-06-14 Kevin Ryde <user42@zip.com.au>
1294 * data-rep.texi (Vector Data): For SCM_VECTOR_BASE, SCM_STRING_CHARS
1295 and SCM_SYMBOL_CHARS, cross reference "Remembering During Operations".
1297 * scheme-data.texi (Arithmetic): round is to nearest even.
1299 2003-06-12 Kevin Ryde <user42@zip.com.au>
1301 * data-rep.texi (Remembering During Operations): New section.
1303 * scheme-data.texi (Primitive Numerics): Add atan2, pow, asinh, acosh
1304 and atanh to scheme<->C table. Note asinh, acosh and atanh are C99,
1305 and scm_asinh, scm_acosh and scm_atanh are equivalents. Cross ref
1306 glibc "Mathematics". Reword this end part for clarity.
1308 * scheme-memory.texi (Memory Blocks): Use {} around types for
1309 @deftypefn, for correct name in indexes.
1310 * scheme-utility.texi (C Hooks): Ditto.
1311 * gh.texi (Scheme to C): Ditto.
1313 * gh.texi (Scheme to C): In gh_scm2newstr, lenp is size_t* not int*.
1314 This changed in guile 1.6, the docs weren't updated.
1316 2003-06-09 Marius Vollmer <mvo@zagadka.de>
1318 From Mike Gran <spikegran@earthlink.net>. Thanks!
1320 * preface.texi: Minor punctuation mistakes. Hyphens should link
1321 compound adjectives. Commas should be placed after a "therefore"
1322 that begins a sentence. Commas should not be used to separate a
1323 list of only 2 dependent clauses.
1325 2003-06-07 Kevin Ryde <user42@zip.com.au>
1327 * scheme-data.texi (Arithmetic): Cross reference glibc floor and ceil.
1329 2003-06-05 Kevin Ryde <user42@zip.com.au>
1331 * posix.texi (File System): stat:rdev and stat:blocks can return #f,
1332 stat:blksize returns a sensible size if the field is not available.
1334 * scheme-compound.texi (Array Mapping): Reword for clarity, and in
1335 particular have the same parameter names in the text and prototypes.
1337 * scheme-evaluation.texi (Delayed Evaluation): Add delay, reword
1338 promise? and force a bit, describe recursive forcing of a promise by
1341 * scheme-io.texi (Ports): Add notes on garbage collection, and on
1342 explicitly closing file ports.
1343 (File Ports): Cross reference Ports node on explicit closing.
1345 * posix.texi (Network Sockets and Communication): Cross reference
1346 Ports node on explicit closing.
1348 * scheme-scheduling.texi (Futures): New section.
1350 * srfi-modules.texi (SRFI-13 Miscellaneous): In string-replace, note
1351 that start1 and end1 optional is a Guile extension.
1353 2003-05-30 Kevin Ryde <user42@zip.com.au>
1355 * deprecated.texi: Add substring-move-left! and substring-move-right!.
1357 * scheme-io.texi (Default Ports): Remove duplicate descriptions of
1358 set-current-output-port and set-current-error-port.
1360 2003-05-27 Dirk Herrmann <D.Herrmann@tu-bs.de>
1362 * scheme-compound.texi: Clarified that vectors need to be quoted.
1364 2003-05-26 Kevin Ryde <user42@zip.com.au>
1366 * posix.texi (Locales): Clarify setlocale a bit, list all categories,
1367 cross reference to libc.
1369 2003-05-24 Kevin Ryde <user42@zip.com.au>
1371 * scheme-procedures.texi: Add index entries lambda, optargs, syncase.
1373 * scsh.texi (The Scheme shell (scsh)): Add index entries.
1375 2003-05-22 Kevin Ryde <user42@zip.com.au>
1377 * srfi-modules.texi (SRFI-2): Rewrite and-let*, describing plain
1378 expression clauses and improving the examples.
1380 2003-05-17 Marius Vollmer <mvo@zagadka.de>
1382 * posix.texi (socket): Use PF_ instead of AF_ prefix.
1384 2003-05-16 Kevin Ryde <user42@zip.com.au>
1386 * guile.texi: Use @copying, show copyright and permissions at start of
1389 * srfi-modules.texi (SRFI-1 Deleting): Rewrite delete and
1390 delete-duplicates, adding behaviour details specified by srfi-1.
1392 2003-05-12 Kevin Ryde <user42@zip.com.au>
1394 * preface.texi (Guile License): Refer to COPYING.LIB.
1396 * repl-modules.texi (Loading Readline Support, Readline Options):
1397 Index entries for readline functions.
1399 * scheme-control.texi (Handling Errors): Fix regexp error key, should
1400 be `regular-expression-syntax'.
1402 * scheme-data.texi (Complex): Show z argument in prototypes.
1404 2003-05-10 Kevin Ryde <user42@zip.com.au>
1406 * scheme-data.texi (Reals and Rationals): Fix typo @result{#f}, and
1407 put @result outside @code.
1409 * scheme-data.texi (Bitwise Operations): Note negatives are treated as
1410 infinite precision twos complement. Revise `ash' to emphasise this
1411 for right shifts of negatives. Describe integer-length behaviour on
1412 negatives. Add `...' to logand, logior, logxor since they take
1413 multiple parameters.
1414 * guile.texi (m): New macro.
1416 * scheme-control.texi (Handling Errors): Revise C support section to
1417 get index entries, and clarify parameters. Remove scm_regex_error, no
1418 longer exists and wasn't available to applications.
1420 * scheme-control.texi (Handling Errors): Index entries for error keys.
1422 2003-05-08 Kevin Ryde <user42@zip.com.au>
1424 * scheme-data.texi (Bitwise Operations): Fix lognot to ones-complement.
1426 * slib.texi (JACAL): Fix @ref title.
1427 Add index entries, use @file and @code variously.
1429 2003-05-06 Kevin Ryde <user42@zip.com.au>
1431 * scheme-scheduling.texi (C level thread interface): Use @deftypefn
1432 not @deftypefun, to get function names (not types) indexed.
1434 * scheme-options.texi (Build Config): Add index entries for
1435 %guile-build-info keys.
1437 2003-05-04 Kevin Ryde <user42@zip.com.au>
1439 * scheme-data.texi (Integer Operations): Describe how quotient,
1440 remainder and modulo round their results.
1442 * scheme-io.texi (Reading): In read-char and peek-char, fix typos "?"
1443 in @rnindex. In port-column, use @: after i.e.
1444 (Writing): In get-print-state, two spaces after full stop. Add write,
1447 * srfi-modules.texi (SRFI-1 Length Append etc): Add count.
1448 (SRFI-1 Fold and Map): In reduce, fix typo "... variant of fold", add
1449 "f" to fold call shown. In reduce-right, use @code on "reduce".
1451 * data-rep.texi, gh.texi: Add spaces after some @defun names.
1452 * posix.texi (Processes): Fix typo "hhhh".
1454 2003-05-01 Neil Jerram <neil@ossau.uklinux.net>
1456 * posix.texi: Add index entries for many variables and functions,
1457 either using @defvar/@deffn or @vindex/@pindex. (Patch supplied
1460 2003-04-30 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1462 * posix.texi (scm_c_port_for_each): Added.
1464 2003-04-26 Neil Jerram <neil@ossau.uklinux.net>
1466 * scheme-data.texi (Symbol Primitives): Document scm_str2symbol
1469 * data-rep.texi (Describing a New Type): Clarify that
1470 scm_make_smob_type_mfpe is deprecated. (Thanks to
1473 * scheme-control.texi (Handling Errors): Remove scm_sysmissing,
1474 long since gone from libguile. (Thanks to Kevin Ryde.)
1476 2003-04-23 Rob Browning <rlb@defaultvalue.org>
1478 * posix.texi (Processes): add documentation for system*.
1480 2003-04-05 Marius Vollmer <mvo@zagadka.de>
1482 * preface.texi: Reflect change to LGPL.
1484 2003-03-27 Rob Browning <rlb@defaultvalue.org>
1486 * scheme-io.texi (Reading): clarify character ordering in port for
1489 2003-03-07 Rob Browning <rlb@defaultvalue.org>
1491 * guile.texi: change MANUAL_EDITION to MANUAL-EDITION so we don't
1492 choke TeX (thanks to Dale P. Smith).
1494 * preface.texi: change MANUAL_EDITION to MANUAL-EDITION so we
1495 don't choke TeX (thanks to Dale P. Smith).
1497 2003-01-02 Mikael Djurfeldt <djurfeldt@nada.kth.se>
1499 * scheme-scheduling.texi (Low level thread primitives): Fixed typo
1500 in broadcast-condition-variable.
1502 2002-12-08 Rob Browning <rlb@defaultvalue.org>
1504 * scheme-options.texi (Build Config): add effective-version docs.
1506 2002-11-17 Neil Jerram <neil@ossau.uklinux.net>
1508 Applied patches from Stephen Compall as follows. (Thanks!)
1510 2002-11-06 Stephen Compall <rushing@sigecom.net>
1512 * posix.texi: Changed quotes to match Texinfo expectations.
1514 Added references to the glibc manual.
1516 Used proper Texinfo text marking for many keywords, such as @code,
1519 Fixed argument metasyntactic variable references in
1520 file-manipulation section so the usage in the descriptions matches
1521 the usage in the declarations.
1523 2002-10-26 Stephen Compall <rushing@sigecom.net>
1525 * scheme-data.texi: Addition and change of many Texinfo tags,
1526 particularly usage of @var and @samp, as well as reformatting of
1527 some lists into tables and usage of @result.
1529 Notes about some things I didn't understand, as well as a
1530 missing section on non-control characters.
1532 2002-10-27 Gary Houston <ghouston@arglist.com>
1534 * scheme-modules.texi (Environments): only available when
1535 (ice-9 r5rs) is used.
1536 * scsh.texi (The Scheme shell (scsh)): current url is www.scsh.net.
1538 2002-10-27 Marius Vollmer <mvo@zagadka.ping.de>
1540 * scheme-scheduling.texi: Updated mutex and condition varable
1543 2002-10-27 Neil Jerram <neil@ossau.uklinux.net>
1545 * debugging.texi (Debugging Features): Rewritten.
1547 2002-10-19 Neil Jerram <neil@ossau.uklinux.net>
1549 * new-docstrings.texi, scheme-binding.texi, scheme-io.texi,
1550 scheme-scheduling.texi, posix.texi: Automatic docstring updates.
1552 2002-10-14 Marius Vollmer <mvo@zagadka.ping.de>
1554 * intro.texi (Whirlwind Tour): Added pointer to examples
1557 2002-10-10 Marius Vollmer <mvo@zagadka.ping.de>
1559 * scheme-scheduling.texi (System Asyncs): Updated.
1561 2002-10-07 Marius Vollmer <mvo@zagadka.ping.de>
1563 * scheme-scheduling.texi (Asyncs): Updated.
1564 * posix.texi (sigaction): Updated.
1566 2002-10-03 Neil Jerram <neil@ossau.uklinux.net>
1568 * posix.texi (Processes), scheme-options.texi (Common Feature
1569 Symbols): Refer to provided? rather than deprecated feature?.
1571 2002-10-03 Marius Vollmer <mvo@zagadka.ping.de>
1573 * tools.texi (How guile-snarf works): Updated.
1574 (Writing your own snarfing macros): New.
1576 2002-09-25 Neil Jerram <neil@ossau.uklinux.net>
1578 * scheme-debug.texi (Debugging): Make sections into nodes.
1579 (Debugging Options): Node removed.
1581 * scheme-options.texi (Feature Tracking): Brought forward before
1582 sections on options.
1583 (Runtime Options): New section, to group options-related nodes.
1585 2002-09-24 Neil Jerram <neil@ossau.uklinux.net>
1587 * scheme-options.texi (Options and Config): Chapter name changed,
1588 and intro text improved.
1589 (Install Config): Brought forward, and renamed Build
1592 The following doc updates are from Ian Sheldon - thanks!
1594 * scheme-data.texi (Appending Strings, Regexp Functions, Match
1595 Structures): Add examples.
1596 (Regular Expressions): Add instruction to use (ice-9 regex)
1599 * slib.texi (SLIB): Remove duplicate `the'.
1601 2002-09-22 Neil Jerram <neil@ossau.uklinux.net>
1603 * scheme-options.texi (General option interface): Mention
1604 eval-options-interface and debug-options-interface.
1606 * scheme-debug.texi (Debugging): New node describing source
1609 2002-09-19 Neil Jerram <neil@ossau.uklinux.net>
1611 * scheme-utility.texi (Hook Reference): Improvements to hook docs.
1612 Thanks to Thien-Thi Nguyen for the patches.
1614 2002-09-16 Marius Vollmer <mvo@zagadka.ping.de>
1616 * scheme-data.texi (Symbol Props): It's "set-symbol-property!",
1617 not "set-symbol-property". Thanks to Pieter Pareit!
1619 2002-09-15 Marius Vollmer <mvo@zagadka.ping.de>
1621 * scheme-data.texi: Tell them to use 'provided?' instead of
1624 2002-09-09 Marius Vollmer <mvo@zagadka.ping.de>
1626 * scheme-ideas.texi (Creating a Procedure): Fixed typo. Thanks to
1629 * intro.texi: Updated GNu ftp server name. Use "-lguile" instead
1630 of "libguile.a". Some small fixes/improvements.
1632 * scheme-reading.texi: Added www.schemers.org. Removed foldoc,
1633 it's too generic. Updated 'teach yourself ...' URL.
1635 2002-08-27 Marius Vollmer <mvo@zagadka.ping.de>
1637 * scheme-modules.texi: Markup fixes and removal of gh_ references.
1638 Thanks to Dale Smith!
1640 2002-08-14 Marius Vollmer <mvo@zagadka.ping.de>
1642 * scheme-evaluation.texi (eval-string): Updated.
1644 * scheme-scheduling.texi (Fluids): Touched up a bit, added
1647 2002-08-13 Marius Vollmer <mvo@zagadka.ping.de>
1649 * scheme-modules.texi (More Modules Procedures): Removed.
1650 (Accessing Modules from C): New.
1652 2002-08-10 Gary Houston <ghouston@arglist.com>
1654 * scheme-procedures.texi: new section Primitive Procedures,
1655 documentation for scm_c_make_gsubr and scm_c_define_gsubr.
1656 * scheme-modules.texi (Compiled Code Modules): replace
1657 gh_new_procedure with scm_c_define_gsubr.
1659 2002-08-08 Neil Jerram <neil@ossau.uklinux.net>
1661 * gh.texi (Data types and constants defined by gh): Avoid
1662 generating index entry for SCM.
1664 * posix.texi (Runtime Environment): Remove duplicate doc for
1667 * data-rep.texi, scheme-memory.texi, scheme-modules.texi: Merge
1668 recent updates from stable branch.
1670 * posix.texi (File System, Time, Pipes, Network Databases,
1671 Internet Socket Examples): Add examples provided by Ian Sheldon.
1673 2002-08-08 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1675 * scheme-binding.texi: Don't talk about 'bound?' which is gone.
1676 Thanks to Christopher Cramer.
1678 2002-08-06 Han-Wen Nienhuys <hanwen@cs.uu.nl>
1680 * scheme-memory.texi (Memory Blocks): add scm_calloc, scm_gc_calloc.
1683 2002-08-05 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1685 * intro.texi, srfi-modules.texi: Added (use-modules (ice-9
1686 rdelim)) to an example that uses read-line. Thanks to Ralf
1689 * scheme-memory.texi: Added an introductory blurb about GC that I
1692 2002-08-02 Gary Houston <ghouston@arglist.com>
1694 * scheme-modules.texi: split "Scheme and modules" into
1695 "provide and require" and "Environments". Mention R5RS
1698 2002-07-16 Neil Jerram <neil@ossau.uklinux.net>
1700 * scheme-options.texi (Debugger options): New subsection
1701 describing stack overflow and what to do about it.
1703 2002-07-10 Gary Houston <ghouston@arglist.com>
1705 * scheme-modules.texi (Compiled Code Modules): Removed description
1706 of scm_register_module_xxx, which no longer exists. A description
1707 of current techniques is needed.
1709 2002-05-09 Marius Vollmer <mvo@zagadka.ping.de>
1711 * scheme-data.texi (Numbers): Added description of the new values
1712 +inf.0, -inf.0 and +nan.0.
1714 * posix.texi (Runtime Environment): Added entries for 'setenv' and
1717 2002-04-28 Marius Vollmer <mvo@zagadka.ping.de>
1719 * gh.texi, data-rep.texi: Moved `@deftyp {Data type} SCM' line
1720 from gh.texi to data-rep.texi. Both files already had similar
1721 descriptions for SCM. Given that gh.texi is deprecated, looking
1722 up `SCM' in the index should take one to the primary location
1723 rather than deprecated section. Hence this change. Added
1724 `@deftp' for scm_t_bits data type so that a proper index entry is
1725 added for this. Thanks to Richard Y. Kim!
1727 * data-rep.texi (Subrs): Changed scm_make_gsubr to
1728 scm_c_define_gsubr. Thanks to Richard Y. Kim!
1730 2002-04-24 Marius Vollmer <mvo@zagadka.ping.de>
1732 * srfi-modules.texi (SRFI-13 Miscellaneous): Updated docs of
1735 2002-04-20 Neil Jerram <neil@ossau.uklinux.net>
1737 * scheme-intro.texi (Scheme Layout), scm.texi (Reference Layout):
1738 Node moved from a to b.
1740 * guile.texi (Scheme Intro, Basic Ideas, Guile Scripting, Command
1741 Line Handling, Debugging Features, Autoconf Support, Miscellaneous
1742 Tools, Further Reading): Moved to new Part II.
1744 * preface.texi (Manual Layout): Part numbers updated accordingly.
1746 * guile.texi (Top): Move API Overview node to beginning of Guile
1748 (Part II: Writing and Running Guile Scheme): New part; will
1749 contain content from `Programming with Guile' that pertains to
1750 writing and using Guile on the Scheme level.
1752 * scm.texi (API Overview): Renamed from `Guile API'.
1754 * guile.texi (Top), scheme-modules.texi (Included Guile Modules):
1755 Debugger User Interface node renamed Debugging Features.
1757 * debugging.texi (Stacks and Frames): Node deleted; non-duplicated
1758 material moved to scheme-debug.texi.
1759 (Debugging Features): Renamed from `Debugger User Interface'.
1761 * scheme-debug.texi (Debugging): Rename chapter `Debugging
1762 Infrastructure' and reorganize its contents.
1764 * scheme-debug.texi (Debugging), scheme-control.texi (Handling
1765 Errors): Move display-error to error-focussed section.
1767 * scheme-debug.texi (Debugging), debugging.texi (Backtrace): Move
1768 backtrace to user-level debugging chapter.
1770 * scheme-debug.texi (Debugging), scheme-procedures.texi (Procedure
1771 Properties): Move procedure-name, procedure-source and
1772 procedure-environment to procedures chapter.
1774 * scheme-debug.texi (Debugging), scheme-memory.texi (Memory
1775 Blocks): Move malloc-stats to memory management chapter.
1777 * scheme-procedures.texi (Syntax Rules): Remove mention of
1778 use-modules for loading syncase; only use-syntax really works.
1779 Thanks to Panagiotis Vossos for spotting this.
1781 * program.texi (Scheme vs C): New node, with existing material
1782 taken from chapter intro.
1783 (Programming Overview): New intro para to introduce example of
1785 (Extending Dia): New node.
1787 2002-04-17 Marius Vollmer <mvo@zagadka.ping.de>
1789 * Makefile.am (CLEANFILES): Added guile.cps, guile.fns, guile.rns,
1790 guile.tps, guile.vrs, guile.tmp.
1792 2002-04-01 Neil Jerram <neil@ossau.uklinux.net>
1794 * scheme-intro.texi (Scheme Layout): Remove reference to defunct
1795 Guile Extensions index.
1797 * guile.texi: Removed Guile Extensions index.
1799 * scheme-indices.texi (Guile Extensions Index): Removed.
1801 * guile.texi: Remove vgone, vdeprecated, vchanged and vnote
1802 macros; they're not actually useful after all. Update copyright
1805 * scheme-compound.texi (Vectors): Make subsections into nodes.
1806 (Vectors): Review, slightly reorg and clarify docs in this
1809 * scheme-data.texi (Symbols): Reorganized node substructure and
1810 added lots of explanatory text around the @deffn's.
1812 2002-03-29 Neil Jerram <neil@ossau.uklinux.net>
1814 * scheme-modules.texi (Variables): Mention obarrays.
1816 * scheme-data.texi (Symbol Tables, Symbol Props): Remove vgone
1817 markers for deprecated symbol items.
1818 (Symbol Props): Remove doc for obsolete 2 arg version of
1820 (String Miscellanea): Removed, since it only contained duplicate
1821 doc for string-ci->symbol.
1822 (Symbol Tables): Move doc for gensym to Symbol Primitives; rest of
1825 * posix.texi (Ports and File Descriptors), scheme-evaluation.texi
1826 (Fly Evaluation): Remove vgone markers for close-all-ports-except,
1827 eval2 and read-and-eval!.
1829 * data-rep.texi (Describing a New Type), scheme-compound.texi
1830 (Append/Reverse), scheme-procedures.texi (Internal Macros):
1831 Trivial updates to sync with stable branch.
1833 2002-03-27 Neil Jerram <neil@ossau.uklinux.net>
1835 * scheme-compound.texi (List Searching): Remove docs for
1836 `scm_sloppy_mem*', which no longer exist.
1838 2002-03-24 Neil Jerram <neil@ossau.uklinux.net>
1840 * guile.texi (Top), intro.texi (What is Guile?, The Basic Guile
1841 Package): Use @ifnottex instead of @ifinfo, so that HTML
1842 generation works correctly.
1844 2002-03-24 Marius Vollmer <mvo@zagadka.ping.de>
1846 * tools.texi: Updated to reflect changes to the guile-snarf tool.
1848 2002-03-16 Neil Jerram <neil@ossau.uklinux.net>
1850 * scheme-utility.texi (Hooks): Further updates. New material on
1853 * scheme-evaluation.texi (Fly Evaluation): Note disappearance of
1854 eval2 and read-and-eval!.
1856 * deprecated.texi (Deprecated): Remove docs about previously
1857 deprecated items that have now been removed.
1859 2002-03-15 Thien-Thi Nguyen <ttn@giblet.glug.org>
1861 * tools.texi (guile-1.4 guile-snarf): Remove this node.
1862 (How guile-snarf works): Update usage and description to
1863 no longer mention "--compat=1.4" and instead "-d" and "-D".
1864 (Macros guile-snarf recognizes): Add list of deprecated macros
1865 and blurb. Add cindex for deprecated macros.
1867 2002-03-15 Neil Jerram <neil@ossau.uklinux.net>
1869 * scheme-utility.texi (Hooks): Reviewed and updated.
1871 * scheme-options.texi (Feature Tracking): New section.
1873 * scheme-data.texi (Arithmetic, Primitive Numerics): Add
1874 description of corresponding C functions.
1876 * scheme-utility.texi (Object Properties): Revamp documentation on
1879 * scheme-memory.texi (Weak References): Update reference to Object
1882 * guile.texi: Add macros for describing version information.
1884 * scheme-data.texi, scheme-debug.texi, scheme-io.texi,
1885 scheme-procedures.texi: Automatic updates from snarfed libguile
1888 2002-03-13 Thien-Thi Nguyen <ttn@giblet.glug.org>
1890 * Makefile.am (guile_toc.html): Look for guile.texi in $(srcdir).
1892 * tools.texi (How guile-snarf works): Mention "--compat=1.4", and
1893 new processing steps. Update usage example, makefile frag.
1895 (guile-1.4 guile-snarf): New subsubsection under
1896 "Init Snarfing with guile-snarf".
1898 2002-03-12 Neil Jerram <neil@ossau.uklinux.net>
1900 * scheme-compound.texi, scheme-data.texi, new-docstrings.texi:
1901 Automatic updates from snarfed libguile docstrings.
1903 * data-rep.texi, guile.texi, scheme-evaluation.texi,
1904 scheme-options.texi, scheme-translation.texi: Various minor
1905 enhancements ported from the stable CVS branch.
1907 2002-03-08 Thien-Thi Nguyen <ttn@giblet.glug.org>
1909 * tools.texi (Miscellaneous Tools): New node/chapter.
1910 (Snarfing, Init Snarfing with guile-snarf, How guile-snarf works,
1911 Macros guile-snarf recognizes, Doc Snarfing): New nodes/(sub)sections.
1912 (Executable Modules): Now a section under "Miscellaneous Tools".
1914 * guile.texi (Miscellaneous Tools): Add under "Part II".
1915 Implement by including tools.texi.
1917 * Makefile.am (guile_TEXINFOS): Add tools.texi.
1919 2002-03-07 Thien-Thi Nguyen <ttn@giblet.glug.org>
1921 * tools.texi: New file.
1923 2002-03-03 Neil Jerram <neil@ossau.uklinux.net>
1925 * autoconf.texi (Autoconf Background): Insert missing `of'.
1927 2002-03-01 Dirk Herrmann <D.Herrmann@tu-bs.de>
1929 * api.txt, data-rep.texi: Renamed the struct scm_cell to
1932 * data-rep.texi: Renamed scm_alloc_cell to scm_cell and
1933 scm_alloc_double_cell to scm_double_cell.
1935 2002-03-01 Marius Vollmer <mvo@zagadka.ping.de>
1937 * scheme-memory.texi (Upgrading from scm_must_malloc et al): New
1940 2002-02-28 Marius Vollmer <mvo@zagadka.ping.de>
1942 * data-rep.texi: Use scm_gc_malloc and scm_gc_free instead of
1943 scm_must_malloc and free in example code. Updated text for the
1944 new memory management functions.
1946 * scheme-debug.texi (malloc-stats): Refer to scm_gc_malloc instead
1947 of to scm_must_malloc.
1949 2002-02-27 Stefan Jahn <stefan@lkcc.org>
1951 * gh.texi (scm transition summary): Documented some more
1952 gh equivalents and removed appropriate FIXME's.
1954 2002-02-26 Thien-Thi Nguyen <ttn@giblet.glug.org>
1956 * Makefile.am: Update path to pre-inst-guile automake frag.
1958 2002-02-24 Rob Browning <rlb@defaultvalue.org>
1960 * .cvsignore: add autoconf-macros.texi.
1962 * Makefile.am (CLEANFILES): add autoconf-macros.texi.
1964 2002-02-19 Marius Vollmer <mvo@zagadka.ping.de>
1966 * scheme-memory.texi (Memory Blocks): New section.
1968 2002-02-05 Thien-Thi Nguyen <ttn@giblet.glug.org>
1970 * Makefile.am: Include $(top_srcdir)/pre-inst-guile.am.
1972 (GUILE): Delete var.
1973 (autoconf-macros.texi): Use $(preinstguiletool).
1975 2002-02-04 Thien-Thi Nguyen <ttn@giblet.glug.org>
1977 * autoconf.texi (Autofrisk, Using Autofrisk): New sections.
1978 (Autoconf Support): Add new sections to menu.
1980 2002-02-04 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1982 * scheme-data.texi (Symbol Uninterned): Added node.
1984 2002-01-29 Stefan Jahn <stefan@lkcc.org>
1986 * gh.texi (scm transition summary): Documented gh equivalents
1987 `scm_c_string2str', `scm_c_substring2str' and `scm_c_symbol2str'
1988 and removed the appropriate FIXME's.
1990 2002-01-14 Marius Vollmer <marius.vollmer@uni-dortmund.de>
1992 * Makefile.am (autoconf-macros.texi): Also set GUILE_LOAD_PATH
1993 when invoking the uninstalled guile executable.
1995 2002-01-09 Thien-Thi Nguyen <ttn@giblet.glug.org>
1997 * Makefile.am (autoconf-macros.texi): Fix build bug:
1998 Write this file to srcdir. Thanks to I. N. Golubev.
2000 2002-01-08 Gary Houston <ghouston@arglist.com>
2002 * Makefile.am: attempt to use guile from $(top_builddir)/libguile
2003 when building autoconf-macros.texi. There are still problems with
2004 modules and running makeinfo when builddir != srcdir.
2006 2002-01-08 Thien-Thi Nguyen <ttn@giblet.glug.org>
2008 * data-rep.texi, gh.texi, guile.texi, intro.texi,
2009 misc-modules.texi, new-docstrings.texi, posix.texi, program.texi,
2010 repl-modules.texi, scheme-binding.texi, scheme-compound.texi,
2011 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
2012 scheme-ideas.texi, scheme-io.texi, scheme-memory.texi,
2013 scheme-modules.texi, scheme-procedures.texi,
2014 scheme-translation.texi, scheme-utility.texi, scm.texi, slib.texi,
2015 srfi-modules.texi: Spell check. Thanks to Fabrice Bauzac.
2017 2002-01-07 Neil Jerram <neil@ossau.uklinux.net>
2019 * intro.texi (Linking Programs With Guile): Fix typo (superfluous
2020 `do'). Thanks to Fabrice Bauzac.
2022 2002-01-05 Thien-Thi Nguyen <ttn@giblet.glug.org>
2024 * intro.texi: Spell check. Thanks to Fabrice Bauzac.
2026 2002-01-02 Thien-Thi Nguyen <ttn@giblet.glug.org>
2028 * guile.texi (Part II): Add "Autoconf Support"; include
2031 * Makefile.am (guile_TEXINFOS): Add autoconf.texi and
2032 autoconf-macros.texi.
2033 (autoconf.texi, autoconf-macros.texi): New rules.
2035 * autoconf.texi: New file.
2037 2001-12-22 Marius Vollmer <mvo@zagadka.ping.de>
2039 * scheme-compound.texi (Alist Example): Changed "Bismarck" to
2040 "Pierre". Thanks to Ron Peterson!
2042 2001-12-22 Neil Jerram <neil@ossau.uklinux.net>
2044 * program.texi (Programming Overview): Chapter renamed from
2045 `Programming Options'; some new material added.
2047 2001-12-07 Neil Jerram <neil@ossau.uklinux.net>
2049 * scm.texi (Guile API): Renamed from `Scheme Primitives' and
2050 broadened so that this chapter discusses the Guile API as a whole.
2052 * program.texi (Available Functionality): Revise so that text
2055 * guile.texi (Programming Intro): New introductory text.
2057 * scheme-ideas.texi (Definition): Reorder reference bullets in
2058 ascending page number order.
2060 2001-12-04 Martin Grabmueller <mg@glug.org>
2062 * scheme-procedures.texi (Optional Arguments): Typo fix: wither ->
2065 2001-12-01 Neil Jerram <neil@ossau.uklinux.net>
2067 * scheme-data.texi (Hooks): Moved into scheme-utility.texi.
2069 * Makefile.am (guile_TEXINFOS): Added scheme-compound.texi.
2071 * scheme-data.texi (Variables): Node moved to modules chapter.
2072 (Symbol Read Syntax): New node, with syntax-related material taken
2073 from old Symbols node.
2074 (Symbol Primitives): Renamed from `Symbols'.
2075 (Symbols and Variables): Renamed to `Symbols'.
2076 (Symbol Props): Renamed from `Symbol Tables'.
2077 (Symbols): General review, improvements and additional material
2078 throughout this section.
2079 (Other Data Types): New material: links to object types documented
2080 elsewhere. Also renamed node to `Other Types'.
2081 (Data Types): Split into two: `Simple Data Types' and `Compound
2082 Data Types'. Introductory blurbs rewritten accordingly.
2084 * guile.texi: Updated Notes comment.
2086 * scheme-data.texi (Rx Interface): Node moved to Guile Modules
2087 part, as the Rx interface is not core Guile.
2089 2001-11-30 Neil Jerram <neil@ossau.uklinux.net>
2091 * scheme-data.texi (String Miscellanea): Removed, moving doc for
2092 string-ci->symbol into the node on Symbols.
2094 * Makefile.am (ETAGS_ARGS): Added.
2096 * scheme-data.texi (Symbol Tables): Removed doc for gentemp,
2097 intern-symbol, string->obarray-symbol, symbol-binding,
2098 symbol-bound?, symbol-set!, unintern-symbol, symbol-interned?; all
2099 of which no longer exist.
2101 2001-11-25 Thien-Thi Nguyen <ttn@glug.org>
2103 * posix.texi: Fix spelling. Thanks to Chris Cramer.
2104 Reword `getpass' intro blurb.
2106 2001-11-23 Neil Jerram <neil@ossau.uklinux.net>
2108 * program.texi (Program Control): Remove spurious placeholder
2111 2001-11-20 Thien-Thi Nguyen <ttn@glug.org>
2113 * scheme-options.texi (Install Config):
2114 Tweak `%load-path' verb to not imply it's a proc.
2115 Add documentation for `%guile-build-info'.
2117 2001-11-19 Neil Jerram <neil@ossau.uklinux.net>
2119 * scheme-data.texi (Symbol Tables), new-docstrings.texi: Removed
2120 doc for builtin-bindings (no longer exists).
2121 (Variables): Expanded existing description of variables. Removed
2122 doc for builtin-variable (no longer exists).
2124 * scheme-binding.texi (Top Level): New docs for define, scm_define
2125 and scm_c_define. Also clarified point about interchangeability
2128 2001-11-18 Neil Jerram <neil@ossau.uklinux.net>
2130 * scheme-data.texi (Vectors): Autoupdate docs for
2131 vector-move-left! and vector-move-right!.
2133 2001-11-16 Neil Jerram <neil@ossau.uklinux.net>
2135 * debugging.texi, deprecated.texi, intro.texi, misc-modules.texi,
2136 new-docstrings.texi, posix.texi, scheme-binding.texi,
2137 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
2138 scheme-evaluation.texi, scheme-io.texi, scheme-memory.texi,
2139 scheme-modules.texi, scheme-options.texi, scheme-procedures.texi,
2140 scheme-scheduling.texi, scheme-translation.texi,
2141 scheme-utility.texi, script-getopt.texi, srfi-modules.texi: Change
2142 category for "primitive" and "procedure" @deffn's to {Scheme
2143 Procedure}; add @deffnx lines for {C Function}s; automatic updates
2144 from libguile docstring changes.
2146 * scheme-memory.texi (Garbage Collection): Removed doc for removed
2149 2001-11-14 Thien-Thi Nguyen <ttn@glug.org>
2151 * scheme-procedures.texi: Spell "library" correctly.
2153 2001-11-13 Neil Jerram <neil@ossau.uklinux.net>
2155 * new-docstrings.texi, scheme-data.texi: Merge recent doc
2156 improvements from stable branch.
2158 * scheme-options.texi: Automatic updates from docstring changes in
2159 libguile's C source code.
2161 2001-11-12 Neil Jerram <neil@ossau.uklinux.net>
2163 * scheme-data.texi (Vtables, Structure Basics): Automatic doc
2164 updates for struct? and struct-vtable?.
2165 (String Searching): Add missing "for". Thanks to Scott Lenser.
2167 2001-11-08 Neil Jerram <neil@ossau.uklinux.net>
2169 * guile.texi (Top): Added new chapter `Programming Options'.
2171 * program.texi: New file.
2173 * Makefile.am (guile_TEXINFOS): Added program.texi.
2175 2001-11-07 Neil Jerram <neil@ossau.uklinux.net>
2177 * scheme-memory.texi, scheme-io.texi, scheme-debug.texi,
2178 scheme-data.texi, scheme-binding.texi, posix.texi,
2179 new-docstrings.texi: Automatic updates from improved libguile
2182 2001-11-04 Neil Jerram <neil@ossau.uklinux.net>
2184 * preface.texi: Use MANUAL_EDITION variable.
2185 (Manual Layout): Updated to reflect reorg.
2187 * guile.texi (MANUAL_EDITION): New variable, with value
2188 incremented from 1.0 to 1.1 to reflect the reorg described here.
2189 (Top): Use MANUAL_EDITION variable.
2191 * scheme-indices.texi (R5RS Index, Guile Extensions Index): Use
2192 @unnumbered rather than @chapter for these indices.
2194 * guile.texi (Top): A little top-level reshuffling, with the aims
2195 that: (1) the `Guile Scheme' (reference) part of the manual
2196 becomes the `Guile API Reference', and covers both Scheme and C
2197 interfaces; (2) non-API-reference material such as the `Basic
2198 Ideas in Scheme' chapter is collected together to form a new part
2199 `Programming with Guile'. This new part will contain general
2200 documentation on using and programming Guile in both Scheme and C,
2201 including - for example - awareness of GC when C programming, how
2202 to use the snarf macros, how to debug ...
2203 (Top): Move inclusion of scheme-indices.texi so that all indices
2204 appear together in the printed manual.
2206 * Makefile.am (guile_TEXINFOS): Removed appendices.texi, added
2209 * appendices.texi: Removed.
2211 * debugging.texi (Debugger User Interface): New file, same as the
2212 material that used to be in appendices.texi, but now a chapter in
2213 Part II rather than an appendix.
2215 * appendices.texi (Obtaining and Installing Guile): Moved to
2216 become a chapter in ...
2217 * intro.texi: ... Part I: Introduction to Guile.
2219 * scm.texi (I/O Extensions): Moved to become a section of ...
2220 * scheme-io.texi (Input and Output): ... this chapter.
2222 * scm.texi (Handling Errors): Moved to become a section of ...
2223 * scheme-control.texi (Control Mechanisms): ... this chapter.
2225 2001-11-06 Thien-Thi Nguyen <ttn@glug.org>
2227 * srfi-modules.texi (SRFI-19, SRFI-19 Constants, SRFI-19 Current
2228 time and clock resolution, SRFI-19 Time object and accessors,
2229 SRFI-19 Time comparison procedures, SRFI-19 Time arithmetic
2230 procedures, SRFI-19 Date object and accessors, SRFI-19
2231 Time/Date/Julian Day/Modified Julian Day converters, SRFI-19 Date
2232 to string/string to date converters): New nodes.
2233 (SRFI Support): Add "SRFI-19" to menu.
2235 2001-11-06 Marius Vollmer <mvo@zagadka.ping.de>
2237 * scripts.texi: Document `--debug' and `--no-debug'.
2239 2001-10-27 Gary Houston <ghouston@arglist.com>
2241 * guile.texi, scsh.texi: removed obsolete guile-scsh material
2242 and updated links (I don't know if it should remain in the
2243 main menu. It's like slib I think.)
2245 * minor updates to the slib installation notes.
2247 2001-10-05 Neil Jerram <neil@ossau.uklinux.net>
2249 * scheme-evaluation.texi (Fly Evaluation): Removed documentation
2250 for `read-and-eval!' and `eval2'. (Thanks to Alex Schroeder for
2251 noticing that they'd disappeared!)
2253 2001-10-05 Thien-Thi Nguyen <ttn@glug.org>
2255 * scheme-io.texi (Writing): Add entry for `display'.
2256 Include in R5RS Index. Thanks to Alex Schroeder for suggestion.
2258 2001-09-26 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
2260 * srfi-modules.texi (SRFI-13): Tyop fix.
2261 (SRFI-13): Changed paragraph about bindings both in the code and
2264 * misc-modules.texi (Formatted Output): Tyop fix.
2265 (Formatted Output): Document ~g properly.
2267 Thanks to Alex Schroeder for pointing out the typos and sending
2270 2001-09-25 Thien-Thi Nguyen <ttn@glug.org>
2272 * scheme-procedures.texi (Syntax Rules): Add `cindex' directive.
2273 Thanks to suggestion by Alex Schroeder.
2275 2001-08-30 Neil Jerram <neil@ossau.uklinux.net>
2277 * guile.texi (Top): Group all index nodes together so that
2278 `Info-index' works more effectively in Info. Thanks to Eric
2279 Hanchrow for the report and fix.
2281 * scheme-data.texi (Random, String Syntax, String Modification,
2282 Regular Expressions), scheme-ideas.texi (Definition),
2283 scheme-modules.texi (Dynamic Linking and Compiled Code Modules),
2284 scm.texi (Transforming Scheme name to C name, Port
2285 Implementation): Various typo fixes and clarifications merged from
2286 the stable CVS branch.
2288 2001-08-27 Neil Jerram <neil@ossau.uklinux.net>
2290 * intro.texi: Merged wording fixes from stable CVS branch.
2292 * Makefile.am (guile_TEXINFOS): Remove ../AUTHORS.
2294 * guile.texi: Incorporate text previously in separate AUTHORS
2297 2001-08-27 Neil Jerram <neil@ossau.uklinux.net>
2299 The change log for files in this directory continues backwards
2300 from 2001-08-27 in ../ChangeLog, as all the Guile documentation
2301 prior to this date was contained in a single directory.