1.1 --- a/README.BUILD	Wed Oct 21 14:26:58 2009 +0800
     1.2 +++ b/README.BUILD	Wed Oct 21 15:43:16 2009 +0800
     1.3 @@ -16,17 +16,13 @@
     1.4  
     1.5  I. PRIMER
     1.6  
     1.7 -  DocBook has a tortured, confusing history.  Before you do anything,
     1.8 -  take a look at Eric Raymond's excellent "DocBook Demystification HOWTO":
     1.9 +  DocBook has a tortured, confusing history. Before you do anything,
    1.10 +  take a look at:
    1.11  
    1.12 -      http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/
    1.13 -
    1.14 -  It's very short and clears up many things.
    1.15 -
    1.16 +      http://wiki.docbook.org/topic/DocBookTutorials
    1.17  
    1.18  II. COMPILING THE DOCS
    1.19  
    1.20 -
    1.21  1. Install XML DTD and XSL stylesheets for DocBook
    1.22  
    1.23        % sudo apt-get install docbook-xml docbook-xsl
    1.24 @@ -47,7 +43,7 @@
    1.25    some trick, let fop's CLASSPATH include saxon.jar and docbook-xsl-saxon.jar .
    1.26  
    1.27  5. Configure XML Catalogs
    1.28 -  For non pdf output, we use xsltproc for XSLT process, which use system
    1.29 +  For non pdf output, we use xsltproc for XSLT process, xsltproc use system
    1.30    catalog files automatically, usually /etc/xml/catalog. Users do not need to
    1.31    care about it.
    1.32  
    1.33 @@ -82,24 +78,22 @@
    1.34  
    1.35  In addition to everything in section II:
    1.36  
    1.37 -
    1.38 -1. Get a nice editing environment for SGML/XML.
    1.39 +1. Get a nice editing environment for XML
    1.40  
    1.41    This isn't strictly required, but it's nice when your editor
    1.42    colorizes things, understands the DTD, tells you what tags you can
    1.43    insert, etc.
    1.44  
    1.45 -  If you use emacs, we recommend the PSGML major-mode.  Most free
    1.46 +  If you use emacs, we recommend the nxml-mode. Most free
    1.47    operating systems package it, or its home page is here:
    1.48  
    1.49 -      http://www.lysator.liu.se/projects/about_psgml.html
    1.50 +      http://www.emacswiki.org/emacs/NxmlMode
    1.51  
    1.52    If you use vim, you might check out xmledit, at:
    1.53  
    1.54        http://www.vim.org/scripts/script.php?script_id=301
    1.55  
    1.56 -
    1.57 -2. Get a validating parser.
    1.58 +2. Get a validating parser
    1.59  
    1.60    Actually, if you have what you need to compile the documentation,
    1.61    then you almost certainly have an XML validator installed already -
    1.62 @@ -110,7 +104,7 @@
    1.63  
    1.64        $ make validate
    1.65  
    1.66 -3. Read about DocBook.
    1.67 +3. Read about DocBook
    1.68  
    1.69    You'll want to get real intimate with a DocBook reference, such as
    1.70    can be found at:  http://www.docbook.org/tdg/en/html/