perl5.20 and document generation problem

[Dewayne Geraghty]

This might help someone avoid the same issue or provide a clue to more
knowledgeable folk.

I experienced doc generation failures on 9.3Stable for the
security/heimdal and sysutils/log_analysis ports.  Reverting from
perl5.20 to perl5.16 "eliminated" the following problems.

>From security/heimdal build log
----------------------------------------------
Making all in doc
sed -e 's,[@]dbdir[@],/var/heimdal,g'  -e
's,[@]PACKAGE_VERSION[@],1.5.2,g' < ./vars.tin > vars.texi.tmp
chmod +x vars.texi.tmp
mv vars.texi.tmp vars.texi
restore=: && backupdir=".am$$" &&  am__cwd=`pwd` &&
CDPATH="${ZSH_VERSION+.}:" && cd . &&  rm -rf $backupdir && mkdir
$backupdir &&  if (/bin/sh
/var/ports/usr/ports/security/heimdal/work/heimdal-1.5.2/missing --run
makeinfo --version) >/dev/null 2>&1; then  for f in ./heimdal.info
./heimdal.info-[0-9] ./heimdal.info-[0-9][0-9] ./heimdal.i[0-9]
./heimdal.i[0-9][0-9]; do  if test -f $f; then mv $f $backupdir;
restore=mv; else :; fi;  done;  else :; fi &&  cd "$am__cwd";  if
/bin/sh /var/ports/usr/ports/security/heimdal/work/heimdal-1.5.2/missing
--run makeinfo  --css-include=./heimdal.css -I .  -o ./heimdal.info
./heimdal.texi;  then  rc=0;  CDPATH="${ZSH_VERSION+.}:" && cd .;  else 
rc=$?;  CDPATH="${ZSH_VERSION+.}:" && cd . &&  $restore $backupdir/*
`echo "././heimdal.info" | sed 's|[^/]*$||'`;  fi;  rm -rf $backupdir;
exit $rc
./whatis.texi:39: unknown command `def'
./whatis.texi:39: unknown command `xsub'
./whatis.texi:40: unknown command `global'
./whatis.texi:40: unknown command `let'
./whatis.texi:40: unknown command `xsub' (possibly involving @sub)
./win2k.texi:314: warning: @end should only appear at a line beginning
*** [./heimdal.info] Error code 1

Stop in /var/ports/usr/ports/security/heimdal/work/heimdal-1.5.2/doc.
*** [all-recursive] Error code 1

>From sysutils/log_analysis log files, upstream has been unchanged for
around 2 years
-------------------------------------
===>  Building for log_analysis-0.46
/usr/local/bin/pod2man log_analysis > log_analysis.1
log_analysis around line 8793: You forgot a '=back' before '=head2'
log_analysis around line 8802: '=item' outside of any '=over'
POD document had syntax errors at /usr/local/bin/pod2man line 71.
*** [log_analysis.1] Error code 255

Stop in /var/ports/usr/ports/sysutils/log_analysis/work/log_analysis-0.46.
*** [do-build] Error code 1

Stop in /usr/ports/sysutils/log_analysis.

----------------------------------
texinfo-5.2.20140608   is installed, and the /etc/src.conf contains
WITHOUT_INFO=YES

Regards, Dewayne