From f88423813f042cf40d9207409cd05cf4b75d87a0 Mon Sep 17 00:00:00 2001 From: Qyriad Date: Wed, 1 May 2024 18:51:16 -0600 Subject: nix3-profile: allow using human-readable names to select packages These names are parsed from the URL provided for that package Based off of commit 257b768436a0e8ab7887f9b790c5b92a7fe51ef5 Upstream-PR: https://github.com/NixOS/nix/pull/8678 Co-authored-by: Felix Uhl Change-Id: I76d5f9cfb11d3d2915b3dd1db21d7bb49e91f4fb --- doc/manual/rl-next/nix-profile-names.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 doc/manual/rl-next/nix-profile-names.md (limited to 'doc') 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..0db17b21e --- /dev/null +++ b/doc/manual/rl-next/nix-profile-names.md @@ -0,0 +1,7 @@ +--- +synopsis: "`nix profile` now allows referring to elements by human-readable name" +prs: 8678 +cls: 978 +--- + +[`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 are deprecated and will be removed in a future version. -- cgit v1.2.3 From e98fc952a81f89c86e871120aac6272dccdc83b9 Mon Sep 17 00:00:00 2001 From: Qyriad Date: Wed, 1 May 2024 19:12:04 -0600 Subject: nix3-profile: remove indices Based off of commit 3187bc9ac3dd193b9329ef68c73ac3cca794ed78 Upstream-PR: https://github.com/NixOS/nix/pull/9656 Co-authored-by: Eelco Dolstra Change-Id: I8ac4a33314cd1cf9de95404c20f58e883460acc7 --- doc/manual/rl-next/nix-profile-names.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/manual/rl-next/nix-profile-names.md b/doc/manual/rl-next/nix-profile-names.md index 0db17b21e..2a37691e6 100644 --- a/doc/manual/rl-next/nix-profile-names.md +++ b/doc/manual/rl-next/nix-profile-names.md @@ -1,7 +1,7 @@ --- -synopsis: "`nix profile` now allows referring to elements by human-readable name" +synopsis: "`nix profile` now allows referring to elements by human-readable name, and no longer accepts indices" prs: 8678 cls: 978 --- -[`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 are deprecated and will be removed in a future version. +[`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. -- cgit v1.2.3 From e0911eef73e36d5b42ebd2e9fa114d535ab287f7 Mon Sep 17 00:00:00 2001 From: Qyriad Date: Wed, 1 May 2024 19:55:26 -0600 Subject: nix3-profile: make element names stable Based off of commit 6268a45b650f563bae2360e0540920a2959bdd40 Upstream-PR: https://github.com/NixOS/nix/pull/9656 Co-authored-by: Eelco Dolstra Change-Id: I0fcf069a8537c61ad6fc4eee1f3c193a708ea1c4 --- doc/manual/rl-next/nix-profile-names.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/manual/rl-next/nix-profile-names.md b/doc/manual/rl-next/nix-profile-names.md index 2a37691e6..53dc53fa9 100644 --- a/doc/manual/rl-next/nix-profile-names.md +++ b/doc/manual/rl-next/nix-profile-names.md @@ -1,7 +1,9 @@ --- synopsis: "`nix profile` now allows referring to elements by human-readable name, and no longer accepts indices" prs: 8678 -cls: 978 +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. +[`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. -- cgit v1.2.3