1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
;;; 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 or 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. However, since Info is
a text-only format, markups such as ,(markup-ref "image") do not yield a
graphical output as with other engines.]))
;;; Local Variables:
;;; coding: latin-1
;;; ispell-local-dictionary: "american"
;;; End:
|
