From fc1ef0776f8b0e2d96960e74669b80cfc1337aff Mon Sep 17 00:00:00 2001 From: rankoo Date: Fri, 16 Jul 2010 14:49:58 +0000 Subject: [PATCH] Stylesheets for API support --- xsl/api/caramel/LICENSE | 58 + xsl/api/caramel/concept2docbook.xsl | 812 +++++++++++++ xsl/api/caramel/cpp-operators.xml | 288 +++++ xsl/api/caramel/unparser.xsl | 497 ++++++++ xsl/api/doxygen/collect.xsl | 58 + xsl/api/doxygen/doxygen2boostbook.xsl | 1541 +++++++++++++++++++++++++ xsl/api/dtd/dtd2boostbook.xsl | 217 ++++ xsl/api/testing/Jamfile.xsl | 243 ++++ xsl/api/testing/testsuite.xsl | 118 ++ 9 files changed, 3832 insertions(+) create mode 100644 xsl/api/caramel/LICENSE create mode 100644 xsl/api/caramel/concept2docbook.xsl create mode 100644 xsl/api/caramel/cpp-operators.xml create mode 100644 xsl/api/caramel/unparser.xsl create mode 100644 xsl/api/doxygen/collect.xsl create mode 100644 xsl/api/doxygen/doxygen2boostbook.xsl create mode 100644 xsl/api/dtd/dtd2boostbook.xsl create mode 100644 xsl/api/testing/Jamfile.xsl create mode 100644 xsl/api/testing/testsuite.xsl diff --git a/xsl/api/caramel/LICENSE b/xsl/api/caramel/LICENSE new file mode 100644 index 000000000..d26de04a0 --- /dev/null +++ b/xsl/api/caramel/LICENSE @@ -0,0 +1,58 @@ +Software License, Version 1.0 + +Copyright 2002-2003, Trustees of Indiana University. +Copyright 2000-2001, University of Notre Dame. +All rights reserved. + +Indiana University has the exclusive rights to license this product under the +following license. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + * All redistributions of source code must retain the above copyright notice, + the list of authors in the original source code, this list of conditions + and the disclaimer listed in this license; + + * All redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the disclaimer listed in this license + in the documentation and/or other materials provided with the distribution; + + * Any documentation included with all redistributions must include the + following acknowledgement: + + "This product includes software developed at the University of Notre Dame + and the Pervasive Technology Labs at Indiana University. For technical + information contact Andrew Lumsdaine at the Pervasive Technology Labs at + Indiana University. For administrative and license questions contact the + Advanced Research and Technology Institute at 351 West 10th Street. + Indianapolis, Indiana 46202, phone 317-278-4100, fax 317-274-5902." + + Alternatively, this acknowledgement may appear in the software itself, and + wherever such third-party acknowledgments normally appear. + + * The name Indiana University, the University of Notre Dame or "Caramel" + shall not be used to endorse or promote products derived from this software + without prior written permission from Indiana University. For written + permission, please contact Indiana University Advanced Research & + Technology Institute. + + * Products derived from this software may not be called "Caramel", nor may + Indiana University, the University of Notre Dame or "Caramel" appear in + their name, without prior written permission of Indiana University Advanced + Research & Technology Institute. + +Indiana University provides no reassurances that the source code provided does +not infringe the patent or any other intellectual property rights of any other +entity. Indiana University disclaims any liability to any recipient for claims +brought by any other entity based on infringement of intellectual property +rights or otherwise. + +LICENSEE UNDERSTANDS THAT SOFTWARE IS PROVIDED "AS IS" FOR WHICH NO WARRANTIES +AS TO CAPABILITIES OR ACCURACY ARE MADE. INDIANA UNIVERSITY GIVES NO WARRANTIES +AND MAKES NO REPRESENTATION THAT SOFTWARE IS FREE OF INFRINGEMENT OF THIRD +PARTY PATENT, COPYRIGHT, OR OTHER PROPRIETARY RIGHTS. INDIANA UNIVERSITY MAKES +NO WARRANTIES THAT SOFTWARE IS FREE FROM "BUGS", "VIRUSES", "TROJAN HORSES", +"TRAP DOORS", "WORMS", OR OTHER HARMFUL CODE. LICENSEE ASSUMES THE ENTIRE RISK +AS TO THE PERFORMANCE OF SOFTWARE AND/OR ASSOCIATED MATERIALS, AND TO THE +PERFORMANCE AND VALIDITY OF INFORMATION GENERATED USING SOFTWARE. diff --git a/xsl/api/caramel/concept2docbook.xsl b/xsl/api/caramel/concept2docbook.xsl new file mode 100644 index 000000000..655498066 --- /dev/null +++ b/xsl/api/caramel/concept2docbook.xsl @@ -0,0 +1,812 @@ + + + + + + + + + + + + + + + + + + + + + + Concept + 7 + + + + + + + + + + + + + + + + + Description + + + + + + + + + + Refinement of + + + + + + + + + + + + + + + + + When mutable: + + + + + + + + + + + + + + + + + + @(@=@)@ + + + + + + + + + + + + + + + + + + + @@(@@ + + + + + @@=@@@@)@@ + + + + + + + + Definitions + +

