svn commit: r48698 - in head: en_US.ISO8859-1/books/porters-handbook/uses share/xml

[Mathieu Arnold]

Author: mat
Date: Thu Apr 21 13:12:30 2016
New Revision: 48698
URL: https://svnweb.freebsd.org/changeset/doc/48698

Log:
  Document USES=7z.
  
  Reviewed by:	wblock
  Sponsored by:	Absolight
  Differential Revision:	https://reviews.freebsd.org/D5949

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
  head/share/xml/man-refs.ent

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Thu Apr 21 13:12:25 2016	(r48697)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Thu Apr 21 13:12:30 2016	(r48698)
@@ -69,6 +69,24 @@
     </example>
   </sect1>
 
+  <sect1 xml:id="uses-7z">
+    <title><literal>7z</literal></title>
+
+    <para>Possible arguments: (none), <literal>p7zip</literal>,
+      <literal>partial</literal></para>
+
+    <para>Extract using &man.7z.1; instead of &man.bsdtar.1; and sets
+      <literal>EXTRACT_SUFX=.7z</literal>.  The
+      <literal>p7zip</literal> option forces a dependency on the
+      <command>7z</command> from <package
+	role="port">archivers/p7zip</package> if the one from the base
+      system is not able to extract the files.
+      <varname>EXTRACT_SUFX</varname> is not changed if the
+      <literal>partial</literal> option is used, this can be used if
+      the main distribution file does not have a
+      <filename>.7z</filename> extension.</para>
+  </sect1>
+
   <sect1 xml:id="uses-ada">
     <title><literal>ada</literal></title>
 

Modified: head/share/xml/man-refs.ent
==============================================================================
--- head/share/xml/man-refs.ent	Thu Apr 21 13:12:25 2016	(r48697)
+++ head/share/xml/man-refs.ent	Thu Apr 21 13:12:30 2016	(r48698)
@@ -25,6 +25,7 @@
 -->
 
 <!ENTITY man...1 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>[</refentrytitle><manvolnum>1</manvolnum></citerefentry>">
+<!ENTITY man.7z.1 "<citerefentry xmlns='http://docbook.org/ns/docbook' vendor='ports'><refentrytitle>7z</refentrytitle><manvolnum>1</manvolnum></citerefentry>">
 <!ENTITY man.CC.1 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>CC</refentrytitle><manvolnum>1</manvolnum></citerefentry>">
 <!ENTITY man.Mail.1 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>Mail</refentrytitle><manvolnum>1</manvolnum></citerefentry>">
 <!-- man.X.1 no longer exists in XFree86 4.3.0; the content looks to have moved