More details regarding how to use patch/pull, to try to help and avoid mistakes. Reference: /n/patches.lsub.org/patch/patchmanfix2 Date: Sun Apr 15 18:08:20 CES 2012 Signed-off-by: nemo@lsub.org --- /sys/man/1/patch Sun Apr 15 12:25:23 2012 +++ /sys/man/1/patch Tue Apr 17 21:00:33 2012 @@ -13,6 +13,9 @@ .PP .B patch/list [ +.B -av +] +[ .I name ... ] .PP @@ -53,6 +56,27 @@ to pull (apply) new patches that have been applied to the main distribution. All other tools are for contributors and maintainers. .PP +.I Patch/pull +applies to the tree mounted at +.I /n/dist +all patches applied to the main nix tree but not yet applied +to that tree. +If there is no tree mounted at +.I /n/dist +then +.I patch/pull +will bind +.B / +there, and apply patches to the tree you are using. +The history of patches applied to a tree is always kept at +.B /dist/patch/applied +within that tree. +.PP +To use this tool it is important that +.I patch/applied +is either not used (from outside this tool) or is used to apply +the patches in exactly the same order used by the main tree. +.PP .I Patch/create creates a new patch consisting of the changes to the listed files from the distribution, reading @@ -101,7 +125,12 @@ .PP .I Patch/list displays information about the named patches, -or all currently pending patches if none are specified. +or all currently pending patches if none are specified. Under flag +.B -a +it list all existing patches. +Flag +.B -v +makes the tool verbose. .PP .I Patch/diff shows a patch as diffs between the original @@ -139,15 +168,6 @@ It is exactly .I patch/apply with a few changes to operate on the main Nix tree. -.PP -.I Patch/pull -applies all patches applied to the main nix tree but not yet applied -to the local tree. To use this tool it is important that -.I patch/applied -is either not used (from outside this tool) or is used to apply -the patches in exactly the same order used by the main tree. -The history of patches applied to a tree is always kept at -.BR /dist/patch/applied . .PP .I Patch/notify is run frequently close to the main distribution to notify by mail of patch creations.