From 38016d1d25b13ee978c85a12a480a63601a42808 Mon Sep 17 00:00:00 2001
From: Luca Toscano <elukey@apache.org>
Date: Wed, 20 Apr 2016 11:12:50 +0000
Subject: [PATCH] Add a new panel to all the module doc pages containing
 quicklinks for Changelog and open bugs.

This change should help users not familiar with the httpd changelog and bugzilla to check them
before asking in IRC/users@/etc if httpd has a bug or not. The wording and position of the
panel can of course be changed; this is a proposal to improve user experience while consulting
doc pages related to httpd modules. The change has also been discussed in docs@.



git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1740110 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/style/lang/da.xml      |  3 +++
 docs/manual/style/lang/de.xml      |  3 +++
 docs/manual/style/lang/en.xml      |  3 +++
 docs/manual/style/lang/es.xml      |  3 +++
 docs/manual/style/lang/fr.xml      |  3 +++
 docs/manual/style/lang/ja.xml      |  3 +++
 docs/manual/style/lang/ko.xml      |  3 +++
 docs/manual/style/lang/pt-br.xml   |  3 +++
 docs/manual/style/lang/ru.xml      |  3 +++
 docs/manual/style/lang/tr.xml      |  3 +++
 docs/manual/style/lang/zh-cn.xml   |  3 +++
 docs/manual/style/xsl/synopsis.xsl | 20 ++++++++++++++++++++
 12 files changed, 53 insertions(+)

diff --git a/docs/manual/style/lang/da.xml b/docs/manual/style/lang/da.xml
index 337623d3e9..a6d94c760d 100644
--- a/docs/manual/style/lang/da.xml
+++ b/docs/manual/style/lang/da.xml
@@ -72,6 +72,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZÆØÅ</message>
         <message id="name-section">NAVN</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntaks</message>
diff --git a/docs/manual/style/lang/de.xml b/docs/manual/style/lang/de.xml
index 1f98debf56..d443510484 100644
--- a/docs/manual/style/lang/de.xml
+++ b/docs/manual/style/lang/de.xml
@@ -67,6 +67,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">NAME</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntax</message>
diff --git a/docs/manual/style/lang/en.xml b/docs/manual/style/lang/en.xml
index 0ad828cafb..40433e6263 100644
--- a/docs/manual/style/lang/en.xml
+++ b/docs/manual/style/lang/en.xml
@@ -71,6 +71,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">NAME</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntax</message>
diff --git a/docs/manual/style/lang/es.xml b/docs/manual/style/lang/es.xml
index 352be08f2a..de3c0f3dd2 100644
--- a/docs/manual/style/lang/es.xml
+++ b/docs/manual/style/lang/es.xml
@@ -69,6 +69,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNÑOPQRSTUVWXYZ</message>
         <message id="name-section">Nombre</message>
         <message id="hyphenation">Cesura</message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Sintaxis</message>
diff --git a/docs/manual/style/lang/fr.xml b/docs/manual/style/lang/fr.xml
index 6cd08abcde..cfee7dade7 100644
--- a/docs/manual/style/lang/fr.xml
+++ b/docs/manual/style/lang/fr.xml
@@ -71,6 +71,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">NOM</message>
         <message id="hyphenation">C&#233;sure</message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntaxe</message>
diff --git a/docs/manual/style/lang/ja.xml b/docs/manual/style/lang/ja.xml
index 744fb0f488..278d1886d5 100644
--- a/docs/manual/style/lang/ja.xml
+++ b/docs/manual/style/lang/ja.xml
@@ -66,6 +66,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">NAME</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">構文</message>
diff --git a/docs/manual/style/lang/ko.xml b/docs/manual/style/lang/ko.xml
index e8d02b113e..f8124a810f 100644
--- a/docs/manual/style/lang/ko.xml
+++ b/docs/manual/style/lang/ko.xml
@@ -72,6 +72,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">NAME</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">¹®¹ý</message>
diff --git a/docs/manual/style/lang/pt-br.xml b/docs/manual/style/lang/pt-br.xml
index c25b729b61..27aeadd7d0 100644
--- a/docs/manual/style/lang/pt-br.xml
+++ b/docs/manual/style/lang/pt-br.xml
@@ -70,6 +70,9 @@
         <!-- Used in manualpage -->
         <message id="relatedmodules">M&#243;dulos Relacionados</message>
         <message id="relateddirectives">Diretrizes Relacionadas</message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Sintaxe</message>
diff --git a/docs/manual/style/lang/ru.xml b/docs/manual/style/lang/ru.xml
index 531324d05d..f24ad01878 100644
--- a/docs/manual/style/lang/ru.xml
+++ b/docs/manual/style/lang/ru.xml
@@ -70,6 +70,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">NAME</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">óÉÎÔÁËÓÉÓ</message>
diff --git a/docs/manual/style/lang/tr.xml b/docs/manual/style/lang/tr.xml
index 2e1f723d8a..2633de0585 100644
--- a/docs/manual/style/lang/tr.xml
+++ b/docs/manual/style/lang/tr.xml
@@ -73,6 +73,9 @@
         <message id="uppercase">ABCÇDEFGĞHIİJKLMNOÖPQRSŞTUÜVWXYZ</message>
         <message id="name-section">Ä°SÄ°M</message>
         <message id="hyphenation">.nh</message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Sözdizimi</message>
diff --git a/docs/manual/style/lang/zh-cn.xml b/docs/manual/style/lang/zh-cn.xml
index c4093567c6..18c897b601 100644
--- a/docs/manual/style/lang/zh-cn.xml
+++ b/docs/manual/style/lang/zh-cn.xml
@@ -69,6 +69,9 @@
         <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
         <message id="name-section">名称</message>
         <message id="hyphenation"></message>
+        <message id="foundabug">Bugfix checklist:</message>
+        <message id="httpdchangelog">Httpd changelog</message>
+        <message id="httpdopenbugs">Open bugs</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">语法</message>
diff --git a/docs/manual/style/xsl/synopsis.xsl b/docs/manual/style/xsl/synopsis.xsl
index 638747b494..8f2c32b1e9 100644
--- a/docs/manual/style/xsl/synopsis.xsl
+++ b/docs/manual/style/xsl/synopsis.xsl
@@ -244,6 +244,26 @@
                         </xsl:choose>
                     </xsl:if> <!-- /!is-chm -->
 
+                    <h3>
+                       <xsl:value-of select="$message[@id='foundabug']" />
+                    </h3>
+                    <ul class="seealso">
+                        <li>
+                            <a href="http://httpd.apache.org/dev/dist/CHANGES_2.4">
+                                <xsl:value-of
+                                    select="$message[@id='httpdchangelog']" />
+                            </a>
+                        </li>
+                        <li>
+                            <!-- The line below is not splitted in multiple
+                                 lines to avoid rendering a broken URL -->
+                            <a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity">
+                                <xsl:value-of
+                                    select="$message[@id='httpdopenbugs']" />
+                            </a>
+                        </li>
+                    </ul>
+
                     <xsl:if test="seealso">
 	                    <h3>
                             <xsl:value-of select="$message
-- 
2.50.1