From 6f4ed9c17e206eea33dceb81e6677cdd04ae2f4a Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Sun, 12 Apr 2009 17:35:34 +0200 Subject: checklinks(1): Better hardlink documentation --- bin/checklinks | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/bin/checklinks b/bin/checklinks index 4cb1200..12ababc 100755 --- a/bin/checklinks +++ b/bin/checklinks @@ -131,7 +131,7 @@ __END__ =head1 NAME -checklinks - create/update symlinks +checklinks - create/update links =head1 SYNOPSIS @@ -139,7 +139,7 @@ B [ I ] =head1 DESCRIPTION -Create or update symlinks based on a file +Create or update links based on a file =head1 OPTIONS @@ -147,11 +147,11 @@ Create or update symlinks based on a file =item B<-q>, B<--quiet> -quiet. Hide unchanged symlinks +Quiet. Hide unchanged links =item B<-r>, B<--remove> -remove all symlinks +Remove all symlinks. Hardlinks will be left as they are. =item B<-p>, B<--parameter> I=I @@ -172,16 +172,19 @@ current working directory. Each line contains, separated by spaces: =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 +path of the source, i.e. the link. Relative to $HOME + +In symlink mode, the source will only be updated if it either does not exist or +already is a symlink. This should prevent accidental data loss. +Note that in hardlink mode, the source will I be deleted unless it is +already the correct hardlink =item the target -path of the target, i.e. the symlink's destination. +path of the target, i.e. the link's destination. This is relative to the source. See L(7) =back -- cgit v1.2.3