[kde-doc-english] Docbooks in kde-workspace master

[Luigi Toscano]

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