summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/user/htmle.skb3
-rw-r--r--doc/user/links.skb23
2 files changed, 16 insertions, 10 deletions
diff --git a/doc/user/htmle.skb b/doc/user/htmle.skb
index 47a5f97..5132999 100644
--- a/doc/user/htmle.skb
+++ b/doc/user/htmle.skb
@@ -48,7 +48,8 @@ used in replacement of the ,(code "css") custom in order to produce
stand alone HTML documents.])
(js ,[A URL or a list of URLs of JavaScript programs used by
the document.])
- (emit-sui [Emit a SUI file for this document.])
+ (emit-sui ,[Emit a SUI file for this document (see ,(numref
+:text [Section] :ident "sui") for details).])
(background "The background color of the document.")
(foreground "The foreground color of the document.")
;; the margins
diff --git a/doc/user/links.skb b/doc/user/links.skb
index 812bd32..53b11a9 100644
--- a/doc/user/links.skb
+++ b/doc/user/links.skb
@@ -163,10 +163,11 @@ introduces mail annotation in a Skribe document.])
(section :title "Skribe URL Index"
:ident "sui"
-(p [A ,(emph "Skribe URL Index") (henceforth ,(sc "Sui")) describes the
-marks that are available in a Skribe document. It is to be used to
-make Skribe marks available to other Skribe documents. The syntax
-of a ,(sc "Sui") file is:])
+(p [A ,(emph "Skribe URL Index") (henceforth SUI) describes the marks
+that are available in a Skribe or Skribilo document. It is to be used
+to make marks available to other Skribe/Skribilo documents through the
+,(param :skribe) option of the ,(markup-ref "ref") markup. The syntax
+of a SUI file is:])
(disp :verb #t :bg *prgm-skribe-color* [
<sui> --> (skribe-url-index <title>
@@ -178,12 +179,16 @@ of a ,(sc "Sui") file is:])
(subsubsection <sui-ref>*))
<sui-ref> --> (<string> :file <file-name> :mark <string>)])
-(p [,(sc "Sui") files can be automatically produced by the Skribe compiler.
-For instance, in order to produce the ,(sc "Sui") file of this user
-manual, one should write:])
+(p [SUI files can be automatically produced by the Skribilo compiler.
+For instance, in order to produce the SUI file of this user
+manual, one should set the ,(ref :mark "html-engine" :text [,(tt
+[emit-sui]) HTML custom]) to ,(tt [#t]); a ,(tt [user.sui]) file will
+then be produced when the manual is compiled to HTML:]
-(disp :verb #t [
-$ skribilo user.skb -o user.sui])))
+(disp :verb #t
+ [skribilo -t html -o user.html user.skb])
+
+)))
;;; LocalWords: Hyperlinks HTML URL url