[132714] trunk/base/doc

[cal at macports.org]

Revision: 132714
          https://trac.macports.org/changeset/132714
Author:   cal at macports.org
Date:     2015-02-08 10:12:19 -0800 (Sun, 08 Feb 2015)
Log Message:
-----------
base: document port {setrequested, unsetrequested, setunrequested}, #44530, see NewHelpSystem

Added Paths:
-----------
    trunk/base/doc/port-setrequested.1.txt
    trunk/base/doc/port-setunrequested.1.soelim
    trunk/base/doc/port-unsetrequested.1.soelim

Added: trunk/base/doc/port-setrequested.1.txt
===================================================================
--- trunk/base/doc/port-setrequested.1.txt	                        (rev 0)
+++ trunk/base/doc/port-setrequested.1.txt	2015-02-08 18:12:19 UTC (rev 132714)
@@ -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 at macports.org>


Property changes on: trunk/base/doc/port-setrequested.1.txt
___________________________________________________________________
Added: svn:keywords
   + Author Date Id Rev URL
Added: svn:eol-style
   + native

Added: trunk/base/doc/port-setunrequested.1.soelim
===================================================================
--- trunk/base/doc/port-setunrequested.1.soelim	                        (rev 0)
+++ trunk/base/doc/port-setunrequested.1.soelim	2015-02-08 18:12:19 UTC (rev 132714)
@@ -0,0 +1 @@
+.so man1/port-setrequested.1

Added: trunk/base/doc/port-unsetrequested.1.soelim
===================================================================
--- trunk/base/doc/port-unsetrequested.1.soelim	                        (rev 0)
+++ trunk/base/doc/port-unsetrequested.1.soelim	2015-02-08 18:12:19 UTC (rev 132714)
@@ -0,0 +1 @@
+.so man1/port-setrequested.1
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20150208/6c1a8375/attachment.html>