2 files changed, 54 insertions, 27 deletions
diff --git a/bin/checklinks b/bin/checklinks
index 2f03551..4ebfc96 100755
--- a/bin/checklinks
+++ b/bin/checklinks
@@ -88,3 +88,57 @@ sub print_format {
 	}
 	print "$src -> $dst\n";
 }
+
+__END__
+
+=head1 NAME
+
+checklinks - create/update symlinks
+
+=head1 SYNOPSIS
+
+B<checklinks> [ B<-q> ]
+
+=head1 DESCRIPTION
+
+Create or update symlinks based on a file
+
+=head1 OPTIONS
+
+=over
+
+=item B<-q>
+
+quiet. Hide unchanged symlinks
+
+=back
+
+=head1 FILES
+
+The symlink definitions are read from the file B<.links> in the current working
+directory. Each line contains, separated by spaces:
+
+=over
+
+=item the symlink type
+
+This may be one of 'soft' or 'hard', indicating either a symlink or a hardlink.
+Note: The use of hardlinks is discouraged and not documented. The following
+definitions only apply to symlinks. For hardlinks, may the source be with you.
+
+=item the source
+
+path of the source, i.e. the symlink. Relative to $HOME
+
+=item the target
+
+path of the target, i.e. the symlink's destination.
+This is relativ to the source. See I<path_resolution>(7)
+
+=back
+
+Lines beginning with an invalid symlink type will be ignored.
+
+=head1 BUGS
+
+There are no checks whether the symlink target actually exists
diff --git a/doc/checklinks b/doc/checklinks
deleted file mode 100644
index 7b9bfa6..0000000
--- a/doc/checklinks
+++ /dev/null
@@ -1,27 +0,0 @@
-checklinks - Automatically symlink files
-
-Usage: checklinks [ -q ]
-
-Options:
-
-	-q
-		quiet. No output if a symlink remained unchained
-
-checklinks will read $PWD/.links for instructions about symlinks.
-Each line contains, separated by spaces:
-
-	the symlink type
-		This may be one of 'soft' or 'hard', indicating it either is a
-		softlink/symlink or a hardlink.
-		Note: The following definitions of source/target only apply for soft
-		links. The corresponding meanings for hard links are unknown.
-
-	the source
-		path of the source, i.e. the symlink
-		This is relative to $HOME
-
-	the target
-		path of the target, i.e. the symlink's destination
-		This is relative to the source. See path_resolution(7)
-
-Lines beginning with an invalid symlink type will be ignored.