FAQ and documentation updates.

4 files changed, 38 insertions, 22 deletions

diff --git a/INSTALL.txt b/INSTALL.txt
index 7684af9..76756b6 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -75,6 +75,10 @@ Distribution tarball installation
 The distribution source tarballs can be downloaded from the
 SourceForge http://sourceforge.net/projects/asciidoc/.
 
+NOTE: Unless you are <<X3,installing on Microsoft Windows>> you should
+use the tarball and not the zip file to install the the distribution
+(the tarball contains symlinks).
+
 If your flavor or UNIX or Linux does not have a packaged AsciiDoc
 distribution or if you prefer to install the latest AsciiDoc version
 from source use the `configure` shell script in the tarball root
@@ -178,6 +182,7 @@ See also link:userguide.html#X38[Packager Notes] in the 'AsciiDoc User
 Guide'.
 
 
+[[X3]]
 Microsoft Windows installation
 ------------------------------
 AsciiDoc is developed and tested on Linux but there seem to be quite a
diff --git a/doc/asciidoc.dict b/doc/asciidoc.dict
index 6306372..817ed50 100644
--- a/doc/asciidoc.dict
+++ b/doc/asciidoc.dict
@@ -1,4 +1,4 @@
-personal_ws-1.1 en 908 
+personal_ws-1.1 en 907 
 mandoc
 colspecs
 API
@@ -29,8 +29,8 @@ BOM
 Bon
 ungenerated
 zipP
-cmd
 des
+cmd
 ListItems
 dev
 vulputate
@@ -90,8 +90,8 @@ hhc
 Chai
 strongwords
 setlocal
-listingblock
 ListingBlock
+listingblock
 exe
 AuthorInfo
 vsides
@@ -104,8 +104,8 @@ magna
 xreflabel
 PDF's
 PDFs
-pede
 MSIE
+pede
 permalinks
 Daly
 arcu
@@ -118,8 +118,8 @@ apos
 ShareSource
 projectname
 hoc
-Maier
 ispum
+Maier
 TableFooter
 blog
 passthroughs
@@ -172,8 +172,8 @@ symlinks
 optionname
 companyname
 pageunits
-loc
 nec
+loc
 latexmath
 articleinfo
 auctor
@@ -201,12 +201,12 @@ endDocument
 odt
 Cygwin
 ultrices
-IndentedParagraph
 indentedparagraph
+IndentedParagraph
 ltr
 doctests
-asciidocapi
 AsciiDocAPI
+asciidocapi
 itemtag
 Dvips
 Jython
@@ -228,7 +228,6 @@ facto
 ListParagraphs
 nunc
 opf
-OPF
 CustomBlocks
 informalfigure
 ORed
@@ -240,9 +239,9 @@ BlockId
 png
 lobortis
 Bowlin
-ASCIIMathML
-AsciiMathML
 asciimathml
+AsciiMathML
+ASCIIMathML
 conf
 RCS
 CalloutList
@@ -290,8 +289,8 @@ pgwide
 RevisionDate
 crlf
 tex
-Bolido
 Bólido
+Bolido
 tabsize
 colpcwidth
 Orry
@@ -306,8 +305,8 @@ Tsawassen
 Aenean
 postsubs
 src
-lastname
 LastName
+lastname
 toc
 tmp
 Knisley
@@ -352,13 +351,13 @@ revisionhistory
 params
 undefines
 Andrés
-HTMLHelp
 htmlhelp
+HTMLHelp
 cellspacing
 Citeaux
 srackham
-Lulea
 Luleå
+Lulea
 Ubuntu
 xml
 XSLTLib
@@ -390,8 +389,8 @@ hg
 guimenu
 toclevels
 xzf
-JB
 gq
+JB
 refactored
 sgml
 backcolor
@@ -412,8 +411,8 @@ js
 blogpost
 xsltproc
 jw
-nd
 ln
+nd
 ne
 oa
 Terje
@@ -435,9 +434,9 @@ ps
 runtime
 tcqn
 epub
+px
 td
 Vivamus
-px
 py
 th
 ru
@@ -497,8 +496,8 @@ pretium
 notitle
 manvolnum
 homero
-listindex
 validators
+listindex
 testasciidoc
 HotSpot
 vimrc
@@ -828,8 +827,8 @@ toolchain
 cellpadding
 entrytbl
 authorinitials
-JavaScripts
 javascripts
+JavaScripts
 undefining
 leveloffset
 CustomBlock
@@ -883,8 +882,8 @@ Redhat
 datadir
 Kumar
 IndentedParagraphs
-Berguvsvägen
 Berguvsvagen
+Berguvsvägen
 executables
 tabledef
 ftdetect
@@ -904,6 +903,6 @@ lectus
 JavaHelp
 unescaped
 mydoc
-MiddleName
 middlename
+MiddleName
 Jimmac's
diff --git a/doc/faq.txt b/doc/faq.txt
index 9f1ea0c..c81061a 100644
--- a/doc/faq.txt
+++ b/doc/faq.txt
@@ -9,6 +9,17 @@ AsciiDoc Frequently Asked Questions
   newer FAQs may apply to the trunk and not the current release.

 ======

 

+== How can I customize the appearance of XHTML and EPUB documents generated by a2x?

+By default, 'a2x' includes your distribution's

+`stylesheets/docbook-xsl.css` CSS file in 'xhtml' and 'epub' outputs.

+Use the `--stylesheet` and `-r, --resource-dir` command-line options

+to specify an alternative stylesheet. The following example

+recursively searches the `resources` directory for `book-style.css`

+and includes it in the output `doc/book.epub` 'EPUB' file:

+

+  a2x -f epub -d book -r resources --stylesheet book-style.css doc/book.txt

+

+

 == DocBook has many elements for document meta-data -- how can I use them from AsciiDoc?

 If the 'docinfo' attribute is defined then AsciiDoc looks for a file

 named like the source file but ending in `-docinfo.xml` and includes

diff --git a/docbook-xsl/common.xsl b/docbook-xsl/common.xsl
index 5c7d3d8..519c572 100644
--- a/docbook-xsl/common.xsl
+++ b/docbook-xsl/common.xsl
@@ -43,6 +43,7 @@
 <xsl:param name="callout.graphics.path" select="'images/icons/callouts/'"/>

 <xsl:param name="callout.list.table" select="'1'"/>

 

+<!-- This does not seem to work. -->

 <xsl:param name="section.autolabel.max.depth" select="2"/>

 

 <xsl:param name="chunk.first.sections" select="1"/>