Polish release notes

docs/antora.yml

@@ -1,6 +1,6 @@
 name: main
 title: Main Project
-version: 0.25.0
+version: 0.25.1
 prerelease: false
 nav:
 - nav.adoc

docs/modules/ROOT/partials/component-attributes.adoc

@@ -3,7 +3,7 @@
 // the following attributes must be updated immediately before a release
 
 // pkl version corresponding to current git commit without -dev suffix or git hash
-:pkl-version-no-suffix: 0.25.0
+:pkl-version-no-suffix: 0.25.1
 // tells whether pkl version corresponding to current git commit
 // is a release version (:is-release-version: '') or dev version (:!is-release-version:)
 :is-release-version: ''

docs/modules/release-notes/pages/0.25.adoc

@@ -1,8 +1,11 @@
 = Pkl 0.25 Release Notes
 :version: 0.25
-:version-minor: 0.25.0
+:version-minor: 0.25.1
 :release-date: February 1st, 2024
 
-This is the first release of Pkl!
+Pkl {version} was released on {release-date}. +
+[.small]#The latest bugfix release is {version-minor}. (xref:changelog.adoc[All Versions])#
 
-To learn more, refer to our xref:blog:introducing-pkl.adoc[blog post].
+This is the initial release of Pkl, a programming language for creating configuration.
+
+To learn more about Pkl, refer to our xref:blog:ROOT:introducing-pkl.adoc[blog post].

docs/modules/release-notes/pages/changelog.adoc

@@ -1,8 +1,12 @@
 = Changelog
 include::ROOT:partial$component-attributes.adoc[]
 
+[[release-0.25.1]]
+== 0.25.1 (2024-02-01)
+
+* Fixes an issue where pkl-tools fat jar is empty.
+
 [[release-0.25.0]]
 == 0.25.0 (2024-02-01)
 
 xref:0.25.adoc[Release notes]
-

gradle.properties

@@ -1,7 +1,7 @@
 # suppress inspection "UnusedProperty" for whole file
 
 group=org.pkl-lang
-version=0.25.0
+version=0.25.1
 
 # google-java-format requires jdk.compiler exports
 org.gradle.jvmargs= \

pkl-tools/pkl-tools.gradle.kts

@@ -7,12 +7,9 @@ plugins {
   signing
 }
 
-val firstPartySourcesJars by configurations.existing
+val dummy: SourceSet by sourceSets.creating
 
-java {
-  // create an empty javadoc jar so Maven Central is happy
-  withJavadocJar()
-}
+val firstPartySourcesJars by configurations.existing
 
 // Note: pkl-tools cannot (easily) contain pkl-config-kotlin 
 // because pkl-tools ships with a shaded Kotlin stdlib.
@@ -37,6 +34,21 @@ dependencies {
   firstPartySourcesJars(project(":pkl-doc", "sourcesJar"))
 }
 
+// TODO: need to figure out how to properly generate javadoc here.
+// For now, we'll include a dummy javadoc jar.
+val javadocDummy by tasks.creating(Javadoc::class) {
+  source = dummy.allJava
+}
+
+java {
+  withJavadocJar()
+}
+
+val javadocJar by tasks.existing(Jar::class) {
+  from(javadocDummy.outputs.files)
+  archiveBaseName.set("pkl-tools-all")
+}
+
 tasks.shadowJar {
   archiveBaseName.set("pkl-tools-all")
 }
