Bug 254894

Summary: find(1): meaning of -newerXt (-newerXY with Y=t) is behind layers of indirection, not installed
Product: Documentation Reporter: danielsh
Component: Manual PagesAssignee: Guangyuan Yang <ygy>
Status: Closed FIXED    
Severity: Affects Only Me CC: doc, felix.the.red, ygy
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
find(1) patch felix.the.red: maintainer-approval? (felix.the.red)

Description danielsh 2021-04-08 21:05:56 UTC 
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?
Comment 1 danielsh 2021-04-08 21:10:57 UTC 
The date parser is get_date() from https://svnweb.freebsd.org/base/head/usr.bin/find/getdate.y?view=markup.
Comment 2 Felix Johnson 2021-10-01 23:23:12 UTC 
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.
Comment 3 commit-hook freebsd_committer freebsd_triage 2021-11-08 06:17:43 UTC 
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(-)
Comment 4 commit-hook freebsd_committer freebsd_triage 2021-11-11 00:35:10 UTC 
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(-)
Comment 5 danielsh 2021-11-11 03:01:34 UTC 
Thank you both :)