From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ian Price Newsgroups: gmane.lisp.guile.devel Subject: SXML documentation Date: Fri, 16 Dec 2011 10:52:57 +0000 Message-ID: <8739cku6t2.fsf@Kagami.home> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1324033065 18423 80.91.229.12 (16 Dec 2011 10:57:45 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 16 Dec 2011 10:57:45 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Dec 16 11:57:38 2011 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RbVTp-00068G-HG for guile-devel@m.gmane.org; Fri, 16 Dec 2011 11:57:33 +0100 Original-Received: from localhost ([::1]:55652 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbVTp-0006GC-6E for guile-devel@m.gmane.org; Fri, 16 Dec 2011 05:57:33 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:57744) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbVTh-0006Ft-Va for guile-devel@gnu.org; Fri, 16 Dec 2011 05:57:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RbVTb-0001Fz-Ua for guile-devel@gnu.org; Fri, 16 Dec 2011 05:57:25 -0500 Original-Received: from lo.gmane.org ([80.91.229.12]:37414) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbVTb-0001Fu-OG for guile-devel@gnu.org; Fri, 16 Dec 2011 05:57:19 -0500 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1RbVTa-00063K-Io for guile-devel@gnu.org; Fri, 16 Dec 2011 11:57:18 +0100 Original-Received: from host31-52-247-217.range31-52.btcentralplus.com ([31.52.247.217]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 16 Dec 2011 11:57:18 +0100 Original-Received: from ianprice90 by host31-52-247-217.range31-52.btcentralplus.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 16 Dec 2011 11:57:18 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 19 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: host31-52-247-217.range31-52.btcentralplus.com User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) Cancel-Lock: sha1:W+av0huSjoqdjHZplZI2vHK2JgQ= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 80.91.229.12 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:13135 Archived-At: Hi guilers, The documentation for this in the manual is pretty sparse. Is it possible to lift the documentation for the procedures in the source up to the manual where people who don't read the source can find it? As an example, the function 'find-string-from-port?' in (sxml ssax input-parse) has the signature find-string-from-port? _ _ . _ which is not particularly meaningful. Or how would I know what the 'ssax:xml->sxml' argument 'namespace-prefix-assig' is if I didn't know already? -- Ian Price "Programming is like pinball. The reward for doing it well is the opportunity to do it again" - from "The Wizardy Compiled"