[pkgsrc/trunk]: pkgsrc/doc/guide/files doc/guide: don't suggest patch files a...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/8dd318538b20
branches:  trunk
changeset: 411304:8dd318538b20
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Feb 09 19:06:12 2020 +0000

description:
doc/guide: don't suggest patch files against /dev/null

These patches would be much harder to edit and read than ordinary files.
Also recommend to copy these files in post-extract instead of
pre-configure, since extract is used for putting all files in place.

diffstat:

 doc/guide/files/components.xml |  13 +++++--------
 1 files changed, 5 insertions(+), 8 deletions(-)

diffs (27 lines):

diff -r 3c58b9fae0ae -r 8dd318538b20 doc/guide/files/components.xml
--- a/doc/guide/files/components.xml    Sun Feb 09 17:44:18 2020 +0000
+++ b/doc/guide/files/components.xml    Sun Feb 09 19:06:12 2020 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.57 2019/08/18 16:35:16 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.58 2020/02/09 19:06:12 rillig Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
 <title>Package components - files, directories and contents</title>
@@ -691,13 +691,10 @@
   <sect1 id="files-dir">
     <title><filename>files/*</filename></title>
 
-    <para>If you have any files that you wish to be placed in the package prior
-    to configuration or building, you could place these files here and use
-    a <command>${CP}</command> command in the
-    <quote>pre-configure</quote> target to achieve
-    this. Alternatively, you could simply diff the file against
-    <filename>/dev/null</filename> and use the patch mechanism to manage
-    the creation of this file.</para>
+    <para>If you have any files that you wish to be placed in the package
+    prior to configuration or building, you can place these files here
+    and use a <command>${CP}</command> command in the
+    <quote>post-extract</quote> target to achieve this.</para>
 
     <para>If you want to share files in this way with other
     packages, set the <varname>FILESDIR</varname> variable to point