Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r68896 - branches/doc-tools-docs/tools/quickbook/doc
From: dnljms_at_[hidden]
Date: 2011-02-14 20:16:17


Author: danieljames
Date: 2011-02-14 20:16:16 EST (Mon, 14 Feb 2011)
New Revision: 68896
URL: http://svn.boost.org/trac/boost/changeset/68896

Log:
A bit more detail on document info.
Text files modified:
   branches/doc-tools-docs/tools/quickbook/doc/syntax.qbk | 53 +++++++++++++++++++++++++--------------
   1 files changed, 34 insertions(+), 19 deletions(-)

Modified: branches/doc-tools-docs/tools/quickbook/doc/syntax.qbk
==============================================================================
--- branches/doc-tools-docs/tools/quickbook/doc/syntax.qbk (original)
+++ branches/doc-tools-docs/tools/quickbook/doc/syntax.qbk 2011-02-14 20:16:16 EST (Mon, 14 Feb 2011)
@@ -47,39 +47,53 @@
 
 [endsect] [/Comments]
 
-[section Document Info]
+[section:docinfo Document Info]
 
-Every document must begin with a Document Info section, which should look
+Every document must begin with a Document Info section, which looks something
 like this:
 
 [pre'''
-[document-type The Document Title
+[article The Document Title
     [quickbook 1.5]
     [version 1.0]
     [id the_document_name]
- [dirname the_document_dir]
     [copyright 2000 2002 2003 Joe Blow, Jane Doe]
- [purpose The document's reason for being]
- [category The document's category]
     [authors [Blow, Joe] [Doe, Jane]]
     [license The document's license]
     [source-mode source-type]
 ]
 ''']
 
-Where document-type is one of:
+`article` is the document type. There are several possible document types,
+most of these are based on docbook document elements. These are fully
+described in
+[@http://www.docbook.org/tdg/ DocBook: The Definitive Guide]:
+
+* [@http://www.docbook.org/tdg/en/html/book.html book]
+* [@http://www.docbook.org/tdg/en/html/article.html article]
+* [@http://www.docbook.org/tdg/en/html/chapter.html chapter]
+* [@http://www.docbook.org/tdg/en/html/part.html part]
+* [@http://www.docbook.org/tdg/en/html/appendix.html appendix]
+* [@http://www.docbook.org/tdg/en/html/preface.html preface]
+* [@http://www.docbook.org/tdg/en/html/qandadiv.html qandadiv]
+* [@http://www.docbook.org/tdg/en/html/qandaset.html qandaset]
+* [@http://www.docbook.org/tdg/en/html/reference.html reference]
+* [@http://www.docbook.org/tdg/en/html/set.html set]
 
-* book
-* article
-* library
-* chapter
-* part
-* appendix
-* preface
-* qandadiv
-* qandaset
-* reference
-* set
+Boostbook also adds another document type [^[link boostbook.defining library]]
+for documenting software libraries.
+
+So the documentation for the 'foo' library might start:
+
+[pre'''
+[library Foo
+ [quickbook 1.5]
+ [version 1.0]
+ [id foo]
+]
+''']
+
+[section:attributes Document Info Attributes]
 
 quickbook 1.5 declares the version of quickbook the document is written for.
 In its absence, version 1.1 is assumed.
@@ -95,7 +109,8 @@
 =source-type= is a lowercase string setting the initial __source_mode__. If
 the =source-mode= field is omitted, a default value of =c++= will be used.
 
+[endsect] [/attributes]
 
-[endsect]
+[endsect] [/docinfo]
 
 [endsect] [/Syntax Summary]


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk