[GNC] help: vs. ghelp: was: Problems upgrading to 4.8a

[Geert Janssens]

I have looked at the link and moved a bit upwards in the hierarchy to this page:
https://packages.debian.org/bookworm/all/gnucash-docs[1]
There's a link there to download the debian gnucash-docs source package on the right hand 
side. I have extracted that and found a rules file (presumably that's what's used to build and 
install ?)

Comparing the rules file in there between bullseye (stable) and bookworm (testing) does 
indeed suggest this happens because of the change to cmake.

It looks like the new rules file should explicitly add ghelp as target in the make rule that also 
builds html and pdf. So line 42 may have to become
	$(MAKE) -C $(BDIR) ghelp html pdf

Or for the upcoming 4.12
	$(MAKE) -C $(BDIR) xdghelp html pdf

Note that html and pdf were never really meant for inclusion in the linux distribution 
packages and not what gnucash has been designed to interact with. If the packager wants to 
they can be included though.

I'll add that due to a recent change in the build scripts the html target is no longer installed 
by default. If this installation is required for the debian package to contain the html output (it 
doesn't look like that) the override_dh_auto_configure line requires an additional option, 
namely
  -DWITH_HTML_INSTALL=ON

Final note: the -DWITH_PDF=ON should not be necessary. It's enabled by default when 
building on linux.

An alternative way to fix it would be to *disable* the unwanted targets (currently that would 
be epub via "-DWITH_EPUB=OFF") and then have override_dh_auto_build just build all 
instead of specific targets, like so:
	$(MAKE) -C $(BDIR)

Hopefully this extra info can help Dmitry decide on how to fix the gnucash-docs package on 
Debian.

Regards,

Geert

Op woensdag 7 september 2022 16:20:59 CEST schreef john:
> I'm pretty sure that the whole Debian ecosystem uses the Debian packages
> created by Dmitry Smirnov, which is why he's CC'd on this thread. The file
> list for his testing Gnucash-docs package:
> https://packages.debian.org/bookworm/all/gnucash-docs/filelist and for
> stable it's
> https://packages.debian.org/bullseye/all/gnucash-docs/filelistNote that
> stable has the docbook docs and testing doesn't. Might we have caused this
> with our cmake changes?
> 
> Regards,
> John Ralls
> 
> .
> 
> > On Sep 7, 2022, at 12:48 AM, Geert Janssens <geert.gnucash at kobaltwit.be>
> > wrote:> 
> > Op dinsdag 6 september 2022 19:00:47 CEST schreef Frank H. Ellenberger:
> > > Am 06.09.22 um 06:01 schrieb john:
> > > >> On Sep 5, 2022, at 2:01 PM, Frank H. Ellenberger
> > > >> <frank.h.ellenberger at gmail.com> wrote:
> > > >> 
> > > >> Hi,
> > > >> 
> > > >> Am 05.09.22 um 22:27 schrieb Geert Janssens:
> > > >>> Op maandag 5 september 2022 19:09:06 CEST schreef john:
> > > >>>> This is https://bugs.gnucash.org/show_bug.cgi?id=798612
> > > >>>> 
> > > >>>> I discovered while researching this that yelp v.42 just dropped
> > > >>>> support
> > > >>>> for