doc: Document the Info engine.

* doc/modules/skribilo/documentation/env.scm (*api-engines*): Add
  `info'.

* doc/user/Makefile.am (EXTRA_DIST): Add `infoe.skb'.

* doc/user/engine.skb: Include `infoe.skb'.

4 files changed, 52 insertions, 4 deletions

diff --git a/doc/modules/skribilo/documentation/env.scm b/doc/modules/skribilo/documentation/env.scm
index 6dc2955..1933005 100644
--- a/doc/modules/skribilo/documentation/env.scm
+++ b/doc/modules/skribilo/documentation/env.scm
@@ -1,6 +1,6 @@
 ;;; env.scm  --  The environment variables for the documentation.
 ;;;
-;;; Copyright 2005, 2006, 2007, 2008  Ludovic Courtès <ludo@gnu.org>
+;;; Copyright 2005, 2006, 2007, 2008, 2009  Ludovic Courtès <ludo@gnu.org>
 ;;; Copyright 2003, 2004  Manuel Serrano
 ;;;
 ;;;
@@ -48,5 +48,5 @@
 (define-public *disp-color* "#ccffcc")
 (define-public *header-color* "#cccccc")
 
-(define-public *api-engines* (map find-engine '(html lout latex context xml)))
+(define-public *api-engines* (map find-engine '(html lout latex context info xml)))
 (define-public *engine-src* "skribilo/engine.scm")
diff --git a/doc/user/Makefile.am b/doc/user/Makefile.am
index d906db3..8039480 100644
--- a/doc/user/Makefile.am
+++ b/doc/user/Makefile.am
@@ -1,7 +1,7 @@
 # Chapters and sections.
 EXTRA_DIST = bib.skb char.skb colframe.skb document.skb emacs.skb	\
   engine.skb enumeration.skb eq.skb examples.skb figure.skb		\
-  font.skb footnote.skb htmle.skb image.skb index.skb			\
+  font.skb footnote.skb htmle.skb image.skb index.skb infoe.skb		\
   justify.skb latexe.skb loute.skb lib.skb line.skb links.skb		\
   markup.skb ornament.skb package.skb pie.skb prgm.skb sectioning.skb	\
   skribilo-config.skb compiler.skb skribeinfo.skb slide.skb spacing.skb	\
diff --git a/doc/user/engine.skb b/doc/user/engine.skb
index 17106f5..882502b 100644
--- a/doc/user/engine.skb
+++ b/doc/user/engine.skb
@@ -1,6 +1,6 @@
 ;;; engine.skb  --  The description of the Skribe engines
 ;;;
-;;; Copyright 2008  Ludovic Courtès <ludo@gnu.org>
+;;; Copyright 2008, 2009  Ludovic Courtès <ludo@gnu.org>
 ;;; Copyright 2003, 2004  Manuel Serrano
 ;;;
 ;;;
@@ -200,6 +200,7 @@ this mechanism is the same as that of ,(emph [readers]) (see ,(numref
    (include "loute.skb")
    (include "latexe.skb")
    (include "contexte.skb")
+   (include "infoe.skb")
    (include "xmle.skb"))
 
 
diff --git a/doc/user/infoe.skb b/doc/user/infoe.skb
new file mode 100644
index 0000000..85fbb0f
--- /dev/null
+++ b/doc/user/infoe.skb
@@ -0,0 +1,47 @@
+;;; info.skb  --  Documentation of the Info engine.
+;;;
+;;; Copyright 2009  Ludovic Courtès <ludo@gnu.org>
+;;;
+;;;
+;;; This program is free software; you can redistribute it and/or modify
+;;; it under the terms of the GNU General Public License as published by
+;;; the Free Software Foundation; either version 2 of the License, or
+;;; (at your option) any later version.
+;;;
+;;; This program is distributed in the hope that it will be useful,
+;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;;; GNU General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU General Public License
+;;; along with this program; if not, write to the Free Software
+;;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
+;;; USA.
+
+(section :title "Info Engine" :file #t
+   (mark "info-engine")
+   (index "Info" :note "Engine")
+
+   (p [The ,(tt [info]) engine produces GNU,(~)Info files for on-line
+browsing with GNU,(~)Emacs of with the stand-alone Info reader of ,(ref
+:text [GNU,(~)Texinfo] :url "http://www.gnu.org/software/texinfo/").])
+   
+   (p [For each ,(markup-ref "chapter"), ,(markup-ref "section"), etc.,
+an Info node is created, whose name is inferred from the ,(param :title)
+option.  However, Info node names have to be unique, which the ,(param
+:title) options are not necessarily.  Thus, the Info engine does two
+things:
+
+,(enumerate
+    (item [It warns you about duplicate Info node titles.])
+    (item [It allows you to choose a different node name to avoid
+conflicts, using the ,(param :info-node) option of ,(markup-ref
+"chapter"), etc.]))
+
+Most markups shown in ,(numref :text [Chapter] :ident "std-markups") are
+meaningfully rendered in Info, including tables.]))
+
+;;; Local Variables:
+;;; coding: latin-1
+;;; ispell-local-dictionary: "american"
+;;; End: