Date: Thu, 1 Oct 2015 14:33:55 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47462 - head/en_US.ISO8859-1/books/porters-handbook/plist Message-ID: <201510011433.t91EXtYA026485@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat Date: Thu Oct 1 14:33:55 2015 New Revision: 47462 URL: https://svnweb.freebsd.org/changeset/doc/47462 Log: Add @{pre,post}{,un}exec and deprecate @{,un}exec. Reviewed by: brd, wblock Sponsored by: Absolight Differential Revision: https://reviews.freebsd.org/D3755 Modified: head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml Thu Oct 1 09:42:40 2015 (r47461) +++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml Thu Oct 1 14:33:55 2015 (r47462) @@ -461,21 +461,67 @@ etc/orbit.conf-dist <programlisting>@(,games,2755) sbin/daemon</programlisting> </sect3> - <sect3 xml:id="plist-keywords-base-cwd"> - <title><literal>@cwd</literal> - [<replaceable>directory</replaceable>] (Deprecated)</title> - - <para>Set the internal directory pointer to point to - directory. All subsequent filenames are assumed relative to - this directory.</para> - </sect3> - <sect3 xml:id="plist-keywords-base-exec"> - <title><literal>@exec</literal> + <title><literal>@preexec</literal> + <replaceable>command</replaceable>, + <literal>@postexec</literal> + <replaceable>command</replaceable>, + <literal>@preunexec</literal> + <replaceable>command</replaceable>, + <literal>@postunexec</literal> <replaceable>command</replaceable></title> <para>Execute <replaceable>command</replaceable> as part of - the unpacking process. If command contains any of these + the package installation or deinstallation process.</para> + + <variablelist> + <varlistentry> + <term><literal>@preexec</literal> + <replaceable>command</replaceable></term> + + <listitem> + <para>Execute <replaceable>command</replaceable> as part + of the <filename>pre-install</filename> + scripts.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>@postexec</literal> + <replaceable>command</replaceable></term> + + <listitem> + <para>Execute <replaceable>command</replaceable> as part + of the <filename>post-install</filename> + scripts.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>@preunexec</literal> + <replaceable>command</replaceable></term> + + <listitem> + <para>Execute <replaceable>command</replaceable> as part + of the <filename>pre-deinstall</filename> + scripts.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><literal>@postunexec</literal> + <replaceable>command</replaceable></term> + + <listitem> + <para>Execute <replaceable>command</replaceable> as part + of the <filename>post-deinstall</filename> + scripts.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>If <replaceable>command</replaceable> contains + any of these sequences somewhere in it, they are expanded inline. For these examples, assume that <literal>@cwd</literal> is set to @@ -527,20 +573,15 @@ etc/orbit.conf-dist </variablelist> </sect3> - <sect3 xml:id="plist-keywords-base-unexec"> - <title><literal>@unexec</literal> - <replaceable>command</replaceable></title> + <sect3 xml:id="plist-keywords-base-exec-deprecated"> + <title><literal>@exec</literal> + <replaceable>command</replaceable>, + <literal>@unexec</literal> + <replaceable>command</replaceable> (Deprecated)</title> <para>Execute <replaceable>command</replaceable> as part of - the deinstallation process. Expansion of special - <literal>%</literal> sequences is the same as for - <literal>@exec</literal>. This command is not executed - during the package add, as <literal>@exec</literal> is, but - rather when the package is deleted. This is useful for - deleting links and other ancillary files that were created - as a result of adding the package, but not directly known to - the package's table of contents (and hence not automatically - removable).</para> + the installation or deinstallation process. Please use <xref + linkend="plist-keywords-base-exec"/> instead.</para> </sect3> <sect3 xml:id="plist-keywords-base-mode">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201510011433.t91EXtYA026485>