1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-05-02 21:10:27 +02:00
Commit graph

935 commits

Author SHA1 Message Date
Neil Jerram
0c02b40803 * Start new node documenting transition from GH to scm interface. 2001-06-22 14:23:46 +00:00
Neil Jerram
a0143ebc24 * Explain GH deprecation & plan for scm documentation. 2001-06-20 22:08:19 +00:00
Martin Grabmüller
39e30745c8 2001-06-18 Martin Grabmueller <mgrabmue@cs.tu-berlin.de>
* srfi-modules.texi (SRFI-1): Completed procedure documentation.

	* scheme-data.texi (List Constructors): Added make-list.
	Added type index entries for all data types.

2001-06-15  Martin Grabmueller  <mgrabmue@cs.tu-berlin.de>

	* srfi-modules.texi (SRFI-1): New section documenting the SRFI-1
	module.
2001-06-18 19:08:31 +00:00
Gary Houston
837f9d198e fixed doc code bug 2001-06-17 20:45:33 +00:00
Marius Vollmer
eb6c2de855 *** empty log message *** 2001-06-16 20:17:50 +00:00
Marius Vollmer
daabbf15d7 (Conventions): Use `system-error-errno' instead of explicit code 2001-06-16 20:16:12 +00:00
Marius Vollmer
be8dd11837 Updates for load-extension et al. 2001-06-14 17:36:41 +00:00
Neil Jerram
12e5078cbb * Fix rogue text caused by line breaking a comment. 2001-06-08 22:35:30 +00:00
Gary Houston
4bcdfe4641 *** empty log message *** 2001-06-04 21:52:21 +00:00
Gary Houston
1fb9789efd * scheme-io.texi (Block Reading and Writing): added
write-string/partial, updated read-string!/partial.
2001-06-04 21:51:01 +00:00
Michael Livshin
b3372ff632 *** empty log message *** 2001-06-03 14:59:19 +00:00
Martin Grabmüller
fec1807cdb *** empty log message *** 2001-05-30 20:54:17 +00:00
Martin Grabmüller
cee2ed4f73 * General: A lot of typo, texinfo markup and layout corrections.
* scheme-data.texi (Arithmetic): Clarified docs for - and /.
	(String Modification): Removed docs for C functions
	(scm_substring_move_right_x etc.)
	(Keyword Procedures): New section documenting the keyword
	procedures from boot-9.scm.
	(Vectors): Moved the section before the non-standard data types.

	* data-rep.texi (Defining New Types (Smobs)): Adapted description
	of smobs and proocedure creation to new terminology.
	(Describing a New Type): Removed mentioning of
	scm_make_smob_type_mfpe from smob function list and added
	deprecation notice for this function.
	(Creating Instances): Added description and macro docs for smobs
	with 2 or 3 data cells.
	(Garbage Collecting Smobs): Removed old docs for SCM_GCTYP16.
	(Garbage Collecting Simple Smobs): Added some clarification about
	usage and usefulness.
	(Non-immediate Datatypes): Changed R4RS reference to R5RS.
	(Vector Data): Document type-specific accessors.
2001-05-30 20:32:05 +00:00
Martin Grabmüller
7977a48737 * image-type.c: Adapted to new typing and naming convention. 2001-05-30 20:28:51 +00:00
Martin Grabmüller
4a0ef52435 Created a usecase diagram for Guile. 2001-05-24 08:46:50 +00:00
Michael Livshin
1be6b49ccb * validate.h
(SCM_NUM2{SIZE,PTRDIFF,SHORT,USHORT,BITS,UBITS,INT,UINT}[_DEF]):
new macros.

* unif.h: type renaming:
scm_array -> scm_array_t
scm_array_dim -> scm_array_dim_t
the old names are deprecated, all in-Guile uses changed.

* tags.h (scm_ubits_t): new typedef, representing unsigned
scm_bits_t.

* stacks.h: type renaming:
scm_info_frame -> scm_info_frame_t
scm_stack -> scm_stack_t
the old names are deprecated, all in-Guile uses changed.

* srcprop.h: type renaming:
scm_srcprops -> scm_srcprops_t
scm_srcprops_chunk -> scm_srcprops_chunk_t
the old names are deprecated, all in-Guile uses changed.

* gsubr.c, procs.c, print.c, ports.c, read.c, rdelim.c, ramap.c,
rw.c, smob.c, sort.c, srcprop.c, stacks.c, strings.c, strop.c,
strorder.c, strports.c, struct.c, symbols.c, unif.c, values.c,
vectors.c, vports.c, weaks.c:
various int/size_t -> size_t/scm_bits_t changes.

* random.h: type renaming:
scm_rstate -> scm_rstate_t
scm_rng -> scm_rng_t
scm_i_rstate -> scm_i_rstate_t
the old names are deprecated, all in-Guile uses changed.

* procs.h: type renaming:
scm_subr_entry -> scm_subr_entry_t
the old name is deprecated, all in-Guile uses changed.

* options.h (scm_option_t.val): unsigned long -> scm_bits_t.
type renaming:
scm_option -> scm_option_t
the old name is deprecated, all in-Guile uses changed.

* objects.c: various long -> scm_bits_t changes.
(scm_i_make_class_object): flags: unsigned long -> scm_ubits_t

* numbers.h (SCM_FIXNUM_BIT): deprecated, renamed to
SCM_I_FIXNUM_BIT.

* num2integral.i.c: new file, multiply included by numbers.c, used
to "templatize" the various integral <-> num conversion routines.

* numbers.c (scm_mkbig, scm_big2num, scm_adjbig, scm_normbig,
scm_copybig, scm_2ulong2big, scm_dbl2big, scm_big2dbl):
deprecated.
(scm_i_mkbig, scm_i_big2inum, scm_i_adjbig, scm_i_normbig,
scm_i_copybig, scm_i_short2big, scm_i_ushort2big, scm_i_int2big,
scm_i_uint2big, scm_i_long2big, scm_i_ulong2big, scm_i_bits2big,
scm_i_ubits2big, scm_i_size2big, scm_i_ptrdiff2big,
scm_i_long_long2big, scm_i_ulong_long2big, scm_i_dbl2big,
scm_i_big2dbl, scm_short2num, scm_ushort2num, scm_int2num,
scm_uint2num, scm_bits2num, scm_ubits2num, scm_size2num,
scm_ptrdiff2num, scm_num2short, scm_num2ushort, scm_num2int,
scm_num2uint, scm_num2bits, scm_num2ubits, scm_num2ptrdiff,
scm_num2size): new functions.

* modules.c (scm_module_reverse_lookup): i, n: int -> scm_bits_t.x

* load.c: change int -> size_t in various places (where the
variable is used to store a string length).
(search-path): call scm_done_free, not scm_done_malloc.

* list.c (scm_ilength): return a scm_bits_t, not long.
some other {int,long} -> scm_bits_t changes.

* hashtab.c: various [u]int -> scm_bits_t changes.
scm_ihashx_closure -> scm_ihashx_closure_t (and made a typedef).
(scm_ihashx): n: uint -> scm_bits_t
use scm_bits2num instead of scm_ulong2num.

* gsubr.c: various int -> scm_bits_t changes.

* gh_data.c (gh_scm2double): no loss of precision any more.

* gh.h (gh_str2scm): len: int -> size_t
(gh_{get,set}_substr): start: int -> scm_bits_t,
len: int -> size_t
(gh_<num>2scm): n: int -> scm_bits_t
(gh_*vector_length): return scm_[u]size_t, not unsigned long.
(gh_length): return scm_bits_t, not unsigned long.

* fports.h: type renaming:
scm_fport -> scm_fport_t
the old name is deprecated, all in-Guile uses changed.

* fports.c (fport_fill_input): count: int -> scm_bits_t
(fport_flush): init_size, remaining, count: int -> scm_bits_t

* debug.h (scm_lookup_cstr, scm_lookup_soft, scm_evstr): removed
those prototypes, as the functions they prototype don't exist.

* fports.c (default_buffer_size): int -> size_t
(scm_fport_buffer_add): read_size, write_size: int -> scm_bits_t
default_size: int -> size_t
(scm_setvbuf): csize: int -> scm_bits_t

* fluids.c (n_fluids): int -> scm_bits_t
(grow_fluids): old_length, i: int -> scm_bits_t
(next_fluid_num, scm_fluid_ref, scm_fluid_set_x): n: int ->
scm_bits_t
(scm_c_with_fluids): flen, vlen: int -> scm_bits_t

* filesys.c (s_scm_open_fdes): changed calls to SCM_NUM2LONG to
the new and shiny SCM_NUM2INT.

* extensions.c: extension -> extension_t (and made a typedef).

* eval.h (SCM_IFRAME): cast to scm_bits_t, not int.  just so
there are no nasty surprises if/when the various deeply magic tag
bits move somewhere else.

* eval.c: changed the locals used to store results of SCM_IFRAME,
scm_ilength and such to be of type scm_bits_t (and not int/long).
(iqq): depth, edepth: int -> scm_bits_t
(scm_eval_stack): int -> scm_bits_t
(SCM_CEVAL): various vars are not scm_bits_t instead of int.
(check_map_args, scm_map, scm_for_each): len: long -> scm_bits_t
i: int -> scm_bits_t

* environments.c: changed the many calls to scm_ulong2num to
scm_ubits2num.
(import_environment_fold): proc_as_ul: ulong -> scm_ubits_t

* dynwind.c (scm_dowinds): delta: long -> scm_bits_t

* debug.h: type renaming:
scm_debug_info -> scm_debug_info_t
scm_debug_frame -> scm_debug_frame_t
the old names are deprecated, all in-Guile uses changed.
(scm_debug_eframe_size): int -> scm_bits_t

* debug.c (scm_init_debug): use scm_c_define instead of the
deprecated scm_define.

* continuations.h: type renaming:
scm_contregs -> scm_contregs_t
the old name is deprecated, all in-Guile uses changed.
(scm_contregs_t.num_stack_items): size_t -> scm_bits_t
(scm_contregs_t.num_stack_items): ulong -> scm_ubits_t

* continuations.c (scm_make_continuation): change the type of
stack_size form long to scm_bits_t.

* ports.h: type renaming:
scm_port_rw_active -> scm_port_rw_active_t (and made a typedef)
scm_port -> scm_port_t
scm_ptob_descriptor -> scm_ptob_descriptor_t
the old names are deprecated, all in-Guile uses changed.
(scm_port_t.entry): int -> scm_bits_t.
(scm_port_t.line_number): int -> long.
(scm_port_t.putback_buf_size): int -> size_t.

* __scm.h (long_long, ulong_long): deprecated (they pollute the
global namespace and have little value besides that).
(SCM_BITS_LENGTH): new, is the bit size of scm_bits_t (i.e. of an
SCM handle).
(ifdef spaghetti): include sys/types.h and sys/stdtypes.h, if they
exist (for size_t & ptrdiff_t)
(scm_sizet): deprecated.

* Makefile.am (noinst_HEADERS): add num2integral.i.c
2001-05-24 00:50:51 +00:00
Martin Grabmüller
92905faf2c * guile.texi: Commented out menu entry and inclusion of Tcl/Tk
stuff.

	* indices.texi: Users are advised to look under C and Scheme
	names, xref to transformation rules added.

	* intro.texi, scheme-modules.texi, scheme-ideas.texi,
	scheme-evaluation.texi, scheme-data.texi, scheme-procedures.texi:
	Fixed most REFFIXMEs.

	* srfi-modules.texi (About SRFI Usage): New node.
	(SRFI-0): Extended.
	Fixed all REFFIXMEs.
2001-05-23 17:24:50 +00:00
Rob Browning
d579d1652d *** empty log message *** 2001-05-22 23:26:36 +00:00
Neil Jerram
7215d65eb2 * Doc updates for lazy-catch and IP address conversion 2001-05-19 11:13:47 +00:00
Rob Browning
7907f79949 * scheme-options.texi (Install Config): fixed minor-version docs
and added micro-version docs.
2001-05-17 04:53:58 +00:00
Neil Jerram
230712c905 * Fix uses of @itemize without a format specifier. 2001-05-16 19:30:57 +00:00
Martin Grabmüller
fb02eb66f6 * scripts.texi (Invoking Guile): Added docs for --use-srfi.
* expect.texi, repl-modules.texi: Start the chapters with a new
	page.

	* srfi-modules.texi (SRFI-0): Added note about supported feature
	identifiers and an example.  Start the chapter with a new page.

	* srfi-modules.texi, scheme-data.texi, scheme-control.texi,
	scheme-binding.texi, repl-modules.texi, posix.texi, intro.texi,
	scheme-utility.texi: Change `--' to `-' throughout.
2001-05-16 18:08:12 +00:00
Martin Grabmüller
554901a3ad * srfi-13-14.texi: Removed.
* srfi-modules.texi (SRFI-13): Merged SRFI-13 docs into SRFI
	chapter.
	(SRFI-14): Merged SRFI-14 too.

	* guile.texi (Top): Remove inclusion of obsolete SRFI-13/14 file.

	* srfi-modules.texi (SRFI-0): New section.
	(SRFI-16): New section.

	Change `--' to `-' throughout.
2001-05-14 21:37:51 +00:00
Thien-Thi Nguyen
a8b56291db *** empty log message *** 2001-05-13 19:16:20 +00:00
Thien-Thi Nguyen
c71375c94b Fixup some module-related references. 2001-05-13 19:14:41 +00:00
Thien-Thi Nguyen
0281752f6a *** empty log message *** 2001-05-13 11:24:35 +00:00
Thien-Thi Nguyen
2b0ce070a3 (Modules): Remove "babbling" fixme.
(The Guile module system): Rewrite intro.
(General Information about Modules): Rewrite some parts.
Move problems to "Module System Quirks".
(Using Guile Modules): Renamed from "Loading Guile Modules".
Rewrite most parts.
Remove reivewme comment.
(Creating Guile Modules): Review, touch up.
Remove "Tkintr" comment.
(Module System Quirks): New node/subsection.
2001-05-13 11:22:01 +00:00
Michael Livshin
dd9eb53242 *** empty log message *** 2001-05-09 16:38:45 +00:00
Thien-Thi Nguyen
90b7e69a9e *** empty log message *** 2001-05-06 09:18:43 +00:00
Thien-Thi Nguyen
5134bfa751 (Using Guile Modules): Review; remove reviewme comment.
Expand `GUILE_LOAD_PATH' blurb; add small example.
(Reporting Bugs): Review; remove reviewme comment.
Reword some phrases; add texi markup.
Add suggestion to include `guile-config info' output.
Update gdb invocation; add fixme question.
2001-05-06 01:49:56 +00:00
Neil Jerram
3777a9d3b6 * Add Martin to AUTHORS for reference manual. 2001-05-05 13:49:14 +00:00
Neil Jerram
725fd9806a * New material on macros. 2001-05-05 13:40:18 +00:00
Neil Jerram
7a095584a9 * eval.c (scm_promise_p), list.c (scm_append_x, scm_reverse_x),
symbols.c (scm_symbol_to_string), vports.c (scm_make_soft_port):
	Change R4RS references to R5RS.

	* guile-snarf.awk.in: Fixes so that (i) blank lines in the
	docstring source are correctly reproduced in the output (ii)
	we don't anymore get occasional trailing quotes.  Also reorganized
	and commented the code a little.

	* scmsigs.c (scm_raise), throw.c (scm_throw): Docstring format
	fixes.

	* new-docstrings.texi, posix.texi, scheme-control.texi,
	scheme-data.texi, scheme-debug.texi, scheme-evaluation.texi,
	scheme-io.texi, scheme-memory.texi, scheme-procedures.texi:
	Automatic docstring updates (mostly argument name updates and
	blank lines).

	* scheme-modules.texi: Change double hyphens to single.

	* scheme-control.texi (Lazy Catch): Completed.

	* posix.texi (Network Databases and Address Conversion): New
	subsubsection `IPv6 Address Conversion'.
2001-05-04 21:54:00 +00:00
Thien-Thi Nguyen
f92a9df0ff *** empty log message *** 2001-05-04 21:03:43 +00:00
Thien-Thi Nguyen
14e94b6096 (iff): Use proper texi markup.
Thanks to Florian Weimer.
2001-05-04 21:01:35 +00:00
Martin Grabmüller
76f944c3ca * scheme-io.texi (Block Reading and Writing): Moved the
documentation for read-string!/partial from the node `Reading'.

	* scheme-data.texi (List/String Conversion): Added docstring for
	`string-split'.
2001-05-04 04:57:39 +00:00
Martin Grabmüller
fc8529c766 * srfi-13-14.texi: Added @bullet to various @itemize lists.
* srfi-modules.texi (SRFI Support): New file and chapter.

	* Makefile.am (guile_TEXINFOS): Added repl-modules.texi and
	srfi-modules.texi.

	* guile.texi (Top): New menu entries for the new chapters.
	(Top): @includes for the new chapters.
	(Top): New menu entry for `SRFI Support', @include for
	`srfi-modules.texi'.

	* repl-modules.texi: New file.
	(Readline Support): New chapter for (ice-9 readline).
	(Value History): New chapter for (ice-9 history).
2001-05-02 21:50:15 +00:00
Martin Grabmüller
0892b63b25 * scheme-modules.texi (Dynamic Libraries): Renamed from `Dynamic
Linking from Marius''.
	(The Guile module system): Removed obsolete naming convention.
	(Loading Guile Modules, Creating Guile Modules),
	(More Module Procedures, Included Guile Modules): New nodes, split
	from `The Guile module system'.
	(The Guile module system): Changed references to (ice-9 slib) to
	(ice-9 popen), because note everybody has SLIB installed.
	(Included Guile Modules): Added a bunch of modules shipped with
	Guile.

	(Dynamic Libraries): (old version) Removed.

	* scheme-io.texi (Block Reading and Writing): Corrected
	capitalization, so it builds again.
2001-05-02 14:44:38 +00:00
Gary Houston
e200c20fa0 * scheme-io.texi: Removed obsolete section Binary IO. Added
new section Block Reading and Writing.  Updated section
	Line/Delimited with module usage.
2001-05-01 21:05:44 +00:00
Neil Jerram
d72691f291 * Doc updates for removal of previously deprecated features.
* More detailed AUTHORS description for Jim Blandy.
2001-04-29 23:01:07 +00:00
Neil Jerram
370bababda * Consolidate authorship information in AUTHORS file.
* Simplify THANKS file and add in recent contributors.
* Add top level menu entry for Manual Conventions node.
* Consolidate notes at beginning of guile.texi.
2001-04-28 23:38:52 +00:00
Gary Houston
cb869864dd * take most of the credit for the manual, at least the unreadable
bits.
2001-04-28 20:54:09 +00:00
Thien-Thi Nguyen
255b50e069 *** empty log message *** 2001-04-28 18:35:41 +00:00
Thien-Thi Nguyen
e9b00bf820 (Manual Conventions): New chapter. 2001-04-28 18:34:17 +00:00
Neil Jerram
87f05a7a5a * Updates to authors and thanks files. 2001-04-28 09:00:31 +00:00
Martin Grabmüller
c59ef9c154 * srfi-13-14.texi (Reverse/Append): Updated procedure names for
string-concatenate-reverse[/shared].
	(Reverse/Append): Document the parameter `end' to
	string-concatenate-reverse.
2001-04-26 19:59:33 +00:00
Neil Jerram
bd5e684091 * Update SMOB example and associated documentation. 2001-04-26 18:26:28 +00:00
Marius Vollmer
253081cf6a *** empty log message *** 2001-04-24 23:51:05 +00:00
Marius Vollmer
4cd2722652 * guile.1: New file, from Robert Merkel and Rob Browning.
* Makefile.am (man_MANS, EXTRADIST): Added, but still commented
out: install and distirbute the manpage.  It is not yet installed
or distributed since we don't have the Robert's papers yet.
2001-04-24 23:23:05 +00:00
Neil Jerram
b516a720b9 * Fix bug with multiple files including of version.texi. 2001-04-24 22:15:10 +00:00