Document that hard-linking may fail

[sunfishcode]

Hard links typically cannot cross filesystems, and mount points could appear practically anywhere. Consequently, we should document that creating a hard link anywhere other than the same directory as the source may fail.

Hard linking may still be useful in portable code, as an opportunistic optimization with a copy as a fallback if the link fails. But we should document that.