FPDoc questions
lazarus / 62-General

----------------------------------------------------------------------
dsiders · 2020-08-23 04:50

I am trying to use FPDoc to generate a chm file for package in
Lazarus, and have found a couple of issues.

First, the --write-project option generates a project file that
includes an IMPORTS tag. It is not documented in the FPDoc.CHM file,
or at https://www.freepascal.org/docs-html/current/fpdoc/.

I think I have it figured out:

Code: XML  [Select][+][-]window.onload = function(){var x1 =
document.getElementById("main_content_section"); if (x1) { var x =
document.getElementsByClassName("geshi");for (var i = 0; i <imports> 
<import file="../../../docs/chm/rtl.xct" prefix="ms-its:rtl.chm::/"/> 
<import file="../../../docs/chm/fcl.xct" prefix="ms-its:fcl.chm::/"/> 
<import file="../../../docs/chm/lcl.xct" prefix="ms-its:lcl.chm::/"/> 
<import file="../../../docs/chm/lazutils.xct" prefix="ms-
its:lazutils.chm::/"/></imports> 
Just looking for confirmation that this is correct. I'll add a bug
report for the missing docs later.

Second, the code analyzer in FPDoc stumbles on the Code: Pascal
 [Select][+][-]window.onload = function(){var x1 =
document.getElementById("main_content_section"); if (x1) { var x =
document.getElementsByClassName("geshi");for (var i = 0; i PLATFORM
and Code: Pascal  [Select][+][-]window.onload = function(){var x1 =
document.getElementById("main_content_section"); if (x1) { var x =
document.getElementsByClassName("geshi");for (var i = 0; i
EXPERIMENTAL hints/directives. Is there a recommended way to work
around this?

TIA

----------------------------------------------------------------------
marcov · 2020-08-23 09:35

There is support for platform and experimental for quite some time, so
if it doesn't work it is a bug. Maybe some of the pas2js work
accidentally undone it.

Import is a fairly normal construct, but yes, it should be added to
the project file description. Another bug then.

----------------------------------------------------------------------
dsiders · 2020-08-23 15:26

Quote from: marcov on August 23, 2020, 11:35:30 amThere is support for
platform and experimental for quite some time, so if it doesn't work
it is a bug. Maybe some of the pas2js work accidentally undone it.

Import is a fairly normal construct, but yes, it should be added to
the project file description. Another bug then.

Done.

https://bugs.freepascal.org/view.php?id=37628
https://bugs.freepascal.org/view.php?id=37629