Multiple mismatchs between e.g. gnucash-guide.xml and *-C.omf

[Geert Janssens]

Hi Frank,

Thanks for bringing this up. While I have worked a lot on the build process in 
the documentation while implementing pdf creation, I never knew the existing 
build process was based on gnome-doc-utils. I didn't know what the omf file 
was for (and I still don't actually), that it should be kept in sync with the 
other tool versions and so on.

I don't remember I took a more recent version of the docbook xslt files from 
the gnome-doc-utils project (as I wasn't aware of this project until now). I 
did upgrade it, but I thought I found this on the docboook website instead.

I'm all for upgrading to a more recent version, and especially for re-aligning 
the other parts I never did. This will have to be done very carefully though. 
I know I have made lots of changes in the makefiles and also a few in the xslt 
files. We will probably have to re-evaluate all of these changes and see if 
they still apply. As it's been a while that would mean I'd have to refresh my 
memory by studying what I actually did and why.

Regards,

Geert

Op donderdag 9 februari 2017 04:35:27 CET schreef Frank H. Ellenberger:
> I am currently searching a good form of olinks for referencing e.g.
> between guide and help. But their parameters depend on the docbook
> version. Looking in gnucash-guide I see
> 
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" ...
> 
> By accident I see in gnucash-guide-C.omf, the opensource meta file
> 
> <format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.1.2//EN"/>
> 
> Might yelp be confused if I would use olinks in a form, which was
> introduced in 4.2?
> 
> Also other other parameters differ. In short, our omfs are all outdated.
> 
> This would not had happen, if we had updated
> more often. As you can see from
> <!--
>       (Do not remove this comment block.)
>   Template Maintained by the GNOME Documentation Project:
> 	  http://developer.gnome.org/projects/gdp
>   Template version: 2.0 beta
>   Template last modified Feb 12, 2002
> -->
> our docs are based on gnome-doc-utils-devel or it's ancestor.
> 
> WHile working on the pdf generation Geert updated gnome-doc-utils (our
> xslt directory) from 1.45 to 1.75.2
> but the devel part (templates, makefile ...) was not incorporated.
> 
> Otherwise the omf files would be generated dynamical with recent date,
> version number, contributor list ...
> 
> So I would suggest to merge gnome-doc-utils-devel-0.20.10 or similar
> before GDP drops docbook support - they now prefer their homebrew
> mallard, other licenses etc.
> 
> If you agree, should we do it on maint or master, cherrypick or switch
> complete? I currently have no complete overview of the divergence
> between the make files.
> 
> Your thoughts?
> 
> ~Frank
> 
> 
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel