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/user/Makefile.am | 2 +- doc/user/engine.skb | 3 ++- doc/user/infoe.skb | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 50 insertions(+), 2 deletions(-) create mode 100644 doc/user/infoe.skb (limited to 'doc/user') 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 +;;; Copyright 2008, 2009 Ludovic Courtès ;;; 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 +;;; +;;; +;;; 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