Bug#1036293: [Pkg-pascal-devel] Bug#1036293: lazarus: LHelp needs CHM files to display online help

2023-05-20 Thread Abou Al Montacir
Control: -1 important

On Thu, 2023-05-18 at 22:41 +0100, Peter B wrote:
> Regarding the html help, looks to me that lazarus is looking in
> /usr/share/doc/lazarus/2.2.0/index.html
> a 2.2.0 folder, but the index is now in 2.2.6
This is an issue during the upgrade. You did configure your Lazarus help when
you were installing 2.2.0, then upon upgrade (the dialog message that appears)
this remained as is. You need just to go to Tools/Options.../Help/Help
Options and then check all entries replacing 2.2.0 by 2.2.6.

One normally should be able to use $(LazVer), but unfortunately this one has the
Debian full version (2.2.6+dfsg2-1) which is improper for that use.

On the other hand, the system wide configuration file seems OK for HTML help,
but the help files seems to be installed on the wrong location. This is probably
what forced people like you to change the path. However as no one complained, we
missed it.

This looks for me important rather than normal severity.
I'll try to fix this and issue and unblock request.

BTW: With correct path HTML help works well. I don't know if we need to fix CHM
help as FPC doc is already using the HTML format.
-- 
Cheers,
Abou Al Montacir


signature.asc
Description: This is a digitally signed message part


Bug#1036293: [Pkg-pascal-devel] Bug#1036293: lazarus: LHelp needs CHM files to display online help

2023-05-18 Thread Mike Swanson
On Thu, 2023-05-18 at 22:28 +0200, Abou Al Montacir wrote:
> Yes these files were removed from the source package. This was
> intentional not only to remove lintian warning but also to force
> using doct build during the lazarus build process.
> 
> 
> You can find them in lazarus-doc-2.2 package. If any is missing,
> please report it here.
> 

Interesting, I do see the lcl.chm in /usr/share/doc/lazarus/... but
LHelp doesn't open it by default.  I recall that working on Debian 11's
version of the package.  I may have placed blame in the wrong place
then, but there is still a bug (it is annoying to navigate to that
file, even when I do know what's going on).



Bug#1036293: [Pkg-pascal-devel] Bug#1036293: lazarus: LHelp needs CHM files to display online help

2023-05-18 Thread Abou Al Montacir
On Thu, 2023-05-18 at 12:13 -0700, Mike Swanson wrote:
> ...
> In order to resolve lintian reports in the Lazarus source package, the
> precompiled Windows help files (*.chm format) were removed and the package
> reuploaded.
Yes these files were removed from the source package. This was intentional not
only to remove lintian warning but also to force using doct build during the
lazarus build process.

>   However, these files are actually essential to Lazarus's ability
> to display help via the built-in LHelp program, which is launched via the Help
> menu in the application.  Without these files, Lazarus is unable to display
> help through this mechanism. 
You can find them in lazarus-doc-2.2 package. If any is missing, please report
it here.
> 
> Instead of removing the files, I would recommend shutting up Lintian through
> any possible means, if there is a way to make an exception or teach Lintian
> how to do an exception for that particular warning.
It is possible to override lintian errors, but we don't think this is the right
way to go. Documentation is subject of a dedicated package and is built from
source documentation. If any file is missing, please report it here and we will
see how to fix that.

Same for FPC documentation, it is packaged in a separate and dedicated package.
-- 
Cheers,
Abou Al Montacir


signature.asc
Description: This is a digitally signed message part