aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorQyriad <qyriad@qyriad.me>2024-05-02 20:15:48 +0000
committerGerrit Code Review <gerrit@lix>2024-05-02 20:15:48 +0000
commit076dfd30c6167cfb8f5003a36baef4438f687782 (patch)
treeaf2e7acb9c240249cb5e571fc271b908e363fa51 /doc
parentb7ce11c97dfd0e73ddefbd15ef2cb59fee7d23f2 (diff)
parent6a8b3796286d2f6e56e1fd6b83dfcb5f56d09d13 (diff)
Merge changes from topic "profile-v3" into main
* changes: nix3-profile: remove check "name" attr in manifests Add profile migration test nix3-profile: make element names stable getNameFromURL(): Support uppercase characters in attribute names nix3-profile: remove indices nix3-profile: allow using human-readable names to select packages implement parsing human-readable names from URLs
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/rl-next/nix-profile-names.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/manual/rl-next/nix-profile-names.md b/doc/manual/rl-next/nix-profile-names.md
new file mode 100644
index 000000000..53dc53fa9
--- /dev/null
+++ b/doc/manual/rl-next/nix-profile-names.md
@@ -0,0 +1,9 @@
+---
+synopsis: "`nix profile` now allows referring to elements by human-readable name, and no longer accepts indices"
+prs: 8678
+cls: [978, 980]
+---
+
+[`nix profile`](@docroot@/command-ref/new-cli/nix3-profile.md) now uses names to refer to installed packages when running [`list`](@docroot@/command-ref/new-cli/nix3-profile-list.md), [`remove`](@docroot@/command-ref/new-cli/nix3-profile-remove.md) or [`upgrade`](@docroot@/command-ref/new-cli/nix3-profile-upgrade.md) as opposed to indices. Indices have been removed. Profile element names are generated when a package is installed and remain the same until the package is removed.
+
+**Warning**: The `manifest.nix` file used to record the contents of profiles has changed. Nix will automatically upgrade profiles to the new version when you modify the profile. After that, the profile can no longer be used by older versions of Nix.