Commit Graph

316 Commits

Author SHA1 Message Date
Daniel
d3bfdf9534 Release notes.
This might end up being 1.7.0, but call it 1.6.2 for now. I used to put
in alpha/beta versions, but that's mainly pointless bookkeeping.
2015-12-17 19:19:26 +00:00
Daniel James
5265eb0ed2 Add some missing changes to the change log. 2014-05-29 17:30:34 +01:00
Daniel James
563e8a23c8 Remove executable flag from a few files. 2014-01-18 17:30:18 +00:00
Daniel James
5fea56f8da Revert the boost-doc-tools documentation.
Will start again on a feature branch.
2013-12-05 00:22:52 +00:00
Daniel James
d111b65896 Update quickbook docs now that colour support has been merged to release.
[SVN r86729]
2013-11-16 20:39:09 +00:00
Daniel James
9dd649ed9f Add glob support.
This is based on Rene's implementation, but I used my own glob function,
and adjusted a few things since it's now always using ascii. It would be
nice to support unicode, but that would require at the very least a
normalization library, and perhaps more than that.

[SVN r86699]
2013-11-14 19:19:54 +00:00
Daniel James
72a15c5e50 Update 1.7 note about attribute templates.
[SVN r86689]
2013-11-13 21:50:08 +00:00
Daniel James
02d70c0524 Document the new source mode changes.
[SVN r86668]
2013-11-12 20:35:37 +00:00
Daniel James
15557b0cab Update the quickbook version number.
Forgot to do this for the release, a bit annoying.

[SVN r86522]
2013-10-30 08:44:08 +00:00
Daniel James
5ea71122b4 List some docbook/boostbook parameters that might need documenting.
[SVN r86364]
2013-10-19 16:53:12 +00:00
Daniel James
719b0dac7c Update role instructions to mention colours.
I'll update this if they get merged for 1.55.

[SVN r86306]
2013-10-14 20:36:40 +00:00
Daniel James
9f0429368d Bump quickbook version for beta.
A bit anal. But there you go.

[SVN r85826]
2013-09-22 10:49:01 +00:00
Daniel James
ba9e2ed772 Encode the filename macro.
Also tweak the utils string functions.

[SVN r85807]
2013-09-20 19:52:38 +00:00
Daniel James
ff2eec0518 A little more about upgrading to 1.6
[SVN r85599]
2013-09-08 07:47:06 +00:00
Daniel James
732600aaa5 Starting to document xsl parameters.
[SVN r85598]
2013-09-08 07:46:42 +00:00
Daniel James
867c11c8b3 Tweak the documentation structure.
[SVN r85597]
2013-09-08 07:46:16 +00:00
Daniel James
937cf87f61 Example of building documentation outside of the boost tree.
[SVN r85596]
2013-09-08 07:45:47 +00:00
Daniel James
3f0ad9cd77 Respect indentation at the start of a file.
Fix bug where a code block at the start of a file was not recognised.
I was actually adding this test to check that the `source_mode_unset`
mechanism in `doc_info_grammar.cpp` was working, but it ended exposing
this bug.

[SVN r85590]
2013-09-07 07:24:47 +00:00
Daniel James
c790319efe First example of building documentation with boost build.
[SVN r85470]
2013-08-25 19:10:31 +00:00
Daniel James
010bd25ba3 Start a more general intro to the documentation tools.
Mostly just the content from the wiki. I left out installing latex for now,
as it's a bit tricky, and rarely required.

[SVN r85468]
2013-08-25 19:09:41 +00:00
Daniel James
19119a5d02 Remove duplicate 1.6 notes.
[SVN r85435]
2013-08-23 13:46:21 +00:00
Daniel James
7676f00765 Fix standalone images in quickbook.
[SVN r85431]
2013-08-22 20:50:08 +00:00
Daniel James
99c2746329 Remove 'not ready' notes about block markup in lists.
The recent improvements to list generation have left me feeling more confident
about this.

