5 files changed, 36 insertions, 23 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.]))
diff --git a/doc/user/start.skb b/doc/user/start.skb
index cea5417..addb51c 100644
--- a/doc/user/start.skb
+++ b/doc/user/start.skb
@@ -1,6 +1,6 @@
 ;;; start.skb  --  Getting started with Skribilo
 ;;;
-;;; Copyright 2007  Ludovic Courtès <ludo@gnu.org>
+;;; Copyright 2007, 2008  Ludovic Courtès <ludo@gnu.org>
 ;;; Copyright 2003, 2004  Manuel Serrano
 ;;;
 ;;;
@@ -47,7 +47,7 @@ The HTML source file for such a page should look like:
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <HTML>
 <HEAD>
-<TITLE>Hello world Example</TITLE>
+<TITLE>Hello World Example</TITLE>
 </HEAD>
 <BODY>
 <H1>Hello World!</H1>
@@ -76,7 +76,7 @@ The HTML source file for such a document should look like:
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <HTML>
 <HEAD>
-<TITLE>Hello world Example</TITLE>
+<TITLE>Hello World Example</TITLE>
 </HEAD>
 <BODY>
 <H1>Hello World!</H1>
@@ -172,7 +172,8 @@ can be used to ease the construction of such documents as illustrated below.
 This text has been generated with the following piece of code
 ,(prgm :language skribe [
 (itemize
- (map (lambda (x) (item \[The square of \,(bold x) is \,(bold (* x x))\]))
+ (map (lambda (x)
+        (item \[The square of \,(bold x) is \,(bold (* x x))\]))
       '(1 2 3 4 5 6 7 8 9)))
 ])]))