Fedora 10 Release Notes Update

[Paul W. Frields]

On Sun, Feb 01, 2009 at 07:45:26PM -0500, John J. McDonough wrote:
>
> ----- Original Message ----- From: "Paul W. Frields" <stickster at gmail.com>
> To: <fedora-docs-list at redhat.com>
> Sent: Sunday, February 01, 2009 5:39 PM
> Subject: Re: Fedora 10 Release Notes Update
>
>> This happens before any other publishing -- leaving enough time for
>> translators to work on the content.  We're pretty far into the F11
>> development cycle so you'll want to talk to the translators on
>> fedora-trans-list to see how much time they feel they need.  If you
>> can give an idea of how extensive the changes are (how many string
>> changes in the POT?), that should help.
>
> I only pushed changes to the XML.  I hadn't made the pot.  When I did a 
> make pot, ad looked at the created file, I see a lot of empty msgstr.  
> Presumably in something translated there would be some text in there, but 
> given that the pot is created new from make how can that be?

Ah, this is how it's expected to work.  The POT is an empty PO
template, so there are no translations present inside.  Translators
copy "this-doc.pot" to "<xx>.po" where <xx> is their locale code.
Then they fill in the appropriate strings.  If they've already done
some work, they use special merging commands that update what's
changed, so they can check or add translations only as needed.

> Should the newly-made pot also be pushed?  Comments in the docs guide  
> indicate that some translators watch this, but I worry about the empty  
> msgstr's.

Yes, the new POT should be pushed.  In general you do this:

$ make pot po
$ cvs ci -m 'Put your message here' po/*.po{,t}

And yes, you are updating the locale-specific PO files as well as the
overall POT.  The PO files will be merged automatically, as described
above, and assuming their statistics display works properly,
translators will see the statistics change.  For instance, they'll see
that now there are 8 new, untranslated strings, and 17 "fuzzy"
(slightly changed) strings to work on.

> When I grep the pot for the changed XMLs, there seem to be perhaps 35  
> strings associated with those files.  I estimate perhaps 3/4 of those are  
> new/changed, so does that imply perhaps a couple dozen strings to be  
> translated?
>
> Of course, those are my changes.  There were a number of commits prior to  
> mine, not sure how to estimate what those might imply (although many 
> commit messages imply that they might not have included new/changed 
> prose).

To see what the XML changes have done, I generally do "make postat"
before I rebuild the POT, then again afterward, to see the effect.
Generally at least one PO file is completely translated and then the
effects are very easy to see.

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20090202/31b7cc30/attachment.bin