* converted FAQ to SGML

  * SGML sucks, this is absolutely ugly, please reread

doc/common/stylesheet-html.dsl

+<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
+<!ENTITY dbstyle SYSTEM "/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl" CDATA DSSSL>
+]>
+
+<style-sheet>
+<style-specification use="docbook">
+<style-specification-body>
+
+; Personnalization of James Clark's stylesheet for HTML output
+; These parameters overide James Clark's one.
+
+; Only produce a table of contents (not a table of figure, etc...)
+(define ($generate-book-lot-list$)
+  (list ))
+
+; Depth of the table of contents
+(define (toc-depth nd)
+      2)
+
+; Change of HTML page for each chapter, not for each "sect1"
+(define (chunk-element-list)
+  (list (normalize "preface")
+	(normalize "chapter")
+	(normalize "appendix") 
+	(normalize "article")
+	(normalize "glossary")
+	(normalize "bibliography")
+	(normalize "index")
+	(normalize "colophon")
+	(normalize "setindex")
+	(normalize "reference")
+	(normalize "refentry")
+	(normalize "part")
+	(normalize "book")
+	(normalize "set")
+	))
+
+
+; "screens" should be in verbatim mode"
+(define %shade-verbatim%
+  #t)
+
+; I want small icons for "notes", "warnings", "caution" & "important"
+(define %admon-graphics%
+  #t)
+; Path for the icons
+(define %admon-graphics-path%
+  "../common/")
+
+; Use ID attributes as name for component HTML files
+(define %use-id-as-filename%
+  #t)
+
+(define %section-autolabel%
+  ;; Are sections enumerated?
+  #t)
+
+
+</style-specification-body>
+</style-specification>
+<external-specification id="docbook" document="dbstyle">
+</style-sheet>

doc/faq/Makefile

+all: html
+
+html:
+	rm -f *.html
+	sgmltools -b html -s ../common/stylesheet-html.dsl faq-alone.sgml
+	mv faq-alone/*.html .
+	rmdir faq-alone
+	ln -s book1.html index.html
+

doc/faq/faq-alone.sgml

+<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook V4.1//EN'
+[
+
+  <!ENTITY faq SYSTEM "faq.sgml">
+
+]>
+
+<book>
+
+<bookinfo>
+
+<title>Frequently Asked Questions</title>
+
+<copyright>
+    <year>2002, 2003</year>
+    <holder>the VideoLAN project</holder>
+</copyright>
+
+</bookinfo>
+
+
+<toc></toc>
+
+&faq;
+
+</book>