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

@@ -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>

doc/port-setunrequested.1.soelim

@@ -0,0 +1 @@
+.so man1/port-setrequested.1

doc/port-unsetrequested.1.soelim

@@ -0,0 +1 @@
+.so man1/port-setrequested.1