Commit a2fa1d07 authored by Alberto Bertogli's avatar Alberto Bertogli

docs/man: Make generate script use git timestamps

When regenerating the manpages, the mtime of the pod files is used.
That mtime can change based on file and repository manipulations,
because git does not preserve mtimes.

This causes unnecessary regenerations which require manual cleanups in
order to avoid cluttering the history unnecessarily.

This patch makes the generate script set the mtime of the pod files to
the time of the last git commit that affected them, if they have not
changed since. This avoids unnecessary changes and makes the script
easier to use.

There's one file that needed adjustment to match its last commit time,
that is also included here.
parent 910c6e9c
......@@ -12,6 +12,14 @@ for IN in *.pod; do
SECTION=${OUT##*.}
NAME=${OUT%.*}
# If it has not changed in git, set the mtime to the last commit that
# touched the file.
CHANGED=$( git status --porcelain -- "$IN" | wc -l )
if [ $CHANGED -eq 0 ]; then
GIT_MTIME=$( git log --pretty=%at -n1 -- "$IN" )
touch -d "@$GIT_MTIME" "$IN"
fi
podchecker $IN
pod2man --section=$SECTION --name=$NAME \
--release "" --center "" \
......
......@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "smtp-check 1"
.TH smtp-check 1 "2018-04-03" "" ""
.TH smtp-check 1 "2018-04-02" "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment