summaryrefslogtreecommitdiff
path: root/doc/ref/api-control.texi
AgeCommit message (Collapse)AuthorFilesLines
2010-09-11Document scm_wrong_type_arg_msgNeil Jerram1-1/+6
* doc/ref/api-control.texi: New def for scm_wrong_type_arg_msg.
2010-08-16a number of doc fixesAndy Wingo1-3/+3
* doc/ref/api-control.texi (Handling Errors): Update docs for display-error. * libguile/backtrace.h (scm_i_display_error): Change prototype to s/stack/frame/. * libguile/throw.c (handler_message): Change invocation of scm_i_display_error to pass a frame. * doc/ref/api-deprecated.texi (Deprecation): Update wording. * doc/ref/api-evaluation.texi (Local Evaluation): Remove section on local-eval. * doc/ref/api-macros.texi: Fix a couple typos. * doc/ref/api-memory.texi (Objects): Remove terrible section. * doc/ref/api-procedures.texi (Procedure Properties): Remove docs for closure?. (Compiled Procedures): Update wording. * doc/ref/guile.texi (API Reference): Remove reference to "Objects".
2010-04-10Merge branch 'master' into wip-manual-2Neil Jerram1-164/+197
Conflicts: doc/ref/api-procedures.texi doc/ref/misc-modules.texi (Caused by me removing `@page' from a couple of sections that have been modified by others.)
2010-03-16add a section to the manual on promptsAndy Wingo1-6/+112
* doc/ref/api-control.texi (Prompts): Add a section on prompts.
2010-03-14update "data representation" part of guile internals docAndy Wingo1-0/+36
* doc/ref/api-control.texi (Handling Errors): Move the "Signalling Type Errors" section here. * doc/ref/data-rep.texi (Data Representation): Refactor, lopping and cropping and stitching. * doc/ref/libguile-concepts.texi (Dynamic Types): * doc/ref/libguile-smobs.texi (Describing a New Type, Double Smobs): * doc/ref/guile.texi (Guile Implementation, Programming in C): Adapt to refactorings. * doc/ref/history.texi (A Scheme of Many Maintainers): (A Timeline of Selected Guile Releases, Status): Update.
2010-02-26deprecate lazy-catchAndy Wingo1-149/+49
* libguile/deprecated.h: * libguile/deprecated.c (scm_internal_lazy_catch, scm_lazy_catch): Deprecate, and print out a nasty warning that people should change to with-throw-handler. * libguile/throw.h: * libguile/throw.c (scm_c_with_throw_handler): Deprecate the use of the lazy_catch_p argument, printing out a nasty warning if someone actually passes 1 as that argument. The combination of the pre-unwind and post-unwind handlers should be sufficient. * test-suite/tests/exceptions.test: Remove lazy-catch tests, as they are deprecated. Two of them fail: * throw/catch: effect of lazy-catch unwinding on throw to another key * throw/catch: repeat of previous test but with lazy-catch Hopefully people are not depending on this behavior, and the warning is sufficiently nasty for people to switch. We will see. * test-suite/tests/eval.test ("promises"): Use with-throw-handler instead of lazy-catch. * doc/ref/api-debug.texi: * doc/ref/api-control.texi: Update to remove references to lazy-catch, folding in the useful bits to with-throw-handler.
2010-02-08make scm_make_continuation internalAndy Wingo1-9/+0
* libguile/continuations.h: * libguile/continuations.c (scm_i_make_continuation): Change from scm_make_continuation, and make internal. * libguile/vm-i-system.c (call/cc, tail-call/cc): Adapt callers. * test-suite/standalone/test-unwind.c (check_cont_body): Adapt a test. * doc/ref/api-control.texi (Continuations): Update docs.
2009-12-19Remove page breaks except before new chapters and indicesNeil Jerram1-1/+0
* doc/ref/api-binding.texi, doc/ref/api-compound.texi, doc/ref/api-control.texi, doc/ref/api-data.texi, doc/ref/api-debug.texi, doc/ref/api-evaluation.texi, doc/ref/api-i18n.texi, doc/ref/api-io.texi, doc/ref/api-memory.texi, doc/ref/api-modules.texi, doc/ref/api-options.texi, doc/ref/api-overview.texi, doc/ref/api-procedures.texi, doc/ref/api-scheduling.texi, doc/ref/api-smobs.texi, doc/ref/api-translation.texi, doc/ref/api-utility.texi, doc/ref/expect.texi, doc/ref/libguile-concepts.texi, doc/ref/libguile-program.texi, doc/ref/misc-modules.texi, doc/ref/repl-modules.texi, doc/ref/scheme-debugging.texi, doc/ref/scheme-reading.texi, doc/ref/scheme-scripts.texi, doc/ref/script-getopt.texi, doc/ref/scsh.texi, doc/ref/srfi-modules.texi: Remove @page before @section.
2009-12-18more typo fixesBrian Gough1-1/+1
More spelling corrections and fixes for doubled words (e.g. "the the") -- Brian Gough Network Theory Ltd, Publishing Free Software Manuals --- http://www.network-theory.co.uk/ >From 7be02beedc739c32cce2c8ec8f4ac814c994a13f Mon Sep 17 00:00:00 2001 From: Brian Gough <bjg@gnu.org> Date: Mon, 14 Dec 2009 22:06:22 +0000 Subject: [PATCH] fix various documentation typos (spelling & doubled words)
2009-10-07Revert "Change dynwind flag enums to #defines, for greater portability"Neil Jerram1-22/+33
This reverts commit b25aa0b9373d2798469e0fe999cd915e8beedc4f.
2009-10-02Change dynwind flag enums to #defines, for greater portabilityNeil Jerram1-33/+22
Thanks to Inge Gutheil for raising this problem. * doc/ref/api-control.texi (Dynamic Wind): Remove doc for scm_t_dynwind_flags, and change uses of scm_t_dynwind_flags to int. Mention possible flags inside doc for scm_dynwind_begin instead. Similarly for scm_t_wind_flags. In this case the doc on possible flags is moved to after the four functions that can use them. * libguile/dynwind.c (scm_dynwind_begin): Change scm_t_dynwind_flags to int. (scm_dynwind_unwind_handler): Change scm_t_wind_flags to int. (scm_dynwind_rewind_handler): Ditto. (scm_dynwind_unwind_handler_with_scm): Ditto. (scm_dynwind_rewind_handler_with_scm): Ditto. * libguile/dynwind.h (SCM_F_DYNWIND_REWINDABLE): Use #define instead of typedef enum. (SCM_F_WIND_EXPLICITLY): Ditto. (function declarations): Change scm_t_dynwind_flags and scm_t_wind_flags to int. * test-suite/standalone/test-unwind.c (check_cont_body): Change scm_t_dynwind_flags to int.
2009-09-06update news; ready for 1.9.3Andy Wingo1-3/+3
* doc/ref/api-control.texi: * doc/ref/goops.texi: Fix some typos. * NEWS: Update.
2009-08-03Move `Continuation Barriers' to the section that covers continuationsNeil Jerram1-0/+28
Since continuation barriers protect against non-local exits, it makes better sense to document them in the same section as continuations and exceptions.
2007-06-07Changes from arch/CVS synchronizationLudovic Courtès1-1/+1
2007-01-15merge from 1.8Kevin Ryde1-1/+1
2006-10-09merge from 1.8 branchKevin Ryde1-19/+20
2006-09-15Doc typo fixesNeil Jerram1-0/+7
2006-06-17merge from 1.8 branchKevin Ryde1-8/+22
2006-02-04(Throw Handlers): New node.Neil Jerram1-88/+219
(Throw): Moved to after the Lazy Catch node. (Catch): Enhance to cover the optional pre-unwind handler, and new APIs scm_c_catch, scm_catch_with_pre_unwind_handler. (Lazy Catch): Describe relationship to with-throw-handler. Document that the handler may return, and what happens if it does. (Throw): Mention that a throw can be handled by a throw handler as well as by a catch.
2006-01-29Renamed the "frames" that are related to dynamic-wind to "dynamicMarius Vollmer1-108/+108
contexts. Renamed all functions from scm_frame_ to scm_dynwind_. Updated documentation.
2005-12-06* api-control.texi (if cond case): Describe SRFI 61 cond.Marius Vollmer1-0/+20
* srfi-modules.texi (SRFI-61): New section. (SRFI Support): Add SRFI-61 to menu.
2005-08-06(Error Reporting): In strerror, note message is inKevin Ryde1-2/+6
locale language and charset.
2005-06-23(Lazy Catch): Cross ref for with-fluids.Kevin Ryde1-1/+2
2005-03-02Updates for the new thread stuff.Marius Vollmer1-4/+3
2004-09-23Updated docstrings from libguile/Marius Vollmer1-1/+3
2004-08-10Updated example to use scm_to_locale_stringMarius Vollmer1-20/+10
instead of roll-your-own scm_to_string. Also showcase scm_frame_free.
2004-08-02* scheme-binding.texi: Renamed to api-binding.texi.Marius Vollmer1-0/+1337
* scheme-compound.texi: Renamed to api-compound.texi. * scheme-control.texi: Renamed to api-control.texi. * scheme-data.texi: Renamed to api-data.texi. * scheme-debug.texi: Renamed to api-debug.texi. * deprecated.texi: Renamed to api-deprecated.texi. * scheme-evaluation.texi: Renamed to api-evaluation.texi. * ref-init.texi: Renamed to api-init.texi. * scheme-io.texi: Renamed to api-io.texi. * scheme-memory.texi: Renamed to api-memory.texi. * scheme-modules.texi: Renamed to api-modules.texi. * scheme-options.texi: Renamed to api-options.texi. * scm.texi: Renamed to api-overview.texi. * scheme-procedures.texi: Renamed to api-procedures.texi. * scheme-scheduling.texi: Renamed to api-scheduling.texi. * scheme-scm.texi: Renamed to api-scm.texi. * scheme-smobs.texi: Renamed to api-smobs.texi. * scheme-snarf.texi: Renamed to api-snarf.texi. * scheme-translation.texi: Renamed to api-translation.texi. * scheme-utility.texi: Renamed to api-utility.texi. * debugging.texi: Renamed to scheme-debugging.texi. * scripts.texi: Renamed to scheme-scripts.texi. * program.texi: Renamed to libguile-program.texi.