-Remove existing file/links using trash-put or rm -rf if it is not available.
-Create directory if needed. Small change to ln argument semantics: for 2 arguments,
-the second argument is a directory unless -T is passed. This removes ambiguity of
-replacing a file but not a directory. No ln option arguments are supported."
+Remove existing file in the using trash-put or rm -rf if it is not available.
+Create directory if needed. Slightly more restrictive arguments than ln.
+
+In the 1st form, create a link to TARGET with the name LINK_NAME. In the 2nd
+form, create a link to TARGET in the current directory. In the 3rd form, create
+links to each TARGET in DIRECTORY."