From 99da401511a7ca18a7edcee3188def912d6cbd24 Mon Sep 17 00:00:00 2001
From: Ludovic Courtès
Date: Wed, 7 Jan 2009 18:10:31 +0100
Subject: 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'.
---
doc/modules/skribilo/documentation/env.scm | 4 +--
doc/user/Makefile.am | 2 +-
doc/user/engine.skb | 3 +-
doc/user/infoe.skb | 47 ++++++++++++++++++++++++++++++
4 files changed, 52 insertions(+), 4 deletions(-)
create mode 100644 doc/user/infoe.skb
(limited to 'doc')
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:
--
cgit v1.2.3