[124481] trunk/base/doc

[cal at macports.org]

Revision: 124481
          https://trac.macports.org/changeset/124481
Author:   cal at macports.org
Date:     2014-08-24 14:27:18 -0700 (Sun, 24 Aug 2014)
Log Message:
-----------
base: document port {load,unload,reload}

Added Paths:
-----------
    trunk/base/doc/port-load.1.txt
    trunk/base/doc/port-reload.1.soelim
    trunk/base/doc/port-unload.1.soelim

Copied: trunk/base/doc/port-load.1.txt (from rev 124479, trunk/base/doc/port-activate.1.txt)
===================================================================
--- trunk/base/doc/port-load.1.txt	                        (rev 0)
+++ trunk/base/doc/port-load.1.txt	2014-08-24 21:27:18 UTC (rev 124481)
@@ -0,0 +1,44 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-load(1)
+============
+$Id$
+
+NAME
+----
+port-load, port-unload, port-reload - Control daemons installed by a port
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-d*] [*-D* 'portdir'] [*load* | *unload* | *reload*]
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+
+DESCRIPTION
+-----------
+These commands control the daemons that are installed by some of the ports. If
+a port provides daemon functionality, a note will be printed during installation
+advising you how to use it.
+
+The daemon functionality is provided by installing a man:launchd[8]
+configuration file (see man:launchd.conf[5]) and calling man:launchctl[1] on
+your behalf. *port load* advises launchd to start the daemon defined by a port's
+configuration file, also called a ``startup item''. Once loaded, launchd will
+preserve this state - even across reboots - until the daemon is unloaded using
+*port unload*. If you want to restart a daemon, you can use *port reload*, which
+is a convenience wrapper around *port unload* followed by a short delay and
+*port load*.
+
+In theory, MacPorts supports generating startup items for older releases of OS
+X. In practice, these commands can not deal with pre-launchd interfaces and will
+fail on these systems.
+
+include::global-flags.txt[]
+
+SEE ALSO
+--------
+man:port[1], man:launchd[8], man:launchd.conf[5], man:launchctl[1]
+
+AUTHORS
+-------
+ (C) 2014 The MacPorts Project
+ Clemens Lang <cal at macports.org>

Added: trunk/base/doc/port-reload.1.soelim
===================================================================
--- trunk/base/doc/port-reload.1.soelim	                        (rev 0)
+++ trunk/base/doc/port-reload.1.soelim	2014-08-24 21:27:18 UTC (rev 124481)
@@ -0,0 +1 @@
+.so man1/port-load.1

Added: trunk/base/doc/port-unload.1.soelim
===================================================================
--- trunk/base/doc/port-unload.1.soelim	                        (rev 0)
+++ trunk/base/doc/port-unload.1.soelim	2014-08-24 21:27:18 UTC (rev 124481)
@@ -0,0 +1 @@
+.so man1/port-load.1
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140824/b0898a15/attachment.html>