Re: git: 6662c2312e95 - main - gettimeofday.2: Do mention improbable future removal

On Sun, Apr 28, 2024 at 12:12 PM Mateusz Piotrowski <0mp@freebsd.org> wrote:

> The branch main has been updated by 0mp:
>
> URL:
> https://cgit.FreeBSD.org/src/commit/?id=6662c2312e956439652ce2d06b42753b6a78fc61
>
> commit 6662c2312e956439652ce2d06b42753b6a78fc61
> Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
> AuthorDate: 2024-04-28 18:06:05 +0000
> Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
> CommitDate: 2024-04-28 18:11:22 +0000
>
>     gettimeofday.2: Do mention improbable future removal
>
>     As kib@ noted:
>
>     > Obviously gettimeofday(2) is not going to be removed
>     > even in the far future.
>
>     Reported by:    kib
>     Fixes:          4395d3ced5cf Document that gettimeofday() is
> obsolescent
>     MFC after:      3 days
> ---
>  lib/libsys/gettimeofday.2 | 8 +++-----
>  1 file changed, 3 insertions(+), 5 deletions(-)
>
> diff --git a/lib/libsys/gettimeofday.2 b/lib/libsys/gettimeofday.2
> index cfba97149199..4fcd4b52312b 100644
> --- a/lib/libsys/gettimeofday.2
> +++ b/lib/libsys/gettimeofday.2
> @@ -25,7 +25,7 @@
>  .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
>  .\" SUCH DAMAGE.
>  .\"
> -.Dd April 24, 2024
> +.Dd April 28, 2024
>  .Dt GETTIMEOFDAY 2
>  .Os
>  .Sh NAME
> @@ -139,11 +139,9 @@ function is considered obsolescent and its usage
> discouraged by
>  .\" XXX: This should be replaced in the future when an appropriate
> argument to
>  .\" the St macro is available: -p1003.1-2017
>  .No IEEE Std 1003.1-2008, 2017 Edition (\\(LqPOSIX.1\\(Rq) .
>

No, this should be .St -p1003.1-2008 since the 2017 edition was only
typographical
and technical changes. The mdoc folks are never going to have a
-p1003.1-2017
because it's not a full new standard.

Warner



> -Application should use the
> +Applications should use the
>  .Xr clock_gettime 2
> -function instead as
> -.Nm gettimeofday
> -might be removed in the future.
> +function instead.
>  .Sh HISTORY
>  The
>  .Fn gettimeofday
>