the help for ln reads:
Usage: ln [OPTION]... TARGET [LINK_NAME]
or: ln [OPTION]... TARGET... DIRECTORY
or: ln [OPTION]... --target-directory=DIRECTORY TARGET...
but if someone only reads that much, they can easily get the paramaters
backwards when creating links. Especially symlinks. To one like me, the
above indicates that you would type this to link dir1 to link1 (link1 is a
symlink): ln -s link1 dir1.
Recomendation: replace DIRECTORY with TARGET_DIRECTORY or something to
help prevent confusion in the future.
Please discuss this change with firstname.lastname@example.org rather than Red Hat - we don't want to change the --help texts in packaging (it would probably lead to odd bug reports sent to the maintainers).