ceph/src/boost/tools/quickbook/doc/language_versions.qbk

   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]