From c09fffc4ea820c2f1809ea8fcb852d0acf307e1d Mon Sep 17 00:00:00 2001
From: Clemens Lang <cal@macports.org>
Date: Sun, 8 Feb 2015 18:12:19 +0000
Subject: [PATCH] base: document port {setrequested, unsetrequested,
 setunrequested}, https://trac.macports.org/ticket/44530, see NewHelpSystem

git-svn-id: https://svn.macports.org/repository/macports/trunk/base@132714 d073be05-634f-4543-b044-5fe20cf6d1d6
---
 doc/port-setrequested.1.txt      | 47 ++++++++++++++++++++++++++++++++
 doc/port-setunrequested.1.soelim |  1 +
 doc/port-unsetrequested.1.soelim |  1 +
 3 files changed, 49 insertions(+)
 create mode 100644 doc/port-setrequested.1.txt
 create mode 100644 doc/port-setunrequested.1.soelim
 create mode 100644 doc/port-unsetrequested.1.soelim

diff --git a/doc/port-setrequested.1.txt b/doc/port-setrequested.1.txt
new file mode 100644
index 000000000..609ccd1eb
--- /dev/null
+++ b/doc/port-setrequested.1.txt
@@ -0,0 +1,47 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-setrequested(1)
+====================
+$Id$
+
+NAME
+----
+port-setrequested, port-unsetrequested, port-setunrequested - Set and clear the
+'manually installed' flag of a port
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-qvd*] [*-D* 'portdir'] *setrequested*
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+
+[cmdsynopsis]
+*port* [*-qvd*] [*-D* 'portdir'] [*unsetrequested* | *setunrequested*]
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+
+DESCRIPTION
+-----------
+MacPorts keeps records indicating whether you installed a port manually, or
+whether it was pulled in as a dependency of another port. This flag is called
+'requested' and is usually automatically set for all ports you list after *port
+install* when installing. You can disable this automatic behavior by passing the
+*--unrequested* flag to *port install*. See man:port-install[1] for more
+information.
+
+*port setrequested* and *port unsetrequested* allow you to manipulate the
+requested flag of a port manually. *port setunrequested* is an alias of *port
+unsetrequested*.
+
+The requested flag is used to expand the 'leaves' pseudo-portname, i.e. the list
+of ports that were automatically installed and are no longer needed. See
+man:port[1] for more information on pseudo-portnames.
+
+include::global-flags.txt[]
+
+SEE ALSO
+--------
+man:port[1], man:port-install[1]
+
+AUTHORS
+-------
+ (C) 2015 The MacPorts Project
+ Clemens Lang <cal@macports.org>
diff --git a/doc/port-setunrequested.1.soelim b/doc/port-setunrequested.1.soelim
new file mode 100644
index 000000000..b8f14f962
--- /dev/null
+++ b/doc/port-setunrequested.1.soelim
@@ -0,0 +1 @@
+.so man1/port-setrequested.1
diff --git a/doc/port-unsetrequested.1.soelim b/doc/port-unsetrequested.1.soelim
new file mode 100644
index 000000000..b8f14f962
--- /dev/null
+++ b/doc/port-unsetrequested.1.soelim
@@ -0,0 +1 @@
+.so man1/port-setrequested.1