From 2c10fda125bd547108ea9067594409df2cbeb4aa Mon Sep 17 00:00:00 2001
From: Daniel Friesel <derf@derf.homelinux.org>
Date: Mon, 2 Jun 2008 20:59:21 +0200
Subject: moved documentation to bin/checklinks (perldoc)

---
 bin/checklinks | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

(limited to 'bin')

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
-- 
cgit v1.2.3