On Wednesday 12 of March 2014 14:09:07 Burkhard L?ck wrote: > Hi, > > a few days ago the kde-workspace master docbooks were switch to use the new > DTD 4.5 which should "Should fix build failures on build.kde.org" according > to the commit log. > Why was this necessary only for kde-workspace? Because (see below) kde-workspace master is frameworks-based.
> > Our workflow so far is to update docbooks in master (tracked by scripty to > trunk/l10n-kde4 for translation), which became either the new documentation > for stable release (tracked by scripty to branches/stable/l10n-kde4) or was > backported monthly in a stable release cycle. > > This does not work any more for kde-workspace because of the DTD switch to > 4.5. Didn't we talk about it? kde-workspace is an exception. master is the branch framework, so it should not be considered for release purpose of 4.x-based stuff. > > a) Translation teams can not generate language docbooks for kde-workspace > any more (not even for a typo fix or spellcheck) with kdelibs master, this > is only possible with frameworks Exactly. And developers can't generate code without using Frameworks as well, so we are on the same situation. > > b) I have updated 2 kcm docbooks for kde-workspace, but can not run > checkXML, because my devel environment has kdelibs master, not frameworks. > Pushing these updated docbooks to master would not work for translation, see > no a). Push to the latest stable branch (4.11) is also not possible due to > string freeze. If needed, I can regenerate docbooks for other languages for all environments. Anyway. kde-workspace will be split in the next weeks. Also, this is the same situation for documentation provided with Frameworks: you need KDocTools to regenerate documentation for them. > > What happens if docbooks in other modules switch to DTD 4.5 / frameworks? Only frameworks-based branches will switch to DTD 4.5. The number is going to increase, so we either need to start having a KF5-based environment for that, or we need to revamp the project for autogenerating translated docbooks on the server. Ciao -- Luigi
