doc/by-name: explain motivation for transition when custom args are used

This commit is contained in:
Doron Behar 2024-09-17 22:21:20 +03:00
parent 546d75c16a
commit 3a0d864123

View File

@ -92,7 +92,7 @@ though this is not required and must not be expected.
Note that definitions in `all-packages.nix` with custom arguments should not be removed.
That is a backwards-incompatible change because it changes the `.override` interface.
Such packages may still be moved to `pkgs/by-name` however, while keeping the definition in `all-packages.nix`.
Such packages may still be moved to `pkgs/by-name` however, in order to avoid the slightly superficial choice of directory / category in which the `default.nix` file was placed, but please keep the definition in `all-packages.nix` using `callPackage`.
See also [changing implicit attribute defaults](#changing-implicit-attribute-defaults).
## Limitations