expand manpages cross-references significantly

i found that most man pages only had references to the main git-annex
manpage, which i stillfind pretty huge and hard to navigate through.

i tried to sift through all the man pages and add cross-references
between relevant pages. my general rule of thumb is that links should
be both ways unless one of the pages is a more general page that would
become ridiculously huge if all backlinks would be added
(git-annex-preferred-content comes to mind).

i have also make the links one per line as this is how it was done in
the metadata pages so far.

i did everything but the plumbing, utility and test commands, although
some of those are linked from the other commands so cross-links were
added there as well.

1 files changed, 8 insertions, 1 deletions

diff --git a/doc/git-annex-sync.mdwn b/doc/git-annex-sync.mdwn
index fa539d8bc..ed3cc1855 100644
--- a/doc/git-annex-sync.mdwn
+++ b/doc/git-annex-sync.mdwn
@@ -47,7 +47,10 @@ by running "git annex sync" on the remote.
   By default, this tries to get each annexed file that the local repository 
   does not yet have, and then copies each file to every remote that it is
   syncing with. This behavior can be overridden by configuring the preferred
-  content of a repository. See [git-annex-preferred-content](1)
+  content of a repository. See [[git-annex-preferred-content]](1).
+
+  To make two repositories have the same set of fies, you should use
+  [[git-annex-mirror]](1) instead of this flag.
 
 * `--message=msg`
 
@@ -57,6 +60,10 @@ by running "git annex sync" on the remote.
 
 [[git-annex]](1)
 
+[[git-annex-preferred-content]](1)
+
+[[git-annex-mirror]](1)
+
 # AUTHOR
 
 Joey Hess <id@joeyh.name>