No content was changed, new titles are wrapped with () to signal that they will need to be decided on in a future commit.
1.4 KiB
1.4 KiB
Contributing to Nixpkgs packages
(Conventions)
meta.description
must:- Be short, just one sentence.
- Be capitalized.
- Not start with the package name.
- More generally, it should not refer to the package name.
- Not end with a period (or any punctuation for that matter).
- Aim to inform while avoiding subjective language.
meta.license
must be set and fit the upstream license.- If there is no upstream license,
meta.license
should default tolib.licenses.unfree
. - If in doubt, try to contact the upstream developers for clarification.
- If there is no upstream license,
meta.mainProgram
must be set when appropriate.meta.maintainers
should be set.
See the nixpkgs manual for more details on standard meta-attributes.
Testing changes
To run the main types of tests locally:
- Run package-internal tests with
nix-build --attr pkgs.PACKAGE.passthru.tests
- Run NixOS tests with
nix-build --attr nixosTest.NAME
, whereNAME
is the name of the test listed innixos/tests/all-tests.nix
- Run global package tests with
nix-build --attr tests.PACKAGE
, wherePACKAGE
is the name of the test listed inpkgs/test/default.nix
- See
lib/tests/NAME.nix
for instructions on running specific library tests