[pkgsrc/trunk]: pkgsrc/doc/guide/files doc/guide: reword paragraph about patc...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/0d71da47b853
branches:  trunk
changeset: 433396:0d71da47b853
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Tue Jun 02 06:10:09 2020 +0000

description:
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.

diffstat:

 doc/guide/files/build.xml |  12 +++++-------
 1 files changed, 5 insertions(+), 7 deletions(-)

diffs (26 lines):

diff -r b0f2ef2c8478 -r 0d71da47b853 doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Tue Jun 02 03:40:57 2020 +0000
+++ b/doc/guide/files/build.xml Tue Jun 02 06:10:09 2020 +0000
@@ -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 @@
     <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>