[CALCITE-6582] Release Calcite 1.38.0

Add release notes. In the release notes for previous releases,
change whitespace and formatting for consistency among
releases, standardize on 'Postgres' rather than 'PostgreSQL',
and move the 'Compatability' paragraph before the 'Breaking
changes' section.

Add users' aliases to .mailmap, so that the contributors list
in the release notes contains people's real name.

Fix a typo in FileReaderTest.

Release candidate #1 introduced

  [CALCITE-6616] ClassNotFoundException:
  java.util.SequencedCollection at RelBuilder$Frame init

The cause was compiling the release candidate using JDK 21,
which caused the `interface SequencedCollection`, introduced
in JDK 21, to be used in resolving methods. The fix (in
release candidate #2) is to revert to JDK 8 for the release
build (and revert the instructions in howto.md). We suspect
that building with building with JDK 11 or 17 would also work.

Revise template vote email. Fix the tag URL, add an end time
for the vote, describe how to use 'code name (role)' vote
format, sign using release manager's name.

Close #3979

.mailmap

@@ -21,7 +21,10 @@ Alan Jin <[email protected]>
 Ali Mansour <[email protected]>
 Amir Gajst <[email protected]>
 Botong Huang <[email protected]>
+Bowen Yang <[email protected]>
+Cancai Cai <[email protected]>
 Cancai Cai <[email protected]>
+Cancai Cai <[email protected]>
 Charbel Yazbeck <[email protected]>
 Chen Kai <[email protected]>
 Chunhui Shi <[email protected]>
@@ -42,6 +45,9 @@ Drew Schmitt <[email protected]>
 Dylan Adams <[email protected]>
 Evgeniy Stanilovskiy <[email protected]> # aka Eugen Stan, Evgeny Stanilovsky
 Evgeniy Stanilovskiy <[email protected]>
+Evgeniy Stanilovsky <[email protected]>
+Evgeniy Stanilovsky <[email protected]>
+Fan Luo <[email protected]>
 Feng Guo <[email protected]>
 Feng Zhu <[email protected]> # DonnyZone at github
 Feng Zhu <[email protected]>
@@ -71,6 +77,7 @@ Jeffery Zhang (张俭) <[email protected]>
 Jerin John <[email protected]>
 Jiajun Xie <[email protected]> # aka Jiajun Bernoulli
 Jiasen Sheng <[email protected]>
+Jie Cheng <[email protected]>
 Jin Xing <[email protected]>
 Jin Xing <[email protected]> # aka jx158167
 Joey Moore <[email protected]>
@@ -83,8 +90,12 @@ Julian Hyde <[email protected]>
 Kevin Liew <[email protected]>
 Kevin Liew <[email protected]>
 Khawla Mouhoubi <[email protected]>
+Konstantin Orlov <[email protected]>
+Konstantin Orlov <[email protected]>
 Konstantin Orlov <[email protected]>
 Krisztian Kasa <[email protected]>
+Krisztian Kasa <[email protected]>
+Krisztian Kasa <[email protected]>
 Lei Shen <[email protected]>
 LeoWangLZ <[email protected]> # aka Rheet Wong?
 Liao Xintao <[email protected]>
@@ -103,9 +114,11 @@ Pavel Gubin <[email protected]>
 Pawel Ruchaj <[email protected]>
 Peng Wang <[email protected]>
 pengzhiwei <[email protected]>
+Pranava B <[email protected]>
 Praveen Kumar <[email protected]>
 Qi Yu (余启) <[email protected]>
 Rafay Qureshi <[email protected]>
+Rodrigo Rueda <[email protected]>
 Ruben Quesada Lopez <[email protected]>
 Rui Wang <[email protected]>
 Runkang He (何润康) <[email protected]>
@@ -120,6 +133,8 @@ Shuo Cheng <[email protected]>
 Slim Bouguerra <[email protected]>
 Stamatis Zampetakis <[email protected]>
 Stamatis Zampetakis <[email protected]>
+suibianwanwan <[email protected]>
+suibianwanwan <[email protected]>
 Taras Ledkov <[email protected]>
 Ted Xu (少杰) <[email protected]>
 Venki Korukanti <[email protected]>
@@ -141,6 +156,8 @@ Yeong Wei <[email protected]>
 Yingyu Wang <[email protected]>
 Yingyu Wang <[email protected]>
 Yiqun Zhang <[email protected]>
+YiwenWu <[email protected]>
+YiwenWu <[email protected]>
 Zhe Hu <[email protected]>
 Zhen Wang <[email protected]>
 Zhen Wang <[email protected]>

README

@@ -1,4 +1,4 @@
-Apache Calcite release 1.37.0
+Apache Calcite release 1.38.0
 
 This is a source distribution of Apache Calcite.
 

file/src/test/java/org/apache/calcite/adapter/file/FileReaderTest.java

@@ -83,7 +83,7 @@ private static String resourcePath(String path) {
     assumeTrue(!r.equals("OpenJDK Runtime Environment")
             || getJavaMajorVersion() > 10,
         "Java 10+ should have root certificates (JEP 319). Runtime is "
-            + r + ", Jave major version is " + getJavaMajorVersion());
+            + r + ", Java major version is " + getJavaMajorVersion());
 
     FileReader t = new FileReader(STATES_SOURCE);
     t.refresh();

release/build.gradle.kts

@@ -26,6 +26,8 @@ import com.github.vlsi.gradle.release.ReleaseExtension
 import com.github.vlsi.gradle.release.ReleaseParams
 import com.github.vlsi.gradle.release.dsl.dependencyLicenses
 import com.github.vlsi.gradle.release.dsl.licensesCopySpec
+import java.time.Instant
+import java.time.temporal.ChronoUnit
 
 plugins {
     id("com.github.vlsi.stage-vote-release")
@@ -54,7 +56,7 @@ https://gitbox.apache.org/repos/asf?p=calcite.git;a=commit;h=$gitSha
 Its hash is $gitSha
 
 Tag:
-$sourceCodeTagUrl
+https://github.com/apache/calcite/tree/$tag
 
 The artifacts to be voted on are located here:
 $svnStagingUri
@@ -71,24 +73,38 @@ https://people.apache.org/keys/committer/$committerId.asc
 https://www.apache.org/dist/$tlpUrl/KEYS
 
 To create the jars and test $componentName: "gradle build"
-(requires an appropriate Gradle/JDK installation)
+(Requires an appropriate Gradle/JDK installation.)
 
 Please vote on releasing this package as $componentName $version.
-
-The vote is open for the next 72 hours and passes if a majority of at
-least three +1 PMC votes are cast.
+Everyone is welcome to vote. Your vote should contain the line
+'code name (role)', where
+  * 'code' is +1, 0 or -1 as below;
+  * 'name' is your ASF id if you have one, else your real name;
+  * 'role' is 'community', 'committer' or 'PMC member'.
 
 [ ] +1 Release this package as Apache Calcite $version
 [ ]  0 I don't feel strongly about it, but I'm okay with the release
 [ ] -1 Do not release this package because...
 
+The vote is open for the next $voteDurationHours hours (closing at
+$voteEnd) and passes if a majority of
+at least three +1 votes by PMC members are cast.
+
 Here is my vote:
 
-+1 (binding)
+  +1 $committerId (PMC member)
+
+$userName (release manager)
+
 """.trimIndent()
 
 val distributionGroup = "distribution"
 val baseFolder = "apache-calcite-${rootProject.version}"
+val userName = System.getProperty("user.name")
+val voteDurationHours = 72L
+val voteEnd =
+    Instant.now().truncatedTo(ChronoUnit.HOURS)
+        .plus(voteDurationHours, ChronoUnit.HOURS).toString()
 
 // This task scans the project for gitignore / gitattributes, and that is reused for building
 // source/binary artifacts with the appropriate eol/executable file flags
@@ -100,7 +116,7 @@ val gitProps by tasks.registering(FindGitAttributes::class) {
 
 val getLicenses by tasks.registering(GatherLicenseTask::class) {
     extraLicenseDir.set(file("$rootDir/src/main/config/licenses"))
-    // Parts of the web site generated by Jekyll (http://jekyllrb.com/)
+    // Parts of the website generated by Jekyll (http://jekyllrb.com/)
     addDependency(":jekyll:", SpdxLicense.MIT)
     addDependency("font-awesome:font-awesome-code:4.2.0", SpdxLicense.MIT)
     // git.io/normalize