#153 References: Consider using DocBook's <refsect1> and related markup

[Anonymous]

Originally created by: cmpilato

DocBook offers what appears to be a pretty complete collection of tags related to reference sections.  We should consider using those instead of the simple <refsect1> sections we are using today.

For example, we could be using <refsynopsisdiv> and <cmdsynopsis> for our binary subcommand reference synopsis bits.

See http://www.docbook.org/tdg/en/html/ch02.html#making-refentry for details.

[Anonymous]

Originally posted by: cmpilato

(No comment was entered for this change.)

Owner: ---

[Anonymous]

Originally posted by: cmpilato

(No comment was entered for this change.)

Summary: References: Consider using DocBook's <refsynopsisdiv> and related markup

[Anonymous]

Originally posted by: cmpilato

As of [r4434], the book uses <refsynopsisdiv> sections.  Now, we need to consider if <cmdsynopsis> will be worth the hassle.

Status: Started

[Anonymous]

Originally posted by: cmpilato

See http://www.docbook.org/tdg/en/html/cmdsynopsis.html for details.