[124015] trunk/base/doc

[cal at macports.org]

Revision: 124015
          https://trac.macports.org/changeset/124015
Author:   cal at macports.org
Date:     2014-08-17 06:07:00 -0700 (Sun, 17 Aug 2014)
Log Message:
-----------
base: document port livecheck, #44530

Modified Paths:
--------------
    trunk/base/doc/Makefile.in

Added Paths:
-----------
    trunk/base/doc/port-livecheck.1.txt

Modified: trunk/base/doc/Makefile.in
===================================================================
--- trunk/base/doc/Makefile.in	2014-08-17 11:51:24 UTC (rev 124014)
+++ trunk/base/doc/Makefile.in	2014-08-17 13:07:00 UTC (rev 124015)
@@ -48,6 +48,7 @@
 		port-installed.1 \
 		port-lint.1 \
 		port-list.1 \
+		port-livecheck.1 \
 		port-location.1 \
 		port-mdmg.1 \
 		port-mpkg.1 \

Copied: trunk/base/doc/port-livecheck.1.txt (from rev 123966, trunk/base/doc/port-lint.1.txt)
===================================================================
--- trunk/base/doc/port-livecheck.1.txt	                        (rev 0)
+++ trunk/base/doc/port-livecheck.1.txt	2014-08-17 13:07:00 UTC (rev 124015)
@@ -0,0 +1,44 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-livecheck(1)
+=================
+$Id$
+
+NAME
+----
+port-livecheck - Check if a new version of the software is available
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-vd*] [*-D* 'portdir'] *livecheck*
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+
+DESCRIPTION
+-----------
+*port livecheck* checks whether a newer version of a given port is available
+upstream. It (usually) does that by automatically downloading a web page and
+applying a regular expression that extracts a version number. If the version
+number is different from the one the port packages, a message is printed.
+
+*port livecheck* is useful for maintainers that want to check whether new
+versions of their ports are available so they can be updated. It can also be
+used by users that encounter a problem, because updating to the latest upstream
+version is generally one of the first steps in case of an error of when
+encountering a bug.
+
+include::global-flags.txt[]
+
+*-v*::
+    Print a message if the port is up to date.
+
+*-d*::
+    Print debugging information such as the regular expression and all matches.
+
+SEE ALSO
+--------
+man:port[1], man:portfile[7], man:port-upgrade[7]
+
+AUTHORS
+-------
+ (C) 2014 The MacPorts Project
+ Clemens Lang <cal at macports.org>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140817/e4079ff1/attachment.html>