[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/plist.xml: 1.14 -> 1.16
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/plist.xml: 1.14 -> 1.16
> revision 1.16
> date: 2009/03/20 14:55:41; author: mishka; state: Exp; lines: +2 -2
> Prevent unwanted CVS Id tag expanding (fix previous commit).
> ----------------------------
> revision 1.15
> date: 2009/03/20 14:50:49; author: mishka; state: Exp; lines: +35 -1
> Provide usage description for the PLIST_VARS variable.
> Proofreaded by <joerg> - thanks a lot!
# prevent できていないよーな気もしますが
水曜日までに異議がなければ、 commit します。
更新後の訳の全文は
http://www.na.rim.or.jp/%7Ekano/tmp/docs/pkgsrc/plist.xml
http://www.na.rim.or.jp/%7Ekano/tmp/docs/pkgsrc/plist.html#plist.misc
に置いてあります。
以下、訳と原文それぞれの新旧の差分です。
--- plist.xml.orig 2009-03-24 22:28:41.000000000 +0900
+++ plist.xml 2009-03-24 22:28:41.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: plist.xml,v 1.14 2007/06/01 11:07:26 rillig Exp $ -->
+<!-- $NetBSD: plist.xml,v 1.16 2009/03/20 14:55:41 mishka Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: plist.xml,v 1.14 2007/06/01 11:07:26 rillig Exp -->
+<!-- NetBSD: plist.xml,v 1.16 2009/03/20 14:55:41 mishka Exp -->
<chapter id="plist">
<title>PLIST 問題</title>
@@ -147,6 +147,43 @@
<para>こうすると、<filename>PLIST</filename>
内のすべての <quote>${SOMEVAR}</quote>
が <quote>somevalue</quote> で置き換えられます。</para>
+
+
+ <para><varname>PLIST_VARS</varname> を使うと、
+ 条件に応じて <filename>PLIST</filename>
+ の項目を追加することができます。
+ <literal><varname>PLIST_VARS</varname>+=foo</literal>
+ のように値を追加して、
+ これに対応する <varname>PLIST.foo</varname> 変数を
+ <literal>yes</literal> に設定します。
+ このように設定すると、<filename>PLIST</filename> にある
+ <quote><varname>${PLIST.foo}</varname></quote> が
+ <quote><literal>""</literal></quote> に置換されるようになります
+ (設定していない場合は
+ <quote><literal>"@comment "</literal></quote> に置換されます)。
+ たとえば、<filename>Makefile</filename> では以下のようにします。</para>
+
+
+ <programlisting>
+PLIST_VARS+= foo
+.if <replaceable>condition</replaceable>
+PLIST.foo= yes
+.else
+ </programlisting>
+
+ <para>こうしたうえで、<filename>PLIST</filename> では以下のようにします。</para>
+ <programlisting>
+@comment $NetBSD$
+bin/bar
+man/man1/bar.1
+${PLIST.foo}bin/foo
+${PLIST.foo}man/man1/foo.1
+${PLIST.foo}share/bar/foo.data
+${PLIST.foo}@dirrm share/bar
+ </programlisting>
+
+
+
</sect1>
<sect1 id="manpage-compression">
Index: plist.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/plist.xml,v
retrieving revision 1.14
retrieving revision 1.16
diff -u -r1.14 -r1.16
--- plist.xml 1 Jun 2007 11:07:26 -0000 1.14
+++ plist.xml 20 Mar 2009 14:55:41 -0000 1.16
@@ -1,4 +1,4 @@
-<!-- $NetBSD: plist.xml,v 1.14 2007/06/01 11:07:26 rillig Exp $ -->
+<!-- $NetBSD: plist.xml,v 1.16 2009/03/20 14:55:41 mishka Exp $ -->
<chapter id="plist">
<title>PLIST issues</title>
@@ -147,6 +147,40 @@
<para>This replaces all occurrences of <quote>${SOMEVAR}</quote>
in the <filename>PLIST</filename> with
<quote>somevalue</quote>.</para>
+
+
+ <para>The <varname>PLIST_VARS</varname> can be used to simplify
+ the common case of conditionally including some
+ <filename>PLIST</filename> entries. It can be done by adding
+ <literal><varname>PLIST_VARS</varname>+=foo</literal> and
+ setting the coresponding <varname>PLIST.foo</varname> variable
+ to <literal>yes</literal>, if the entry should be included.
+ This will substitute <quote><varname>${PLIST.foo}</varname></quote>
+ in the <filename>PLIST</filename> with either
+ <quote><literal>""</literal></quote> or
+ <quote><literal>"@comment "</literal></quote>.
+ For example, in <filename>Makefile</filename>:</para>
+
+ <programlisting>
+PLIST_VARS+= foo
+.if <replaceable>condition</replaceable>
+PLIST.foo= yes
+.else
+ </programlisting>
+
+ <para>And then in <filename>PLIST</filename>:</para>
+ <programlisting>
+@comment $NetBSD$
+bin/bar
+man/man1/bar.1
+${PLIST.foo}bin/foo
+${PLIST.foo}man/man1/foo.1
+${PLIST.foo}share/bar/foo.data
+${PLIST.foo}@dirrm share/bar
+ </programlisting>
+
+
+
</sect1>
<sect1 id="manpage-compression">