42 Commits

Author SHA1 Message Date
Daniel James
b684ebaa7c Boostbook: Merge from trunk.
- Template parameter documentation.
- Don't print an empty table/hr in header if there is not image or
  navigation info.
- Initial mathjax support.


[SVN r75947]
2011-12-14 22:42:18 +00:00
Daniel James
8a73555c3e Merge boostbook (mostly by Steven Watanabe).
* New faster highlighter.
* Optimized namelookup.
* Separate out some of the common html xsl (supports Boost.Test docs).
* Tweaks to optimize boostbook to html conversion.
* Bug in cxx-name-lookup.
* Use images under doc/src.


[SVN r63678]
2010-07-06 00:12:00 +00:00
Daniel James
6425f26f09 Merge most of the recent changes to quickbook and boostbook.
Left out doxygen changes: [51323],[51324],[51680]
And a quickbook change which might be a breaking change: [51403]

Fixes #1977, #1170, #1213, #2701.
Refs #2153, #2771.

Merged revisions 51268-51269,51319-51321,51370-51372,51388-51389,51401-51402,51405-51406,51508,51647,51696 via svnmerge from 
https://svn.boost.org/svn/boost/trunk

........
  r51268 | johnmaddock | 2009-02-16 10:39:18 +0000 (Mon, 16 Feb 2009) | 1 line
  
  Add default path for callouts.
........
  r51269 | johnmaddock | 2009-02-16 10:40:26 +0000 (Mon, 16 Feb 2009) | 1 line
  
  Add preliminary HTMLHelp support.
........
  r51319 | danieljames | 2009-02-18 21:22:37 +0000 (Wed, 18 Feb 2009) | 1 line
  
  Remove long out of date warning.
........
  r51320 | danieljames | 2009-02-18 21:23:13 +0000 (Wed, 18 Feb 2009) | 1 line
  
  Write out the quickbook options when the file is missing.
........
  r51321 | danieljames | 2009-02-18 21:23:35 +0000 (Wed, 18 Feb 2009) | 1 line
  
  Add default path for callouts to xhtml.
........
  r51370 | danieljames | 2009-02-21 18:50:00 +0000 (Sat, 21 Feb 2009) | 4 lines
  
  Regenerate boostbook reference documentation and merge with existing
  documentation.
  
  Ref #2153
........
  r51371 | danieljames | 2009-02-21 18:50:14 +0000 (Sat, 21 Feb 2009) | 1 line
  
  Fix links in standalone boostbook documentation.
........
  r51372 | danieljames | 2009-02-21 18:50:25 +0000 (Sat, 21 Feb 2009) | 3 lines
  
  Change license in boostbook docs to boost license.
  
  Douglas Gregor is listed in the blanket permissions file.
........
  r51388 | danieljames | 2009-02-22 11:54:01 +0000 (Sun, 22 Feb 2009) | 1 line
  
  This DTD isn't stable, so I'm calling it a 'development' version. Which is probably wrong, but there you go.
........
  r51389 | danieljames | 2009-02-22 11:54:18 +0000 (Sun, 22 Feb 2009) | 2 lines
  
  Support the alt tag in headername and macroname. Also make headername
  and macroname valid. Refs #1977
........
  r51401 | danieljames | 2009-02-22 23:47:51 +0000 (Sun, 22 Feb 2009) | 8 lines
  
  Add a purpose for macroname, headername, enumname, globalname.
  
  Ref #2153: There's still no documentation for methodname and classname.
  These are actually defined in the docbook DTD for a different purpose so
  I'm not sure how to deal with them.
  
  http://www.docbook.org/tdg/en/html/methodname.html
  http://www.docbook.org/tdg/en/html/classname.html
........
  r51402 | danieljames | 2009-02-22 23:48:37 +0000 (Sun, 22 Feb 2009) | 7 lines
  
  Generate slightly more valid boostbook.
  
  For document types other than library:
  * Don't generate name or dirname for document types.
  * Put title before document info.
  
  Ref #2771
........
  r51405 | danieljames | 2009-02-22 23:49:21 +0000 (Sun, 22 Feb 2009) | 3 lines
  
  Print out unexpected characters as errors.
  
  Ref #1170
........
  r51406 | danieljames | 2009-02-22 23:49:36 +0000 (Sun, 22 Feb 2009) | 1 line
  
  Better handling of errors without line numbers.
........
  r51508 | danieljames | 2009-03-01 14:16:44 +0000 (Sun, 01 Mar 2009) | 3 lines
  
  Try to make anchor and link usage a little clearer.
  
  Refs #1213, #2701
