1 2001-04-29 Neil Jerram <neil@ossau.uklinux.net>
3 * guile.texi (Top): Add menu entry for Manual Conventions node.
5 2001-04-28 Neil Jerram <neil@ossau.uklinux.net>
7 * THANKS: Move authorship bit into AUTHORS, simplify structure,
10 * AUTHORS, guile.texi, guile-tut.texi, goops.texi, Makefile.am:
11 Consolidate authorship information in AUTHORS file, and @include
12 AUTHORS from the top level source file for each manual.
14 2001-04-28 Thien-Thi Nguyen <ttn@revel.glug.org>
16 * preface.texi (Manual Conventions): New chapter.
18 2001-04-26 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
20 * srfi-13-14.texi (Reverse/Append): Updated procedure names for
21 string-concatenate-reverse[/shared].
22 (Reverse/Append): Document the parameter `end' to
23 string-concatenate-reverse.
25 2001-04-26 Neil Jerram <neil@ossau.uklinux.net>
27 * data-rep.texi (Defining New Types (Smobs)): Use non-deprecated
28 smob interface. Thanks to Masao Uebayashi for the patch!
29 (Creating Instances): Don't need SCM_NIMP anymore.
31 2001-04-25 Marius Vollmer <mvo@zagadka.ping.de>
33 * guile.1: New file, from Robert Merkel and Rob Browning.
34 * Makefile.am (man_MANS, EXTRADIST): Added, but still commented
35 out: install and distribute the manpage. It is not yet installed
36 or distributed since we don't have Robert's papers yet.
38 2001-04-24 Neil Jerram <neil@ossau.uklinux.net>
40 * guile-tut.texi: Include version-tutorial.texi rather than
43 * Makefile.am ($(srcdir)/version-tutorial.texi): New target, to
44 avoid having two files both include version.texi.
46 2001-04-24 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
48 * Makefile.am (guile_TEXINFOS): Added srfi-13-14.texi.
50 * srfi-13-14.texi: New file documenting SRFI-13/14.
52 * guile.texi (Top): Added the SRFI-13/14 menu entry and @include.
54 2001-04-22 Neil Jerram <neil@ossau.uklinux.net>
56 * posix.texi (Network Sockets and Communication): Automatic
57 docstring updates for `socket' and `connect'. (For IPV6 support.)
59 * scheme-io.texi: Remove old docstring comments referring to
62 * appendices.texi (The Basic Guile Package, Packages not shipped
63 with Guile), env.texi (Switching to Environments), format.texi
64 (Format Specification), gh.texi
65 (Executing Scheme code, Calling Scheme procedures from C),
66 guile-tut.texi (How to characterize Guile), scheme-data.texi
67 (Symbols, Keywords, Keyword Read Syntax, Append/Reverse),
68 scheme-evaluation.texi (Delayed Evaluation), scheme-modules.texi
69 (Scheme and modules), scheme-io.texi (Soft Ports): Change R4RS
74 * Makefile.am (info_TEXINFOS): Remove r4rs.
76 * README: Note removal of r4rs, and provide a reference.
78 * scheme-control.texi (Exceptions): Extended documentation.
79 (Continuations): Correct "except" typo, and fix reference to
80 Exceptions node. Plus minor review changes.
82 2001-04-20 Neil Jerram <neil@ossau.uklinux.net>
84 * scheme-control.texi (Exceptions): Reorganized and extended
85 existing documentation; more to come.
87 2001-04-20 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
89 * scheme-evaluation.texi (Comments): Document normal comments and
91 (Block Comments): Documented multiline comments.
92 (Case Sensitivity): Documented R5RS and Guile behaviour and how to
95 * scheme-control.texi (Continuations): Added some documentation
97 (Exceptions): Added xref to `Continuations'.
99 * scheme-binding.texi (Binding Reflection): Typo fix.
101 2001-04-20 Neil Jerram <neil@ossau.uklinux.net>
103 * gh.texi (Executing Scheme code): gh_eval_file returns
104 SCM_UNSPECIFIED. Thanks to Dirk for the report!
106 * data-rep.texi (Non-immediate Datatypes, Immediates vs
107 Non-immediates): Emphasize current rather than pre-1.4 practice
108 when talking about not needing to call SCM_NIMP.
110 * recipe-guidelines.txt: New file: guidelines for contributions to
111 the Guile Recipes manual.
113 2001-04-20 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
115 * intro.texi (Using Guile Modules): Wrote intro to using modules.
116 (Writing New Modules): New intro for writing modules.
117 (Reporting Bugs): Added info about what is a bug and what to
118 include in a bug report (taken and adapted from the Emacs
121 2001-04-19 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
123 * scheme-control.texi (while do): Added documentation for named
126 * scheme-binding.texi (Internal Definitions): New explanation of
127 `Internal Definitions'.
128 (Top Level): Documented behaviour of top level definitions.
129 (Binding Constructs): New introductory text.
130 (Local Bindings): Explain concept of local bindings. Document
131 let, let* and letrec.
133 2001-04-18 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
135 * scheme-modules.texi (Modules): Added menu descriptions.
136 (Scheme and modules, The Guile module system): Some whitespace
138 (The Guile module system): Layout fixes, docstring fix for
141 2001-04-17 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
143 * scheme-control.texi (Multiple Values): Documented concept of
144 multiple values, added docs for `receive'.
145 (begin): Documented `begin'.
146 (if cond case): Documented `if', `cond' and `case'.
147 (and or): Documented `and' and `or'.
148 (while do): Documented `do' and `while'.
150 * scheme-procedures.texi (Optional Arguments): Split the node,
151 added introductory text, added menu for subsections.
152 (let-optional Reference, let-keywords Reference),
153 (lambda* Reference, define* Reference): Added syntax documentation
154 for all exported procedures from (ice-9 optargs).
156 2001-04-17 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
158 * scheme-utility.texi (General Conversion): New node, added
160 (Equality): Added definition and explanation of `sameness'.
162 * posix.texi (System Identification): Added `gethostname' and
164 (Processes): Added `setpriority' and `getpriority'.
165 (User Information): Added `cuserid' and `getlogin'.
166 (Ports and File Descriptors): Added `flock'.
167 (Processes): Added `chroot'.
168 (File System): Added `mkstemp!'.
169 (Encryption): New node, added `crypt' and `getpass'.
171 * new-docstrings.texi: Moved several docstrings over to the
172 reference manual (see above which).
174 * scheme-data.texi (Data Types), (Numerical Tower): Add explicit
175 @bullet to @itemize to satisfy older `makeinfo'.
177 2001-04-16 Neil Jerram <neil@ossau.uklinux.net>
179 * data-rep.texi (Signalling Type Errors): Update SCM_ASSERT doc
180 for recent changes to disallow passing a string parameter as the
181 `pos'. Thanks to Dirk Herrmann for the patch!
183 2001-04-13 Neil Jerram <neil@ossau.uklinux.net>
185 * data-rep.texi (Unpacking the SCM type): New section, taken from
186 Dirk Herrmann's description of SCM and scm_bits_t in api.txt.
187 (Immediate Datatypes, Non-immediate Datatypes): Remove obsolete
188 notes about needing to call SCM_NIMP.
190 2001-04-11 Neil Jerram <neil@ossau.uklinux.net>
192 * scheme-procedures.texi (Procedures with Setters): Fix dvi
193 building syntax error. Thanks to Dale P. Smith for the report and
196 2001-04-11 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
198 * scheme-scheduling.texi (Arbiters): New explanatory text.
199 (Asyncs): New explanations and documentation.
200 (Scheduling): Added menu entry descriptions.
201 (Fluids): New documentation.
203 2001-04-11 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
205 * scheme-procedures.texi (Lambda): Documented the lambda form.
206 (Procedure Properties): Concept and usage explanation added.
207 (Procedures with Setters): Explain by example, introduce
210 * scheme-data.texi (Symbols and Variables): Split and reorganized
212 (Symbols): New introductory text.
213 (Characters): Added char-ci* procedures to rn index.
215 2001-04-10 Neil Jerram <neil@ossau.uklinux.net>
217 * scm.texi (Handling Errors): Improve Texinfo markup. Thanks to
218 Dale P. Smith for the patch!
220 * api.txt (Accessing Cell Entries): Fix typo.
222 2001-04-09 Neil Jerram <neil@ossau.uklinux.net>
224 * deprecated.texi (Shared And Read Only Strings): New section for
225 deprecated string stuff. I've also updated the text a bit to
226 reflect current usage of "read only" strings.
228 * scheme-data.texi (Shared Substrings, Read Only Strings): Moved
231 * deprecated.texi, posix.texi, scheme-binding.texi,
232 scheme-control.texi, scheme-data.texi, scheme-debug.texi,
233 scheme-evaluation.texi, scheme-io.texi, scheme-memory.texi,
234 scheme-modules.texi, scheme-options.texi, scheme-procedures.texi,
235 scheme-scheduling.texi, scheme-translation.texi,
236 scheme-utility.texi: Remove `@c docstring' comments, since they
237 aren't used any more by the docstring tracking utilities.
239 2001-04-09 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
241 * scheme-data.texi (Pairs): New data type and procedure
243 (Lists): Added new subsections for grouping the list procedures.
244 (Hooks): Added new nodes for hook subsections.
245 (String Syntax): New node, factoring out read syntax.
246 (Strings): Some blurb about allowed characters, zero-termination
248 (Keywords): Added menu descriptions.
250 2001-04-08 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
252 * scheme-indices.texi (R5RS Index): Print index `rn', not `r5'.
254 * guile.texi: The index formerly known as `r5' is now called `rn'.
256 * scheme-utility.texi, scheme-procedures.texi, scheme-io.texi,
257 scheme-evaluation.texi, scheme-control.texi, scheme-data.texi:
258 Changed all @r5index entries to @rnindex.
260 2001-04-06 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
262 * scheme-data.texi (Hooks): Added hook description and
265 2001-04-06 Thien-Thi Nguyen <ttn@revel.glug.org>
267 * scheme-scheduling.texi (Higher level thread
268 procedures): Replace some instances of `@var' with `@code'.
270 * scheme-scheduling.texi (Higher level thread
271 procedures): Rewrite.
273 2001-04-04 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
275 * scheme-data.texi (Alphabetic Case Mapping),
276 (String Comparison): Rearranged function order.
277 (Vectors): Reorganized, new introductory text, docs about read
280 2001-04-03 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
282 * scheme-options.texi, scheme-procedures.texi,
283 scheme-modules.texi, scheme-memory.texi, scheme-control.texi,
284 scheme-utility.texi, scheme-io.texi, scheme-evaluation.texi,
285 scheme-data.texi: Removed a lot of ARGFIXME's after tweaking
286 docstrings and C source.
288 * new-docstrings.texi, scheme-io.texi, scheme-data.texi,
289 posix.texi, scheme-control.texi, scheme-evaluation.texi,
290 scheme-memory.texi, scheme-procedures.texi, scheme-modules.texi,
291 scheme-scheduling.texi: Automated docstring merging.
293 2001-04-02 Neil Jerram <neil@ossau.uklinux.net>
295 * data-rep.texi (Immediates vs. Non-immediates): Update
296 out-of-date documentation. (Thanks to Dirk Herrmann for the
298 (Immediates vs Non-immediates): Renamed without the dot, since the
299 dot causes `info' not to be able to display this node!
301 * Makefile.am (guile_TEXINFOS): Add in a few more source files
302 that had got left out.
304 2001-03-30 Neil Jerram <neil@ossau.uklinux.net>
306 * scheme-reading.texi (Further Reading): Add bullets to further
309 * gh.texi: Insert page break before chapter. Remove page breaks
312 * Makefile.am: Add script-getopt.texi.
314 * guile.texi (Top): Include and link to new script-getopt.texi
317 * script-getopt.texi: New chapter on command line handling.
318 (Written and contributed by Martin Grabmueller, revised by me.)
320 * intro.texi (Modules and Extensions): Fix typo.
322 2001-03-27 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
324 * scheme-data.texi (Strings): Reorganized the whole `Strings'
325 section and wrote introductory material for each new subsection.
327 2001-03-25 Marius Vollmer <mvo@zagadka.ping.de>
329 * intro.texi (Modules and Extensions): Some short text about
330 dynamic libraries and modules.
332 2001-03-23 Neil Jerram <neil@ossau.uklinux.net>
334 * intro.texi (Writing Extensions for Guile), scheme-data.texi
337 * guile-tut.texi, ChangeLog-guile-doc-tutorial: Added to CVS. It
338 seems that I somehow missed these out when I moved everything from
339 guile-doc to guile-core.
341 * posix.texi, scheme-data.texi, scheme-evaluation.texi,
342 scheme-io.texi, scheme-memory.texi: Automatic docstring updates.
344 * new-docstrings.texi: New file. Holds snarfed docstrings that
345 have not yet been incorporated into the reference manual.
347 2001-03-20 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
349 * scheme-options.texi (Evaluator options): Added evaluator
350 options, corrected docs for evaluator trap options.
352 * scheme-evaluation.texi (Scheme Read): New docs for read-options,
353 read-enable, read-disable and read-set! and cross references to
355 (Evaluator Options): New docs for eval-options, eval-enable,
356 eval-disable and eval-set!, traps, trap-enable, trap-disable and
357 trap-set! and cross references to option nodes.
358 (Evaluator Behaviour): Renamed node from `Evaluator options' to
361 * scheme-io.texi (String Ports): Added docs for SRFI-6 procedures.
362 (Void Ports): Corrected introductory comment.
364 2001-03-16 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
366 * scheme-data.texi (Arithmetic): Documented the arithmetic
368 (Integer Operations): Added documentation.
369 (Comparison): Added documentation.
370 (Complex): Added documentation.
371 (Symbols and Variables): Comment out `builtin-bindings', which is
372 removed according to NEWS.
373 (Pairs): Added documentation.
375 * scheme-io.texi: Added R5RS index entries for all R5RS
377 (File Ports): New docs for `call-with-input-file',
378 `call-with-output-file', `with-input-from-file',
379 `with-output-to-file', `with-error-to-file'.
381 * scheme-control.texi, scheme-utility.texi,
382 * scheme-procedures.texi: Added R5RS index entries for all R5RS
385 * scheme-evaluation.texi (Fly Evaluation): Added documentation for
386 `apply'. Added R5RS index entries for all R5RS procedures.
388 * scheme-data.texi: Added R5RS index entries for all R5RS
389 procedures. Removed R5RS index entries for `ass{q,v,occ}-set!'.
390 Removed explicit entries into the function entries. They are
392 (Vectors): Added documentation for `make-vector', `vector-ref' and
395 2001-03-12 Marius Vollmer <mvo@zagadka.ping.de>
397 * intro.texi: Changed to reflect current practice better. Added
398 stuff about writing Guile Extensions (aka dynamically loaded
401 2001-03-09 Mikael Djurfeldt <mdj@linnaeus.mit.edu>
403 * goops.texi (VERSION): Bumped to version 0.3.
405 * goops-tutorial.texi, goops.texi: Updated to reflect new
406 define-method syntax.
408 2001-03-09 Neil Jerram <neil@ossau.uklinux.net>
410 * Makefile.am: Change HTML to HTMLDOC, now that we're part of a
413 Moving documentation files from guile-doc and guile-doc into
416 * env.texi, indices.texi, mbapi.texi, mltext.texi, scripts.texi,
417 scsh.texi, tcltk.texi, hierarchy.txt, scheme-indices.texi,
418 slib.texi, deprecated.texi, scheme-binding.texi, appendices.texi,
419 scheme-intro.texi, goops.texi, extend.texi, gh.texi, intro.texi,
420 preface.texi, scm.texi, goops-tutorial.texi, hierarchy.eps,
421 r4rs.texi, r5rs.texi, texinfo.tex, scheme-reading.texi,
422 data-rep.texi, scheme-utility.texi, posix.texi,
423 scheme-control.texi, scheme-debug.texi, scheme-evaluation.texi,
424 scheme-io.texi, scheme-memory.texi, scheme-modules.texi,
425 scheme-options.texi, scheme-procedures.texi,
426 scheme-scheduling.texi, scheme-translation.texi, guile.texi,
427 scheme-data.texi, scheme-ideas.texi, expect.texi,
428 ChangeLog-guile-doc-ref, guile-tut.texi,
429 ChangeLog-guile-doc-tutorial, AUTHORS, BUGS, NEWS, THANKS: New
432 * .cvsignore, Makefile.am, README: Merged.
434 * sources: New subdirectory.
436 Both the following files are about to be replaced by files from
439 * texinfo.tex: Removed.
441 * data-rep.texi: Removed.
443 2001-02-15 Neil Jerram <neil@ossau.uklinux.net>
445 * README: Explain retirement of `data-rep.texi'.
447 * Makefile.am (info_TEXINFOS, data_rep_TEXINFOS): Removed.
449 * data-rep.texi: Replace this copy of data-rep.texi with a notice
450 indicating that it has been retired. The master copy of
451 data-rep.texi is at guile-doc/ref/data-rep.texi.
453 2001-02-04 Marius Vollmer <mvo@zagadka.ping.de>
455 * data-rep.texi: Use SCM_SMOB_DATA instead of SCM_CDR. Also
456 things like SCM_SMOB_PREDICATE and SCM_NEWSMOB. Thanks to Dale
459 2000-10-25 Mikael Djurfeldt <mdj@linnaeus.mit.edu>
461 * mop.text: Preliminary documentation of the GOOPS meta object
464 2000-07-28 Neil Jerram <neil@ossau.uklinux.net>
466 * data-rep.texi (Garbage Collection): Fix "accomodate" spelling
469 2000-06-30 Dirk Herrmann <D.Herrmann@tu-bs.de>
471 * data-rep.tex: Removed documentation for SCM_OUTOFRANGE.
473 2000-06-20 Mikael Djurfeldt <mdj@thalamus.nada.kth.se>
475 * data-rep.texi: Center discussion around the standard interface
476 for smob type creation (scm_make_smob_type) and warn about the
477 ongoing discussion which may result in deprecating
478 scm_make_smob_type_mfpe in next release of Guile.
480 2000-05-15 Dirk Herrmann <D.Herrmann@tu-bs.de>
482 * data-rep.texi: Updated the macro names for operating on
485 2000-03-22 Dirk Herrmann <D.Herrmann@tu-bs.de>
487 * api.txt: Added a first attempt for a description of the newly
488 designed low level API.
490 2000-01-31 Marius Vollmer <mvo@zagadka.ping.de>
492 * Makefile.am (version.texi): Override automake's rule for
493 version.texi so that it gets created even in non-maintainer-mode.
495 Thu Jan 20 13:00:18 2000 Greg J. Badros <gjb@cs.washington.edu>
497 * version.texi, stamp-vti: Removed -- these are auto-generated.
499 2000-01-12 Mikael Djurfeldt <mdj@mdj.nada.kth.se>
501 * Makefile.am (dist-hook): Updated to include oldfmt.c in
502 distribution archive.
504 * README: Updated with note about oldfmt.c.
506 * oldfmt.c: New file: Used by application writers to adapt to
507 new-style error format strings.
509 1999-12-06 Gary Houston <ghouston@freewire.co.uk>
511 * data-rep.texi: change dircategory to match change in guile-doc
514 1999-10-05 Jim Blandy <jimb@savonarola.red-bean.com>
516 * Makefile.in: Deleted from CVS repository. Run the autogen.sh
517 script to create generated files like this one.
519 1999-09-11 Jim Blandy <jimb@savonarola.red-bean.com>
521 * Makefile.in: Regenerated.
523 Fri Jun 25 22:21:43 1999 Greg Badros <gjb@cs.washington.edu>
525 * data-rep.texi: Updated SMOB docs to talk about
526 scm_make_smob_type_mfpe, SCM_RETURN_NEWSMOB, SCM_NEWSMOB function
529 1999-04-17 Jim Blandy <jimb@savonarola.red-bean.com>
531 * Makefile.in: Regenerated.
533 1998-10-19 Jim Blandy <jimb@zwingli.cygnus.com>
536 * Makefile.in: Regenerated.
538 * Makefile.am (EXAMPLE_SMOB_FILES): List example-smob/COPYING.
539 * Makefile.in: Regenerated.
541 1998-10-16 Jim Blandy <jimb@zwingli.cygnus.com>
543 * Makefile.in: Regenerated, after change to qthreads.m4.
545 1998-10-15 Jim Blandy <jimb@zwingli.cygnus.com>
547 * stamp-vti: Regenerated.
549 * hacks.el: Some handy helper functions for working on the manual.
551 * data-rep.texi: Extended to accomodate a full running example,
552 provided with the manual.
553 * example-smob: A new subdirectory, containing example files for
554 the manual chapter on smobs.
555 * Makefile.am (EXAMPLE_SMOB_FILES, dist-hook): New variable and
556 target, to get the example-smob directory into the distribution.
557 * Makefile.in: Regenerated.
559 1998-10-08 Jim Blandy <jimb@zwingli.cygnus.com>
561 * .cvsignore: New file, containing data-rep.info. I'm not sure
562 whether we want to check this file into CVS, because it's
563 generated; if you find compelling reasons it should be, let me
566 1998-10-07 Jim Blandy <jimb@zwingli.cygnus.com>
568 * New directory for documentation.
570 * data-rep.texi: It's not a real manual, but it's better than
572 * Makefile.am, Makefile.in, data-rep.info, data-rep.texi,
573 mdate-sh, stamp-vti, texinfo.tex, version.texi: The usual support