Commit Graph

355 Commits

Author SHA1 Message Date
Daniel James
6c54bc38c4 Quickbook: Merge quickbook-dev into trunk.
[SVN r77382]
2012-03-18 19:39:00 +00:00
Daniel James
0463a93263 Quickbook: Merge from trunk.
Includes blocks in lists fixes, and some documentation changes.


[SVN r77347]
2012-03-16 08:48:10 +00:00
Daniel James
fe883c5b76 Quickbook: Use anchors for linking to syntax.
Will make restructuring documentation easier.

[SVN r76972]
2012-02-11 12:34:10 +00:00
Daniel James
d525c56f60 Quickbook: Some explicit section ids.
[SVN r76971]
2012-02-11 12:33:46 +00:00
Daniel James
d9931935cd Quickbook: Changelog for 1.49
[SVN r76847]
2012-02-02 23:47:19 +00:00
Daniel James
a883a5b13c Quickbook: Initial implementation of templates in link values.
[SVN r76647]
2012-01-22 23:08:21 +00:00
Daniel James
0c0795fcff Quickbook: Escaped markup in docinfo blocks.
[SVN r76645]
2012-01-22 23:07:26 +00:00
Daniel James
aefb22bc28 Quickbook: Merge from trunk to quickbook-dev.
[SVN r76255]
2012-01-01 13:35:27 +00:00
Daniel James
821bc75c77 Quickbook: Fix escaping in some code examples.
[SVN r76254]
2012-01-01 12:37:00 +00:00
Daniel James
5892db6a0d Quickbook: Fix some errors in 1.7 docs.
[SVN r75898]
2011-12-11 11:28:59 +00:00
Daniel James
672caeec17 Quickbook: Code block callouts.
[SVN r75897]
2011-12-11 11:16:01 +00:00
Daniel James
3ed6415296 Quickbook: Support single entity source mode marker.
[SVN r75895]
2011-12-11 11:14:17 +00:00
Daniel James
13ce9e9fdb Quickbook: Use 1.7 for everything on dev branch.
Might promote them to 1.6 later.

[SVN r75892]
2011-12-11 11:11:50 +00:00
Daniel James
4c2ad1f909 Quickbook: Merge from trunk to quickbook-dev.
[SVN r75846]
2011-12-07 09:40:30 +00:00
Daniel James
0034e20457 Quickbook: Small documentation improvements.
- Use `heading` rather than `h3` in changelog.
- Improve code block documentation.
- Update line break info.
- I'm pretty sure quickbook isn't Turing complete.
- Not just C++ syntax highlight any more.

[SVN r75845]
2011-12-07 09:21:11 +00:00
Daniel James
7bbc23917c Quickbook: Use fewer escapes in documentation.
[SVN r75844]
2011-12-07 09:20:48 +00:00
Daniel James
8052d2936a Quickbook: Use default doc build settings to match main docs.
[SVN r75843]
2011-12-07 09:20:27 +00:00
Daniel James
e4b7df253d Quickbook: Add some of the old quickbook-dev docs.
- Link example.
- Extra Docinfo information.
- Quickbook 1.3 and 1.5

[SVN r75842]
2011-12-07 09:20:04 +00:00
Daniel James
bab85ee477 Quickbook: Split up the documentation.
Into a `part` containing `chapter`s in order to match the boostbook
documentation.

[SVN r75841]
2011-12-07 09:19:39 +00:00
Daniel James
b8fc2c7db7 Quickbook: Merge from trunk to quickbook-dev.
[SVN r75763]
2011-12-01 18:07:38 +00:00
Rene Rivera
bceab2ece7 Implement glob multi-file includes.
[SVN r75761]
2011-12-01 04:29:54 +00:00
Daniel James
fa2cc5f339 Quickbook: Small edits to 1.6 docs.
[SVN r75745]
2011-11-30 08:22:19 +00:00
Daniel James
cc34500587 Quickbook: Merge from trunk to quickbook-dev
[SVN r75739]
2011-11-30 01:35:25 +00:00
Daniel James
354f26e020 Quickbook: Fix code blocks in quickbook docs.
Under 1.6 indentation rules they were interpreted as paragraphs inside a list
item. An alternative fix would have been to increase the indentation so that it
was more than the previous list item's.


[SVN r75703]
2011-11-28 08:47:11 +00:00
Daniel James
ef6628f851 Quickbook: Merge from quickbook-dev to trunk.
[SVN r75696]
2011-11-27 21:34:56 +00:00
Daniel James
73f76e778e Quickbook: Allow block elements in lists.
[SVN r75632]
2011-11-22 23:50:48 +00:00
Daniel James
0081b73a34 Quickbook: 1.6 note.
[SVN r75533]
2011-11-17 21:05:33 +00:00
Daniel James
53be4f1e81 Quickbook: Add boost versions to old releases.
[SVN r75527]
2011-11-17 21:03:41 +00:00
Daniel James
9711cead8b Quickbook: Parse lists with paragraphs.
Quite a big change. I moved the list logic into the grammar so that it's
easier to tell how to parse different blocks. Also reworked some of the
block vs. phrase stuff - it's a lot cleaner now which helped implement
this.  It generates terrible markup at the moment, but at least the
parser is in place.

[SVN r75446]
2011-11-10 18:17:00 +00:00
Daniel James
5f5c526ea3 Quickbook: Better table titles.
[SVN r75445]
2011-11-10 18:16:37 +00:00
Daniel James
00f06ac438 Quickbook: Convert quickbook docs to 1.6
[SVN r75444]
2011-11-10 18:16:19 +00:00
Daniel James
952b3b6550 Quickbook: Support version info outside of document info blocks.
[SVN r75442]
2011-11-10 18:15:49 +00:00
Daniel James
fc7e9d0919 Quickbook: Start to document 1.6
[SVN r75363]
2011-11-06 22:23:48 +00:00
Daniel James
8bb70e9c3b Quickbook: Revert documentation to trunk.
[SVN r75362]
2011-11-06 22:23:29 +00:00
Daniel James
3afae60dd4 Quickbook: Fix old changelog entry.
[SVN r75340]
2011-11-06 09:33:55 +00:00
Daniel James
19e7038643 Quickbook: Add tip clarifying BoostBook, DocBook, need to know.
Merged from change by Beman.

[SVN r75228]
2011-11-01 19:01:27 +00:00
Daniel James
6be83be59f Quickbook: Add Windows 7 as supported platform
Merged from change by Beman.

[SVN r75227]
2011-11-01 19:01:09 +00:00
Daniel James
fc3102422a Quickbook: Change log for 1.48.
[SVN r75225]
2011-11-01 19:00:38 +00:00
Beman Dawes
4069b1d024 Add tip clarifying BoostBook, DocBook, need to know.
[SVN r74752]
2011-10-06 12:10:27 +00:00
Beman Dawes
22eb772d42 Add Windows 7 as supported platform
[SVN r74737]
2011-10-05 13:35:10 +00:00
Daniel James
4d19afef68 Quickbook: Change log for 1.48.
[SVN r74350]
2011-09-11 17:00:54 +00:00
Daniel James
9b1eed66f4 Quickbook: Merge from trunk to quickbook-dev.
[SVN r73239]
2011-07-19 07:35:49 +00:00
Daniel James
f81dc542d6 Quickbook: Avoid expanding __FILENAME__.
[SVN r72823]
2011-06-30 20:27:02 +00:00
Daniel James
09165188f1 Quickbook: merge from trunk to dev.
[SVN r72762]
2011-06-26 11:07:04 +00:00
Daniel James
c72d4029c0 Quickbook: xml encode escaped punctuation.
[SVN r72760]
2011-06-26 10:44:00 +00:00
Daniel James
bf1d753dba Merge tools directory from trunk.
[SVN r72698]
2011-06-20 19:19:56 +00:00
Daniel James
15ad3c2e14 Quickbook: Trying to write a gentler intro to quickbook.
[SVN r72081]
2011-05-22 15:36:07 +00:00
Daniel James
72a250506f Quickbook: fix incorrect apostrophe.
[SVN r72080]
2011-05-22 15:35:41 +00:00
Daniel James
19e0188456 Quickbook: separate structure from syntax.
The structure information will get more complex with differences
between 1.5 and 1.6, and full attribute documentation. The syntax
section could be expanded to be a more useful introduction and to link
to the various parts of the reference documentation.

[SVN r72079]
2011-05-22 15:35:09 +00:00
Daniel James
4e654322cb Quickbook: Change log entry for syntax highlighter changes.
[SVN r71601]
2011-04-29 11:02:55 +00:00
Daniel James
d8df74fe08 Doc tools: Combined documentation.
[SVN r71017]
2011-04-05 21:14:26 +00:00
Daniel James
eebdf1a915 Documentation: Merge documentation into quickbook branch.
[SVN r71012]
2011-04-05 19:49:50 +00:00
Daniel James
a8079d421d Quickbook: New branch for development.
From now on this will be my development branch.


[SVN r70613]
2011-03-27 10:17:05 +00:00
Daniel James
94a6d24e7b Quickbook: another missing changelog entry.
[SVN r70234]
2011-03-20 21:51:14 +00:00
Daniel James
ecedc66228 Quickbook: missing changelog entries.
[SVN r70233]
2011-03-20 21:50:12 +00:00
Daniel James
345f0a2648 Quickbook: pass-thru comments.
[SVN r70207]
2011-03-19 19:22:45 +00:00
Daniel James
4caec51e26 Quickbook: better anchor placement for lists.
[SVN r70206]
2011-03-19 19:18:51 +00:00
Daniel James
96e19b221a Quickbook: Go back to using invalid markup for lists.
[SVN r70191]
2011-03-19 15:27:51 +00:00
Daniel James
eef84701b9 Quickbook: note about nestable elements.
[SVN r70190]
2011-03-19 15:20:23 +00:00
Daniel James
6758230e52 Quickbook: fix simple markup.
[SVN r70184]
2011-03-19 14:33:47 +00:00
Daniel James
f977003c85 Richer copyright syntax.
[SVN r70178]
2011-03-19 11:58:26 +00:00
Daniel James
de6a388a35 Quickbook: merge 'values' from quickbook-filenames branch.
[SVN r70177]
2011-03-19 11:45:49 +00:00
Daniel James
1ffd3ed233 Quickbook: doc info improvements.
- Fix handling empty category attributes.
- Quickbook 1.6: Scope source mode changes to the file they're made in.



[SVN r70176]
2011-03-19 10:47:02 +00:00
Daniel James
13513830b5 Quickbook: better path support and undeprecate [br].
[SVN r70170]
2011-03-19 00:26:59 +00:00
Daniel James
badfd2d69c Quickbook: document recent changes.
[SVN r70051]
2011-03-17 09:07:28 +00:00
Daniel James
72de1779b1 Better wording about xsltproc on OS X.
[SVN r68567]
2011-01-30 12:51:05 +00:00
Daniel James
8b9dedf0e3 Use 'teletype' for syntax highlighting in quickbook docs.
[SVN r68558]
2011-01-30 10:51:47 +00:00
Daniel James
286007ec53 Update the quickbook installation instructions.
[SVN r68557]
2011-01-30 10:51:02 +00:00
Daniel James
d5dce8c46d Quickbook release notes.
[SVN r68556]
2011-01-30 10:50:00 +00:00
Daniel James
c9b5364585 Revert quickbook documentation changes.
Not abandoning them, I'll continue on a branch. There's just no need to do this
on trunk.


[SVN r68490]
2011-01-27 21:38:58 +00:00
Daniel James
034d70e562 Branch to work on filename handling without disturbing trunk.
[SVN r68345]
2011-01-21 09:17:08 +00:00
Daniel James
d4d728baf0 Update metadata.
[SVN r67891]
2011-01-09 21:16:24 +00:00
Daniel James
913e239cd9 More document metadata documentation.
[SVN r67890]
2011-01-09 21:15:47 +00:00
Daniel James
396f372820 Make the section documentation fit its new location better.
[SVN r67889]
2011-01-09 21:15:12 +00:00
Daniel James
6a15e79f03 Update links.
[SVN r67888]
2011-01-09 21:14:36 +00:00
Daniel James
1da1a19b9c Move section documentation into syntax section.
[SVN r67887]
2011-01-09 21:14:02 +00:00
Daniel James
1cd94b7cf3 Move the comments section after the document info section.
[SVN r67886]
2011-01-09 21:13:27 +00:00
Daniel James
a77b957c02 Start with a very simple quickbook document.
[SVN r67885]
2011-01-09 21:12:55 +00:00
Daniel James
ae7f22136d A bit more detail on document info.
[SVN r67884]
2011-01-09 21:12:24 +00:00
Daniel James
05fe74227c Move the document info section to the syntax section.
[SVN r67883]
2011-01-09 21:11:20 +00:00
Daniel James
b0cc667a2b Detab again.
[SVN r67638]
2011-01-03 22:19:35 +00:00
Daniel James
26dbdc09ec Fix tabs and files without copyright.
[SVN r67612]
2011-01-03 12:43:34 +00:00
Daniel James
96e128aef5 Quickbook changelog entries.
[SVN r67336]
2010-12-19 13:35:26 +00:00
Daniel James
a9f093e78e Release note for 'lang' support.
[SVN r67171]
2010-12-11 14:43:41 +00:00
Daniel James
e44df058dc Add a description of using a quickbook template to generate a link.
[SVN r67092]
2010-12-07 21:23:21 +00:00
Daniel James
f49bfd06fb Chunk the standalone quickbook docs in the same way as the main docs.
[SVN r66429]
2010-11-07 14:44:29 +00:00
Daniel James
20a79983e2 Start to document the differences between quickbook language versions.
[SVN r65452]
2010-09-18 17:58:24 +00:00
Daniel James
34a273adca Split the quickbook documentation into several files.
[SVN r65451]
2010-09-18 17:57:54 +00:00
Daniel James
dc42158789 Flatten the quickbook documentation hierarchy a little.
[SVN r65450]
2010-09-18 17:57:09 +00:00
Daniel James
d5a442d6a1 Comment all the 'endsect's in the quickbook documentation.
[SVN r65449]
2010-09-18 17:56:43 +00:00
Daniel James
53fec6d3f1 Nested blocks in document info comments.
[SVN r65448]
2010-09-18 17:56:15 +00:00
Daniel James
810642f159 Restore 1.43 style document fields.
Only xml encoding the fields, and supporting escapes with a 1.6 version
switch.

[SVN r65113]
2010-08-29 21:11:02 +00:00
Daniel James
8eeff84ac5 Don't escape docinfo fields for quickbook <= 1.2
[SVN r65005]
2010-08-25 20:28:15 +00:00
Daniel James
351442d050 Escapes in doc info fields.
[SVN r64988]
2010-08-24 19:47:46 +00:00
Daniel James
1dc08fd09c Nested code snippets.
[SVN r64976]
2010-08-23 21:51:53 +00:00
Daniel James
4b41d22c87 Merge multiple listitems in varlistentry.
Docbook only allows a single `listitem` in a `varlistentry` so combine
multiple items into a single item.

[SVN r64831]
2010-08-15 16:48:10 +00:00
Daniel James
aa69438440 Overhaul some of the template code.
* Store the location along with the contents of the template body, so
  the location should usually be correct now. Exceptions are code
  snippets, because they get rewritten, and the extra newlines added to
  block template.
* Store if a template is a block template at the time of creation. Using
  spirit to decide, rather than handwritten C++.
* Fix callout list markup.
* Fix the `skip_initial_spaces` stuff in `block.hpp`. This never really
  worked before. No longer have to skip spaces in `parse_template` in
  `actions.cpp`.

[SVN r64830]
2010-08-15 16:47:21 +00:00
Daniel James
e641698536 Better parser for code blocks.
* A line containing a comment with no identation will now end a code
  block.
* Code blocks no longer need to be followed by a blank line.

[SVN r64829]
2010-08-15 16:46:18 +00:00
Daniel James
6b6aad78a6 Ids for headings.
[SVN r64826]
2010-08-15 16:43:40 +00:00
Daniel James
8fe8e33699 Fix command line macros in quickbook.
[SVN r64825]
2010-08-15 16:41:54 +00:00
Daniel James
3dfa03deb7 Update bjam calls in quickbook docs.
[SVN r64138]
2010-07-18 16:49:01 +00:00
Daniel James
54938aef15 Restore the invalid doc info attributes.
Removing them breaks the release notes, there's still a warning that
they're invalid. Refs #1281

[SVN r63896]
2010-07-11 23:15:18 +00:00
Daniel James
1bc916f41f Generate different ids when reusing code snippets.
Generates the ids during template expansion instead of when parsing the
code snippet - so that different ids are used for different exapnsions.
Refs #4416

[SVN r63809]
2010-07-10 11:24:54 +00:00
Daniel James
df0ab8082e Organise the quickbook release notes a bit better.
[SVN r63764]
2010-07-08 20:49:52 +00:00
Daniel James
f3a52f99ee Fix duplicate image attribute detection.
[SVN r63735]
2010-07-08 07:14:03 +00:00
Daniel James
9d9721f79e Fix xml encoding in a few places.
[SVN r63734]
2010-07-08 07:13:26 +00:00
Daniel James
db2cfd0d79 Fix documentation info handling in included files. Refs #3907.
[SVN r63733]
2010-07-08 07:12:43 +00:00
Daniel James
3127d2fd1b Fix identifier generation for headings. Refs #1436.
[SVN r63732]
2010-07-08 07:11:58 +00:00
Daniel James
c8cdcd075e Don't match empty paragraphs.
[SVN r63611]
2010-07-04 16:55:58 +00:00
Daniel James
e3e2018a45 Allow empty document bodies.
[SVN r63610]
2010-07-04 16:55:24 +00:00
Daniel James
87b3423402 Keep the quickbook documentation compatible with the last version.
[SVN r63354]
2010-06-26 15:56:03 +00:00
Daniel James
7e299228fe Don't require commas between authors.
Makes the author grammar more consistent with the rest of quickbook.

[SVN r63342]
2010-06-26 12:09:56 +00:00
Daniel James
3d58eb2835 Fix images in quickbook docs.
[SVN r63154]
2010-06-20 18:05:21 +00:00
Daniel James
415f847cb0 Update various libraries' documentation build.
Mostly to use the images and css files under doc/src instead of
doc/html, usually be deleting the settings in order to use the defaults.
Also add 'boost.root' to some builds in order to fix links which rely on
it.

[SVN r63146]
2010-06-20 18:00:48 +00:00
Daniel James
52a5504cb4 Nested lists inside <simplepara>.
Not valid, but generates better html. Maybe I should use `<para>` inside
list items, and remove the margin using CSS.

[SVN r62701]
2010-06-10 00:15:41 +00:00
Daniel James
ebeaccff1e Use cygwin 1.7 path API.
[SVN r62472]
2010-06-06 07:24:10 +00:00
Daniel James
796b9eb078 Support multiple categories. Refs #1200.
[SVN r62471]
2010-06-06 07:23:44 +00:00
Daniel James
d61eb528cf Deal with invalid docinfo details. Refs #1281.
Warn when boostbook attributes are used for docbook document types and
don't output them.

[SVN r62470]
2010-06-06 07:23:09 +00:00
Daniel James
b572a6291a Fix the DOCTYPE generated by quickbook. Refs #1281
[SVN r62465]
2010-06-06 07:20:37 +00:00
Daniel James
24d80fe886 Prep for 1.5.2
[SVN r62463]
2010-06-06 07:19:21 +00:00
Daniel James
ca6a308852 Add missing change to quickbook documentation.
[SVN r61398]
2010-04-19 07:56:49 +00:00
Daniel James
d2c6ff1175 Fix some inspect errors.
[SVN r61057]
2010-04-05 07:24:27 +00:00
Daniel James
2fe5e11ec2 32 bit unicode characters.
[SVN r60387]
2010-03-09 20:58:01 +00:00
Daniel James
99f39528f3 Escape a couple of equal signs. Refs #3906.
[SVN r60377]
2010-03-09 08:18:23 +00:00
Daniel James
6a90a09d50 Of course, only 16 bit values are supported
[SVN r60330]
2010-03-07 21:02:17 +00:00
Daniel James
3128fdf646 Quickbook changes.
[SVN r60287]
2010-03-07 10:46:39 +00:00
Daniel James
a44a972cc8 Make table example output match code. Refs #3794.
[SVN r58523]
2009-12-24 01:48:08 +00:00
Daniel James
5ef47624ae Mention that image attributes are supported.
[SVN r56989]
2009-10-18 20:18:43 +00:00
Daniel James
f9f5b8a25e Add table ids to the documentation.
[SVN r56719]
2009-10-11 18:21:48 +00:00
Daniel James
1cdfbb519c Use quickbook 1.5 in the document block example.
[SVN r56718]
2009-10-11 18:21:32 +00:00
Daniel James
42a4d94ee2 Document the simplified quickbook 1.5 argument separators.
[SVN r56717]
2009-10-11 18:21:11 +00:00
Daniel James
3b839f1eb0 Ignore spaces after 'section:' for quickbook 1.5+ Refs #2712
And warn when section id is empty after colon.

