From 2d9a419c5cbff8ace945754cc806143ef3009360 Mon Sep 17 00:00:00 2001 From: dlichteblau Date: Sun, 18 Feb 2007 15:27:30 +0000 Subject: [PATCH] new argument :buffering to make-source --- doc/html.xsl | 4 ++-- doc/klacks.xml | 22 +++++++++++++++++++--- klacks/klacks-impl.lisp | 11 +++++++---- 3 files changed, 28 insertions(+), 9 deletions(-) diff --git a/doc/html.xsl b/doc/html.xsl index 149158e..f20af8b 100644 --- a/doc/html.xsl +++ b/doc/html.xsl @@ -57,8 +57,8 @@
  • Klacks parser
  • diff --git a/doc/klacks.xml b/doc/klacks.xml index 93b8de6..6ca626c 100644 --- a/doc/klacks.xml +++ b/doc/klacks.xml @@ -45,7 +45,8 @@ NIL * (klacks:consume *source*) NIL -

    Klacks sources

    + +

    Parsing incrementally using sources

    To parse using Klacks, create an XML source first.

    @@ -96,8 +97,22 @@ NIL closed otherwise.

    - Keyword arguments have the same meaning as with the SAX parser, - please refer to the documentation of Buffering: By default, the Klacks parser performs buffering + of octets being read from the stream as an optimization. This can + result in unwanted blocking if the stream is a socket and the + parser tries to read more data than required to parse the current + event. Use :buffering nil to disable this optimization. +

    +
      +
    • + buffering -- Boolean, defaults to t. If + enabled, read data several kilobytes at time. If disabled, + read only single bytes at a time. +
      • +
    +

    + The following keyword arguments have the same meaning as + with the SAX parser, please refer to the documentation of parse-file for more information: