| <?xml version="1.0"?> |
| <!-- |
| |
| Licensed under the Apache License, Version 2.0 (the "License"); |
| you may not use this file except in compliance with the License. |
| You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> |
| <xsl:param name="binary"/> |
| <xsl:param name="support-level"/> <!-- either 'stable' or 'unsupported' --> |
| <xsl:output method="text"/> |
| |
| <!-- Normalize space --> |
| <xsl:template match="text()"> |
| <xsl:if test="normalize-space(.)"> |
| <xsl:value-of select="normalize-space(.)"/> |
| </xsl:if> |
| </xsl:template> |
| |
| <!-- Grab nodes of the <configuration> element --> |
| <xsl:template match="AllFlags"> |
| <!-- Inject the license text into the header of each file --> |
| //// |
| // |
| // Licensed to the Apache Software Foundation (ASF) under one |
| // or more contributor license agreements. See the NOTICE file |
| // distributed with this work for additional information |
| // regarding copyright ownership. The ASF licenses this file |
| // to you under the Apache License, Version 2.0 (the |
| // "License"); you may not use this file except in compliance |
| // with the License. You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, |
| // software distributed under the License is distributed on an |
| // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| // KIND, either express or implied. See the License for the |
| // specific language governing permissions and limitations |
| // under the License. |
| //// |
| |
| :author: Kudu Team |
| :imagesdir: ./images |
| :icons: font |
| :toc: left |
| :toclevels: 2 |
| :doctype: book |
| :backend: html5 |
| :sectlinks: |
| :experimental: |
| |
| <!--start supported --> |
| <xsl:if test="$support-level = 'supported'"> |
| [[<xsl:value-of select="$binary"/>_supported]] |
| = `<xsl:value-of select="$binary"/>` Flags |
| |
| [[<xsl:value-of select="$binary"/>_stable]] |
| == Stable Flags |
| |
| Flags tagged `stable` and not `advanced` are safe to use for common |
| configuration tasks. |
| |
| <xsl:for-each select="flag"> |
| <xsl:if test="contains(tags, 'stable') and |
| not(contains(tags, 'advanced')) and |
| not(contains(tags, 'hidden')) and |
| not(contains(tags, 'unsafe'))"> |
| [[<xsl:value-of select="$binary"/>_<xsl:value-of select="name"/>]] |
| === `--<xsl:value-of select="name"/>` |
| |
| <xsl:value-of select="meaning"/> |
| |
| [cols="1h,3d", width="50%"] |
| |=== |
| | Type | <xsl:value-of select="type"/> |
| | Default | <xsl:choose><xsl:when test="default != ''">`<xsl:value-of select="default"/>`</xsl:when><xsl:otherwise>none</xsl:otherwise></xsl:choose> |
| | Tags | <xsl:value-of select="tags"/> |
| |=== |
| {nbsp} |
| |
| </xsl:if> |
| </xsl:for-each> |
| |
| |
| [[<xsl:value-of select="$binary"/>_stable_advanced]] |
| == Stable, Advanced Flags |
| |
| Flags tagged `stable` and `advanced` are supported, but should be considered |
| "expert" options and should be used carefully and after thorough testing. |
| |
| <xsl:for-each select="flag"> |
| <xsl:if test="contains(tags, 'stable') and |
| contains(tags, 'advanced') and |
| not(contains(tags, 'hidden')) and |
| not(contains(tags, 'unsafe'))"> |
| [[<xsl:value-of select="$binary"/>_<xsl:value-of select="name"/>]] |
| === `--<xsl:value-of select="name"/>` |
| |
| <xsl:value-of select="meaning"/> |
| |
| [cols="1h,3d", width="50%"] |
| |=== |
| | Type | <xsl:value-of select="type"/> |
| | Default | <xsl:choose><xsl:when test="default != ''">`<xsl:value-of select="default"/>`</xsl:when><xsl:otherwise>none</xsl:otherwise></xsl:choose> |
| | Tags | <xsl:value-of select="tags"/> |
| |=== |
| {nbsp} |
| |
| </xsl:if> |
| </xsl:for-each> |
| |
| [[<xsl:value-of select="$binary"/>_evolving]] |
| == Evolving Flags |
| |
| Flags tagged `evolving` (or not tagged with a stability tag) are not yet |
| considered final, and while they may be useful for tuning, they are subject to |
| being changed or removed without notice. |
| |
| <xsl:for-each select="flag"> |
| <xsl:if test="not(contains(tags, 'stable')) and |
| not(contains(tags, 'experimental')) and |
| not(contains(tags, 'hidden')) and |
| not(contains(tags, 'unsafe'))"> |
| [[<xsl:value-of select="$binary"/>_<xsl:value-of select="name"/>]] |
| === `--<xsl:value-of select="name"/>` |
| |
| <xsl:value-of select="meaning"/> |
| |
| [cols="1h,3d", width="50%"] |
| |=== |
| | Type | <xsl:value-of select="type"/> |
| | Default | <xsl:choose><xsl:when test="default != ''">`<xsl:value-of select="default"/>`</xsl:when><xsl:otherwise>none</xsl:otherwise></xsl:choose> |
| | Tags | <xsl:value-of select="tags"/> |
| |=== |
| {nbsp} |
| |
| </xsl:if> |
| </xsl:for-each> |
| |
| ''' |
| </xsl:if> |
| <!--end supported --> |
| |
| <!-- start unsupported --> |
| <xsl:if test="$support-level = 'unsupported'"> |
| [[<xsl:value-of select="$binary"/>_unsupported]] |
| = `<xsl:value-of select="$binary"/>` Unsupported Flags |
| |
| Flags not marked `stable` or `evolving` are considered experimental and are |
| *unsupported*. They are included here for informational purposes only and are |
| subject to being changed or removed without notice. |
| |
| <xsl:for-each select="flag"> |
| <xsl:if test="not(contains(tags, 'stable')) and |
| not(contains(tags, 'evolving')) and |
| not(contains(tags, 'hidden')) and |
| not(contains(tags, 'unsafe'))"> |
| [[<xsl:value-of select="$binary"/>_<xsl:value-of select="name"/>]] |
| == `--<xsl:value-of select="name"/>` |
| |
| <xsl:value-of select="meaning"/> |
| |
| [cols="1h,3d", width="50%"] |
| |=== |
| | Type | <xsl:value-of select="type"/> |
| | Default | <xsl:choose><xsl:when test="default != ''">`<xsl:value-of select="default"/>`</xsl:when><xsl:otherwise>none</xsl:otherwise></xsl:choose> |
| | Tags | <xsl:value-of select="tags"/> |
| |=== |
| </xsl:if> |
| </xsl:for-each> |
| ''' |
| </xsl:if> |
| <!-- end unsupported --> |
| </xsl:template> |
| </xsl:stylesheet> |