4 files changed, 31 insertions, 19 deletions
diff --git a/doc/user/src/start1.skb b/doc/user/src/start1.skb
index 4e37dda..e18bc6c 100644
--- a/doc/user/src/start1.skb
+++ b/doc/user/src/start1.skb
@@ -1,2 +1,4 @@
-(document :title [Hello World!] [
-This is a very simple text.])
+(document :title [Hello World!]
+   :html-title [Hello World Example]
+   
+   [This is a very simple text.])
diff --git a/doc/user/src/start2.skb b/doc/user/src/start2.skb
index 9fcfdbf..1f22892 100644
--- a/doc/user/src/start2.skb
+++ b/doc/user/src/start2.skb
@@ -1,2 +1,5 @@
-(document :title [Hello World!] [
-This is a ,(bold [very]) ,(it [simple]) ,(color :fg [red] [text]).])
+(document :title [Hello World!]
+   :html-title [Hello World Example]
+   
+   [This is a ,(bold [very]) ,(it [simple])
+,(color :fg [red] [text]).])
diff --git a/doc/user/src/start3.skb b/doc/user/src/start3.skb
index 65fa738..5f9bf4b 100644
--- a/doc/user/src/start3.skb
+++ b/doc/user/src/start3.skb
@@ -1,10 +1,15 @@
 (document :title [Hello World!] 
 
-(chapter :title [A first Section] [
- This is a ,(bold [very]) ,(it [simple]) ,(color :fg [red] [text]).])
+   (chapter :title [A first Section]
+   
+      [This is a ,(bold [very]) ,(it [simple])
+,(color :fg [red] [text]).])
+
+   (chapter :title [A second Section]
+   
+      [That section contains an ,(bold [itemize])
+construction:
 
-(chapter :title [A second Section] [
- That section contains an ,(bold itemize) construction:
  ,(itemize (item [first item])
            (item [second item])
            (item [third item]))]))
diff --git a/doc/user/src/start4.skb b/doc/user/src/start4.skb
index 31fba0c..0d792a2 100644
--- a/doc/user/src/start4.skb
+++ b/doc/user/src/start4.skb
@@ -1,13 +1,15 @@
-(document :title [Various links]
+(document :title [Various Links]
 
-  (chapter :title "A Section" [
-The first link points to an external web page. Here we point to a
-,(ref :url [http://slashdot.org/] [Slashdot])
-web page. The second one points to the second
-,(ref :section [A second Section] [Section])
-of that document.])
+  (chapter :title [A Section]
+     
+     [The first link points to an external web page.
+Here we point to a ,(ref :url "http://slashdot.org/"
+:text [Slashdot]) web page.  The second one points to
+the second ,(ref :chapter "A Second Section" :text
+[section]) of that document.])
 
-  (chapter :title [A second Section] [
-The last links points to the first
-,(ref :scribe [user.scr] :figure [A simple web page] [Figure])
-of the Scribe User Manual.]))
+  (chapter :title "A Second Section"
+     
+     [The last link points to the first
+,(ref :skribe "user.sui" :chapter "Introduction"
+:text [chapter]) of the Skribilo User Manual.]))