[Pkg-pascal-devel] CGE Lintian errors and warnings

[Michalis Kamburelis]

> According to this page, CGE has 1285 errors and 1324 warning issued by Lintian.
> Most error are about embedding JS libraries and possible security breaches resulting on using remote JS libraries.
>
> I don't feel having the courage to tackle them, but don't like also to neither keep them nor overriding them.
> Can anybody help reducing that to a reasonable number of errors.

It seems most of the warnings relate to our API docs including
Bootstrap3 (deprecated) and references to online things (like
https://oss.maxcdn.com/respond/1.4.2/respond.min.js ). These are
actually resolved already in CGE master -- where we migrated to latest
Bootstrap 5 and (from what I can see, as a consequence of Bootstrap
upgrade we also...) no longer link to respond.min.js.

I mentioned the Bootstrap upgrade in
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1088447 .

So, to get rid of them you can

1. wait for next CGE release (likely 7.0-alpha.4) -- but this means
waiting for us to finish some stuff (
https://castle-engine.io/wp/2024/12/31/done-2024-todo-2025-web-packages-ifc/
) so it may take a while (let's say 2-4 months),

2. or merge to Debian's CGE the changes we've done to "doc/pasdoc/" ,
see https://github.com/castle-engine/castle-engine/tree/master/doc/pasdoc
, since last release. They should be independent from the rest of the
engine.

3. or, also following the option I described in
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1088447 , you can
just remove the "styling" of CGE API docs. If you remove the options
--html-xxx from PasDoc call (here:
https://github.com/castle-engine/castle-engine/blob/8ce77b04e4420cfd4b9032aff43e7e883eaa8824/doc/pasdoc/mk_docs.sh#L201C1-L203C59
), also remove --css xxx, then you can also remove the
"doc/pasdoc/html-parts/"  subdirectory of CGE, regenerate API docs,
and then they will just have default PasDoc style. That's really OK
for me as an upstream, that "styling of API docs" is just something
"nice to have" not "must have".

AD 3 is likely the simplest to do, and it means that CGE no longer
pulls all the HTML/JS stuff, or any Bootstrap. The API docs generated
by PasDoc will just use default PasDoc style, that's OK. So if this
higher-priority, I would suggest to do this.

Regards,
Michalis