Quoting find(1): https://svnweb.freebsd.org/base/head/usr.bin/find/find.1?revision=360074&view=markup#l644 > In addition, if > .Ar Y Ns = Ns Cm t , > then > .Ar file > is instead interpreted as a direct date specification of the form > understood by > .Xr cvs 1 . Now, I didn't even have cvs(1) installed, but opening https://man.freebsd.org/cvs and going to the third match for "date" told me that "1 hour ago" was one valid syntax, and beyond that, said just: > For a complete description of the date formats accepted by cvs, see node > `Date input formats' in the CVS manual. I followed the link at the bottom of the manpage to the CVS homepage. I followed the link in the top nav bar to "Documentation". I followed the link to the manual. I followed the link to the "HTML - with one web page per node" version of the manual. There wasn't a table of contents entry called "Date input formats", nor such an entry in the index. I went through the matches for "date" in the table of contents, and tried <https://www.gnu.org/software/trans-coord/manual/cvs/html_node/Tagging-by-date_002ftag.html#Tagging-by-date_002ftag>. I followed the link to "Common options", https://www.gnu.org/software/trans-coord/manual/cvs/html_node/Common-options.html#Common-options. That finally told me that the supported input formats are ISO8601 and RFC822. Could that information please be placed behind fewer layers of indirection? Ideally, in the find(1) man page itself?
The date parser is get_date() from https://svnweb.freebsd.org/base/head/usr.bin/find/getdate.y?view=markup.
Created attachment 228337 [details] find(1) patch cvs(1) isn't installed by default, change the date format reference to note that find(1) understands ISO8601 and RFC822 date formats. Remove reference to cvs(1) in SEE ALSO.
A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=52dbe1a0f419b8d45b4beed56b90ff48bc12e14c commit 52dbe1a0f419b8d45b4beed56b90ff48bc12e14c Author: Felix Johnson <felix.the.red@gmail.com> AuthorDate: 2021-11-08 06:14:58 +0000 Commit: Guangyuan Yang <ygy@FreeBSD.org> CommitDate: 2021-11-08 06:14:58 +0000 find(1): Update date format reference and remove cvs(1) references cvs(1) is not installed by default. Change the date format reference to note that find(1) understands ISO8601 and RFC822 date formats. Also remove references to cvs(1). PR: 254894 MFC after: 3 days Reported by: danielsh@apache.org usr.bin/find/find.1 | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-)
A commit in branch stable/13 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=c702a2897efcfef31f2fdfee0e36c7a9a63373ec commit c702a2897efcfef31f2fdfee0e36c7a9a63373ec Author: Felix Johnson <felix.the.red@gmail.com> AuthorDate: 2021-11-08 06:14:58 +0000 Commit: Guangyuan Yang <ygy@FreeBSD.org> CommitDate: 2021-11-11 00:34:15 +0000 find(1): Update date format reference and remove cvs(1) references cvs(1) is not installed by default. Change the date format reference to note that find(1) understands ISO8601 and RFC822 date formats. Also remove references to cvs(1). PR: 254894 Reported by: danielsh@apache.org (cherry picked from commit 52dbe1a0f419b8d45b4beed56b90ff48bc12e14c) usr.bin/find/find.1 | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-)
Thank you both :)