[PATCH 6 of 6] doc: link man pages to one another

[Martin Geisler]

# HG changeset patch
# User Martin Geisler <mg at lazybytes.net>
# Date 1247224910 -7200
# Node ID f896fd4446e36008d5d1fe1f83e066f3ed61df2c
# Parent  e827e3e17fb14fd478dc62d720d3ae5981f67c35
doc: link man pages to one another

diff --git a/doc/hg.1.txt b/doc/hg.1.txt
--- a/doc/hg.1.txt
+++ b/doc/hg.1.txt
@@ -48,7 +48,7 @@
 ``.hgignore``
     This file contains regular expressions (one per line) that
     describe file names that should be ignored by **hg**. For details,
-    see *hgignore(5)*.
+    see |hgignore(5)|_.
 
 ``.hgtags``
     This file contains changeset hash values and text tag names (one
@@ -59,7 +59,7 @@
     This file contains defaults and configuration. Values in
     ``.hg/hgrc`` override those in ``$HOME/.hgrc``, and these override
     settings made in the global ``/etc/mercurial/hgrc`` configuration.
-    See *hgrc(5)* for details of the contents and format of these
+    See |hgrc(5)|_ for details of the contents and format of these
     files.
 
 Some commands (e.g. revert) produce backup files ending in ``.orig``,
@@ -73,7 +73,7 @@
 
 SEE ALSO
 --------
-*hgignore(5)*, *hgrc(5)*
+|hgignore(5)|_, |hgrc(5)|_
 
 AUTHOR
 ------
@@ -92,3 +92,5 @@
 Copyright \(C) 2005-2009 Matt Mackall.
 Free use of this software is granted under the terms of the GNU General
 Public License (GPL).
+
+.. include:: links.txt
diff --git a/doc/hgignore.5.txt b/doc/hgignore.5.txt
--- a/doc/hgignore.5.txt
+++ b/doc/hgignore.5.txt
@@ -24,10 +24,10 @@
 Mercurial ignores every unmanaged file that matches any pattern in an
 ignore file. The patterns in an ignore file do not apply to files
 managed by Mercurial. To control Mercurial's handling of files that it
-manages, see the hg(1) man page. Look for the "-I" and "-X" options.
+manages, see the |hg(1)|_ man page. Look for the "-I" and "-X" options.
 
 In addition, a Mercurial configuration file can point to a set of
-per-user or global ignore files. See the hgrc(5) man page for details
+per-user or global ignore files. See the |hgrc(5)|_ man page for details
 of how to configure these files. Look for the "ignore" entry in the
 "ui" section.
 
@@ -85,7 +85,7 @@
 
 SEE ALSO
 --------
-hg(1), hgrc(5)
+|hg(1)|_, |hgrc(5)|_
 
 COPYING
 -------
@@ -93,3 +93,5 @@
 Mercurial is copyright 2005-2009 Matt Mackall.
 Free use of this software is granted under the terms of the GNU General
 Public License (GPL).
+
+.. include:: links.txt
diff --git a/doc/hgrc.5.txt b/doc/hgrc.5.txt
--- a/doc/hgrc.5.txt
+++ b/doc/hgrc.5.txt
@@ -743,7 +743,7 @@
     option supports hook syntax, so if you want to specify multiple
     ignore files, you can do so by setting something like
     "ignore.other = ~/.hgignore2". For details of the ignore file
-    format, see the hgignore(5) man page.
+    format, see the |hgignore(5)|_ man page.
 ``interactive``
     Allow to prompt the user. True or False. Default is True.
 ``logtemplate``
@@ -922,7 +922,7 @@
 
 SEE ALSO
 --------
-hg(1), hgignore(5)
+|hg(1)|_, |hgignore(5)|_
 
 COPYING
 -------
@@ -930,3 +930,5 @@
 Mercurial is copyright 2005-2009 Matt Mackall.
 Free use of this software is granted under the terms of the GNU General
 Public License (GPL).
+
+.. include:: links.txt
diff --git a/doc/links.txt b/doc/links.txt
new file mode 100644
--- /dev/null
+++ b/doc/links.txt
@@ -0,0 +1,8 @@
+.. Common links and substitution definitions.
+
+.. |hg(1)| replace:: **hg**\ (1)
+.. _hg(1): hg.1.html
+.. |hgrc(5)| replace:: **hgrc**\ (5)
+.. _hgrc(5): hgrc.5.html
+.. |hgignore(5)| replace:: **hgignore**\ (5)
+.. _hgignore(5): hgignore.5.html