CVS commit: pkgsrc/doc/guide/files

["Roland Illig" <rillig%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   rillig
Date:           Tue Jun  2 06:10:10 UTC 2020

Modified Files:
        pkgsrc/doc/guide/files: build.xml

Log Message:
doc/guide: reword paragraph about patches applying cleanly

The previous wording was too easy to get wrong.  Applying cleanly mainly
means that the context lines are as expected.  In most cases this is good
enough.  Having the exact line information would be nice as well, but if
this were crucial, pkgtools/pkgdiff would need to fix this sitation.
Since it doesn't and even states in a comment that it doesn't, the
situation can't be that bad.


To generate a diff of this commit:
cvs rdiff -u -r1.81 -r1.82 pkgsrc/doc/guide/files/build.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/files/build.xml
diff -u pkgsrc/doc/guide/files/build.xml:1.81 pkgsrc/doc/guide/files/build.xml:1.82
--- pkgsrc/doc/guide/files/build.xml:1.81       Sun May  3 08:27:10 2020
+++ pkgsrc/doc/guide/files/build.xml    Tue Jun  2 06:10:09 2020
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.81 2020/05/03 08:27:10 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.82 2020/06/02 06:10:09 rillig Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -394,12 +394,10 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
     <varname>PATCH_DIST_ARGS</varname>.  See <xref
     linkend="components.patches"/> for more details.</para>
 
-    <para>By default &man.patch.1; is given special args to make
-    it fail if the patches apply with some lines of fuzz. Please
-    fix (regen) the patches so that they apply cleanly. The
-    rationale behind this is that patches that don't apply cleanly
-    may end up being applied in the wrong place, and cause severe
-    harm there.</para>
+    <para>By default &man.patch.1; is given special arguments to make it
+    fail if the expected text from the patch context is not found in the
+    patched file. If that happens, fix the patch file by comparing it
+    with the actual text in the file to be patched.</para>
 
   </sect1>