summaryrefslogtreecommitdiff
path: root/bin
diff options
context:
space:
mode:
authorDaniel Friesel <derf@derf.homelinux.org>2008-06-02 20:59:21 +0200
committerDaniel Friesel <derf@derf.homelinux.org>2008-06-02 20:59:21 +0200
commit2c10fda125bd547108ea9067594409df2cbeb4aa (patch)
treeea14f7778b9ce69dbd3d09b8ae90e5f53199bfd3 /bin
parent23ad6e0322b0b6b9e1d88b8a2db208312840ff68 (diff)
moved documentation to bin/checklinks (perldoc)
Diffstat (limited to 'bin')
-rwxr-xr-xbin/checklinks54
1 files changed, 54 insertions, 0 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