From c327b26a617c6921ae01460ebc2ff8311101bc24 Mon Sep 17 00:00:00 2001 From: Nikita Kniazev Date: Mon, 18 Feb 2019 01:16:21 +0300 Subject: [PATCH 1/3] dtd2boostbook.xsl: Use `chapter` element instead of `section` Backport manual `reference.xml` edit 895142ea8db9501e32c5ae69f38b5644997a0c50 --- xsl/dtd/dtd2boostbook.xsl | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/xsl/dtd/dtd2boostbook.xsl b/xsl/dtd/dtd2boostbook.xsl index 38bf815..e76d6df 100644 --- a/xsl/dtd/dtd2boostbook.xsl +++ b/xsl/dtd/dtd2boostbook.xsl @@ -18,7 +18,7 @@ -
+ Reference Elements: @@ -29,7 +29,7 @@ -
+ From 6db0b9e93a9bcf9fdc2635e9b682f19769b2c037 Mon Sep 17 00:00:00 2001 From: Nikita Kniazev Date: Mon, 18 Feb 2019 01:17:39 +0300 Subject: [PATCH 2/3] dtd2boostbook.xsl: Added copyright to the output Backport manual `reference.xml` edit 7484e56d455ef01a5f82590f7b02532158dc141d --- xsl/dtd/dtd2boostbook.xsl | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/xsl/dtd/dtd2boostbook.xsl b/xsl/dtd/dtd2boostbook.xsl index e76d6df..c0fd969 100644 --- a/xsl/dtd/dtd2boostbook.xsl +++ b/xsl/dtd/dtd2boostbook.xsl @@ -18,6 +18,15 @@ + + Copyright (c) 2002 Douglas Gregor <doug.gregor -at- gmail.com> + + Distributed under the Boost Software License, Version 1.0. + (See accompanying file LICENSE_1_0.txt or copy at + http://www.boost.org/LICENSE_1_0.txt) + + This file is automatically generated by dtd2boostbook.xsl + Reference From 2ba31e6c17e445b30f25692bb310237d421d7fc2 Mon Sep 17 00:00:00 2001 From: Nikita Kniazev Date: Sat, 16 Feb 2019 22:58:16 +0300 Subject: [PATCH 3/3] Added reference.xml auto-generation from dtdxml This should have been an established process, but for some reason it was edited manually after initial generation. After the change `reference.xml` can be removed from the repository, but I left it to show that the things are working fine and the difference from an auto-generated one are simple divergences due to manual changing (not updated `reference.xml` with added `` elements in 38017203f69cec3aa5f402fe8306eb1deff67b9a). Also removed the date numbers from `dtdxml` as they were never in `xml` and seems to have no actual use, but brings a lot of noise to `xml` differences after added auto-generation. --- doc/Jamfile.v2 | 4 ++++ doc/reference.dtdxml | 2 +- doc/reference.xml | 15 ++++++++------- 3 files changed, 13 insertions(+), 8 deletions(-) diff --git a/doc/Jamfile.v2 b/doc/Jamfile.v2 index d09d3de..db7f79b 100644 --- a/doc/Jamfile.v2 +++ b/doc/Jamfile.v2 @@ -7,7 +7,11 @@ project boostbook/doc ; import boostbook : boostbook ; +xml reference : reference.dtdxml : . ; +explicit reference ; + boostbook boostbook : boostbook.xml : boost.root=../../../.. + reference ; diff --git a/doc/reference.dtdxml b/doc/reference.dtdxml index 35267e8..e79dcfb 100644 --- a/doc/reference.dtdxml +++ b/doc/reference.dtdxml @@ -11,7 +11,7 @@ created-on="Wed Feb 18 23:39:45 2009" > A global identifier for this element -Set to $Date: 2003/04/13 14:46:07 $ to keep "last revised" information in sync with CVS changes +Set to $Date$ to keep "last revised" information in sync with CVS changes Implementation detail used by XIncludes The name of the element being declared to referenced The name of the file associated with this element diff --git a/doc/reference.xml b/doc/reference.xml index d4c56a5..4786b7e 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -1,11 +1,13 @@ + + This file is automatically generated by dtd2boostbook.xsl +--> Reference Elements:Element access - Declares an access specification for class membersElement boostbook - Defines a BoostBook bookElement class - Declares a class or class templateElement class-specialization - A specialization (partial or full) of a class templateElement code - Mimics the code tag in HTMLElement compile-fail-test - A testcase that should fail to compileElement compile-test - A testcase that should compile correctlyElement complexity - The time/space/etc. complexity of a functionElement constructor - Declares a constructor of the enclosing classElement copy-assignment - Declares a copy-assignment operatorElement data-member - Declares a data member of a classElement default - The default value of a function or template parameterElement description - Detailed description of a constructElement destructor - Declares a destructor for the enclosing classElement effects - Declares the side effects of a functionElement enum - Declares an enumeration typeElement enumname - References an enumeration type with the given nameElement enumvalue - A single value of an enumerationElement free-function-group - A set of functions that are grouped together under one nameElement function - Declares a functionElement functionname - References a function with the given nameElement globalname - References a global with the given nameElement header - Declares a C++ header with the given nameElement headername - References a C++ header with the given nameElement if-fails - What it means when a testcase failsElement inherit - Declares a base class of the enclosing class or structElement lib - A library dependencyElement library - Top-level element for a libraryElement library-reference - Declares the reference material for a libraryElement librarycategory - Declares that the enclosing library is in this categoryElement librarycategorydef - Defines a new library categoryElement librarycategorylist - Categorized listing of librariesElement libraryinfo - Provides information about a libraryElement librarylist - Placeholder for an alphabetical list of librariesElement libraryname - References a library of the given nameElement librarypurpose - Describes in one short sentence or phrase the purpose of a libraryElement link-fail-test - Declares a test that should compile but fail to linkElement link-test - Declares a test that should compile and linkElement macroname - References a macro with the given nameElement method - Declares a method, i.e., a member functionElement method-group - A set of methods that are grouped together under one nameElement namespace - Declares a namespaceElement notes - Non-normative notes about a function's semanticsElement overloaded-function - An overloaded functionElement overloaded-method - An overloaded methodElement parameter - A function parameterElement paramtype - The type of a function parameterElement postconditions - Conditions that must hold after the function returnsElement precondition - Conditions that must be met prior to executing a functionElement programlisting - A sample of program codeElement purpose - A short description of an entity's useElement rationale - Describes the rationale for a particular function's designElement requirement - A requirement/property in the Jamfile for a testcaseElement requires - Declares the requirements of a functionElement returns - Description of the return value of a functionElement run-fail-test - A testcase that should compile and link, but fail on executionElement run-test - A testcase that should compile, link, and executeElement signature - One signature of an overloaded function or methodElement snippet - Pulls in a code snippet from a programlisting elementElement source - Defines source code for a testElement specialization - Defines the specialization arguments for a class specializationElement static-constant - Declares a static constant, e.g., const int foo = 5;.Element struct - Declares a C++ structElement struct-specialization - A specialization (full or partial) of a struct templateElement template - Declares the template parameters of a class or functionElement template-arg - A template argument in a specializationElement template-nontype-parameter - A nontype template parameterElement template-type-parameter - Declares a template type parameterElement template-varargs - Declares a variable-length list of template parametersElement testsuite - Describes a library testsuiteElement throws - Description of the exceptions thrown by a functionElement type - The type of an element or return type of a functionElement typedef - Declares a typedefElement union - Declares a C++ union or union templateElement union-specialization - A specialization (full or partial) of a union templateElement using-class - Injects the method and function names of a class into the local scopeElement using-namespace - Injects the declared names from a namespace into the local scope @@ -735,7 +737,7 @@ macroname - + References a macro with the given name macroname ::= (#PCDATA) @@ -1031,7 +1033,7 @@ headername - + References a C++ header with the given name headername ::= (#PCDATA) @@ -1396,7 +1398,7 @@ globalname - + References a global with the given name globalname ::= (#PCDATA) @@ -2549,7 +2551,7 @@ enumname - + References an enumeration type with the given name enumname ::= (#PCDATA) @@ -2948,4 +2950,3 @@ -