........
  r51647 | danieljames | 2009-03-08 09:45:51 +0000 (Sun, 08 Mar 2009) | 1 line
  
  Display text purposes in function reference.
........
  r51696 | johnmaddock | 2009-03-11 10:22:42 +0000 (Wed, 11 Mar 2009) | 1 line
  
  Set margins to 0pt so they line up with surrounding text rather than appearing outside it - prevents margins from overlapping other content.
........


[SVN r51774]
2009-03-14 11:42:38 +00:00
Daniel James
f5c41d9194 Merged revisions 49661-49662,49666,49669,49735,49756,49770,49811 via svnmerge from
https://svn.boost.org/svn/boost/trunk

........
  r49661 | danieljames | 2008-11-09 12:03:45 +0000 (Sun, 09 Nov 2008) | 1 line
  
  Move hash detail headers out of boost/functional/detail.
........
  r49662 | danieljames | 2008-11-09 12:11:50 +0000 (Sun, 09 Nov 2008) | 1 line
  
  Add a forwarding header for container_fwd.hpp
........
  r49666 | danieljames | 2008-11-09 19:12:05 +0000 (Sun, 09 Nov 2008) | 1 line
  
  Avoid comparing default initialised iterators in position_iterator.
........
  r49669 | danieljames | 2008-11-09 21:57:38 +0000 (Sun, 09 Nov 2008) | 2 lines
  
  Add link to the header to the synopsis in reference documentation.
  Refs #2214
........
  r49735 | danieljames | 2008-11-14 12:51:00 +0000 (Fri, 14 Nov 2008) | 1 line
  
  Explicitly specify the template parameters in the unordered container friend, in order to avoid some warnings.
........
  r49756 | danieljames | 2008-11-14 16:11:16 +0000 (Fri, 14 Nov 2008) | 1 line
  
  Use pragmas to suppress a Visual C++ warning.
........
  r49770 | danieljames | 2008-11-15 13:07:29 +0000 (Sat, 15 Nov 2008) | 1 line
  
  Use the new swap library.
........
  r49811 | danieljames | 2008-11-16 23:10:00 +0000 (Sun, 16 Nov 2008) | 1 line
  
  Fix a typo.
........


[SVN r49855]
2008-11-20 22:53:20 +00:00
Daniel James
aa95798fbe Add link to the header to the synopsis in reference documentation.
Refs #2214

[SVN r49669]
2008-11-09 21:57:38 +00:00
Daniel James
a25bf63826 Merge in boostbook changes, fixes free-function-group and adds support for variadic parameters.
Merged revisions 45298-45302,45308-45338,45340-45345,45348-45352,45356-45358,45360-45377,45379-45392,45394,45396-45408,45410-45420,45424-45444,45448,45450-45455,45457-45478,45480,45484-45544,45546-45549,45551-45564,45566-45569,45571-45572,45575,45578-45584,45586-45593,45595-45597,45599,45605,45610-45618,45622-45624,45628-45632,45634-45637,45639-45644,45646,45648-45652,45654-45656,45666,45668-45670,45674-45675,45679-45680,45683-45684,45687,45691,45706-45708,45710-45741 via svnmerge from 
https://svn.boost.org/svn/boost/trunk

................
  r45298 | fmhess | 2008-05-12 14:59:20 +0100 (Mon, 12 May 2008) | 6 lines
  
  Prevent a class' or namespace's associated free functions
  (a "free-function-group" element inside a "class" or "namespace" element)
  from reappearing in the synopsis of nested classes or namespaces.
  This is a merge of revision 45297 from the boost_docs sandbox.
................
  r45741 | danieljames | 2008-05-25 17:14:17 +0100 (Sun, 25 May 2008) | 35 lines
  
  Support for variadic parameters.
  
  Merged revisions 44832-44957,44959-44995,44997-45128,45132-45135 via svnmerge from 
  https://svn.boost.org/svn/boost/branches/doc
  
  ........
    r44832 | danieljames | 2008-04-28 07:55:01 +0100 (Mon, 28 Apr 2008) | 2 lines
    
    Add variadic attribute to template type parameters.
  ........
    r44943 | danieljames | 2008-04-30 20:27:32 +0100 (Wed, 30 Apr 2008) | 1 line
    
    Back out my half-done support for variadic template parameters.
  ........
    r44994 | danieljames | 2008-05-01 21:52:59 +0100 (Thu, 01 May 2008) | 1 line
    
    Support for variadic template parameters.
  ........
    r45132 | danieljames | 2008-05-05 12:37:35 +0100 (Mon, 05 May 2008) | 2 lines
    
    Rename variadic attributes pack.
  ........
    r45133 | danieljames | 2008-05-05 12:37:50 +0100 (Mon, 05 May 2008) | 2 lines
    
    Support for function parameter packs.
  ........
    r45134 | danieljames | 2008-05-05 12:38:08 +0100 (Mon, 05 May 2008) | 2 lines
    
    Support for inherited pack expansions.
  ........
    r45135 | danieljames | 2008-05-05 12:38:25 +0100 (Mon, 05 May 2008) | 2 lines
    
    Support for pack expansions in template specializations.
  ........
