[vbox-dev] Updated translation of manual

Klaus Espenlaub klaus.espenlaub at oracle.com
Thu May 23 12:05:00 GMT 2013 

Hello Jean-Philippe,

we just discovered a few technical issues with your translation source 
(incorrect use of id=... attributes in the <title> tags) which result in 
dangling links in the HTML variant of the manual.

This is fixed (including the French translation) in the public 
repository in r46232, and I hope that "svn up" will merge this in 
without further trouble for you.

Just a heads up, the bug was purely on our side.

Klaus

On 15.05.2013 20:42, Jean-Philippe MENGUAL wrote:
> On mercredi 15 mai 2013 à 14:35:48 (+0200), Michael Thayer wrote:
>> Hello Jean-Philippe,
>
> Hi, :)
>
>>
>> I have applied your patch and updated the svn repository.  If you
>> have not made any changes since you created the patch you might want
>> to switch your local copy entirely to the svn one ("svn up && svn
>> revert doc/manual/fr_FR") so that we both have the same base to work
>> from.
>
> Thanks very much. If you applied the latest patch I sent after the .tar.gz
> containing all the xml files, it's up-to-date. So perfect.
>
>>
>> I made a few corrections and also combined the two change log files.
>
> Excellent
>
>> We have them separate in the English manual because
>> doc/manual/user_ChangeLogImpl.xml is changed regularly by developers
>> when they add features, but since you are translating everything
>> together you don't really need this (and it saves me from having to
>> add new logic into the make files!)
>
> Perfect.
>
>>
>> Thank you again for your contributions!  Out of interest, did you
>> ever manage to get in contact with Benjamin, who is maintaining the
>> French translation of the user interface?
>
> He wrote to me some weeks after my 1st message posting about the translation
> I ead just finished. I answered, but now I have not had news since this mail.
> It'd be good to work together, all the more as I cannot work with some toolkit
> or framework. So to translate, if I had to translate the GUI, I should understand
> how it is handled in the text files. So really, his help to review the manual
> and update his GUI work would be fine.
>
> Sincerely,
>
> JPM
>
>
>> Regards,
>>
>> Michael
>>
>> On 14/05/13 21:59, Jean-Philippe MENGUAL wrote:
>>> Thanks very much, and sorry for the mistake. I certainly did a false tweak
>>> trying to gain some time and actually... you lost time yourself... my apologies.
>>> Moreover I thought I had fixed the issue which concerned VBoxManage only, but
>>> it seems it was more important than I imagined (larger). Well... sorry and
>>> thanks again. I will be more careful to maintain clean the base you'll commit.
>>> It will be easier now I think.
>>>
>>> Sincerely,
>>>
>>> JPM
>>>
>>> On mardi 14 mai 2013 à 21:44:30 (+0200), Michael Thayer wrote:
>>>> Hello Jean-Philippe,
>>>>
>>>> Thank you!  I have finally got round to looking at your last upload.
>>>> The problem was that for some reason a couple of files got inserted
>>>> into others (the new version of user_GuestAdditions.xml got inserted
>>>> at the beginning of user_AdvancedTopics.xml and the new version of
>>>> user_VBoxManage.xml stuck on the end of the old one).  I have fixed
>>>> that and am making it build.  I will apply your patch and provide
>>>> you with a new version you can use as a base.
>>>>
>>>> Regards,
>>>>
>>>> Michael
>>>>
>>>> On 14/05/13 21:14, Jean-Philippe MENGUAL wrote:
>>>>> Hi,
>>>>>
>>>>> Here's a patch to update to the latest changes of the doc:
>>>>> http://demo.accelibreinfo.eu/patchupdatevboxmanfr.patch
>>>>>
>>>>> Regards,
>>>>>
>>>>> On vendredi 03 mai 2013 à 20:07:35 (+0200), Jean-Philippe MENGUAL wrote:
>>>>>> Hi Michael,
>>>>>>
>>>>>> Sorry I had not understood the nature of the problem. All the more as I'm unable
>>>>>> to understand how it happent.
>>>>>>
>>>>>> Actually it's fixed, I hope. The clean translation is on:
>>>>>> http://demo.accelibreinfo.eu/manualupd.tar.bz2
>>>>>>
>>>>>> Let me know any problem and thanks for the suggestions you made, which
>>>>>> helped me understanding better.
>>>>>>
>>>>>> Regards,
>>>>>>
>>>>>> On vendredi 03 mai 2013 à 14:06:22 (+0200), Michael Thayer wrote:
>>>>>>> Hello Jean-Philippe,
>>>>>>>
>>>>>>> Thanks for the update.  There is still the same issue as before
>>>>>>> though - the VBoxManage chapter is inserted into other files in
>>>>>>> seven places.  Do "grep chapter.id..vboxmanage" on the XML files to
>>>>>>> see this.  If you like I can fix this for you, but then you should
>>>>>>> probably do a complete fresh copy of my fixed files.
>>>>>>>
>>>>>>> Regards,
>>>>>>>
>>>>>>> Michael
>>>>>>>
>>>>>>> On 03/05/13 02:09, Jean-Philippe MENGUAL wrote:
>>>>>>>> Hi,
>>>>>>>>
>>>>>>>> On: http://demo.accelibreinfo.eu/manualupd.tar.bz2 you'll find the full up-to-date
>>>>>>>> manual. It'd be necessary to debug it from a xml point of view or tell me how I
>>>>>>>> can identify the errors.
>>>>>>>>
>>>>>>>> Please tell me how I can debug or when it is debugged so that I sync my work
>>>>>>>> copy for an easier future updating.
>>>>>>>>
>>>>>>>> You'll find also, in the tarball, the changelog which is translated. That's
>>>>>>>> why I've not sent anything for some weeks. I'll maintain it to stay up-to-date
>>>>>>>> in case you want to ship it someday. I prefer to maintain it as I don't feel
>>>>>>>> able to translate it for each release once the release is online. This kind of
>>>>>>>> doc is fastidious. So I prefer to translate on-the-fly, it's easier.
>>>>>>>>
>>>>>>>>
>>>>>>>> Thanks for your help and hope my doc helps :)
>>>>>>>>
>>>>>>>> Regards,
>>>>>>>>
>>>>>>>> JPM
>>>>>>>>
>>>>>>>> On lundi 08 avril 2013 à 10:23:21 (+0200), Michael Thayer wrote:
>>>>>>>>> Hello Jean-Philippe,
>>>>>>>>>
>>>>>>>>> On 02/04/13 23:39, Jean-Philippe MENGUAL wrote:
>>>>>>>>>> Hi,
>>>>>>>>>>
>>>>>>>>>> The latest changes of the user manual were translated here:
>>>>>>>>>> http://demo.accelibreinfo.eu/manualvboxupdated.patch
>>>>>>>>>>
>>>>>>>>>> it's a big patch, but its actual contents isn't. I think all the files appear
>>>>>>>>>> because I had to do some twicks with charset (converting to iso then re-convert
>>>>>>>>>> into utf-8. That's why the patch (svn diff) appears like this. I'm thinking of
>>>>>>>>>> some solution to produce clean patches.
>>>>>>>>>>
>>>>>>>>>> I am ready to read any suggestion. Anyway I hope it helps.
>>>>>>>>>
>>>>>>>>> Thank you for the update!  Sorry for the late reply - I am just back
>>>>>>>> >from holiday.  Something is clearly not quite right though with the
>>>>>>>>> way your system is producing the patches: if you search through the
>>>>>>>>> patch for the text '<chapter id="vboxmanage">' you will see what I
>>>>>>>>> mean.  I could probably fix this manually, but it might make sense
>>>>>>>>> for you to do that on your system (and then perhaps send your
>>>>>>>>> complete user manual text again as a compressed archive file to be
>>>>>>>>> sure that we are in sync).
>>>>>>>>>
>>>>>>>>> Regards,
>>>>>>>>>
>>>>>>>>> Michael
>>>>>>>>> --
>>>>>>>>> ORACLE Deutschland B.V. & Co. KG   Michael Thayer
>>>>>>>>> Werkstrasse 24                     VirtualBox engineering
>>>>>>>>> 71384 Weinstadt, Germany           mailto:michael.thayer at oracle.com
>>>>>>>>>
>>>>>>>>> Hauptverwaltung: Riesstr. 25, D-80992 München
>>>>>>>>> Registergericht: Amtsgericht München, HRA 95603
>>>>>>>>> Geschäftsführer: Jürgen Kunz
>>>>>>>>>
>>>>>>>>> Komplementärin: ORACLE Deutschland Verwaltung B.V.
>>>>>>>>> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
>>>>>>>>> Handelsregister der Handelskammer Midden-Niederlande, Nr. 30143697
>>>>>>>>> Geschäftsführer: Alexander van der Ven, Astrid Kepper, Val Maher
>>>>>>>
>>>>>>>
>>>>>>> --
>>>>>>> ORACLE Deutschland B.V. & Co. KG   Michael Thayer
>>>>>>> Werkstrasse 24                     VirtualBox engineering
>>>>>>> 71384 Weinstadt, Germany           mailto:michael.thayer at oracle.com
>>>>>>>
>>>>>>> Hauptverwaltung: Riesstr. 25, D-80992 München
>>>>>>> Registergericht: Amtsgericht München, HRA 95603
>>>>>>> Geschäftsführer: Jürgen Kunz
>>>>>>>
>>>>>>> Komplementärin: ORACLE Deutschland Verwaltung B.V.
>>>>>>> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
>>>>>>> Handelsregister der Handelskammer Midden-Niederlande, Nr. 30143697
>>>>>>> Geschäftsführer: Alexander van der Ven, Astrid Kepper, Val Maher
>>>>>>
>>>>>> _______________________________________________
>>>>>> vbox-dev mailing list
>>>>>> vbox-dev at virtualbox.org
>>>>>> https://www.virtualbox.org/mailman/listinfo/vbox-dev
>>>>
>>>>
>>>> --
>>>> ORACLE Deutschland B.V. & Co. KG   Michael Thayer
>>>> Werkstrasse 24                     VirtualBox engineering
>>>> 71384 Weinstadt, Germany           mailto:michael.thayer at oracle.com
>>>>
>>>> Hauptverwaltung: Riesstr. 25, D-80992 München
>>>> Registergericht: Amtsgericht München, HRA 95603
>>>> Geschäftsführer: Jürgen Kunz
>>>>
>>>> Komplementärin: ORACLE Deutschland Verwaltung B.V.
>>>> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
>>>> Handelsregister der Handelskammer Midden-Niederlande, Nr. 30143697
>>>> Geschäftsführer: Alexander van der Ven, Astrid Kepper, Val Maher
>>
>>
>> --
>> ORACLE Deutschland B.V. & Co. KG   Michael Thayer
>> Werkstrasse 24                     VirtualBox engineering
>> 71384 Weinstadt, Germany           mailto:michael.thayer at oracle.com
>>
>> Hauptverwaltung: Riesstr. 25, D-80992 München
>> Registergericht: Amtsgericht München, HRA 95603
>> Geschäftsführer: Jürgen Kunz
>>
>> Komplementärin: ORACLE Deutschland Verwaltung B.V.
>> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
>> Handelsregister der Handelskammer Midden-Niederlande, Nr. 30143697
>> Geschäftsführer: Alexander van der Ven, Astrid Kepper, Val Maher
>
> _______________________________________________
> vbox-dev mailing list
> vbox-dev at virtualbox.org
> https://www.virtualbox.org/mailman/listinfo/vbox-dev

More information about the vbox-dev mailing list