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

[raimue at macports.org]

Revision: 50691
          http://trac.macports.org/changeset/50691
Author:   raimue at macports.org
Date:     2009-05-06 17:01:43 -0700 (Wed, 06 May 2009)
Log Message:
-----------
doc:
Add new linkman: macro to easily link to other pages

Modified Paths:
--------------
    branches/new-help-system/base/doc/asciidoc.conf.in
    branches/new-help-system/base/doc/port.1
    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	2009-05-06 23:52:46 UTC (rev 50690)
+++ branches/new-help-system/base/doc/asciidoc.conf.in	2009-05-07 00:01:43 UTC (rev 50691)
@@ -1,3 +1,26 @@
+## linkman: macro
+#
+# Usage: linkman:command[manpage-section]
+#
+# Note, {0} is the manpage section, while {target} is the command.
+#
+# Show link as: <command>(<section>); if section is defined, else just show
+# the command.
+
+[macros]
+(?su)[\\]?(?P<name>linkman):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
+
+ifdef::backend-docbook[]
+[linkman-inlinemacro]
+<ulink url="{target}{0?.{0}}.html">{target}{0?({0})}</ulink>
+endif::backend-docbook[]
+
+ifdef::backend-xhtml11[]
+[linkman-inlinemacro]
+<a href="{target}{0?.{0}}.html">{target}{0?({0})}</a>
+endif::backend-xhtml11[]
+
+
 ifdef::doctype-manpage[]
 ifdef::backend-docbook[]
 [header]

Modified: branches/new-help-system/base/doc/port.1
===================================================================
--- branches/new-help-system/base/doc/port.1	2009-05-06 23:52:46 UTC (rev 50690)
+++ branches/new-help-system/base/doc/port.1	2009-05-07 00:01:43 UTC (rev 50691)
@@ -2,12 +2,12 @@
 .\"     Title: port
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
-.\"      Date: 04/30/2009
+.\"      Date: 05/07/2009
 .\"    Manual: MacPorts Manual
 .\"    Source: MacPorts 1.8.0
 .\"  Language: English
 .\"
-.TH "PORT" "1" "04/30/2009" "MacPorts 1\&.8\&.0" "MacPorts Manual"
+.TH "PORT" "1" "05/07/2009" "MacPorts 1\&.8\&.0" "MacPorts Manual"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------

Modified: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt	2009-05-06 23:52:46 UTC (rev 50690)
+++ branches/new-help-system/base/doc/port.1.txt	2009-05-07 00:01:43 UTC (rev 50691)
@@ -596,7 +596,8 @@
 
 SEE ALSO
 --------
-macports.conf(5), portfile(7), portgroup(7), portstyle(7), porthier(7)
+linkman:macports.conf[5], linkman:portfile[7], linkman:portgroup[7],
+linkman:portstyle[7], linkman:porthier[7]
 
 
 AUTHORS
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090506/9bce620c/attachment.html>