public/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

doc/coding-conventions: Add documentation for fetchpatch optional arguments

Browse Source 
(cherry picked from commit 585f63b364460b11a25f1692678395465a8fe8b4)
This commit is contained in:
Stefan Frijters 2021-05-28 11:55:21 +02:00 committed by Dmitry Kalinkin
parent 5b52f151e1
commit 18cd14175f
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/contributing/coding-conventions.chapter.md
View File

@ -526,6 +526,16 @@ If you do need to do create this sort of patch file, one way to do so is with gi
$ git diff > nixpkgs/pkgs/the/package/0001-changes.patch $ git diff > nixpkgs/pkgs/the/package/0001-changes.patch
``` ```
If a patch is available online but does not cleanly apply, it can be modified in some fixed ways by using additional optional arguments for `fetchpatch`:
- `stripLen`: Remove the first `stripLen` components of pathnames in the patch.
- `extraPrefix`: Prefix pathnames by this string.
- `excludes`: Exclude files matching this pattern.
- `includes`: Include only files matching this pattern.
- `revert`: Revert the patch.
Note that because the checksum is computed after applying these effects, using or modifying these arguments will have no effect unless the `sha256` argument is changed as well.
## Package tests {#sec-package-tests} ## Package tests {#sec-package-tests}
Tests are important to ensure quality and make reviews and automatic updates easy. Tests are important to ensure quality and make reviews and automatic updates easy.