commit: b0c17723d0d52c646f0ca11b7c5aeb34446fd194
parent b1ab2e7a54d9c51e57a72b286d355eecb6d7b09c
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Mon, 30 Jun 2025 19:28:31 +0200
libutils/datetime_parse.mdoc: Improve formatting thanks to Section usage
Diffstat:
1 file changed, 14 insertions(+), 11 deletions(-)
diff --git a/libutils/datetime_parse.mdoc b/libutils/datetime_parse.mdoc
@@ -2,26 +2,30 @@
.\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
.\" SPDX-License-Identifier: MPL-2.0
.\"
-Should be formatted either with a leading @ (at) symbol followed by
+Multiple different but unambiguous formats are supported:
+@epoch, Email, asctime, RFC3339.
+.Ss @epoch
+Leading @ (at) symbol followed by
the Unix timestamp (number of seconds before and after 1970-01-01 00:00:00Z),
for example
.Ql @1698791420
corresponds to 2023-10-31 23:30:20 UTC
-.Pp
-Or as Email / "Internet Message Format" (RFC5322, RFC2822, RFC822), for example:
+.Ss Email
+Also known as "Internet Message Format" (RFC5322, RFC2822, RFC822), for example:
.Bl -bullet -compact
.It
.Ql Fri, 21 Nov 1997 09:55:06 -0600
.It
.Ql 21 Nov 97 09:55:06 GMT
.El
-.Pp
-Or an
-.Xr asctime 3 Ns -like
-format, for example:
+.Ss asctime
+Output format of
+.Xr asctime 3 ,
+for example:
.Ql Sun Sep 16 01:03:52 1973
-.Pp
-Or as RFC3339 which looks like
+.Ss RFC3339
+Profile of ISO\ 8601:1988, found in modern protocols and file formats.
+Formatted as
.Ql YYYY-MM-DDThh:mm:SS[frac][tz] ,
where:
.Bl -tag -width Ds
@@ -52,4 +56,4 @@ Some examples:
.Ql 2003-06-02T13:37:42.713Z
.It
.Ql 1971-01-02T03:04:05.678+0900
-.El
-\ No newline at end of file
+.El
