You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
CONTRIBUTING: allow fetching unaccepted changes if the URL is stable
Reword documentation to allow using `fetchpatch` for changes that are
not yet merged upstream. Additionally, put a greater emphasis on URL
stability.
fixes#400873
@@ -517,12 +517,13 @@ In the interest of keeping our maintenance burden and the size of Nixpkgs to a m
517
517
518
518
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`. Check [the `fetchpatch` reference](https://nixos.org/manual/nixpkgs/unstable/#fetchpatch) for details.
519
519
520
+
When adding patches in this manner you should be reasonably sure that the used URL is stable. Patches referencing open pull requests will change when the PR is updated and code forges (such as GitHub) usually garbage collect commits that are no longer reachable due to rebases/amends.
521
+
520
522
### Vendoring patches
521
523
522
524
In the following cases, a `.patch` file _should_ be added to Nixpkgs repository, instead of retrieved:
523
525
524
526
- solves problems unique to packaging in Nixpkgs
525
-
- is already proposed upstream but not merged yet
526
527
- cannot be fetched easily
527
528
- has a high chance to disappear in the future due to unstable or unreliable URLs
0 commit comments