From 627072f022ac7743b033b3230782671ea8b95bce Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Tue, 18 Nov 2025 21:44:11 -0600
Subject: [PATCH] doc: populate man pages' headers and footers more
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Style warnings from `groff -rCHECKSTYLE=3 -man`.
an.tmac:/.../share/man/man1/locate.1:1: style: .TH missing third argument; \
  consider document modification date in ISO 8601 format (YYYY-MM-DD)
an.tmac:/.../share/man/man1/locate.1:1: style: .TH missing fourth argument; \
  consider package/project name and version (e.g., "groff 1.23.0")
...and similar.

groff_man_style(7):
     .TH identifier section [footer‐middle [footer‐inside [header‐
     middle]]]
...
            By convention, footer‐middle is the date of the most recent
            modification to the man page source document, and footer‐
            inside is the name and version or release of the project
            providing it.

* find/find.1:
* locate/locate.1:
* locate/locatedb.5:
* locate/updatedb.1:
* xargs/xargs.1: Add appropriate third and fourth arguments to `TH` macro calls.

To determine the revision date to include in the page, I used the Git
"AuthorDate" of the last commit consituting anything but a "bump" to the
copyright notice.

Discussed at:
https://lists.gnu.org/r/bug-findutils/2025-11/msg00094.html

Copyright-paperwork-exempt: Yes
---
 find/find.1       | 2 +-
 locate/locate.1   | 2 +-
 locate/locatedb.5 | 2 +-
 locate/updatedb.1 | 2 +-
 xargs/xargs.1     | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/find/find.1 b/find/find.1
index 4efda0a2..3784c2b4 100644
--- a/find/find.1
+++ b/find/find.1
@@ -1,5 +1,5 @@
 '\" t
-.TH FIND 1 \" -*- nroff -*-
+.TH FIND 1 2025-10-12 findutils \" -*- nroff -*-
 .SH NAME
 find \- search for files in a directory hierarchy
 .SH SYNOPSIS
diff --git a/locate/locate.1 b/locate/locate.1
index 4fd4e168..a240237e 100644
--- a/locate/locate.1
+++ b/locate/locate.1
@@ -1,4 +1,4 @@
-.TH LOCATE 1 \" -*- nroff -*-
+.TH LOCATE 1 2020-12-27 findutils \" -*- nroff -*-
 .SH NAME
 locate \- list files in databases that match a pattern
 .
diff --git a/locate/locatedb.5 b/locate/locatedb.5
index 68d49f31..c0484f7d 100644
--- a/locate/locatedb.5
+++ b/locate/locatedb.5
@@ -1,4 +1,4 @@
-.TH LOCATEDB 5 \" -*- nroff -*-
+.TH LOCATEDB 5 2020-12-27 findutils \" -*- nroff -*-
 .SH NAME
 locatedb \- front-compressed file name database
 .
diff --git a/locate/updatedb.1 b/locate/updatedb.1
index f2fbd5ac..2ee09e9f 100644
--- a/locate/updatedb.1
+++ b/locate/updatedb.1
@@ -1,4 +1,4 @@
-.TH UPDATEDB 1 \" -*- nroff -*-
+.TH UPDATEDB 1 2023-11-10 findutils \" -*- nroff -*-
 .SH NAME
 updatedb \- update a file name database
 .SH SYNOPSIS
diff --git a/xargs/xargs.1 b/xargs/xargs.1
index 4f36ee39..a7b3768a 100644
--- a/xargs/xargs.1
+++ b/xargs/xargs.1
@@ -1,4 +1,4 @@
-.TH XARGS 1 \" -*- nroff -*-
+.TH XARGS 1 2024-06-03 findutils \" -*- nroff -*-
 .SH NAME
 xargs \- build and execute command lines from standard input
 .SH SYNOPSIS