From ee0b90a6974bcbea60948f375e2892925395d3b8 Mon Sep 17 00:00:00 2001 From: Quentin Aristote <62126931+qaristote@users.noreply.github.com> Date: Tue, 11 Jun 2024 19:38:05 +0000 Subject: [PATCH 1/3] doc: minimal profile: explain building the configurations may be costly see https://github.com/NixOS/nixpkgs/issues/319102 --- nixos/doc/manual/configuration/profiles/minimal.section.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/nixos/doc/manual/configuration/profiles/minimal.section.md b/nixos/doc/manual/configuration/profiles/minimal.section.md index 02a3b65ae422a8b..438d4daa98ccfe7 100644 --- a/nixos/doc/manual/configuration/profiles/minimal.section.md +++ b/nixos/doc/manual/configuration/profiles/minimal.section.md @@ -7,3 +7,10 @@ graphical stuff. It's a very short file that enables only support the user-selected locale, [disables packages' documentation](#opt-documentation.enable), and [disables sound](#opt-sound.enable). + +With this profile enabled, a lot of package derivations will differ from the +ones available for download in the binary cache (because they are built with +X libraries enabled by default), and will thus have to be built locally. +Hence, while configurations built using this profile may be appropriate for +machines with low resources, the configurations themselves should still be +built on more powerful machines. From e2210972c8779fd70a465dbf33b557db082f8950 Mon Sep 17 00:00:00 2001 From: Quentin Aristote <62126931+qaristote@users.noreply.github.com> Date: Tue, 11 Jun 2024 19:42:52 +0000 Subject: [PATCH 2/3] remove trailing whitespace --- nixos/doc/manual/configuration/profiles/minimal.section.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nixos/doc/manual/configuration/profiles/minimal.section.md b/nixos/doc/manual/configuration/profiles/minimal.section.md index 438d4daa98ccfe7..daf3822d0f20ade 100644 --- a/nixos/doc/manual/configuration/profiles/minimal.section.md +++ b/nixos/doc/manual/configuration/profiles/minimal.section.md @@ -10,7 +10,7 @@ and [disables sound](#opt-sound.enable). With this profile enabled, a lot of package derivations will differ from the ones available for download in the binary cache (because they are built with -X libraries enabled by default), and will thus have to be built locally. +X libraries enabled by default), and will thus have to be built locally. Hence, while configurations built using this profile may be appropriate for machines with low resources, the configurations themselves should still be built on more powerful machines. From e726d4fa3257b95551fe0432c30460597331fad3 Mon Sep 17 00:00:00 2001 From: Quentin Aristote <62126931+qaristote@users.noreply.github.com> Date: Mon, 26 Aug 2024 12:48:04 +0000 Subject: [PATCH 3/3] mention the minimal profile enables the noXlibs option --- .../manual/configuration/profiles/minimal.section.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/nixos/doc/manual/configuration/profiles/minimal.section.md b/nixos/doc/manual/configuration/profiles/minimal.section.md index daf3822d0f20ade..4c9e8662e695c6a 100644 --- a/nixos/doc/manual/configuration/profiles/minimal.section.md +++ b/nixos/doc/manual/configuration/profiles/minimal.section.md @@ -9,8 +9,9 @@ only support the user-selected locale, and [disables sound](#opt-sound.enable). With this profile enabled, a lot of package derivations will differ from the -ones available for download in the binary cache (because they are built with -X libraries enabled by default), and will thus have to be built locally. -Hence, while configurations built using this profile may be appropriate for -machines with low resources, the configurations themselves should still be -built on more powerful machines. +ones available for download in the binary cache (because the derivations in +the binary cache are built with X libraries enabled by default, while the +minimal profile disables these libraries through the `noXlibs` option), and +will thus have to be built locally. Hence, while configurations built using +this profile may be appropriate for machines with low resources, the +configurations themselves should still be built on more powerful machines.