Documentation files
Brought to you by:
ra28145
On Gscan2pdf version 2.13.2 documentation does not work in Ubuntu 24.04.1.
To get the help file to display from the command line "gscan2pdf --help" you need to install the package perl-doc. The help dropdown in the gui shows file not found. This appears to be a folder permissions issue in packaging the Ubuntu repository on
/usr/share/help/C/gscan2pdf/documentation.html. as the file displays properly when copied to my home folder.
I have chased this down. In new versions of Ubuntu (at least 2.4.0 and up) Firefox is installed as a Snap with permissions that prohibit rendering local html files. Unfortunately Firefox does not drop an exit code, it just displays an error message.
There is some discussion about fixing this. I don't know if this will happen.
A workaround is to uninstall Firefox Snap and reinstall from .deb.
Another possibility would be to convert the file to an .md file and okular will open it
Okular is very likely to be installed if gscan2pdf is installed.
The problem seems not to exist for brave-browser, but that is not part of the normal Ubuntu install.
A way to adjust this for users would be to put the local file location in the .config/gscan2pdfrc file and a commented out copy that points to the documentation on your website which firefox is happy to display.