Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id BC1331A9239
	for <mhonarc+pkgsrc-changes@mail-index.netbsd.org>; Mon,  8 Nov 2021 22:21:35 +0000 (UTC)
Received: by mail.netbsd.org (Postfix, from userid 605)
	id EFC8785032; Mon,  8 Nov 2021 22:21:34 +0000 (UTC)
Received: from localhost (localhost [127.0.0.1])
	by mail.netbsd.org (Postfix) with ESMTP id 353A284D51
	for <pkgsrc-changes@NetBSD.org>; Mon,  8 Nov 2021 22:21:34 +0000 (UTC)
X-Virus-Scanned: amavisd-new at netbsd.org
Received: from mail.netbsd.org ([IPv6:::1])
	by localhost (mail.netbsd.org [IPv6:::1]) (amavisd-new, port 10025)
	with ESMTP id pIuqWiQpvher for <pkgsrc-changes@netbsd.org>;
	Mon,  8 Nov 2021 22:21:33 +0000 (UTC)
Received: from cvs.NetBSD.org (ivanova.NetBSD.org [IPv6:2001:470:a085:999:28c:faff:fe03:5984])
	by mail.netbsd.org (Postfix) with ESMTP id 7840684D43
	for <pkgsrc-changes@NetBSD.org>; Mon,  8 Nov 2021 22:21:33 +0000 (UTC)
Received: by cvs.NetBSD.org (Postfix, from userid 500)
	id 65F1EFAEC; Mon,  8 Nov 2021 22:21:33 +0000 (UTC)
Content-Transfer-Encoding: 7bit
Content-Type: multipart/mixed; boundary="_----------=_163641009317000"
MIME-Version: 1.0
Date: Mon, 8 Nov 2021 22:21:33 +0000
From: "David H. Gutteridge" <gutteridge@netbsd.org>
Subject: CVS commit: pkgsrc/doc/guide/files
To: pkgsrc-changes@NetBSD.org
Reply-To: gutteridge@netbsd.org
X-Mailer: log_accum
Message-Id: <20211108222133.65F1EFAEC@cvs.NetBSD.org>
Sender: pkgsrc-changes-owner@NetBSD.org
List-Id: <pkgsrc-changes.NetBSD.org>
Precedence: bulk
List-Unsubscribe: <mailto:majordomo@NetBSD.org?subject=Unsubscribe%20pkgsrc-changes&body=unsubscribe%20pkgsrc-changes>

This is a multi-part message in MIME format.

--_----------=_163641009317000
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="US-ASCII"

Module Name:	pkgsrc
Committed By:	gutteridge
Date:		Mon Nov  8 22:21:33 UTC 2021

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

Log Message:
fixes.xml: add more details about REPLACE_* variables

Address PR pkg/56301 from J. Lewis Muir. I have added further details
about specific variables, and given more general information about
where they may be located. (While here, spell "Perl" consistently.)


To generate a diff of this commit:
cvs rdiff -u -r1.164 -r1.165 pkgsrc/doc/guide/files/fixes.xml

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


--_----------=_163641009317000
Content-Disposition: inline
Content-Length: 2656
Content-Transfer-Encoding: binary
Content-Type: text/x-diff; charset=us-ascii

Modified files:

Index: pkgsrc/doc/guide/files/fixes.xml
diff -u pkgsrc/doc/guide/files/fixes.xml:1.164 pkgsrc/doc/guide/files/fixes.xml:1.165
--- pkgsrc/doc/guide/files/fixes.xml:1.164	Mon Aug 23 18:38:16 2021
+++ pkgsrc/doc/guide/files/fixes.xml	Mon Nov  8 22:21:33 2021
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.164 2021/08/23 18:38:16 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.165 2021/11/08 22:21:33 gutteridge Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -1481,14 +1481,17 @@ pre-configure:
     contain a list of scripts, relative to <varname>WRKSRC</varname>,
     that you want adjusted. Every occurrence of
     <filename>*/bin/perl</filename> in a she-bang line will be
-    replaced with the full path to the perl executable.</para>
+    replaced with the full path to the Perl executable.</para>
 
-    <para>If a particular version of perl is needed, set the
+    <para>If a particular version of Perl is needed, set the
     <varname>PERL5_REQD</varname> variable to the version number.  The
     default is <quote>5.0</quote>.</para>
 
     <para>See <xref linkend="perl-modules" /> for information
-    about handling perl modules.</para>
+    about handling Perl modules.</para>
+
+    <para>There is also the <varname>REPLACE_PERL6</varname> variable
+    for the language now known as Raku.</para>
   </sect2>
 
   <sect2 id="shell-scripts">
@@ -1510,7 +1513,20 @@ pre-configure:
   <sect2 id="other-programming-languages">
     <title>Other programming languages</title>
 
-    <para>Currently, there is no special handling for other languages
+    <para>There are further similar REPLACE variables available, e.g.,
+    <varname>REPLACE_AWK</varname> for packages containing awk scripts,
+    and <varname>REPLACE_R</varname> for R. These two, like the others
+    noted above, are defined centrally in
+    <filename>mk/configure/replace-interpreter.mk</filename>. Other
+    languages define these variables within their own dedicated part of
+    the tree, e.g., PHP defines <varname>REPLACE_PHP</varname> in
+    <filename>lang/php/phpversion.mk</filename>, and Python defines
+    <varname>REPLACE_PYTHON</varname> in
+    <filename>lang/python/application.mk</filename>. For other languages,
+    consult the mk files found within their specific directories (the
+    naming convention varies).</para>
+    
+    <para>Currently, special handling for other languages varies
     in pkgsrc.  If a compiler package provides a
     <filename>buildlink3.mk</filename> file, include that, otherwise
     just add a (build) dependency on the appropriate compiler


--_----------=_163641009317000--