<!--
|
! CDDL HEADER START
|
!
|
! The contents of this file are subject to the terms of the
|
! Common Development and Distribution License, Version 1.0 only
|
! (the "License"). You may not use this file except in compliance
|
! with the License.
|
!
|
! You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
|
! or http://forgerock.org/license/CDDLv1.0.html.
|
! See the License for the specific language governing permissions
|
! and limitations under the License.
|
!
|
! When distributing Covered Code, include this CDDL HEADER in each
|
! file and include the License file at legal-notices/CDDLv1_0.txt.
|
! If applicable, add the following below this CDDL HEADER, with the
|
! fields enclosed by brackets "[]" replaced with your own identifying
|
! information:
|
! Portions Copyright [yyyy] [name of copyright owner]
|
!
|
! CDDL HEADER END
|
!
|
!
|
! Copyright 2008 Sun Microsystems, Inc.
|
! -->
|
<xsl:stylesheet version="1.0" xmlns:adm="http://www.opends.org/admin"
|
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
|
<xsl:import href="java-utilities.xsl" />
|
<xsl:output method="text" encoding="us-ascii" />
|
<!--
|
Global parameter: the sub-package name. Either 'meta', 'client', or 'server'.
|
-->
|
<xsl:param name="type" select="'.'" />
|
<!--
|
Main document parsing template.
|
-->
|
<xsl:template match="/">
|
<xsl:call-template name="copyright-notice" />
|
<xsl:text>
</xsl:text>
|
<xsl:text>
</xsl:text>
|
<xsl:text>
</xsl:text>
|
<xsl:value-of select="'/**
'" />
|
<xsl:choose>
|
<xsl:when test="$type='meta'">
|
<xsl:call-template name="add-java-comment">
|
<xsl:with-param name="indent-text" select="' *'" />
|
<xsl:with-param name="content"
|
select="concat('Provides introspection interfaces for the ',
|
normalize-space(adm:package/adm:synopsis),
|
' This package provides access to meta-',
|
'information about the managed objects, their ',
|
'properties, their relationships with other ',
|
'managed objects, and their inheritance model.')" />
|
</xsl:call-template>
|
</xsl:when>
|
<xsl:when test="$type='client'">
|
<xsl:call-template name="add-java-comment">
|
<xsl:with-param name="indent-text" select="' *'" />
|
<xsl:with-param name="content"
|
select="concat('Provides client-side interfaces for querying ',
|
'and managing the ',
|
normalize-space(adm:package/adm:synopsis),
|
' Applications can use the interfaces defined ',
|
'within this package to retrieve, list, create, ',
|
'and remove managed objects, as well as query ',
|
'and update their properties.')" />
|
</xsl:call-template>
|
</xsl:when>
|
<xsl:when test="$type='server'">
|
<xsl:call-template name="add-java-comment">
|
<xsl:with-param name="indent-text" select="' *'" />
|
<xsl:with-param name="content"
|
select="concat('Provides server-side interfaces for accessing ',
|
'the ', normalize-space(adm:package/adm:synopsis),
|
' Components within the server can use the ',
|
'interfaces defined within this package to query ',
|
'the properties of the managed objects and ',
|
'register to be notified when managed objects are ',
|
'added, removed, or modified.')" />
|
</xsl:call-template>
|
</xsl:when>
|
<xsl:otherwise>
|
<xsl:message terminate="yes">
|
<xsl:value-of
|
select="concat('Invalid package-info sub-package name: ', $type)" />
|
</xsl:message>
|
</xsl:otherwise>
|
</xsl:choose>
|
<xsl:value-of select="' */
'" />
|
<xsl:value-of select="concat('@org.opends.server.types.PublicAPI(
',
|
' stability=org.opends.server.types.StabilityLevel.VOLATILE,
',
|
' mayInstantiate=false,
',
|
' mayExtend=false,
',
|
' mayInvoke=true)
')"/>
|
<xsl:value-of
|
select="concat('package ', adm:package/@name, '.', $type, ';
')" />
|
</xsl:template>
|
</xsl:stylesheet>
|
