base: document port help, move links to further documentation into separate file for re-usability

git-svn-id: https://svn.macports.org/repository/macports/trunk/base@123020 d073be05-634f-4543-b044-5fe20cf6d1d6

doc/Makefile.in

@@ -26,6 +26,7 @@ MAN1=	\
 		port-edit.1 \
 		port-extract.1 \
 		port-fetch.1 \
+		port-help.1 \
 		port-install.1 \
 		port-patch.1 \
 		port-rev-upgrade.1 \

doc/furtherdocs.txt

@@ -0,0 +1,15 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+Further documentation on MacPorts can be found in the following places:
+
+guide:[The MacPorts Guide]::
+    Detailed help and support guide
+wiki:[The MacPorts Wiki]::
+    MacPorts usage, development, and support
+wiki:MailingLists[Mailing Lists]::
+    Ask questions on the mailing lists:
+    macports-dev for base and Portfile development,
+    macports-users for user support questions
+wiki:FAQ[]::
+    Frequently Asked Questions
+wiki:ProblemHotlist[Problem Hotlist]::
+    Solutions for the most common error messages and other problems

doc/port-help.1.txt

@@ -0,0 +1,31 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-help(1)
+============
+$Id$
+
+NAME
+----
+port-help - Get help on MacPorts commands
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* *help* ['action' | 'help-topic']
+
+DESCRIPTION
+-----------
+*port help* opens the manpage for a given port action such as 'install',
+'upgrade', 'selfupdate', etc. or a specific help topic like 'macports.conf'.
+MacPorts even has help for its help feature. MacPorts will however not engage in
+higher level abstractions: There is no help on the help on the help.
+
+include::furtherdocs.txt[]
+
+SEE ALSO
+--------
+port(1)
+
+AUTHORS
+-------
+ (C) 2014 The MacPorts Project
+ Clemens Lang <cal@macports.org>

doc/portundocumented.7.txt

@@ -12,21 +12,7 @@ DESCRIPTION
 Unfortunately, the requested topic is not yet documented in the MacPorts man
 pages. Sorry.
 
-Further documentation on MacPorts can be found in the following places:
-
-guide:[The MacPorts Guide]::
-    Detailed help and support guide
-wiki:[The MacPorts Wiki]::
-    MacPorts usage, development, and support
-wiki:MailingLists[Mailing Lists]::
-    Ask questions on the mailing lists:
-    macports-dev for base and Portfile development,
-    macports-users for user support questions
-wiki:FAQ[]::
-    Frequently Asked Questions
-wiki:ProblemHotlist[Problem Hotlist]::
-    Solutions for the most common error messages and other problems
-
+include::furtherdocs.txt[]
 
 CONTRIBUTING
 ------------