[clang] Clarify documentation for -funique-source-file-names. (PR #135832)

[Peter Collingbourne via cfe-commits]

https://github.com/pcc commented:

Will leave this for a bit in case @efriedma-quic has any comments

https://github.com/llvm/llvm-project/pull/135832