Shipped manpage have duplicate title/name header

[landry]

Affecting at least 1.11.0, 1.11.2 and 2.0.0 (only looked at those), the manpage shipped in the source tarballs for releases have a wrong duplicated header:

.TH "gdal-config" 1 "Sun Jun 14 2015" "GDAL" \" -*- nroff -*-
.ad l
.nh
.SH NAME
gdal-config \- .TH "gdal-config" 1 "Sun Jun 14 2015" "GDAL" \" -*- nroff -*-
.ad l
.nh
.SH NAME
gdal-config \- determines various information about a GDAL installation

The .TH section is duplicated and at display time this shows as:

NAME
       gdal-config - .TH "gdal-config" 1 "Sun Jun 14 2015" "GDAL"

NAME
       gdal-config - determines various information about a GDAL installation

I dont think this is a doxygen issue, since if i re-ran the doxygen command present in GNUMakefile for the man target:

(cat Doxyfile ; echo "ENABLED_SECTIONS=man"; echo "INPUT=apps swig/python/scripts"; echo "FILE_PATTERNS=*.cpp *.dox"; echo "GENERATE_HTML=NO"; echo "GENERATE_MAN=YES") | doxygen -

This generates valid/correct makefiles (with a single .TH entry/section), using doxygen 1.8.2 on OpenBSD. Which version/other config is used when generating the release tarballs ?

[Even Rouault]

Found in the changelog of Doxygen 1.7.4 :

id 641188: Header of \page was wrong in Man page output. 
https://bugzilla.gnome.org/show_bug.cgi?id=641188

I've added a check in the generation script: trunk r29963 "mkgdaldist.sh: make sure that at least Doxygen 1.7.4 is installed (#6048)"

And on my account on the reference server, I've compiled 1.7.6.1