................


[SVN r46414]
2008-06-15 19:48:40 +00:00
Daniel James
843e939404 Support for variadic parameters.
Merged revisions 44832-44957,44959-44995,44997-45128,45132-45135 via svnmerge from 
https://svn.boost.org/svn/boost/branches/doc

........
  r44832 | danieljames | 2008-04-28 07:55:01 +0100 (Mon, 28 Apr 2008) | 2 lines
  
  Add variadic attribute to template type parameters.
........
  r44943 | danieljames | 2008-04-30 20:27:32 +0100 (Wed, 30 Apr 2008) | 1 line
  
  Back out my half-done support for variadic template parameters.
........
  r44994 | danieljames | 2008-05-01 21:52:59 +0100 (Thu, 01 May 2008) | 1 line
  
  Support for variadic template parameters.
........
  r45132 | danieljames | 2008-05-05 12:37:35 +0100 (Mon, 05 May 2008) | 2 lines
  
  Rename variadic attributes pack.
........
  r45133 | danieljames | 2008-05-05 12:37:50 +0100 (Mon, 05 May 2008) | 2 lines
  
  Support for function parameter packs.
........
  r45134 | danieljames | 2008-05-05 12:38:08 +0100 (Mon, 05 May 2008) | 2 lines
  
  Support for inherited pack expansions.
........
  r45135 | danieljames | 2008-05-05 12:38:25 +0100 (Mon, 05 May 2008) | 2 lines
  
  Support for pack expansions in template specializations.
........


[SVN r45741]
2008-05-25 16:14:17 +00:00
Beman Dawes
924c854286 Merged tools, system, filesystem from trunk at 41106
[SVN r41109]
2007-11-15 16:31:06 +00:00
Frank Mori Hess
abc4097abf Fixed spurious paragraph in html output for overloaded
methods.



[SVN r40702]
2007-11-02 22:37:52 +00:00
Frank Mori Hess
677773ea5b Added support for new boostbook <access> element for documenting non-public
class members.

function.xsl, type.xsl, utility.xsl: Added support for <access> elements to
allow nonpublic access specifiers for class member documentation.

boostbook.dtd: Updated to reflect new <access> element.  Updated Peter Simons
email address.  Added mention of boost license.

reference.dtdxml: Added reference documentation for new <access> element.
Removed some obsolete remarks from the description of inherit element.

reference.xml: The changes to this file were generated by applying
dtd2boostbook.xsl to the updated reference.dtdxml file.



[SVN r40555]
2007-10-29 15:18:49 +00:00
Rene Rivera
f53d31a77f (merge from head) Fix minor validation problem with boostbook.
[SVN r36045]
2006-11-15 17:58:35 +00:00
Rene Rivera
3c43a8045c Fix minor validation problem with boostbook.
[SVN r36044]
2006-11-15 17:46:40 +00:00
Rene Rivera
22a192bce4 Cross merge HEAD and RC_1_34_0.
[SVN r36024]
2006-11-13 16:24:38 +00:00
Rene Rivera
835e482af7 Cross merge HEAD and RC_1_34_0.
[SVN r36024]
2006-11-13 16:24:38 +00:00
Douglas Gregor
6abbba874f Fix inspection problems
[SVN r35827]
2006-11-03 19:41:10 +00:00
Douglas Gregor
c6499c1345 Unnamed parameter fix, from Julio M. Merino Vidal
[SVN r34797]
2006-08-01 14:00:22 +00:00
Eric Niebler
1ba762e2d0 use fixed-width font for parameter names in doxygen-generated parameter lists
[SVN r33483]
2006-03-27 04:31:12 +00:00
Eric Niebler
94f520b924 use fixed-width font for parameter names in doxygen-generated parameter lists
[SVN r33483]
2006-03-27 04:31:12 +00:00
Eric Niebler
09f9e1620c improve layout for Doxygen-generated function documentation
[SVN r33445]
2006-03-22 18:46:39 +00:00
Eric Niebler
0f83dbdf6f improve layout for Doxygen-generated function documentation
[SVN r33445]
2006-03-22 18:46:39 +00:00
Douglas Gregor
24621811da Some cosmetic tweaks to get rid of empty synopses, empty function groups, and use more nested directories
[SVN r33018]
2006-02-20 03:09:03 +00:00
Douglas Gregor
60c318f225 Move function parameter documentation after the description
[SVN r24673]
2004-08-23 15:21:35 +00:00
Douglas Gregor
aece427f54 Deal with parameter documentation in overloaded functions
[SVN r23387]
2004-07-07 04:19:11 +00:00
Douglas Gregor
9ea136fecd docbook.xsl, function.xsl, macro.xsl, type.xsl:
- Allow BoostBook markup in <purpose>


[SVN r23330]
2004-07-03 22:20:11 +00:00
Douglas Gregor
91c19f9b91 function.xsl: Fix problem with ungrouped methods
[SVN r21065]
2003-12-02 06:08:29 +00:00
Douglas Gregor
02fd5d3611 function.xsl: Default values can not be annotated
doxygen/doxygen2boostbook.xsl: If the string "detail::" is found in a
type or default argument, the type/argument is replaced with
"unspecified".


[SVN r20810]
2003-11-15 05:36:47 +00:00
Douglas Gregor
075fcc3cbd doxygen/doxygen2boostbook.xsl: Don't strip <para> elements from within
(generated) <purpose> elements; just make them <simpara> elements.

annotation.xsl: Added a "purpose" mode that strips paragraph elements
for printing the purpose in a comment

function.xsl: Don't compact methods or overloaded methods.


[SVN r20499]
2003-10-27 01:13:34 +00:00
Douglas Gregor
c1cdd4526f Put some extra spacing before function synopsis that have a comment.
[SVN r20498]
2003-10-26 23:40:18 +00:00
Douglas Gregor
5bbddee283 Strip <para> and <simpara> elements when printing the purpose of a
function into the synopsis (because it has no detailed documentation).


[SVN r20497]
2003-10-26 23:35:29 +00:00
Douglas Gregor
e9232f91cc Fix missing return type for copy assignment operators
[SVN r20103]
2003-09-18 19:59:48 +00:00
Douglas Gregor
ebb5873362 - Highlight the function name when printing it, so "operator" gets
highlighted for overloaded operators


[SVN r20098]
2003-09-18 18:43:12 +00:00
Douglas Gregor
ae2938aa76 function.xsl: Do proper highlighting/linking for the return types of
functions


[SVN r20096]
2003-09-18 18:38:51 +00:00
Douglas Gregor
a6666cd27a function.xsl:
- Don't link entire function declaration; just link the name.


[SVN r19842]
2003-08-28 21:43:09 +00:00
Douglas Gregor
1689acb635 - use generate.id instead of generate-id
- Add the "-bb" suffix to id names generated by generate-id


[SVN r19756]
2003-08-23 15:54:46 +00:00
Douglas Gregor
d1ab30b7f1 Don't highlight a full declaration if the template header was placed on a
separate line.


[SVN r19061]
2003-07-11 16:09:47 +00:00
Douglas Gregor
bfa67ad183 dtd/boostbook.dtd:
- Parameters can now have <description> elements
	- Add function specifiers

xsl/function.xsl:
	- When needed, place function return type on a separate line
	- Format <description> element for parameters
	- Use "spacing=boost" for variablelists used for function requirements

xsl/doxygen/doxygen2boostbook.xsl:
	- Emit <description> elements for parameters when available
	- Properly translate file descriptions


[SVN r18963]
2003-07-07 15:31:34 +00:00
Douglas Gregor
2f878b7612 function.xsl:
- Use arabic numbering for semantic clauses

collect.xsl:
  - Accept the input directory as a stylesheet parameter

doxygen2boostbook.xsl:
  - Update for recent changes in the BoostBook XML format


[SVN r18242]
2003-04-13 14:44:38 +00:00
Douglas Gregor
ce3af72b76 function.xsl: Remove the <formalpara> stuff from the 'standardese' generation
mode. It looks silly at the moment.


[SVN r18184]
2003-04-04 21:37:30 +00:00
Douglas Gregor
9c4a80af08 function.xsl, template.xsl, type.xsl:
- Deal with changes in the DTD

html.xsl, html-single.xsl:
  - Better handling of function semantic clauses


[SVN r17940]
2003-03-15 23:11:32 +00:00
Douglas Gregor
d2e78d320f Use description element in functions
[SVN r17935]
2003-03-15 21:36:10 +00:00
Douglas Gregor
c9c1f578ca use the generate.id template, not generate-id
[SVN r17925]
2003-03-14 21:39:17 +00:00
Douglas Gregor
df433e64bd Imported BoostBook XSL stylesheets and DTD
[SVN r17862]
2003-03-12 22:01:44 +00:00