Problem Building KMyMoney 5.1.0: translation problem?

[Burkhard Lück]

Am Montag, 15. Juni 2020, 01:06:36 CEST schrieb Albert Astals Cid:
> El dilluns, 15 de juny de 2020, a les 0:56:39 CEST, Jack va escriure:
> > On 6/14/20 6:49 PM, Albert Astals Cid wrote:
> > > El dilluns, 15 de juny de 2020, a les 0:22:50 CEST, Jack va escriure:
> > >> KMyMoney just released version 5.1.0, and we received a build failure
> > >> report on the mailing list.  My comments/questions are at the bottom.
> > >> 
> > >> -------- Forwarded Message --------
> > >> With today's release of 5.1.0, decided to upgrade from a home complied
> > >> 5.0.8
> > >> 
> > >> The source link used is:
> > >> 
> > >> https://download.kde.org/stable/kmymoney/5.1.0/src/
> > >> I'm running Kubuntu 18.04 (a.k.a Ubuntu 18.04)
> > >> 
> > >> Downloaded the released tar.xz file and extracted.  Created a
> > >> sub-directory of build and ran the following command from that
> > >> directory
> > >> 
> > >> cmake .. -DCMAKE_INSTALL_PREFIX=/usr
> > >> 
> > >> And got the output text:
> > >> 
> > >> https://pastebin.com/raw/eszNxkDs
> > >> When trying to run make I get:
> > >> 
> > >> Scanning dependencies of target po-uk-docs-kmymoney-kmymoney-1
> > >> [  0%] Generating po/uk/docs/kmymoney/kmymoney.1
> > >> Note: Writing kmymoney.1
> > >> [  0%] Built target po-uk-docs-kmymoney-kmymoney-1
> > >> Scanning dependencies of target po-it-docs-kmymoney-kmymoney-1
> > >> [  0%] Generating po/it/docs/kmymoney/kmymoney.1
> > >> Note: Writing kmymoney.1
> > >> [  0%] Built target po-it-docs-kmymoney-kmymoney-1
> > >> Scanning dependencies of target po-ca-docs-kmymoney-index-cache-bz2
> > >> [  0%] Generating po/ca/docs/kmymoney/index.cache.bz2
> > >> details-formats.docbook:105: parser error : Entity 'ASCII' not defined
> > >> 
> > >>   >armadura &ASCII;</emphasis
> > >>   >
> > >>                    ^
> > >> 
> > >> details-formats.docbook:174: parser error : chunk is not well balanced
> > >> 
> > >> ^
> > >> index.docbook:368: parser error : Failure to process entity
> > >> details-formats
> > >> &details-formats;
> > >> 
> > >>                    ^
> > >> 
> > >> index.docbook:368: parser error : Entity 'details-formats' not defined
> > >> &details-formats;
> > >> 
> > >>                    ^
> > >> 
> > >> kf5.kdoctools: Error: `xmllint --noout` outputted text
> > >> CMakeFiles/po-ca-docs-kmymoney-index-cache-bz2.dir/build.make:90:
> > >> recipe
> > >> for target 'po/ca/docs/kmymoney/index.cache.bz2' failed
> > >> make[2]: *** [po/ca/docs/kmymoney/index.cache.bz2] Error 1
> > >> CMakeFiles/Makefile2:173: recipe for target
> > >> 'CMakeFiles/po-ca-docs-kmymoney-index-cache-bz2.dir/all' failed
> > >> make[1]: *** [CMakeFiles/po-ca-docs-kmymoney-index-cache-bz2.dir/all]
> > >> Error 2
> > >> Makefile:140: recipe for target 'all' failed
> > >> make: *** [all] Error 2
> > >> 
> > >> --------------------
> > >> 
> > >> The pastebin cmake output shows he is missing some dependency
> > >> libraries,
> > >> but I see nothing there that should affect the docbook errors.
> > >> 
> > >> His locale is en_US.UTF-8, and he is not trying to build for any other
> > >> locale.  There is no entity ASCII anywhere in any of the original
> > >> docbook files.  The word "ASCII" appears once within the text in
> > >> details-formats.docbook.
> > >> 
> > >> I got no errors when I previously ran checkXML5 on index.docbook, but
> > >> now I get:
> > >> 
> > >> Note: namesp. add : added namespace before processing              The
> > >> KMyMoney Handbook
> > >> Attributed 6226 IDs for element, cleaned up 0
> > >> 
> > >> Have I missed something in the docbook files, or is it possible there
> > >> is
> > >> something wrong somewhere in the translation process?  I'm not home
> > >> now,
> > >> and for irrelevant reasons, cannot actually try the build on my laptop.
> > >> (cmake is failing due to missing some files that should be present, and
> > >> I have not debugged yet.)  I will try compiling when I'm home in some
> > >> days, but hopefully can figure this out before then.
> > > 
> > > The ASCII entity was added to kdoctools in 5.50, Ubuntu 18.04 only ships
> > > 5.44 so it won't work.
> > > 
> > > He can just delete the po folder before running cmake if he's not
> > > interested in any of the translations
> > > 
> > > Cheers,
> > > 
> > >    Albert
> > 
> > Hi Albert,
> > 
> > Thanks, but there is no use of the ascii entity in the docbooks.
> 
> Yes there is
> 
> $ wcgrep ASCII
> ./kmymoney-5.1.0/po/ca/docs/kmymoney/details-formats.docbook:105:>armadura
> &ASCII;</emphasis

That is the reason for this build problem.

The source details-formats.docbook and the template kmymoney_details-
formats.pot do not use the entity &ASCII;, therefore it should not be used in 
the catalan kmymoney_details-formats.po as well.

> > Is it
> > that it is used in the po files, just to translate the word, even though
> > the entity is not used in the original?  Should I be using the entity in
> > the original?
> 
> Not really a documentation writer myself.
> 
> Burkhard is the one that added the entity, maybe he can give you a qualified
> opinion :)
> 
I added it to general.entities in kdoctools for later use, i. e for all 
docbooks depending on kdoctools > 5.50, but this is not true for kmymony  
5.1.0

-- 
Burkhard Lück