This is an automated email from the ASF dual-hosted git repository.
claude pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/creadur-rat.git
The following commit(s) were added to refs/heads/master by this push:
new bcc29a79 RAT-489: Provide page skeleton for known issues (#545)
bcc29a79 is described below
commit bcc29a799038608a8c9bd492d011f23ef89da8ce
Author: P. Ottlinger <[email protected]>
AuthorDate: Tue Oct 7 09:37:49 2025 +0200
RAT-489: Provide page skeleton for known issues (#545)
* RAT-489: Provide page for known issues
---
.buildtools/site | 20 ++++++++++++++++++++
apache-rat/src/site/apt/known_issues.apt | 30 ++++++++++++++++++++++++++++++
src/changes/changes.xml | 3 +++
src/site/site.xml | 1 +
4 files changed, 54 insertions(+)
diff --git a/.buildtools/site b/.buildtools/site
new file mode 100755
index 00000000..bfe29b72
--- /dev/null
+++ b/.buildtools/site
@@ -0,0 +1,20 @@
+#!/bin/bash
+# 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.
+#
+# DEVHINT: RAT-302: Do not use modern JDK due to the javadoc problem; JDK8 and
16 are okay
+# DEVHINT: package build is required as site target requires access to the
completed jar package.
+./mvnw -B clean package site site:stage
+open target/staging/index.html &
diff --git a/apache-rat/src/site/apt/known_issues.apt
b/apache-rat/src/site/apt/known_issues.apt
new file mode 100644
index 00000000..acb4fe56
--- /dev/null
+++ b/apache-rat/src/site/apt/known_issues.apt
@@ -0,0 +1,30 @@
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~ 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.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ --------------------------
+ Known issues
+ --------------------------
+
+Known issues
+
+ This page collects any known issues with Apache RAT™. As it is
developed as an open source project, you are free to help, comment or provide
insights about the known issues.
+
+ * {{{https://issues.apache.org/jira/browse/RAT-476}RAT-476}}: RAT's
include/exclude precedence rules do not match gitignore semantics
+
+ * {{{https://issues.apache.org/jira/browse/RAT-97}RAT-97}}: Maven plugin
parameter <<<excludeSubProjects>>> does not work properly if deeper than one
hierarchy level
+
+ Feel free to have a look into our project's
{{{https://issues.apache.org/jira/browse/RAT}Jira}} to find other reported
{{{https://issues.apache.org/jira/issues/?jql=project%20%3D%20%22Apache%20Rat%22%20%20and%20issuetype%20%3D%20Bug%20and%20status%20not%20in%20(resolved%2C%20closed)}bugs}}
or open issues.
\ No newline at end of file
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index d14f7a4e..1c39e48d 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -72,6 +72,9 @@ The <action> type attribute can be one of:
</release>
-->
<release version="0.17-SNAPSHOT" date="xxxx-yy-zz" description="Current
SNAPSHOT - release to be done">
+ <action issue="RAT-489" type="add" dev="pottlinger">
+ Provide a central known issues section to the RAT homepage in order to
inform users more directly about already known challenges with the current RAT
version.
+ </action>
<action issue="RAT-481" type="add" dev="pottlinger">
Update scripts to generate RAT's webpage and fix multiple linking,
menu and documentation errors.
</action>
diff --git a/src/site/site.xml b/src/site/site.xml
index 01e5279b..4e9011b3 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -49,6 +49,7 @@
<item name="Introducing RAT" href="/index.html"/>
<item name="Downloads" href="/download_rat.cgi"/>
<item name="Changes" href="/changes.html"/>
+ <item name="Known issues" href="apache-rat/known_issues.html"/>
</menu>
<menu name="RAT from the Command Line" inherit="bottom">
<item name="Command Line Introduction" href="apache-rat/index.html"/>
