Mon Mar 2 16:40:54 2015 UTC ()
bsd.pkg.mk no longer contains a list of substitutions which are applied to
PLISTs, direct readers to how they can find out about substitutions today.

Reviewed by wiz@


(sevan)
diff -r1.20 -r1.21 pkgsrc/doc/guide/files/plist.xml
cvs diff -r1.20 -r1.21 pkgsrc/doc/guide/files/plist.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/plist.xml 2015/02/15 18:50:04 1.20
+++ pkgsrc/doc/guide/files/plist.xml 2015/03/02 16:40:54 1.21
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: plist.xml,v 1.20 2015/02/15 18:50:04 wiz Exp $ --> 1<!-- $NetBSD: plist.xml,v 1.21 2015/03/02 16:40:54 sevan Exp $ -->
2 2
3<chapter id="plist"> 3<chapter id="plist">
4 <title>PLIST issues</title> 4 <title>PLIST issues</title>
5 5
6 <para>The <filename>PLIST</filename> file contains a package's 6 <para>The <filename>PLIST</filename> file contains a package's
7 <quote>packing list</quote>, i.e. a list of files that belong to 7 <quote>packing list</quote>, i.e. a list of files that belong to
8 the package (relative to the <filename>${PREFIX}</filename> 8 the package (relative to the <filename>${PREFIX}</filename>
9 directory it's been installed in) plus some additional statements 9 directory it's been installed in) plus some additional statements
10 - see the &man.pkg.create.1; man page for a full list. 10 - see the &man.pkg.create.1; man page for a full list.
11 This chapter addresses some issues that need attention when 11 This chapter addresses some issues that need attention when
12 dealing with the <filename>PLIST</filename> file (or files, see 12 dealing with the <filename>PLIST</filename> file (or files, see
13 below!).</para> 13 below!).</para>
14 14
@@ -121,29 +121,30 @@ PRINT_PLIST_AWK+= /^@dirrm share\/ @@ -121,29 +121,30 @@ PRINT_PLIST_AWK+= /^@dirrm share\/
121 121
122 <listitem> 122 <listitem>
123 <para><varname>${LOWER_OPSYS}</varname> - lowercase common name (eg. <quote>solaris</quote>)</para> 123 <para><varname>${LOWER_OPSYS}</varname> - lowercase common name (eg. <quote>solaris</quote>)</para>
124 </listitem> 124 </listitem>
125 125
126 <listitem> 126 <listitem>
127 <para><varname>${OS_VERSION}</varname> - <quote><command>uname -r</command></quote></para> 127 <para><varname>${OS_VERSION}</varname> - <quote><command>uname -r</command></quote></para>
128 </listitem> 128 </listitem>
129 </itemizedlist> 129 </itemizedlist>
130 </listitem> 130 </listitem>
131 </varlistentry> 131 </varlistentry>
132 </variablelist> 132 </variablelist>
133 133
134 <para>For a complete list of values which are replaced by 134 <para>For a list of values which are replaced by
135 default, please look in <filename>bsd.pkg.mk</filename> (and 135 default, the output of <command>make help topic=PLIST_SUBST</command> as
136 search for <varname>PLIST_SUBST</varname>).</para> 136well as searching the <filename>pkgsrc/mk</filename> directory with <command>grep</command> for
 137<varname>PLIST_SUBST</varname> should help.</para>
137 138
138 <para>If you want to change other variables not listed above, you 139 <para>If you want to change other variables not listed above, you
139 can add variables and their expansions to this variable in the 140 can add variables and their expansions to this variable in the
140 following way, similar to <varname>MESSAGE_SUBST</varname> (see <xref 141 following way, similar to <varname>MESSAGE_SUBST</varname> (see <xref
141 linkend="components.optional"/>):</para> 142 linkend="components.optional"/>):</para>
142 143
143 <programlisting> 144 <programlisting>
144PLIST_SUBST+= SOMEVAR="somevalue" 145PLIST_SUBST+= SOMEVAR="somevalue"
145 </programlisting> 146 </programlisting>
146 147
147 <para>This replaces all occurrences of <quote>${SOMEVAR}</quote> 148 <para>This replaces all occurrences of <quote>${SOMEVAR}</quote>
148 in the <filename>PLIST</filename> with 149 in the <filename>PLIST</filename> with
149 <quote>somevalue</quote>.</para> 150 <quote>somevalue</quote>.</para>