From add12c1a35bea267e0dd6115da19f14cba67c5bb Mon Sep 17 00:00:00 2001
From: Mathieu Arnold <mat@FreeBSD.org>
Date: Thu, 21 Apr 2016 13:12:30 +0000
Subject: [PATCH] Document USES=7z.

Reviewed by:	wblock
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D5949
---
 .../books/porters-handbook/uses/chapter.xml    | 18 ++++++++++++++++++
 share/xml/man-refs.ent                         |  1 +
 2 files changed, 19 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
index 10de8ece77..20f1f9d002 100644
--- a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -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>
 
diff --git a/share/xml/man-refs.ent b/share/xml/man-refs.ent
index 72953b8433..fc7ef6ade6 100644
--- a/share/xml/man-refs.ent
+++ b/share/xml/man-refs.ent
@@ -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