Building HTML documentation causes fpdoc to crash
Original Reporter info from Mantis: mazen
-
Reporter name: Abou Al Montacir
Original Reporter info from Mantis: mazen
- Reporter name: Abou Al Montacir
Description:
The issue was identified when trying to debug Debian bug https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=939414.
The reason of that bug is that fpdoc fails is called with missing options.
It was hided by an other bug causing fpdoc to crash silently and does not return a non zero exit code.
Steps to reproduce:
Just try to build html doces using hevea.
$ make hevea
...
FPDoc - Free Pascal Documentation Tool
Version 3.0.4 [2019/01/24]
(c) 2000 - 2003 Areca Systems GmbH / Sebastian Guenther, sg@freepascal.org
(c) 2005 - 2012 various FPC contributors
Exception at 000000000047F415: EInOutError:
File not found: rtl.xct.
make[2]: *** [Makefile:2729: fcl.chk] Error 1
Additional information:
The missing file rtl.xct is normally created by fpdoc itself when processing the RTL project and is used by fpdoc when processing FCL project.
However this file is not created because --content option is missing.
This option is added to RTLOPTS but that variable is not used when calling fpdoc for building fcl.chk (see Makefile.fpc:928).
The same issue with FCLOPT not called when calling fpdoc for building fcl.chk (see Makefile.fpc:941) which will lead to crash when building fclres.chk.
Mantis conversion info:
- Mantis ID: 36349
- OS: Debian GNU/Linux
- OS Build: Stretch
- Build: 3.0.4+dfsg-22
- Platform: x86_64
- Version: 3.0.4
- Fixed in version: 3.3.1
- Fixed in revision: 1672 (#f85f3aec)
- Target version: 3.2.0