access.2: Mention that lstat(2) should be used for symbolic links

[gbe]

Summary

access(), eaccess() and faccessat() will always dereference
symbolic links.

So add a note the manual page, that stat(2) should be used in
the case of symbolic links.

PR: 262895
MFC after: 1 week

Test Plan

mandoc output review and 'mandoc -Tlint' checks

[pauamma_gundo.com]

There are 2 spurious ) after eaccess and faccessat in the change summary.

[gbe]

In D44890#1023405, @pauamma_gundo.com wrote:

There are 2 spurious ) after eaccess and faccessat in the change summary.

Thanks, when typing fast, auto completion can be evil. ;)

[jamie_catflap.org]

I realise that it's my fault for using the weak word "refer" in my original suggestion (I originally wrote "access, eaccess, faccessat will ALWAYS dereference symbolic links. If you need to refer to the symbolic link itself, you'll have to instead use stat(2)") but I think it looks even less suitable in your submission. Would "If the symbolic link itself needs to be referenced..." be better?

Cheers, Jamie

[jamie_catflap.org]

Oops. Suggested alternative should be "lstat(2)" not "stat(2)" !

[gbe]

• Reword a sentence and recommand lstat(2) instead of stat(2)

[pauamma_gundo.com]

English and markup still LGTM.