@@ -46,6 +58,10 @@ publishing {
     named<MavenPublication>("fatJar") {
       // don't use `-all` suffix because this is the only JAR we publish
       artifactId = "pkl-tools"
+      // add dummy javadoc jar to publication
+      artifact(javadocJar.flatMap { it.archiveFile }) {
+        classifier = "javadoc"
+      }
       pom {
         url.set("https://github.com/apple/pkl/tree/main/pkl-tools")
         description.set("Fat Jar containing pkl-cli, pkl-codegen-java, " +

pkl-tools/src/dummy/java/org/pkl/tools/Empty.java

@@ -0,0 +1,24 @@
+/**
+ * Copyright © 2024 Apple Inc. and the Pkl project authors. All rights reserved.
+ *
+ * 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
+ *
+ *     https://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.
+ */
+package org.pkl.tools;
+
+/**
+ * This is an intentionally empty class.
+ */
+// TODO: figure out how to generate javadoc for a shadow jar.
+@SuppressWarnings("unused")
+public class Empty {
+}

stdlib/Benchmark.pkl

@@ -36,7 +36,7 @@
 ///
 /// Warning: Although this module is ready for initial use,
 /// benchmark results may be inaccurate or inconsistent.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.Benchmark
 
 import "pkl:platform" as _platform

stdlib/DocPackageInfo.pkl

@@ -63,7 +63,7 @@
 /// @Deprecated { message = "Use `com.example.Birds.Parrot` instead" }
 /// amends "pkl:PackageInfo"
 /// ```
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.DocPackageInfo
 
 import "pkl:reflect"

stdlib/DocsiteInfo.pkl

@@ -31,7 +31,7 @@
 ///
 /// title = "Title displayed in the header of each page"
 /// ```
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.DocsiteInfo
 
 import "pkl:reflect"

stdlib/Project.pkl

@@ -64,7 +64,7 @@
 ///   value = project
 /// }
 /// ``` 
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.Project
 
 import "pkl:Project"

stdlib/base.pkl

@@ -17,7 +17,7 @@
 /// Fundamental properties, methods, and classes for writing Pkl programs.
 ///
 /// Members of this module are automatically available in every Pkl module.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.base
 
 import "pkl:jsonnet"

stdlib/json.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// A JSON parser.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.json
 
 /// A JSON parser.

stdlib/jsonnet.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// A [Jsonnet](https://jsonnet.org) renderer.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.jsonnet
 
 /// Constructs an [ImportStr].

stdlib/math.pkl

@@ -18,7 +18,7 @@
 ///
 /// Note that some mathematical functions, such as `sign()`, `abs()`, and `round()`,
 /// are directly defined in classes [Number], [Int], and [Float].
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.math
 
 /// The minimum [Int] value: `-9223372036854775808`.

stdlib/platform.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// Information about the platform that the current program runs on.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.platform
 
 /// The platform that the current program runs on.

stdlib/protobuf.pkl

@@ -16,7 +16,7 @@
 
 /// A renderer for [Protocol Buffers](https://developers.google.com/protocol-buffers).
 /// Note: This module is _experimental_ and not ready for production use.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.protobuf
 
 import "pkl:reflect"

stdlib/reflect.pkl

@@ -26,7 +26,7 @@
 /// - Documentation generators (such as *Pkldoc*)
 /// - Code generators (such as *pkl-codegen-java* and *pkl-codegen-kotlin*)
 /// - Domain-specific schema validators
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.reflect
 
 import "pkl:base"

stdlib/release.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// Information about the Pkl release that the current program runs on.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.release
 
 import "pkl:semver"

stdlib/semver.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// Parsing, comparison, and manipulation of [semantic version](https://semver.org/spec/v2.0.0.html) numbers.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.semver
 
 /// Tells whether [version] is a valid semantic version number.

stdlib/settings.pkl

@@ -19,7 +19,7 @@
 /// Every settings file must amend this module.
 /// Unless CLI commands and build tool plugins are explicitly configured with a settings file,
 /// they will use `~/.pkl/settings.pkl` or the defaults specified in this module.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.settings
 
 /// The editor for viewing and editing Pkl files.

stdlib/shell.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// Utilities for generating shell scripts.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.shell
 
 /// Escapes [str] by enclosing it in single quotes.

stdlib/test.pkl

@@ -18,7 +18,7 @@
 ///
 /// To write tests, amend this module and define [facts] or [examples] (or both).
 /// To run tests, evaluate the amended module.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 open module pkl.test
 
 /// Named groups of boolean expressions that are expected to evaluate to [true].

stdlib/xml.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// An XML renderer.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.xml
 
 /// Renders values as XML.

stdlib/yaml.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 
 /// A YAML 1.2 compliant YAML parser.
-@ModuleInfo { minPklVersion = "0.25.0" }
+@ModuleInfo { minPklVersion = "0.25.1" }
 module pkl.yaml
 
 /// A YAML parser.