mirror of
https://github.com/apple/pkl.git
synced 2026-08-27 06:04:03 +02:00
Daniel ChaoandFlorin Ungur
6551a59f9e
This changes logic that previously read/wrote from `~/.pkl` to use XDG base directories (all OSes), and Known Folders locations on Windows. For example, Pkl will look for `settings.pkl` in: 1. `$XDG_CONFIG_HOME/pkl/settings.pkl` 2. `%APPDATA/pkl/settings.pkl` 3. `~/.pkl/settings.pkl` 4. Path pkl/settings/pkl within `$XDG_CONFIG_DIRS` 5. `/etc/xdg/pkl/settings.pkl` --------- Co-authored-by: Florin Ungur <florin@florinungur.com>
73 lines
1.7 KiB
Plaintext
73 lines
1.7 KiB
Plaintext
= Pkl 0.33 Release Notes
|
|
:version: 0.33
|
|
:version-minor: 0.33.0
|
|
:release-date: XXX
|
|
:version-next: 0.34
|
|
:version-next-date: February 2027
|
|
|
|
include::partial$intro.adoc[]
|
|
|
|
== Highlights [small]#💖#
|
|
|
|
=== XXX
|
|
|
|
== Noteworthy [small]#🎶#
|
|
|
|
=== CLI Changes
|
|
|
|
==== Default file locations
|
|
|
|
For new setups, the CLI no longer stores anything under `~/.pkl` (https://github.com/apple/pkl/pull/1809[#1809]).
|
|
|
|
It uses XDG-style locations on Unix and Known Folder locations on Windows:
|
|
|
|
[cols="1,2,2,2",options="header"]
|
|
|===
|
|
| Concern | Unix (Linux/macOS) | Windows | Legacy fallback
|
|
|
|
| Package cache
|
|
| `~/.cache/pkl`
|
|
| `$LOCALAPPDATA/pkl/Cache`
|
|
| none
|
|
|
|
| Settings file
|
|
| `~/.config/pkl/settings.pkl`
|
|
| `$APPDATA/pkl/settings.pkl`
|
|
| `~/.pkl/settings.pkl`
|
|
|
|
| CA certificates
|
|
| `~/.config/pkl/cacerts`
|
|
| `$APPDATA/pkl/cacerts`
|
|
| `~/.pkl/cacerts`
|
|
|
|
| REPL history
|
|
| `~/.local/state/pkl/repl-history`
|
|
| `$LOCALAPPDATA/pkl/repl-history`
|
|
| none
|
|
|===
|
|
|
|
On every OS, these locations can be overridden with XDG-style env vars.
|
|
For example, setting `XDG_CACHE_HOME` will configure the cache directory.
|
|
|
|
Note that the existing `~/.pkl/cache` directory is ignored, so Pkl will download packages to populate its cache if configured to do so.
|
|
|
|
== Breaking Changes [small]#💔#
|
|
|
|
=== Removal of macOS amd64 (Intel) Binaries
|
|
|
|
Native `pkl` and `pkldoc` binaries for Intel Mac systems are no longer published with Pkl releases.
|
|
|
|
To continue running new Pkl releases on these systems, use an appropriate Java runtime and the `jpkl` and `jpkldoc` Java executables.
|
|
|
|
=== XXX
|
|
|
|
== Bug Fixes [small]#🐜#
|
|
|
|
* XXX
|
|
|
|
== Contributors [small]#🙏#
|
|
|
|
We would like to thank the contributors to this release (in alphabetical order):
|
|
|
|
* XXX
|