···639640#### Using pythonImportsCheck
641642-Although unit tests are highly prefered to valid correctness of a package. Not
643all packages have test suites that can be ran easily, and some have none at all.
644To help ensure the package still works, `pythonImportsCheck` can attempt to import
645the listed modules.
···15691570### Contributing guidelines
15711572-Following rules are desired to be respected:
15731574* Python libraries are called from `python-packages.nix` and packaged with
1575 `buildPythonPackage`. The expression of a library should be in
1576 `pkgs/development/python-modules/<name>/default.nix`.
1577-* Libraries in `pkgs/top-level/python-packages.nix` are sorted
1578- alphanumerically to avoid merge conflicts and ease locating attributes.
1579* Python applications live outside of `python-packages.nix` and are packaged
1580 with `buildPythonApplication`.
1581* Make sure libraries build for all Python interpreters.
···1585 case, when you disable tests, leave a comment explaining why.
1586* Commit names of Python libraries should reflect that they are Python
1587 libraries, so write for example `pythonPackages.numpy: 1.11 -> 1.12`.
1588-* Attribute names in `python-packages.nix` should be normalized according to
1589- [PEP 0503](https://www.python.org/dev/peps/pep-0503/#normalized-names). This
1590- means that characters should be converted to lowercase and `.` and `_` should
1591- be replaced by a single `-` (foo-bar-baz instead of Foo__Bar.baz )
1592-* Attribute names in `python-packages.nix` should be sorted alphanumerically.
000
···639640#### Using pythonImportsCheck
641642+Although unit tests are highly prefered to validate correctness of a package, not
643all packages have test suites that can be ran easily, and some have none at all.
644To help ensure the package still works, `pythonImportsCheck` can attempt to import
645the listed modules.
···15691570### Contributing guidelines
15711572+The following rules are desired to be respected:
15731574* Python libraries are called from `python-packages.nix` and packaged with
1575 `buildPythonPackage`. The expression of a library should be in
1576 `pkgs/development/python-modules/<name>/default.nix`.
001577* Python applications live outside of `python-packages.nix` and are packaged
1578 with `buildPythonApplication`.
1579* Make sure libraries build for all Python interpreters.
···1583 case, when you disable tests, leave a comment explaining why.
1584* Commit names of Python libraries should reflect that they are Python
1585 libraries, so write for example `pythonPackages.numpy: 1.11 -> 1.12`.
1586+* Attribute names in `python-packages.nix` as well as `pname`s should match the
1587+ library's name on PyPI, but be normalized according to [PEP
1588+ 0503](https://www.python.org/dev/peps/pep-0503/#normalized-names). This means
1589+ that characters should be converted to lowercase and `.` and `_` should be
1590+ replaced by a single `-` (foo-bar-baz instead of Foo__Bar.baz).
1591+ If necessary, `pname` has to be given a different value within `fetchPypi`.
1592+* Attribute names in `python-packages.nix` should be sorted alphanumerically to
1593+ avoid merge conflicts and ease locating attributes.
+1-1
nixos/doc/manual/Makefile
···1.PHONY: all
2-all: manual-combined.xml format
34.PHONY: debug
5debug: generated manual-combined.xml
···1.PHONY: all
2+all: manual-combined.xml
34.PHONY: debug
5debug: generated manual-combined.xml