ln Info page reupholstering indicated

[Dan Jacobson]

First we look at a result:
$ echo o>o; echo p>p
$ ln -f o p
$ cat o p
o
o

Now we look at parts of the Info page that make us glad we tested this first.

     ln [OPTION]... TARGET [LINKNAME]


targets usually get hurt, glad we didn't assume a city life meaning.

   * If two filenames are given, `ln' creates a link from the second to
     the first.

emphasize the second's contents will be destroyed, if any destroying
is to be done.

   * It is an error if the last argument is not a directory and more
     than two files are given.  Without `-f' or `-i' (see below), `ln'
     will not remove an existing file.  Use the `--backup' option to

yes, but which file...

`-f'
`--force'
     Remove existing destination files.

this is the first occurrence of the word 'destination' on the Info
page.  One must guess if it means first, second, TARGET, etc.

So, the man page should be tightened up, probably adding examples are
the only way, lest the user be forced to do tests, or take gambles.

Sure, perhaps other parts of the Info page say other things, but the
user might not have read all of the page.