[Asterisk-doc] DocBook

[William Suffill]

After the conference yesterday I decided to give docbook a shot for myself.
Felt it couldn't hurt and be just something else to learn and ease the 
the manual labor to contributions to the book.

It seems to work ok using the FreeBSD Doc Projects suggested toolset including
jade. Although I downloaded conf-files.xml from the website and I got
alot of errors. Perhaps it would be wise to check how clean our markup is.
It does seem to work ok besides a strange html line layout 
(cat the file produced html it looks weird)


jade:conf-files.xml:1:0:E: no document type declaration; will parse without validation
jade:conf-files.xml:30:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:29:3: start tag was here
jade:conf-files.xml:34:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:33:3: start tag was here
jade:conf-files.xml:38:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:37:3: start tag was here
jade:conf-files.xml:42:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:41:3: start tag was here
jade:conf-files.xml:53:16:E: end tag for "PROGRAMLISTING" omitted, but its declaration does not permit this
jade:conf-files.xml:51:3: start tag was here
jade:conf-files.xml:53:16:E: end tag for "INFORMALEXAMPLE" omitted, but its declaration does not permit this
jade:conf-files.xml:50:3: start tag was here
jade:conf-files.xml:53:16:E: end tag for "SECT2" omitted, but its declaration does not permit this
jade:conf-files.xml:43:2: start tag was here
jade:conf-files.xml:60:19:E: end tag for element "PROGRAMLISTING" which is not open
jade:conf-files.xml:61:20:E: end tag for element "INFORMALEXAMPLE" which is not open
jade:conf-files.xml:104:9:E: end tag for element "SECT2" which is not open
jade:conf-files.xml:108:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:107:3: start tag was here
jade:conf-files.xml:122:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:121:3: start tag was here
jade:conf-files.xml:126:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:125:3: start tag was here
jade:conf-files.xml:130:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:129:3: start tag was here
jade:conf-files.xml:134:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:133:3: start tag was here
jade:conf-files.xml:138:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:137:3: start tag was here
jade:conf-files.xml:240:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:239:3: start tag was here
jade:conf-files.xml:244:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:243:3: start tag was here
jade:conf-files.xml:248:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:247:3: start tag was here
jade:conf-files.xml:252:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:251:3: start tag was here
jade:conf-files.xml:256:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:255:3: start tag was here
jade:conf-files.xml:306:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:305:3: start tag was here
jade:conf-files.xml:310:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:309:3: start tag was here
jade:conf-files.xml:314:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:313:3: start tag was here
jade:conf-files.xml:318:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:317:3: start tag was here
jade:conf-files.xml:358:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:357:3: start tag was here
jade:conf-files.xml:470:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:469:3: start tag was here
jade:conf-files.xml:474:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:473:3: start tag was here
jade:conf-files.xml:478:9:E: end tag for "PARA" omitted, but its declaration does not permit this
jade:conf-files.xml:477:3: start tag was here
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/dblists.dsl:331:40:E: no clause in cond expression matched