From 9f08ec317436acb62fb0f47c1ea3f1a1460f88e1 Mon Sep 17 00:00:00 2001
From: Ludovic Court`es
Date: Tue, 28 Nov 2006 12:40:13 +0000
Subject: doc: Documented `eq' and the `:div-style' option.

* doc/user/char.skb (Symbols): Added an ident.

* doc/user/eq.skb (Equation Formatting)[Summary]: New section.
  Use `doc-markup' as should have already been the case and document
  `:div-style'.

git-archimport-id: lcourtes@laas.fr--2005-libre/skribilo--devo--1.2--patch-81
---
 doc/user/char.skb |  1 +
 doc/user/eq.skb   | 26 +++++++++++++++++++++++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/doc/user/char.skb b/doc/user/char.skb
index 16c4625..b2f94e2 100644
--- a/doc/user/char.skb
+++ b/doc/user/char.skb
@@ -67,6 +67,7 @@ are replaced with the actual values of the arguments ,(param 'node).])
 
 ;*--- Symbols ---------------------------------------------------------*/
 (subsection :title "Symbols"
+   :ident "symbols"
 
 (p [The function ,(code "symbol") introduces special symbols in the
 produced file. Note that the rendering of symbols is unportable. It depends
diff --git a/doc/user/eq.skb b/doc/user/eq.skb
index a611f88..455832b 100644
--- a/doc/user/eq.skb
+++ b/doc/user/eq.skb
@@ -57,7 +57,7 @@ much like any other kind of markup.  However, the resulting syntax
 is very verbose and hard to read.])
       
       (p [Fortunately, the ,(tt [eq]) package allows for the use of a
-much simple syntax.  ]
+much simpler syntax.  ]
 
 	(example-produce
 	  (example :legend "Example of a simple equation"
@@ -69,10 +69,30 @@ may have already recognized its ,(emph [prefix notation]).  Note that,
 unlike in the previous example, the equation itself if ,(emph [quoted]),
 that is, preceded by the ,(tt [']) sign.  Additionally, when referring
 to a symbol (such as the Greek letter ,(symbol "phi")), you no longer
-need to use the ,(tt [symbol]) markup (,(ref :text [see subsection]
-:subsection "Symbols")).]))
+need to use the ,(tt [symbol]) markup (,(numref :text [see Section]
+:ident "symbols")).]))
    
+   ;; FIXME: Write this.
    (section :title [Rendering])
+   
+   (section :title [Summary]
+      
+      (p [The options available for the top-level ,(code [eq]) markup
+are summarized here:])
+      
+      (doc-markup 'eq
+	          `((:inline? [A boolean indicating whether the equation
+is to appear "inline", i.e., within a paragraph.  If the engine supports
+it, it may adjust various parameters such as in-equation spacing
+accordingly.])
+	            (:renderer [The engine that should be used to render
+the equation.  This allows, for instance, to use the Lout engine to
+render equations in HTML.])
+	            (:div-style [A symbol denoting the default style for
+divisions.  This should be one of ,(code [over]), ,(code [fraction]),
+,(code [div]) and ,(code [slash]).  Per-,(code [eq:/]) ,(code
+[:div-style]) options override this setting.]))
+	          :source "skribilo/package/eq.scm"))
 
    )
 
-- 
cgit v1.2.3