boost/quickbook
2
0
Fork 0
mirror of https://github.com/boostorg/quickbook.git synced 2026-01-19 16:32:16 +00:00
Code Issues Projects Releases Wiki Activity

Doc tools: Update documentation from trunk.

Browse Source 
[SVN r70567]
This commit is contained in:
Daniel James
2011-03-26 11:40:47 +00:00
parent 30261e04c6
commit 3aa87fa151
2 changed files with 60 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
doc/block.qbk
View File

@@ -1053,6 +1053,18 @@ or
can be used to inhibit code from passing through to quickbook. All text between
the delimeters will simply be ignored.
Comments of this form:
//=int main() {}
or
/*=foo()*/
will be displayed as code that isn't in comments. This allows you to
include some code in the snippet but not actually use it when
compiling your example.
[heading Callouts]
Special comments of the form:

49
doc/change_log.qbk
View File

@@ -46,6 +46,10 @@ the way a document is interpreted or would break existing documentation.
* XML encode all document info attributes. Previously the text would be
passed through as is, which allowed you to write xml character entities
inline. Instead you should now use unicode escapes.
* Source mode changes are scoped to the file they're made in.
* Explicit markup for lists. e.g.
`[ordered_list [item1][item2]]` or
`[itemized_list [item1][item2]]`.
[endsect] [/versions]
@@ -183,7 +187,9 @@ the way a document is interpreted or would break existing documentation.
* XML escape documentation fields, with escapes to allow encoding unicode
in ASCII.
[heading Version 1.5.4 - Boost 1.46.0]
[heading Version 1.5.4 - Boost 1.46.1]
Boost 1.46.0:
* Add support for `lang` attribute in documentation info.
* Improved anchor implementation. Especially for using an anchor
@@ -195,6 +201,47 @@ the way a document is interpreted or would break existing documentation.
* Rearrange the structure of the grammar.
* Use filesystem 3. Remove cygwin support.
Boost 1.46.1:
* Work around optimization bug in g++ 4.4 on 64 bit linux.
[heading Version 1.5.5 - Boost 1.47]
* Tweak anchor placement for titles.
* Hard code the quickbook path into the quickbook testing tools. This
means that they can be used from multiple locations.
* Generate an id for boostbook `bridgehead` elements. This results in
more consistent html, since docbook generates a random id if they
don't have one.
* Improved unicode support on windows. Unicode can now be used from the
command line, and unicode filenames are supported. Unicode output is
a bit weak.
* Check for windows paths, and warn about them.
* Fix relative path detection on windows.
* Reverse deprecation of `[br]`, printing a single warning about
generating invalid boostbook.
* Fix handling empty category attributes.
* Store data from the parser in a dynamic data structure.
This simplifies the implementation and makes it easier to parse
more complicated data structures.
* Improved error messages for unknown doc info attributes.
* Richer copyright syntax. Now understands:
`[copyright 2001-2006, 2010 One person, 2008 Another person]`.
* Fix delimeter checking for simple markup.
* Allow more block elements to be nested.
* Go back to using invalid markup for lists. It generates better html.
* Better anchor placement for lists.
* Pass-thru comments in code snippets.
* Use relative paths for `__FILENAME__` macro.
* Rewrite xinclude path generator so that it doesn't use deprecated
filesystem functions.
* Quickbook 1.6:
* Scope source mode changes to the file they're made in.
* Explicit markup for lists. e.g.
`[ordered_list [item1][item2]]` or
`[itemized_list [item1][item2]]`.
[endsect] [/releases]
[endsect] [/Change log]