[SVN r85430]
2013-08-22 20:49:50 +00:00
Daniel James
faca522959 A little copy editting for the 1.7 description.
[SVN r85429]
2013-08-22 20:49:31 +00:00
Daniel James
50c4cab88f Add a quick guide on upgrading to 1.6
[SVN r85428]
2013-08-22 20:49:05 +00:00
Daniel James
4fefa013a9 Add new elements in 1.6 to the main documentation.
[SVN r85407]
2013-08-20 08:57:49 +00:00
Daniel James
c58e64af03 Add note about xmlbase.
[SVN r85406]
2013-08-20 08:57:29 +00:00
Daniel James
0f37ec4da2 Add explicit ids to heading documentation.
[SVN r85405]
2013-08-20 08:57:13 +00:00
Daniel James
1adc92593c Update version meta-data documentation.
[SVN r85404]
2013-08-20 08:56:56 +00:00
Daniel James
09005dc2b4 Update the import and include documentation.
This is a bit incoherent at the moment. It needs to be rearranged so
that there's a tutorial that introduces the concepts in a more logical
order. But I want to press on with some of the other updates.

[SVN r85403]
2013-08-20 08:56:39 +00:00
Daniel James
6c412da094 Fix inaccurate heading id generation documentation.
All headings have ids generated, not just `h1`, `h2` and `h3`.

[SVN r85402]
2013-08-20 08:56:24 +00:00
Daniel James
3db7767853 Start to document quickbook 1.6 include.
[SVN r85382]
2013-08-17 19:01:46 +00:00
Daniel James
d1d87511a9 Quickbook 1.6 alpha 1.
[SVN r85381]
2013-08-17 19:01:27 +00:00
Daniel James
6f06a8d7a6 Remove incorrect note about document id.
The document id has never been generated from the filename. It comes
from the docinfo `id` attribute, or if that doesn't exist, it's
generated from the document title. Although, thanks to bugs, it's a bit
more complicated than that.

[SVN r85328]
2013-08-12 21:42:20 +00:00
Daniel James
55d7447469 Fix single entity source mode notes.
[SVN r85327]
2013-08-12 21:42:01 +00:00
Daniel James
29ee34d4b7 Split up the language version chapter.
[SVN r85288]
2013-08-10 19:18:25 +00:00
Daniel James
c784dcbc44 Some notes about recent quickbook changes.
[SVN r85287]
2013-08-10 19:17:51 +00:00
Daniel James
8dfd18abd4 Expand all phrase templates inline, even if they contain blocks.
Hopefully more intuitive than turning what looks like a phrase into
a block.

[SVN r85130]
2013-07-23 08:23:29 +00:00
Daniel James
57e59f148a Allow block markup in phrase templates.
[SVN r85127]
2013-07-23 08:22:26 +00:00
Daniel James
2b5f23951e Allow block markup inside nested blocks (e.g. tables)
Since this is often indented, does not treat indented blocks as code
blocks. This is inconsistent for lists, so maybe indented blocks in
lists should always be code, or never be code. Or maybe it should be a
bit smarter about nested indented blocks.

[SVN r85126]
2013-07-23 08:21:56 +00:00
Daniel James
705605b381 Error if phrase element body doesn't parse.
[SVN r85117]
2013-07-22 19:34:32 +00:00
Daniel James
7dcc517949 Error if element used in incorrect context.
Should be less suprising than just not processing them. Needs more tests.

[SVN r85116]
2013-07-22 19:34:03 +00:00
Daniel James
8e0047f0fb Don't break out of a list after a block tag.
[SVN r84936]
2013-07-01 19:35:37 +00:00
Daniel James
774fe19d0b Check for errors when writing dependencies.
[SVN r84933]
2013-07-01 19:34:33 +00:00
Daniel James
0c69657973 Make nested paragraphs/code blocks in lists an error in 1.6.
They're now a 1.7 feature. Will revert to 1.5 behaviour before 1.6 final.

[SVN r84932]
2013-07-01 19:34:07 +00:00
Daniel James
671747969e Fix 'doc info macros' id.
[SVN r84637]
2013-06-04 18:57:02 +00:00
Daniel James
919e42eafb Better project names.
[SVN r84564]
2013-05-30 21:47:02 +00:00
Daniel James
ac0f8cf92f Fix block example again. Refs #8545.
[SVN r84175]
2013-05-06 20:22:16 +00:00
Daniel James
172ff0f4e3 Macros in docinfo blocks for 1.6. Refs #8543.
[SVN r84153]
2013-05-05 13:47:26 +00:00
Daniel James
7e76b65ed8 C++11 keywords. Refs #8541.
[SVN r84152]
2013-05-05 13:46:57 +00:00