docs: reproducibly build docs by using deterministic timestamp

Use the SOURCE_DATE_EPOCH timestamp [1] if it is available for
timestamps in the tarballs and the HTML documentation.

Also fix permissions inside tarballs to normalize umask
variations.

[1]: https://reproducible-builds.org/specs/source-date-epoch/
This commit is contained in:
Reiner Herrmann 2015-10-30 19:27:32 +01:00
parent f3d0d44a60
commit a2b20f4c84

View file

@ -40,6 +40,7 @@ scriptversion=2014-10-09.23
prog=`basename "$0"` prog=`basename "$0"`
srcdir=`pwd` srcdir=`pwd`
timestamp=${SOURCE_DATE_EPOCH:-$(date +%s)}
scripturl="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs.sh" scripturl="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs.sh"
templateurl="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs_template" templateurl="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs_template"
@ -272,10 +273,11 @@ echo "Making output for $srcfile"
echo " in `pwd`" echo " in `pwd`"
mkdir -p "$outdir/" mkdir -p "$outdir/"
taropts="--mtime=@$timestamp --mode=go=rX,u+rw,a-s"
cmd="$SETLANG $MAKEINFO -o $PACKAGE.info $commonarg $infoarg \"$srcfile\"" cmd="$SETLANG $MAKEINFO -o $PACKAGE.info $commonarg $infoarg \"$srcfile\""
echo "Generating info... ($cmd)" echo "Generating info... ($cmd)"
eval "$cmd" eval "$cmd"
tar --create $PACKAGE.info* | gzip --no-name -f -9 --to-stdout > "$outdir/$PACKAGE.info.tar.gz" tar $taropts --create $PACKAGE.info* | gzip --no-name -f -9 --to-stdout > "$outdir/$PACKAGE.info.tar.gz"
ls -l "$outdir/$PACKAGE.info.tar.gz" ls -l "$outdir/$PACKAGE.info.tar.gz"
info_tgz_size=`calcsize "$outdir/$PACKAGE.info.tar.gz"` info_tgz_size=`calcsize "$outdir/$PACKAGE.info.tar.gz"`
# do not mv the info files, there's no point in having them available # do not mv the info files, there's no point in having them available
@ -319,7 +321,7 @@ html_split()
( (
cd ${split_html_dir} || exit 1 cd ${split_html_dir} || exit 1
ln -sf ${PACKAGE}.html index.html ln -sf ${PACKAGE}.html index.html
tar --create -- *.html | gzip --no-name -f -9 --to-stdout > "$abs_outdir/${PACKAGE}.html_$1.tar.gz" tar $taropts --create -- *.html | gzip --no-name -f -9 --to-stdout > "$abs_outdir/${PACKAGE}.html_$1.tar.gz"
) )
eval html_$1_tgz_size=`calcsize "$outdir/${PACKAGE}.html_$1.tar.gz"` eval html_$1_tgz_size=`calcsize "$outdir/${PACKAGE}.html_$1.tar.gz"`
rm -f "$outdir"/html_$1/*.html rm -f "$outdir"/html_$1/*.html
@ -349,7 +351,7 @@ if test -z "$use_texi2html"; then
copy_images $split_html_dir/ $split_html_dir/*.html copy_images $split_html_dir/ $split_html_dir/*.html
( (
cd $split_html_dir || exit 1 cd $split_html_dir || exit 1
tar --create -- * | gzip --no-name -f -9 --to-stdout > "$abs_outdir/$PACKAGE.html_$split.tar.gz" tar $taropts --create -- * | gzip --no-name -f -9 --to-stdout > "$abs_outdir/$PACKAGE.html_$split.tar.gz"
) )
eval \ eval \
html_${split}_tgz_size=`calcsize "$outdir/$PACKAGE.html_$split.tar.gz"` html_${split}_tgz_size=`calcsize "$outdir/$PACKAGE.html_$split.tar.gz"`
@ -379,7 +381,7 @@ d=`dirname $srcfile`
( (
cd "$d" cd "$d"
srcfiles=`ls -d *.texinfo *.texi *.txi *.eps $source_extra 2>/dev/null` || true srcfiles=`ls -d *.texinfo *.texi *.txi *.eps $source_extra 2>/dev/null` || true
tar --create --dereference $srcfiles | gzip --no-name -f -9 --to-stdout > "$abs_outdir/$PACKAGE.texi.tar.gz" tar $taropts --create --dereference $srcfiles | gzip --no-name -f -9 --to-stdout > "$abs_outdir/$PACKAGE.texi.tar.gz"
ls -l "$abs_outdir/$PACKAGE.texi.tar.gz" ls -l "$abs_outdir/$PACKAGE.texi.tar.gz"
) )
texi_tgz_size=`calcsize "$outdir/$PACKAGE.texi.tar.gz"` texi_tgz_size=`calcsize "$outdir/$PACKAGE.texi.tar.gz"`
@ -401,7 +403,7 @@ if test -n "$docbook"; then
eval "$cmd" eval "$cmd"
( (
cd ${split_html_db_dir} || exit 1 cd ${split_html_db_dir} || exit 1
tar --create -- *.html | gzip --no-name -f -9 --to-stdout > "$abs_outdir/${PACKAGE}.html_node_db.tar.gz" tar $taropts --create -- *.html | gzip --no-name -f -9 --to-stdout > "$abs_outdir/${PACKAGE}.html_node_db.tar.gz"
) )
html_node_db_tgz_size=`calcsize "$outdir/${PACKAGE}.html_node_db.tar.gz"` html_node_db_tgz_size=`calcsize "$outdir/${PACKAGE}.html_node_db.tar.gz"`
rm -f "$outdir"/html_node_db/*.html rm -f "$outdir"/html_node_db/*.html
@ -431,7 +433,7 @@ else
CONDS="/%%ENDIF.*%%/d;/%%IF *HTML_SECTION%%/d;/%%IF *HTML_CHAPTER%%/d" CONDS="/%%ENDIF.*%%/d;/%%IF *HTML_SECTION%%/d;/%%IF *HTML_CHAPTER%%/d"
fi fi
curdate=`$SETLANG date '+%B %d, %Y'` curdate=`$SETLANG date -u '+%B %d, %Y' -d @$timestamp`
sed \ sed \
-e "s!%%TITLE%%!$MANUAL_TITLE!g" \ -e "s!%%TITLE%%!$MANUAL_TITLE!g" \
-e "s!%%EMAIL%%!$EMAIL!g" \ -e "s!%%EMAIL%%!$EMAIL!g" \