__realpath.2: Fix typo.

__realpath.2: Small mdoc correction.

libc - Update manual page for realpath(3) and add page for __realpath(2)

* Add a manual page for __realpath(2) which clarifies differences
between realpath(3) and __realpath(2).