[Pkg-pascal-devel] Bug#858553: Re Bug#858553: [lazarus-doc-1.6] Package lazarus-doc-1.6 is empty and does not ship documentation files

[Paul Gevers]

Control: reassing -1 src:lazarus
Control: found -1 1.6.2+dfsg-1

On 01-04-17 21:45, Paul Gevers wrote:
> First shot at debugging from my side.

Second shot...

> 2) lazarus may have xml files that need updating.

Well, turns out that at least the error handling is going wrong in the
lazarus package. I had other errors introduced, and the build still
continued. I have no idea why yet, but this is hinting at lazarus
d/rules somehow. Therefor, reassigning back.

Anyways, as noted before the magic is going on in
docs/html/build_lcl_docs.lpr. It is that file that in the end creates
the code that runs fpdoc. I added a debug statement and found the fpdoc
call that was executed (or at least part of it, see ¹²). Because of the
failure to error out in a different situation as well, I stopped chasing
the error ignoring for a moment and found that in docs/xml/ there are
functions to update the xml files that are apparently causing the issues
or could fix the issue.

I haven't found the right incantations for multi_makeskel.pl yet to
regenerate the xml files. With my current tries, I seem to:
a) get ISO-8859-1 instead of UTF-8
b) loose information about the nodes that should be in the xml tree.

Will continue later.

Paul

¹
http://debomatic-amd64.debian.net/distribution#unstable/lazarus/1.6.2+dfsg-2/buildlog
² fpdoc --content=lcl.xct --package=lcl --descr=../../xml/lcl/lcl.xml
--input=@inputfile.txt  --format=html
--descr=../../xml/lcl/actnlist.xml --descr=../../xml/lcl/alllclunits.xml
--descr=../../xml/lcl/arrow.xml --descr=../../xml/lcl/asyncprocess.xml
--descr=../../xml/lcl/buttonpanel.xml ..... etc ....

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: OpenPGP digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-pascal-devel/attachments/20170403/03d63f22/attachment.sig>