Document that gettimeofday() is obsolescent

[0mp]

Summary

Document that gettimeofday() is obsolescent

Reported by:	kaktus

I am not sure if I should put the link to this document in the commit message:
https://pubs.opengroup.org/onlinepubs/9699919799/functions/gettimeofday.html

[0mp]

• Hard-code the correct standards name. mdoc cannot do it on its own at the moment.

[0mp]

lib/libc/sys/gettimeofday.2

142 ↗

(On Diff #69124)

Related differential revision: https://reviews.freebsd.org/D23944

[bcr]

What's the status on this? Seems like all issues were resolved and it is ready for commit?

[0mp]

This DR is blocked by https://reviews.freebsd.org/D23944.

[concussious.bugzilla_runbox.com]

Sorry I'm late (no subscribe @manpages?)

How do you guys feel about similar language to PR #1195:

(First line after .Sh DESCRIPTION)
"Some commands attempt to describe the nature of a failure condition by using these pre-defined exit codes. This interface has been deprecated and is retained only for compatibility. Its use is discouraged."

I don't like the first line in the description being a emphasized note of depreciation. The first line in the description should explain what the manual is about. 10x as many people read the manual to determine what's going on with their existing stuff as they do to write new stuff. I also really prefer consistent syntax of "deprecated" over obsolescent, we say deprecated most of the time.

What we have in #1195 doesn't imply that it will be removed, but firmly, clearly and immediately states that it is deprecated, without resorting to Em, and still explaining what the page is about. And it's terse :)