build: Sphinx build fixes

manticore-projects · manticore-projects · commit f3e89527df25 · 2023-05-14T20:19:38.000+07:00
diff --git a/.github/workflows/sphinx.yml b/.github/workflows/sphinx.yml
@@ -18,7 +18,7 @@ jobs:
       - name: Setup Gradle
         uses: gradle/gradle-build-action@v2
       - name: Run build with Gradle Wrapper
-        run: gradle sphinx
+        run: gradle --no-build-cache clean xmldoc sphinx
       - name: Deploy
         uses: actions/configure-pages@v2
       - name: Upload artifact
diff --git a/.gitignore b/.gitignore
@@ -7,6 +7,8 @@
 
 # Exclude the Auto-generated Changelog
 /src/site/sphinx/changelog.rst
+/src/site/sphinx/javadoc.rst
+/src/site/sphinx/syntax.rst
 
 # Generated by javacc-maven-plugin
 /bin
diff --git a/build.gradle b/build.gradle
@@ -422,7 +422,7 @@ task sphinx(type: Exec) {
                     , "sphinx-prompt"
                     , "sphinx_substitution_extensions"
                     , "sphinx_issues"
-                    , "sphinx_tabs"
+                    , "sphinx_tabs.tabs"
                     , "sphinx_inline_tabs"
                     , "pygments"
             ]
diff --git a/src/site/sphinx/changelog.rst b/src/site/sphinx/changelog.rst
@@ -8,6 +8,57 @@ Latest Changes since |JSQLPARSER_VERSION|
 =============================================================
 
 
+  * **test: add unit test for issue #1778**
+    
+    Andreas Reichel, 2023-05-11
+  * **style: appease PMD/Codacy**
+    
+    Andreas Reichel, 2023-05-11
+  * **style: appease PMD/Codacy**
+    
+    Andreas Reichel, 2023-05-11
+  * **feat: `MEMBER OF` condition as shown at https://dev.mysql.com/doc/refman/8.0/en/json-search-functions.html#operator_member-of**
+    
+    Andreas Reichel, 2023-05-11
+  * **feat: access Elements of Array Columns**
+    
+    Andreas Reichel, 2023-05-11
+  * **feat: JdbcNamedParameter allows "&" (instead of ":")**
+    
+    Andreas Reichel, 2023-05-11
+  * **fix: Java Version 8**
+    
+    Andreas Reichel, 2023-05-09
+  * **refactor: generify `SelectItem` and remove `FunctionItem` and `ExpressionListItem`**
+    
+    Andreas Reichel, 2023-05-09
+  * **style: replace all List<Expression> with ExpressionList<> and enforce policy via Acceptance Test**
+    
+    Andreas Reichel, 2023-05-09
+  * **fix: find the correct position when field belongs to an internal class**
+    
+    Andreas Reichel, 2023-05-09
+  * **style: Appease PMD**
+    
+    Andreas Reichel, 2023-05-07
+  * **style: Appease Checkstyle**
+    
+    Andreas Reichel, 2023-05-07
+  * **test: Disable API Sanitation for the moment**
+    
+    Andreas Reichel, 2023-05-07
+  * **refactor: `Insert` uses `ExpressionList` and `UpdateSet`**
+    
+    Andreas Reichel, 2023-05-07
+  * **build: improve Gradle Build**
+    
+    Andreas Reichel, 2023-05-07
+  * **refactor: remove SimpleFunction**
+    
+    Andreas Reichel, 2023-05-06
+  * **doc: RR chart colors cater for Dark Mode**
+    
+    Andreas Reichel, 2023-05-06
   * **doc: Better Sphinx Tabs**
     
     Andreas Reichel, 2023-05-06
diff --git a/src/site/sphinx/conf.py b/src/site/sphinx/conf.py
@@ -4,7 +4,7 @@
 needs_sphinx = '1.0'
 add_function_parentheses = True
 
-extensions = ['myst_parser', 'sphinx.ext.autodoc', 'sphinx.ext.autosectionlabel', 'sphinx.ext.extlinks', 'sphinx-prompt', 'sphinx_substitution_extensions', 'sphinx_issues', 'sphinx_inline_tabs', 'pygments.sphinxext', ]
+extensions = ['myst_parser', 'sphinx.ext.autodoc', 'sphinx.ext.autosectionlabel', 'sphinx.ext.extlinks', 'sphinx-prompt', 'sphinx_substitution_extensions', 'sphinx_issues', 'sphinx_tabs.tabs', 'sphinx_inline_tabs', 'pygments.sphinxext', ]
 
 issues_github_path = "JSQLParser/JSqlParser"
 
diff --git a/src/site/sphinx/syntax.rst b/src/site/sphinx/syntax.rst
diff --git a/src/test/java/net/sf/jsqlparser/statement/ReturningClause.java b/src/test/java/net/sf/jsqlparser/statement/ReturningClause.java
@@ -0,0 +1,12 @@
+package net.sf.jsqlparser.statement;
+
+import net.sf.jsqlparser.expression.operators.relational.ExpressionList;
+import net.sf.jsqlparser.schema.Column;
+
+/**
+ * @see https://docs.oracle.com/en/database/oracle/oracle-database/21/lnpls/RETURNING-INTO-clause.html#GUID-38F735B9-1100-45AF-AE71-18FB74A899BE
+ */
+public class ReturningClause {
+    private String returnKeyword = "RETURNING";
+    ExpressionList<Column> columns;
+}

Original file line number	Diff line number	Diff line change
`@@ -422,7 +422,7 @@ task sphinx(type: Exec) {`
`422`	`422`	`, "sphinx-prompt"`
`423`	`423`	`, "sphinx_substitution_extensions"`
`424`	`424`	`, "sphinx_issues"`
`425`		`- , "sphinx_tabs"`
	`425`	`+ , "sphinx_tabs.tabs"`
`426`	`426`	`, "sphinx_inline_tabs"`
`427`	`427`	`, "pygments"`
`428`	`428`	`]`