[SVN r55911]
2009-08-31 11:37:32 +00:00
Daniel James
d2e0488349 Implement static/lexical scoping for 1.5. Refs #2034.
[SVN r55908]
2009-08-31 11:36:47 +00:00
Daniel James
cf94d24976 Create entry for 1.5 in the change log.
Starting it of with some of the changes that have been made to quickbook
since 1.4 - considering the first 1.4 release as the proper 1.4 release.

[SVN r55906]
2009-08-31 11:36:23 +00:00
Daniel James
a087316841 Teletype source mode. Refs #1202.
[SVN r54815]
2009-07-08 21:40:46 +00:00
Daniel James
573d7b76f5 Document 'boost:' links in boostbook & quickbook.
Fixes #2861.

[SVN r52352]
2009-04-12 11:21:59 +00:00
Daniel James
ecccb9dc0d Try to make anchor and link usage a little clearer.
Refs #1213, #2701

[SVN r51508]
2009-03-01 14:16:44 +00:00
John Maddock
46f3da7bc8 Add PDF generation options to fix external links to point to the web site.
Added a few more Boostbook based libs that were missed first time around.
Fixed PDF naming issues.

[SVN r51284]
2009-02-17 10:05:58 +00:00
Daniel James
bd041be9d9 Use the new 'boost:' links for the hash, unordered and quickbook documentation.
[SVN r51262]
2009-02-15 19:32:04 +00:00
John Maddock
f5f25404db Add Jamfile to build PDF versions of all the docs.
Tweaked some existing Jamfiles so that PDF build finds all the necessary image files etc.
Tweaked fo.xsl to provide more options by default, and improve formatting.

[SVN r51104]
2009-02-08 16:59:14 +00:00
Daniel James
daae2996ac Remove the prebuilt version of quickbook.
[SVN r48930]
2008-09-23 19:44:39 +00:00
Daniel James
28bd954c59 Change quickbook so that the links are relative to the combined documentation.
[SVN r48929]
2008-09-23 19:44:20 +00:00
Eric Niebler
c1f8c71486 add globalref tag for linking to the reference section for a global object
[SVN r47862]
2008-07-29 05:52:35 +00:00
Joel de Guzman
e3d132e111 - doc updates
- rudementary template debugging
- template bug! added in test

[SVN r45598]
2008-05-21 06:29:33 +00:00
Joel de Guzman
2dc9c694ac refresh docs
[SVN r41081]
2007-11-14 10:23:23 +00:00
Joel de Guzman
a742647220 added copyright and license info for each page.
[SVN r40872]
2007-11-07 03:37:51 +00:00
Joel de Guzman
02a18c39d1 added copyright and license info for each page.
[SVN r40870]
2007-11-07 03:30:01 +00:00
Joel de Guzman
656cf57d00 fixed [cpp] to [c++]
[SVN r40733]
2007-11-03 23:42:06 +00:00
Rene Rivera
fbc4fea44c Merge search path for include & import from backend branch. And add corresponding support for <include> to BBv2 quickbook tool. Remove obsolete quickbook.xml file. (fixes #1263)
[SVN r40469]
2007-10-26 01:02:48 +00:00
Joel de Guzman
b3289d4223 added new import syntax for ignoring code.
[SVN r39497]
2007-09-24 06:03:12 +00:00