[65982] branches/new-help-system/base/doc

raimue at macports.org raimue at macports.org
Sun Apr 4 06:53:21 PDT 2010


Revision: 65982
          http://trac.macports.org/changeset/65982
Author:   raimue at macports.org
Date:     2010-04-04 06:53:18 -0700 (Sun, 04 Apr 2010)
Log Message:
-----------
Rename linkman: to man:, add guide:

Modified Paths:
--------------
    branches/new-help-system/base/doc/asciidoc.conf.in
    branches/new-help-system/base/doc/global-flags.txt
    branches/new-help-system/base/doc/images.txt
    branches/new-help-system/base/doc/manpage.xsl
    branches/new-help-system/base/doc/port-activate.1
    branches/new-help-system/base/doc/port-activate.1.txt
    branches/new-help-system/base/doc/port-edit.1.txt
    branches/new-help-system/base/doc/port.1.txt

Modified: branches/new-help-system/base/doc/asciidoc.conf.in
===================================================================
--- branches/new-help-system/base/doc/asciidoc.conf.in	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/asciidoc.conf.in	2010-04-04 13:53:18 UTC (rev 65982)
@@ -2,10 +2,11 @@
 mansource=MacPorts
 manversion=@MACPORTS_VERSION@
 manmanual=MacPorts Manual
+guideurl=http://guide.macports.org/
 
-## linkman: macro
+## man: macro
 #
-# Usage: linkman:command[manpage-section]
+# Usage: man:command[manpage-section]
 #
 # Note, {0} is the manpage section, while {target} is the command.
 #
@@ -13,18 +14,23 @@
 # the command.
 
 [macros]
-(?su)[\\]?(?P<name>linkman):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
+(?su)[\\]?(?P<name>man):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
+(?su)[\\]?(?P<name>guide):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
 
 ifdef::backend-docbook[]
-[linkman-inlinemacro]
+[man-inlinemacro]
 <citerefentry>
     <refentrytitle>{target}</refentrytitle>{0?<manvolnum>{0}</manvolnum>}
 </citerefentry>
+[guide-inlinemacro]
+<ulink url="#{target}">{0={guideurl}{target}}</ulink>
 endif::backend-docbook[]
 
 ifdef::backend-xhtml11[]
-[linkman-inlinemacro]
-<a href="{target}{0?.{0}}.html">{target}{0?({0})}</a>
+[man-inlinemacro]
+<a href="{guideurl}{target}{0?.{0}}.html">{target}{0?({0})}</a>
+[guide-inlinemacro]
+<a href="{guideurl}#{target}">{0={guideurl}{target}}</a>
 endif::backend-xhtml11[]
 
 [paradef-default]

Modified: branches/new-help-system/base/doc/global-flags.txt
===================================================================
--- branches/new-help-system/base/doc/global-flags.txt	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/global-flags.txt	2010-04-04 13:53:18 UTC (rev 65982)
@@ -4,5 +4,5 @@
 GLOBAL OPTIONS
 --------------
 
-Please see the section *GLOBAL OPTIONS* in the linkman:port[1] man page for a
+Please see the section *GLOBAL OPTIONS* in the man:port[1] man page for a
 description of global port options.

Modified: branches/new-help-system/base/doc/images.txt
===================================================================
--- branches/new-help-system/base/doc/images.txt	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/images.txt	2010-04-04 13:53:18 UTC (rev 65982)
@@ -4,4 +4,7 @@
 version can be active at a time. On activation, files will be hardlinked to
 their intended place in 'prefix'.
 
-To check the current status of a specific port, use *linkman:port-installed{1}*.
+More information on this topic can be found in the
+guide:internals.images[The MacPorts Guide].
+
+To check the current status of a specific port, use *man:port-installed{1}*.

Modified: branches/new-help-system/base/doc/manpage.xsl
===================================================================
--- branches/new-help-system/base/doc/manpage.xsl	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/manpage.xsl	2010-04-04 13:53:18 UTC (rev 65982)
@@ -3,7 +3,6 @@
 
 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"/>
 
-<xsl:param name="man.base.url.for.relative.links">http://guide.macports.org/</xsl:param>
 <xsl:param name="man.endnotes.list.heading">External References</xsl:param>
 
 <!-- Do not write soelim files -->

Modified: branches/new-help-system/base/doc/port-activate.1
===================================================================
--- branches/new-help-system/base/doc/port-activate.1	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/port-activate.1	2010-04-04 13:53:18 UTC (rev 65982)
@@ -42,6 +42,8 @@
 .sp
 MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIimages\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be hardlinked to their intended place in \fIprefix\fR\&.
 .sp
+More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
+.sp
 .SH "GLOBAL OPTIONS"
 .sp
 Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
@@ -60,3 +62,9 @@
 .if n \{\
 .RE
 .\}
+.SH "EXTERNAL REFERENCES"
+.IP " 1." 4
+The MacPorts Guide
+.RS 4
+\%[set $man.base.url.for.relative.links]/#internals.images
+.RE

Modified: branches/new-help-system/base/doc/port-activate.1.txt
===================================================================
--- branches/new-help-system/base/doc/port-activate.1.txt	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/port-activate.1.txt	2010-04-04 13:53:18 UTC (rev 65982)
@@ -39,8 +39,8 @@
 
 SEE ALSO
 --------
-linkman:port[1], linkman:port-install[1], linkman:port-installed[1],
-linkman:port-deactivate[1]
+man:port[1], man:port-install[1], man:port-installed[1],
+man:port-deactivate[1]
 
 AUTHORS
 -------

Modified: branches/new-help-system/base/doc/port-edit.1.txt
===================================================================
--- branches/new-help-system/base/doc/port-edit.1.txt	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/port-edit.1.txt	2010-04-04 13:53:18 UTC (rev 65982)
@@ -44,7 +44,7 @@
 
 SEE ALSO
 --------
-linkman:port[1], linkman:port-file[1], linkman:port-cat[1]
+man:port[1], man:port-file[1], man:port-cat[1]
 
 AUTHORS
 -------

Modified: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt	2010-04-04 12:56:26 UTC (rev 65981)
+++ branches/new-help-system/base/doc/port.1.txt	2010-04-04 13:53:18 UTC (rev 65982)
@@ -596,8 +596,8 @@
 
 SEE ALSO
 --------
-linkman:macports.conf[5], linkman:portfile[7], linkman:portgroup[7],
-linkman:portstyle[7], linkman:porthier[7]
+man:macports.conf[5], man:portfile[7], man:portgroup[7],
+man:portstyle[7], man:porthier[7]
 
 
 AUTHORS
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100404/bd52c0a0/attachment.html>


More information about the macports-changes mailing list