[Kde-scm-interest] scripty questions

[Albert Astals Cid]

A Dissabte, 23 de maig de 2009, Chani va escriure:
> I have a plan for making scripty accept git modules, but it's bedtime now,
> so I want to dump a bunch of questions here in hte hopes that there'll be
> answers in hte morning :)
> there's one possible snag, btw... well, I'll get to that...
>
> first, there are some scripts that don't seem to be called from anywhere.

l10n-kde4/scripts != scripty

> is merge.sh obsolete? can it be deleted?
> repack-pot.pl isn't used right now; can it be deleted?

repack-pot.pl is used in update_translations and this is part of scripty

> what calls make_doc_externals? is it just called manually as needed?
Yes

> what calls createdoctemplates?
A person

> what calls process_orphans.sh
A person

> ? why's there a copy of it in l10n-support
> too? 
Because l10n-support is some kind of experiment for improving l10n and needs 
it

> why does process_orphans.txt look like nothing has ever been deleted
> from it?
Because it was not

> what's lbundle-check.py?
scripty does not touch l10n-support at all, forget about it

> does it read/write files outside of l10n
> folders?
>
> update_xml is run manually by .. some guy, as needed, right?
Yes

> why are we extracting messages from qt?
Because we need to translate it and Qt did not have a good track accepting 
external contributions

> if I was to move the scripty files into their own folder to separate them
> from the non-scripty files, would I have to change anything apart from
> those files and makemessages?

l10n-kde4/scripts/update_translations and kde-common/makemessages at least, 
but why risk breaking it?

> scripty's extract-messages takes care of making rc.cpp from all the ui
> files - but some Messages.sh do that too. is this a bug in those
> Messages.sh?
Not exactly a bug, but most of the times it wouldn't be needed. If you look 
carefully you'll see extract-messages only adds files of the same dir to 
rc.cpp, so programs like kmail need to create their own rc.cpp because need to 
include .ui files that are not in the same directory than the Messages.sh. But 
this can't be put in extract-messages itself because for example Okular has 
various Messages.sh if you make extract-messages find in all dirs it'll create 
"wrong" po files.

> now, the problem: documentation/ is full of svn externals. absolutely full
> of them.
> if this folder is only used by scripts (and people running the scripts who
> know what they're doing), then I should be able to write a script to fetch
> the code from git. but if translators expect this folder to be full of
> docbook files when checked out, that could be bad, when half those files
> are in git. (btw, only a couple of the externals successfully checked out
> when I tried anyways. svn: No such revision 971664 )

update_xml needs those files to be there.

> the best thing I can think of in that case is asking the translators to run
> a script to update documentation/ after they svn up (or checkout). which
> isn't ideal.
> so, do translators need it? 

Yes, as said update_xml needs it

> if so, is it a big deal to run a script after svn up? 

It's a step backwards

> are there any other ways of dealing with this?

You could make update_xml fetch the needed docbooks, but that'd be putting 
more strain in the server, tough update_xml is not called that often so it'd 
be an option.

> also, the documentation/ folder *is* treated as readonly, right?

It's a svn external, you can't commit into svn externals.

Albert