+ + + + + + + Type expressions + + + + + + + + + + + + + + + + + + + + + + Only when mutable + + + + + + + + + + + + + + + + + + + + + + + + + + + + + must be + + , + and + + + + + + . + + + + + + + + + + + + + + + + + Valid expressions + + + + T + + + P + + + S + + + O + + + + + + + + + + + Name + Expression + + Type + + + Precondition + + + Semantics + + + Postcondition + + + + + + + + + + + + + + + + + + + Complexity + + + + + + + + + Invariants + + + + + + + + + + + + + + + + Models + + + + + + + + + + + + + + + + + + + + + + + + + + See also + + + + + + + + + + + + + + + + + + + + + + + + + + + + identical to + + + + + + + + + + + convertible to + Convertible to + convertible to + + + + + + + + + + + + derived from + Derived from + derived from + + + + + + + + + + + + assignable to + Assignable to + assignable to + + + + + + + + + + + + a model + Models + models + + + (along with + + + + + + + + and + , and + , + + ) + + of + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Associated types + + + + + + + + + + + + + + + + + + + + + + + Name + Code + Description + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + and + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Notation + + + + + + + A type playing the role of + + in the + + + + concept. + + + + + + + + + + + + + + + + + Objects of type + + + + + + + + + + + + + + + + + + + + + + + + + + warning: cannot find concept ' + + ' + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/xsl/api/caramel/cpp-operators.xml b/xsl/api/caramel/cpp-operators.xml new file mode 100644 index 000000000..68626acbb --- /dev/null +++ b/xsl/api/caramel/cpp-operators.xml @@ -0,0 +1,288 @@ + + + + + + + + + ++ + operator++(int) + + + + -- + operator--(int) + + + + () + () + + + + .() + () + + + + ->() + Error + + + + () + operator()() + + + + () + () + + + + [] + operator[]() + + + + . + Error + + + + + ->{member-name} (return type is pointer-to-object type) + operator->() + + + + ++ + operator++() + + + + -- + operator--() + + + + ! + operator!() + + + + ~ + operator~() + + + + & + operator&() + + + + * + operator*() + + + + + + operator+() + + + + - + operator-() + + + + .* + Error + + + + ->* + operator->*() + + + + * + operator * () + + + + / + operator / () + + + + % + operator % () + + + + + + operator + () + + + + - + operator - () + + + + << + operator << () + + + + >> + operator >> () + + + + < + operator < () + + + + > + operator > () + + + + <= + operator <= () + + + + >= + operator >= () + + + + == + operator == () + + + + != + operator != () + + + + & + operator & () + + + + | + operator | () + + + + ^ + operator ^ () + + + + && + operator && () + + + + || + operator || () + + + + ? : + Error + + + + = + operator = () + + + + += + operator += () + + + + -= + operator -= () + + + + *= + operator *= () + + + + /= + operator /= () + + + + %= + operator %= () + + + + <<= + operator <<= () + + + + >>= + operator >>= () + + + + &= + operator &= () + + + + |= + operator |= () + + + + ^= + operator ^= () + + + + , + operator , () + + + + (*)() + Error + + + + + functorization of operator on arguments {} + Error + + + + + functorization of function on arguments {} + Error + + + diff --git a/xsl/api/caramel/unparser.xsl b/xsl/api/caramel/unparser.xsl new file mode 100644 index 000000000..63db55fff --- /dev/null +++ b/xsl/api/caramel/unparser.xsl @@ -0,0 +1,497 @@ + + + + + + + + + 0 + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + ( + + + + boost::sample_value < >() + + & + + * + + const + + + + + + volatile + + + + < + , + + + + + + + > + + + :: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + (Unrecognized tag ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + *@@@* + + + + + + + 1 + + + + + + + + + + + + + + + + *@@@* + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + *@@@* + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Invalid tag in operator definition: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + typename + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/xsl/api/doxygen/collect.xsl b/xsl/api/doxygen/collect.xsl new file mode 100644 index 000000000..3ec164bed --- /dev/null +++ b/xsl/api/doxygen/collect.xsl @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/xsl/api/doxygen/doxygen2boostbook.xsl b/xsl/api/doxygen/doxygen2boostbook.xsl new file mode 100644 index 000000000..5eb190a7b --- /dev/null +++ b/xsl/api/doxygen/doxygen2boostbook.xsl @@ -0,0 +1,1541 @@ + + + + + + + + + + + + + + This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. + + + + detail + + + :: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:copy-of select="$boost.doxygen.reftitle"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -specialization + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + yes + + + + + + + + + + + yes + + + + + + + + + yes + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + unspecified + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + false + + + false + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + conversion-operator + + + + + + + const + + + + + + volatile + + + + + + + + + + + + + + + + + + + + + + + + + const + + + + + + volatile + + + + + + + + + static + + + + virtual + + + + + + + + + + + + + + + + + + + + + static + + + mutable + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Will not throw. + + + + + + + + + + + + + + + + + unspecified + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <alt> + <xsl:value-of select="*|text()"/> + </alt> + <mediaobject> + <imageobject role="html"> + <imagedata format="PNG" align="center"> + <xsl:attribute name="fileref"> + <xsl:value-of select="concat(concat(concat($boost.doxygen.formuladir, 'form_'), @id), '.png')"/> + </xsl:attribute> + </imagedata> + </imageobject> + <textobject role="tex"> + <phrase> + <xsl:value-of select="*|text()"/> + </phrase> + </textobject> + </mediaobject> + </equation> + </xsl:when> + <xsl:otherwise> + <inlineequation> + <alt> + <xsl:value-of select="*|text()"/> + </alt> + <inlinemediaobject> + <imageobject role="html"> + <imagedata format="PNG"> + <xsl:attribute name="fileref"> + <xsl:value-of select="concat(concat(concat($boost.doxygen.formuladir, 'form_'), @id), '.png')"/> + </xsl:attribute> + </imagedata> + </imageobject> + <textobject role="tex"> + <phrase> + <xsl:value-of select="*|text()"/> + </phrase> + </textobject> + </inlinemediaobject> + </inlineequation> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + </xsl:stylesheet> diff --git a/xsl/api/dtd/dtd2boostbook.xsl b/xsl/api/dtd/dtd2boostbook.xsl new file mode 100644 index 000000000..38bf815fa --- /dev/null +++ b/xsl/api/dtd/dtd2boostbook.xsl @@ -0,0 +1,217 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- + 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) + --> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + + <xsl:output method="xml" indent="yes" standalone="yes"/> + + <xsl:strip-space elements="sequence-group or-group element element-name"/> + + <xsl:key name="elements" match="element" use="@name"/> + <xsl:key name="attributes" match="attlist" use="@name"/> + <xsl:key name="attribute-purposes" match="attpurpose" use="@name"/> + + <xsl:template match="dtd"> + <section id="reference"> + <title>Reference + + Elements: + + + + + + + + + + + + + + + + + + + Element + + - + + + + + + + + + + + + + + + + BoostBook element + + 9 + + + + + + + ::= + + + + + + + + + + + + + + + + + + + ( + + + + ) + + + + + + + + + + + ( + + + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #PCDATA + + + + + ANY + + + + + EMPTY + + + + + + + + + + + Description + + + + + + + + Attributes + + + + + + Name + Type + Value + Purpose + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/xsl/api/testing/Jamfile.xsl b/xsl/api/testing/Jamfile.xsl new file mode 100644 index 000000000..f8648e42f --- /dev/null +++ b/xsl/api/testing/Jamfile.xsl @@ -0,0 +1,243 @@ + + + + + + + + + + + + + + + + + + + + + + + + + Please set the XSL stylesheet parameter "boost.root" to the top-level + Boost directory (i.e., BOOST_ROOT) + + + + + + + + + + + + + + +# Testing Jamfile autogenerated from XML source +subproject ; + +# bring in rules for testing +SEARCH on testing.jam = $(BOOST_BUILD_PATH) ; +include testing.jam ; + +# Make tests run by default. +DEPENDS all : test ; + +{ + # look in BOOST_ROOT for sources first, just in this Jamfile + local SEARCH_SOURCE = $(BOOST_ROOT) $(SEARCH_SOURCE) ; + + test-suite + : ; +} + + + + + + + [ + + + : + + : + + : + + + : + + + + ] + + + + <lib> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/xsl/api/testing/testsuite.xsl b/xsl/api/testing/testsuite.xsl new file mode 100644 index 000000000..b12eef667 --- /dev/null +++ b/xsl/api/testing/testsuite.xsl @@ -0,0 +1,118 @@ + + + + +
+ + + + + + + + + + + + + + Testsuite + + +
+ + + + .acceptance + + + + Acceptance tests + + + + + + Test + Type + Description + If failing... + + + + + + + +
+ + + +
+ + + + .negative + + + Negative tests + + + + + + Test + Type + Description + If failing... + + + + + + + +
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + -- 2.50.1