From b34e25359aad4a08e15de8c5a150ebcff55ff7c1 Mon Sep 17 00:00:00 2001 From: Mark H Weaver Date: Sun, 27 Jan 2013 10:10:21 -0500 Subject: Add 'for-humans?' flag to specifications. * module/system/base/language.scm (): Add 'for-humans?' field, and export new 'language-for-humans?' predicate. * doc/ref/compiler.texi (Compiler Tower): Document. * module/language/assembly/spec.scm, module/language/bytecode/spec.scm, module/language/glil/spec.scm, module/language/objcode/spec.scm, module/language/tree-il/spec.scm, module/language/value/spec.scm: Mark these languages as 'for-humans?'. --- doc/ref/compiler.texi | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc/ref') diff --git a/doc/ref/compiler.texi b/doc/ref/compiler.texi index a88942d02..0fe75e3e3 100644 --- a/doc/ref/compiler.texi +++ b/doc/ref/compiler.texi @@ -55,7 +55,8 @@ They are registered with the @code{define-language} form. @deffn {Scheme Syntax} define-language @ name title reader printer @ [parser=#f] [compilers='()] [decompilers='()] [evaluator=#f] @ -[joiner=#f] [make-default-environment=make-fresh-user-module] +[joiner=#f] [for-humans?=#t] @ +[make-default-environment=make-fresh-user-module] Define a language. This syntax defines a @code{#} object, bound to @var{name} -- cgit v1.2.3 From 3e31e75a462fc05f425b887105ccd6607a56ca3b Mon Sep 17 00:00:00 2001 From: Andy Wingo Date: Mon, 28 Jan 2013 10:48:42 +0100 Subject: begin rewriting SXML docs * doc/ref/sxml.texi (SXML): Reorder and begin rewriting. Fix formatting throughout, provide a new introduction, and the beginning of proper SSAX documentation. * doc/ref/sxml-match.texi: * doc/ref/texinfo.texi: * doc/ref/web.texi: Update references to new node names. --- doc/ref/sxml-match.texi | 10 +- doc/ref/sxml.texi | 945 +++++++++++++++++++++++++----------------------- doc/ref/texinfo.texi | 14 +- doc/ref/web.texi | 6 +- 4 files changed, 514 insertions(+), 461 deletions(-) (limited to 'doc/ref') diff --git a/doc/ref/sxml-match.texi b/doc/ref/sxml-match.texi index 7a1a9ac7c..d2795a5f7 100644 --- a/doc/ref/sxml-match.texi +++ b/doc/ref/sxml-match.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Guile Reference Manual. -@c Copyright (C) 2010 Free Software Foundation, Inc. +@c Copyright (C) 2010, 2013 Free Software Foundation, Inc. @c See the file guile.texi for copying conditions. @c @c Based on the documentation at @@ -16,10 +16,10 @@ @cindex pattern matching (SXML) @cindex SXML pattern matching -The @code{(sxml match)} module provides syntactic forms for pattern matching of -SXML trees, in a ``by example'' style reminiscent of the pattern matching of the -@code{syntax-rules} and @code{syntax-case} macro systems. @xref{sxml simple, -the @code{(sxml simple)} module}, for more information on SXML. +The @code{(sxml match)} module provides syntactic forms for pattern +matching of SXML trees, in a ``by example'' style reminiscent of the +pattern matching of the @code{syntax-rules} and @code{syntax-case} macro +systems. @xref{SXML}, for more information on SXML. The following example@footnote{This example is taken from a paper by Krishnamurthi et al. Their paper was the first to show the usefulness of the diff --git a/doc/ref/sxml.texi b/doc/ref/sxml.texi index 3ce6062f4..ab9881567 100644 --- a/doc/ref/sxml.texi +++ b/doc/ref/sxml.texi @@ -6,257 +6,157 @@ @node SXML @section SXML -@menu -* sxml apply-templates:: A more XSLT-like approach to SXML transformations -* sxml fold:: Fold-based SXML transformation operators -* sxml simple:: Convenient XML parsing and serializing -* sxml ssax:: Functional-style XML parsing for Scheme -* sxml ssax input-parse:: The SSAX tokenizer, optimized for Guile -* sxml transform:: A higher-order SXML transformation operator, @code{pre-post-order} -* sxml xpath:: XPath for SXML -@end menu - -@node sxml apply-templates -@subsection (sxml apply-templates) -@subsubsection Overview -Pre-order traversal of a tree and creation of a new tree: - -@smallexample - apply-templates:: tree x -> -@end smallexample - -where - -@smallexample - ::= (