[kde-doc-english] No docs on d.k.o for stable

[Yuri Chornoivan]

написане Sat, 26 Oct 2013 14:45:04 +0300, Burkhard Lück  
<lueck at hube-lueck.de>:

> We have so far several issues with d.k.o updates:
> 1) To switch stable release version you need to change release number in  
> two
> different files (see e.g.
> http://websvn.kde.org/?view=revision&sortby=date&revision=1331259 ), but  
> one
> change was forgotten for the switch of stable to 4.12, the generator  
> script
> still has stable_branch="4.10"
> 2) Actually we remove all docbooks in stable/trunk (generator script  
> line 26)
> for two reasons:
> * Afaik populate_documentation.sh does not delete an obsolete directory
> * Switching stable fails (see comment #3 in
> https://bugs.kde.org/show_bug.cgi?id=308104 )
> But it would be sufficient to rm the docs only when switching stable,  
> that would
> prevent the situation we have now.
> 3) Crontab for docs user on library.kde.org has
> "MAILTO=sysadmin at kde.org,lueck at hube-lueck.de"
> This week I got two mails from 	Cron Daemon <root at library.kde.org>:
> a) Cron <docs at library> cd /home/docs/docs && svn up
>     "At revision 1367432."
>    ->  it is not possible to detect that "svn up" failed partially
> b) Cron <docs at library> /usr/bin/rsync -azvC --delete /home/docs/website/
> docs at spider.kde.org:/srv/www/docs
>    "sending incremental file list
>    ./
>    generated.inc.php
>    [snip]
>    sent 162033222 bytes  received 8728263 bytes  531139.92 bytes/sec
>    total size is 1034905291  speedup is 6.06
>    -> A *BIG* mail (10,7 MB)
> Some ideas to solve 1) - 3)
> * One place to change the release version, e.g a file  
> "d.k.o-release-numbers"
> with "stable=4.11" and "development=4.12.x" in www/areas/docs/.
> The generator script and index.php pull in these release numbers.
> The release number for stable can be used on liberty.kde.org to check if  
> the
> old docs need to be removed if the stable release number changes.
> In pseudo code this would be something like this at the beginning of the
> generator script:
> read stable from a file called "stable-release-number" with "stable=4.x"
> if no file "stable-release-number" or stable != stable in "d.k.o-release-
> numbers"
>    delete docbooks (rm -rf $websiteDir)
>    write stable from "d.k.o-release-numbers" to "stable-release-number"
> endif
> * remove MAILTO from Crontab
> * At the end of generator script mail logs/generator.log to this list.
> generator.log shows if updating the docbooks failed
> * New script for rsync run in Crontab
> Content of this script e.g.:
> read line numbers from "rsync2spider.log" (=log from last run)
> run "/usr/bin/rsync -azvC --delete /home/docs/website/
> docs at spider.kde.org:/srv/www/docs" with output to "rsync2spider.log"
> read new line numbers from "rsync2spider.log"(=log from current run)
> mail both line numbers to this list
> A big difference in both line numbers should indicate an error with  
> syncing
> What do you think?

Sounds nice to me as an incompetent non-professional. ;)