Forum > Documentation (Maintaining -)

docs updates but smaller

(1/2) > >>

marcov:
I rebuilt FPC and lazarus CHM docs based on the FPC 3.2.x branch and lazarus trunk.

It seems the Lazarus documentation has gotten smaller, which could indicate a fpdoc problem. However the FPC docs are fine?!?!

If anybody notices anything, please comment here.

The archive at http:/www.stack.nl/~marcov/doc-chmbeta.zip has been updates (24.2 MB, was 24.9 MB)

dsiders:

--- Quote from: marcov on January 13, 2020, 09:30:15 pm ---I rebuilt FPC and lazarus CHM docs based on the FPC 3.2.x branch and lazarus trunk.

It seems the Lazarus documentation has gotten smaller, which could indicate a fpdoc problem. However the FPC docs are fine?!?!

If anybody notices anything, please comment here.

The archive at http:/www.stack.nl/~marcov/doc-chmbeta.zip has been updates (24.2 MB, was 24.9 MB)

--- End quote ---

The problem is that lcl.chm and lazutils.chm have no content at all provided by the XML files. Everything you're seeing is the generated output from FPDoc.

user.chm also got smaller, but I can't see an obvious reason for it yet.

marcov:
That would make sense and point to another BOM problem in build_lcl_docs.lpr.

I'll see if I can build it with a 3.2 fpdoc instead of a 3.3.1 fpdoc.

marcov:
I tried again today. No results but some observations:


* Fpc files are correctly generated
* lazutils and lcll not
* there is a BOM problem with the savetofile in build_lcl_docs but that is easily fixed
* I thought it was something with relative paths, but this is probably ok.
* In the fpdoc output of lazutils/lcl I see less output
* Fixes fpdoc has the same problem
Afaik the FPC docs are now compiled over project files. So maybe something is broken in the cmdline handling.

dsiders:

--- Quote from: marcov on January 16, 2020, 10:11:20 pm ---I tried again today. No results but some observations:


* Fpc files are correctly generated
* lazutils and lcll not
* there is a BOM problem with the savetofile in build_lcl_docs but that is easily fixed
* I thought it was something with relative paths, but this is probably ok.
* In the fpdoc output of lazutils/lcl I see less output
* Fixes fpdoc has the same problem
Afaik the FPC docs are now compiled over project files. So maybe something is broken in the cmdline handling.

--- End quote ---

Looking at the buildlcllog.txt, I found an error when it is writing pages.


--- Code: ---#lcl.WSControls.TWSWinControl.GetPreferredSize] Invalid description (illegFPDoc - Free Pascal Documentation Tool
--- End code ---

It's a content error in lcl/WSControls.xml. I am posting a bug report to correct it. Not sure if that might be the problem.

Bug report: https://bugs.freepascal.org/view.php?id=36594
Fixed in Revision 62566

Navigation

[0] Message Index

[#] Next page

Go to full version