summaryrefslogtreecommitdiff
path: root/doc/ref
AgeCommit message (Collapse)AuthorFilesLines
2018-08-07Add -Wshadowed-toplevel.Ludovic Courtès1-1/+3
* module/language/tree-il/analyze.scm (shadowed-toplevel-analysis): New variable. * module/language/tree-il/compile-cps.scm (%warning-passes): Add it. * module/system/base/message.scm (%warning-types): Add it. * test-suite/tests/tree-il.test ("warnings")["shadowed-toplevel"]: New test prefix. * module/ice-9/boot-9.scm (%auto-compilation-options): Add it. * doc/ref/api-evaluation.texi (Compilation): Add 'shadowed-toplevel' and 'macro-use-before-definition'.
2018-08-07compile: Add '-x' flag.Ludovic Courtès1-0/+6
* module/scripts/compile.scm (%options, compile): Add '-x'. * doc/ref/api-evaluation.texi (Compilation): Document it.
2018-08-07Update copyright years in '--version' and the manual.Ludovic Courtès1-1/+2
* module/ice-9/command-line.scm (version-etc): Change #:copyright-year to 2018. * doc/ref/guile.texi: Add 2017 and 2018 to the copyright years. * configure.ac (GUILE_CONFIGURE_COPYRIGHT): Add 2018.
2018-08-07web: Export http-request.Arun Isaac1-14/+27
* module/web/client.scm (request): Rename to http-request, add a docstring, and export it. (http-get, http-head, http-post, http-put, http-delete, http-trace, http-options): Update docstring. * doc/ref/web.texi (Web Client): Document http-request. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-08-07doc: Document (ice-9 match) macros.Arun Isaac1-2/+90
* doc/ref/match.texi: Document match-lambda, match-lambda*, match-let, match-let* and match-letrec. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-08-07doc: Fix typo.Ludovic Courtès1-2/+2
Fixes <https://bugs.gnu.org/30941>. Reported by Fis Trivial <ybbs.daans@hotmail.com>. * doc/ref/libguile-foreign-objects.texi (Defining Foreign Object Types): Remove extraneous 'image_type' in example.
2018-08-07Add SRFI 71: Extended LET-syntax for multiple values.Christopher Allan Webber1-1/+21
* module/srfi/srfi-71.scm: New file. * module/srfi/Makefile.am: Add it. * doc/ref/srfi-modules.texi: Document it. * NEWS: Update. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-08-07Fix minor typo in the PEG documentation.Arun Isaac1-1/+1
* doc/ref/api-peg.texi (PEG Internals): Fix minor typo. Signed-off-by: Mark H Weaver <mhw@netris.org>
2018-08-07Fix a few typos in the manual.Mark H Weaver2-4/+4
Fixes <https://bugs.gnu.org/30276>. Reported by Matt Wette <matt.wette@gmail.com>. * doc/ref/api-macros.texi (Macro Expansion) doc/ref/vm.texi (Procedure Call and Return Instructions): Fix typos.
2018-08-07doc: Fix typo about SRFI-4 syntax.Ludovic Courtès1-1/+1
Reported by Matt Wette <matt.wette@gmail.com>. Fixes <https://bugs.gnu.org/29910>. * doc/ref/api-data.texi (Array Syntax): Fix typo.
2018-08-07doc: Update LALR URL.Ludovic Courtès1-2/+2
Reported by Chris Vine <vine35792468@gmail.com>. * doc/ref/api-lalr.texi (LALR(1) Parsing): Update URL.
2018-07-24Add -Wshadowed-toplevel.Ludovic Courtès1-1/+3
* module/language/tree-il/analyze.scm (shadowed-toplevel-analysis): New variable. * module/language/tree-il/compile-cps.scm (%warning-passes): Add it. * module/system/base/message.scm (%warning-types): Add it. * test-suite/tests/tree-il.test ("warnings")["shadowed-toplevel"]: New test prefix. * module/ice-9/boot-9.scm (%auto-compilation-options): Add it. * doc/ref/api-evaluation.texi (Compilation): Add 'shadowed-toplevel' and 'macro-use-before-definition'.
2018-07-19compile: Add '-x' flag.Ludovic Courtès1-0/+6
* module/scripts/compile.scm (%options, compile): Add '-x'. * doc/ref/api-evaluation.texi (Compilation): Document it.
2018-07-01Update copyright years in '--version' and the manual.Ludovic Courtès1-1/+2
* module/ice-9/command-line.scm (version-etc): Change #:copyright-year to 2018. * doc/ref/guile.texi: Add 2017 and 2018 to the copyright years. * configure.ac (GUILE_CONFIGURE_COPYRIGHT): Add 2018.
2018-06-23web: Export http-request.Arun Isaac1-14/+27
* module/web/client.scm (request): Rename to http-request, add a docstring, and export it. (http-get, http-head, http-post, http-put, http-delete, http-trace, http-options): Update docstring. * doc/ref/web.texi (Web Client): Document http-request. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-06-18doc: Document (ice-9 match) macros.Arun Isaac1-2/+90
* doc/ref/match.texi: Document match-lambda, match-lambda*, match-let, match-let* and match-letrec. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-06-18doc: Fix typo.Ludovic Courtès1-2/+2
Fixes <https://bugs.gnu.org/30941>. Reported by Fis Trivial <ybbs.daans@hotmail.com>. * doc/ref/libguile-foreign-objects.texi (Defining Foreign Object Types): Remove extraneous 'image_type' in example.
2018-06-18Add SRFI 71: Extended LET-syntax for multiple values.Christopher Allan Webber1-1/+21
* module/srfi/srfi-71.scm: New file. * module/srfi/Makefile.am: Add it. * doc/ref/srfi-modules.texi: Document it. * NEWS: Update. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-03-16Fix minor typo in the PEG documentation.Arun Isaac1-1/+1
* doc/ref/api-peg.texi (PEG Internals): Fix minor typo. Signed-off-by: Mark H Weaver <mhw@netris.org>
2018-03-16Fix a few typos in the manual.Mark H Weaver2-4/+4
Fixes <https://bugs.gnu.org/30276>. Reported by Matt Wette <matt.wette@gmail.com>. * doc/ref/api-macros.texi (Macro Expansion) doc/ref/vm.texi (Procedure Call and Return Instructions): Fix typos.
2018-02-16doc: Fix typo about SRFI-4 syntax.Ludovic Courtès1-1/+1
Reported by Matt Wette <matt.wette@gmail.com>. Fixes <https://bugs.gnu.org/29910>. * doc/ref/api-data.texi (Array Syntax): Fix typo.
2017-12-14doc: Update LALR URL.Ludovic Courtès1-2/+2
Reported by Chris Vine <vine35792468@gmail.com>. * doc/ref/api-lalr.texi (LALR(1) Parsing): Update URL.
2017-11-29Merge until 8e2314c46dc3aa98574d380a2c7cb782da643913 from stable-2.2Andy Wingo3-8/+10
2017-11-29Merge until e0bcda4ad940c4e15679cc2b229838b33acdd36c from stable-2.2Andy Wingo1-39/+18
2017-11-22foreign: Add 'uintptr_t' and 'intptr_t'.Matt Wette1-0/+2
* libguile/foreign.c (scm_uintptr_t, scm_intptr_t): New variables. (scm_init_foreign): Define them. * module/system/foreign.scm: Export 'intptr_t' and 'uintptr_t'. * doc/ref/api-foreign.texi (Foreign Types): Document them. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2017-11-22Mention (ice-9 peg) module path.Arun Isaac1-5/+6
* doc/ref/api-peg.texi (PEG Parsing): Mention (ice-9 peg) module path. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2017-11-22Convert `close' ref to xref.Arun Isaac1-3/+2
* doc/ref/api-io.texi (Ports): Convert `close' ref to xref. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2017-10-31Fix sort, sort! for arrays with nonzero lower boundDaniel Llorens1-10/+22
* module/ice-9/arrays.scm (array-copy): New function, export. * module/Makefile.am: Install (ice-9 arrays). * doc/ref/api-data.texi: Add documentation for (ice-9 arrays). * libguile/quicksort.i.c: Use signed bounds throughout. * libguile/sort.c (scm_restricted_vector_sort_x): Fix error calls. Fix calls to quicksort. * test-suite/tests/sort.test: Actually test that the sorted results match the original data. Test cases for non-zero base index arrays for sort, sort!, and stable-sort!.
2017-10-31Remove documentation on uniform-vector-read!, uniform-vector-writeDaniel Llorens1-33/+0
* NEWS: Add specific removal notice. * doc/ref/api-data.texi: Remove documentation on uniform-vector-read!, uniform-vector-write.
2017-09-25Merge 'stable-2.2'Andy Wingo1-6/+19
Resolve conflicts by removing capability of struct-ref / struct-set! to access unboxed slots.
2017-09-25Add struct-ref/unboxed, struct-set!/unboxedAndy Wingo1-6/+19
* NEWS: Add news entry. * doc/ref/api-data.texi (Vtables, Structure Basics): Update documentation. * libguile/struct.c (scm_i_struct_equalp): Avoid using struct-ref on unboxed fields. (scm_struct_ref, scm_struct_set_x_unboxed): Issue deprecation warning when accessing unboxed fields. (scm_struct_ref_unboxed, scm_struct_set_x_unboxed): New functions. * libguile/struct.h (scm_struct_ref_unboxed, scm_struct_set_x_unboxed): New functions. * module/oop/goops.scm (class-add-flags!, class-clear-flags!): (class-has-flags?, <class>, %allocate-instance, <slot>): (compute-get-n-set, unboxed-get, unboxed-set, unboxed-slot?): (allocate-slots, %prep-layout!, make-standard-class, initialize): Adapt to access unboxed nfields and flags fields via the new accessors.
2017-09-23Replace "pr" struct fields with "pw" fieldsAndy Wingo1-19/+21
* libguile/struct.h (SCM_VTABLE_BASE_LAYOUT): Layout is a "pr" field. * module/ice-9/boot-9.scm (record-type-vtable): Record vtable fields are writable. (<parameter>): "pw" fields. * module/oop/goops.scm (<class>, %compute-layout): <read-only> fields are "pw" underneath. * module/rnrs/records/procedural.scm (record-type-vtable) (record-constructor-vtable, make-record-type-descriptor): Use "pw" fields in vtables. * module/srfi/srfi-35.scm (%condition-type-vtable) (struct-layout-for-condition): "pw" fields in vtables. * test-suite/tests/goops.test: * test-suite/tests/structs.test: Use "pw" fields only. * benchmark-suite/benchmarks/structs.bm: Update for make-struct/no-tail, to use pw fields, and also to remove useless tests that the compiler would optimize away. * doc/ref/api-data.texi (Vtables): Add a note about the now-vestigial permissions character and update documentation. (Structure Basics, Meta-Vtables): Update examples. * libguile/hash.c (scm_i_struct_hash): Remove code that would handle opaque/self fields. * libguile/print.h (SCM_PRINT_STATE_LAYOUT): Use "pw" fields. * libguile/struct.c (scm_struct_init): Simplify check for hidden fields. * libguile/values.c (scm_init_values): Field is "pw".
2017-09-23Merge 'stable-2.2'Andy Wingo1-11/+2
2017-09-23Deprecate opaque struct fieldsAndy Wingo1-11/+2
* NEWS: Add entry. * doc/ref/api-data.texi (Vtables, Structure Basics): Remove mention of opaque field protection. * libguile/struct.c (scm_make_struct_layout, scm_make_struct_no_tail): Remove discussion of opaque fields. (set_vtable_layout_flags): Issue a deprecation warning when opaque fields are used.
2017-09-22Merge stable-2.2 into masterAndy Wingo2-76/+19
This commit resolves conflicts by removing the deprecated make-struct.
2017-09-22Deprecate struct "self" slotsAndy Wingo1-12/+4
* libguile/print.h (SCM_PRINT_STATE_LAYOUT): Use a normal slot instead of a self slot. * libguile/print.c (make_print_state): Initialize "handle" slot manually. * libguile/struct.c (issue_deprecation_warning_for_self_slots): New helper, called when making vtables to issue deprecation warnings for "self" slots. Avoids warning for the "self" slot that's part of the fixed vtable slots. (scm_i_struct_inherit_vtable_magic): Call issue_deprecation_warning_for_self_slots. * doc/ref/api-data.texi (Vtables, Structure Basics): Remove references to self slots. * NEWS: Add entry.
2017-09-20Remove references to tail arrays in the documentationAndy Wingo1-69/+18
* doc/ref/api-data.texi (Vtables, Structure Basics): Update to remove references to tail arrays, in preparation for deprecation.
2017-09-14Document class redefinition changeAndy Wingo1-21/+70
* doc/ref/goops.texi (Redefinable Classes): New subsection. (Default Class Redefinition Behaviour) (Changing the Class of an Instance): Update for class redefinition change. * NEWS: Add 2.3.0 section.
2017-06-11doc: Document 'short' and 'unsigned-short' foreign types.Mark H Weaver1-0/+2
This is a followup to commit 42f7c01e0a1d1c139ec8b835429a80ab15ac4007. Reported by Adriano Peluso <catonano@gmail.com>. * doc/ref/api-foreign.texi (Foreign Types): Add missing entries for 'short' and 'unsigned-short'.
2017-05-22Update uri? documentation.Andy Wingo1-7/+3
* doc/ref/web.texi (URIs): Update uri? documentation for deprecation removal.
2017-05-22Remove support for legacy syntax objects.Andy Wingo1-38/+0
* module/ice-9/psyntax.scm: Remove support for legacy syntax objects. * module/ice-9/psyntax-pp.scm: Regenerate. * module/ice-9/deprecated.scm (allow-legacy-syntax-objects?): New deprecation. * module/ice-9/boot-9.scm: Don't define allow-legacy-syntax-objects?. * doc/ref/api-macros.texi: Remove documentation for allow-legacy-syntax-objects?.
2017-05-22Update effective version to 3.0Andy Wingo6-19/+18
* GUILE-VERSION: Bump version to 2.3.0, and effective version to 3.0. * .gitignore: * README: * doc/guile.1: * doc/ref/api-evaluation.texi: * doc/ref/api-options.texi: * doc/ref/guile-invoke.texi: * doc/ref/libguile-foreign-objects.texi: * doc/ref/libguile-parallel.texi: * doc/ref/srfi-modules.texi: Update to 3.0. * libguile/_scm.h (SCM_OBJCODE_MAJOR_VERSION): (SCM_OBJCODE_MINIMUM_MINOR_VERSION, SCM_OBJCODE_MINOR_VERSION): Bump bytecode version for fallback path. * libguile/loader.c: Update to avoid loading version 2.2 bytecode files. * meta/guile-3.0-uninstalled.pc.in: * meta/guile-3.0.pc.in: Rename. * module/system/vm/assembler.scm (*bytecode-major-version*): (*bytecode-minor-version*): Write the new bytecode version.
2017-05-21web: add support for URI-referenceAndy Wingo1-48/+86
Based on a patch by Daniel Hartwig <mandyke@gmail.com>. * NEWS: Update. * doc/ref/web.texi (URIs): Fragments are properly part of a URI, so remove the incorrect note. Add documentation on URI subtypes. * module/web/uri.scm (uri-reference?): New base type predicate. (uri?, relative-ref?): Specific predicates. (validate-uri-reference): Strict validation. (validate-uri, validate-relative-ref): Specific validators. (build-uri-reference, build-relative-ref): New constructors. (string->uri-reference): Rename from string->uri. (string->uri, string->relative-ref): Specific constructors. (uri->string): Add #:include-fragment? keyword argument. * module/web/http.scm (parse-request-uri): Use `build-uri-reference', and result is a URI-reference, not URI, object. No longer infer an absent `uri-scheme' is `http'. (write-uri): Just use `uri->string'. (declare-uri-header!): Remove unused function. (declare-uri-reference-header!): Update. Rename from `declare-relative-uri-header!'. * test-suite/tests/web-uri.test ("build-uri-reference"): ("string->uri-reference"): Add. ("uri->string"): Also tests for relative-refs. * test-suite/tests/web-http.test ("read-request-line"): ("write-request-line"): Update for no scheme in some URIs. ("entity headers", "request headers"): Content-location, Referer, and Location should also parse relative-URIs. * test-suite/tests/web-request.test ("example-1"): Expect URI-reference with no scheme.
2017-05-17readline: Avoid interpreting control characters in pastes.Andy Wingo1-0/+2
* NEWS: Update. * doc/ref/repl-modules.texi (Readline Options): Update for bracketed-paste. * guile-readline/readline.h (SCM_READLINE_BRACKETED_PASTE): Add bracketed-paste option. * guile-readline/readline.c (scm_readline_opts): Add bracketed-paste. (scm_init_readline): Wire up the logic.
2017-04-25Correct note about Gregorian reform in SRFI-19Zefram1-11/+10
* doc/ref/srfi-modules.texi (SRFI-19): SRFI-19 specifies proleptic use of the Gregorian calendar, so it was incorrect of the documentation to describe the code as erroneous in doing so. Rewrite the caution more neutrally, and move it to the section about the "date" structure, where it seems most relevant.
2017-04-19api-procedures.texi: typo: 'an' -> 'on'Sergei Trofimovich1-1/+1
* doc/ref/api-procedures.texi: Fix typo. Signed-off-by: Sergei Trofimovich <slyfox@gentoo.org>
2017-04-19Documentation typo tweakSergei Trofimovich1-1/+1
* doc/ref/api-data.texi: Tweak 'u+0007' to 'U+0007' (as in the rest of the table). Signed-off-by: Sergei Trofimovich <slyfox@gentoo.org>
2017-04-19Document guile-2.2 cond-expand feature.Andy Wingo1-1/+2
* doc/ref/srfi-modules.texi (SRFI-0): Mention guile-2.2 feature.
2017-04-19Fix typo in fold-layout documentationAndy Wingo1-2/+2
* doc/ref/sxml.texi (SXML Tree Fold): Fix minor typo. Fixes https://bugs.gnu.org/26188.
2017-04-18Add sandboxed evaluation facilityAndy Wingo1-0/+265
* module/ice-9/sandbox.scm: New file. * module/Makefile.am (SOURCES): Add new file. * doc/ref/api-evaluation.texi (Sandboxed Evaluation): New section. * NEWS: Update. * test-suite/tests/sandbox.test: New file. * test-suite/Makefile.am: Add new file.