[ceph.git] / ceph / src / boost / tools / quickbook / doc / language_versions.qbk

[/
    Copyright 2002,2004,2006 Joel de Guzman, Eric Niebler
    Copyright 2010-2013 Daniel James

    Distributed under the Boost Software License, Version 1.0.
    (See accompanying file LICENSE_1_0.txt or copy at
    http://www.boost.org/LICENSE_1_0.txt)
]

[chapter Language Versions
    [quickbook 1.7]
    [compatibility-mode 1.5]
    [id quickbook.versions]
    [source-mode teletype]
]

[section:stable Stable Versions]

Since quickbook 1.3 the `quickbook` attribute in the document block selects
which version of the language to use. Not all changes to quickbook are
implemented using a version switch, it's mainly just the changes that change
the way a document is interpreted or would break existing documentation.

[heading Quickbook 1.3 and later]

* Introduced quickbook language versioning.
* In the documentation info, allow phrase markup in license and purpose
  attributes.
* Fully qualified section and headers. Subsection names are concatenated to the
  ID to avoid clashing. Example: `doc_name.sect_name.sub_sect_name.sub_sub_sect_name`.

[heading Quickbook 1.5 and later]

* Ignore template argument separators inside square brackets.
* Don't separate the final template argument if the `..` separator was
  used. i.e. never mix `..` and whitespace separators.
* Statically scope templates and their arguments rather than dynamically
  scope them.
* Give table ids, and let you set them.
* Allow spaces between the `:` character and ids in elements which can
  have ids.

[endsect]

[include 1_6.qbk]
[include 1_7.qbk]
Commit	Line	Data
7c673cae FG	1	[/
	2	Copyright 2002,2004,2006 Joel de Guzman, Eric Niebler
	3	Copyright 2010-2013 Daniel James
	4
	5	Distributed under the Boost Software License, Version 1.0.
	6	(See accompanying file LICENSE_1_0.txt or copy at
	7	http://www.boost.org/LICENSE_1_0.txt)
	8	]
	9
	10	[chapter Language Versions
	11	[quickbook 1.7]
	12	[compatibility-mode 1.5]
	13	[id quickbook.versions]
	14	[source-mode teletype]
	15	]
	16
	17	[section:stable Stable Versions]
	18
	19	Since quickbook 1.3 the `quickbook` attribute in the document block selects
	20	which version of the language to use. Not all changes to quickbook are
	21	implemented using a version switch, it's mainly just the changes that change
	22	the way a document is interpreted or would break existing documentation.
	23
	24	[heading Quickbook 1.3 and later]
	25
	26	* Introduced quickbook language versioning.
	27	* In the documentation info, allow phrase markup in license and purpose
	28	attributes.
	29	* Fully qualified section and headers. Subsection names are concatenated to the
	30	ID to avoid clashing. Example: `doc_name.sect_name.sub_sect_name.sub_sub_sect_name`.
	31
	32	[heading Quickbook 1.5 and later]
	33
	34	* Ignore template argument separators inside square brackets.
	35	* Don't separate the final template argument if the `..` separator was
	36	used. i.e. never mix `..` and whitespace separators.
	37	* Statically scope templates and their arguments rather than dynamically
	38	scope them.
	39	* Give table ids, and let you set them.
	40	* Allow spaces between the `:` character and ids in elements which can
	41	have ids.
	42
	43	[endsect]
	44
	45	[include 1_6.qbk]
	46	[include 1_7.qbk]