From 68bd1e92cece2b529902b208fb7948e3591db9ea Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 00:43:19 +0200 Subject: [PATCH 01/13] Documenting back porting and forward porting. --- CONTRIBUTING.rst | 54 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index a95dfcf61..5c9e4ab52 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -719,6 +719,60 @@ Fusion des fichiers *pot* de CPython make merge +Copier des traductions d'une branche à l'autre +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Dans certains cas on a besoin de bouger des traductions d'une branche +à l'autre : + +- D'une ancienne branche vers une nouvelle branche : Lors du passage + d'une version à l'autre de cpython, quelqu'un à une PR sur une + ancienne release (*forward porting*). +- D'une nouvelle branche vers des anciennes branches : Pour propager + de temps en temps le travail sur d'anciennes releases (*back porting*). + +On utilise ``pomerge`` : on le fait lire sur une branche, puis écrire +sur une autre, par exemple pour copier de la 3.7 à la 3.8 : + + git fetch + git checkout 3.7 + git reset --hard upstream/3.7 + pomerge --from-files *.po */*.po + git checkout -b forward-porting upstream/3.8 + pomerge --no-overwrite --to-files *.po */*.po + powrap -m + git add -p + git commit -m "Forward porting from 3.7" + git push -u origin HEAD + +Notes : + +- J'utilise ``git fetch`` au début pour avoir upstream/3.7 et + upstream/3.8 à jour localement, ainsi je peux travailler sans + toucher au réseau jusqu'au ``git push``, mais chacun fait comme il + veut. +- J'utilise ``*.po */*.po`` et pas ``**/*.po``, car si vous avez un + venv il va vous trouver des traductions de Sphinx et peut être + d'autres paquets dans ``.venv/lib/python*/`` (et mettre beaucoup + plus longtemps). +- J'utilise ``pomerge --no-overwrite``, ça indique à ``pomerge`` de + n'écrire que si le ``msgstr`` est vide, donc de ne pas modifier + l'existant, ainsi il est impossible de casser quelque chose, c'est + important lors du *forward-porting* pour ne pas défaire une + correction. Mais on pourrait le tenter sans ``---no-overwrite`` sur + du rétroportage, attention, ça fait des bêtises, ça nécessite une + relecture attentive : certaines traductions, comme *example:* sont en + francais parfois traduite avec une majuscule, et parfois non, en + fonction du contexte, ``pomerge`` uniformiserai ça, c'est pas bien. +- Attention, si vous testez sans ``--no-overwrite``, il est peut être + bon de vider la mémoire de ``pomerge`` avant la lecture, pour éviter + de lui faire écrire des choses lues lors des sessions précédentes, + via un ``rm -f ~/.pomerge.json``. +- J'utilise ``git add -p`` car j'aime bien relire quand même, + typiquement je n'ajoute pas les différnces d'ordre dans les entêtes, + mais un ``git add -u`` irait très bien. + + Synchronisation de la traduction avec Transifex ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From a2704fc58069102ea7e80321cb64560bafeaaa90 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 14:49:44 +0200 Subject: [PATCH 02/13] Update CONTRIBUTING.rst Co-authored-by: Antoine <43954001+awecx@users.noreply.github.com> --- CONTRIBUTING.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 5c9e4ab52..5c80b200d 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -725,10 +725,10 @@ Copier des traductions d'une branche à l'autre Dans certains cas on a besoin de bouger des traductions d'une branche à l'autre : -- D'une ancienne branche vers une nouvelle branche : Lors du passage +- d'une ancienne branche vers une nouvelle branche : lors du passage d'une version à l'autre de cpython, quelqu'un à une PR sur une - ancienne release (*forward porting*). -- D'une nouvelle branche vers des anciennes branches : Pour propager + ancienne release (*forward porting*) ; +- d'une nouvelle branche vers des anciennes branches : pour propager de temps en temps le travail sur d'anciennes releases (*back porting*). On utilise ``pomerge`` : on le fait lire sur une branche, puis écrire From 2af433e9ddbb4aa994fa549abb89a8995250ca27 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 14:49:54 +0200 Subject: [PATCH 03/13] Update CONTRIBUTING.rst Co-authored-by: Antoine <43954001+awecx@users.noreply.github.com> --- CONTRIBUTING.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 5c80b200d..b5824031d 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -747,30 +747,30 @@ sur une autre, par exemple pour copier de la 3.7 à la 3.8 : Notes : -- J'utilise ``git fetch`` au début pour avoir upstream/3.7 et +- j'utilise ``git fetch`` au début pour avoir upstream/3.7 et upstream/3.8 à jour localement, ainsi je peux travailler sans toucher au réseau jusqu'au ``git push``, mais chacun fait comme il - veut. -- J'utilise ``*.po */*.po`` et pas ``**/*.po``, car si vous avez un + veut ; +- j'utilise ``*.po */*.po`` et pas ``**/*.po``, car si vous avez un venv il va vous trouver des traductions de Sphinx et peut être d'autres paquets dans ``.venv/lib/python*/`` (et mettre beaucoup - plus longtemps). -- J'utilise ``pomerge --no-overwrite``, ça indique à ``pomerge`` de + plus longtemps) ; +- j'utilise ``pomerge --no-overwrite``, ça indique à ``pomerge`` de n'écrire que si le ``msgstr`` est vide, donc de ne pas modifier l'existant, ainsi il est impossible de casser quelque chose, c'est important lors du *forward-porting* pour ne pas défaire une - correction. Mais on pourrait le tenter sans ``---no-overwrite`` sur + correction. Mais on pourrait le tenter sans ``--no-overwrite`` sur du rétroportage, attention, ça fait des bêtises, ça nécessite une relecture attentive : certaines traductions, comme *example:* sont en francais parfois traduite avec une majuscule, et parfois non, en - fonction du contexte, ``pomerge`` uniformiserai ça, c'est pas bien. -- Attention, si vous testez sans ``--no-overwrite``, il est peut être + fonction du contexte, ``pomerge`` uniformiserait ça, ce n'est pas bien ; +- attention, si vous testez sans ``--no-overwrite``, il est peut être bon de vider la mémoire de ``pomerge`` avant la lecture, pour éviter de lui faire écrire des choses lues lors des sessions précédentes, - via un ``rm -f ~/.pomerge.json``. -- J'utilise ``git add -p`` car j'aime bien relire quand même, - typiquement je n'ajoute pas les différnces d'ordre dans les entêtes, - mais un ``git add -u`` irait très bien. + via un ``rm -f ~/.pomerge.json`` ; +- j'utilise ``git add -p`` car j'aime bien relire quand même, + typiquement je n'ajoute pas les différences d'ordre dans les entêtes, + mais un ``git add -u`` irait très bien ; Synchronisation de la traduction avec Transifex From 4cb8eb946bdcc98be766d173f7decfbd5df6c5f1 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 14:51:12 +0200 Subject: [PATCH 04/13] dict --- CONTRIBUTING.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index b5824031d..52fee18df 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -771,6 +771,7 @@ Notes : - j'utilise ``git add -p`` car j'aime bien relire quand même, typiquement je n'ajoute pas les différences d'ordre dans les entêtes, mais un ``git add -u`` irait très bien ; +- attention au fichier dict à qui il peut manquer des lignes. Synchronisation de la traduction avec Transifex From 313af734910429f86aac44c54d741a988525bef6 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 16:58:00 +0200 Subject: [PATCH 05/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 52fee18df..fceea18ec 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -726,7 +726,7 @@ Dans certains cas on a besoin de bouger des traductions d'une branche à l'autre : - d'une ancienne branche vers une nouvelle branche : lors du passage - d'une version à l'autre de cpython, quelqu'un à une PR sur une + d'une version à l'autre de cpython, quelqu'un a une PR sur une ancienne release (*forward porting*) ; - d'une nouvelle branche vers des anciennes branches : pour propager de temps en temps le travail sur d'anciennes releases (*back porting*). From 14ace86ab2948cf2a63dd61b042e1759a88e927d Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 16:58:30 +0200 Subject: [PATCH 06/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index fceea18ec..7444410a4 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -741,7 +741,7 @@ sur une autre, par exemple pour copier de la 3.7 à la 3.8 : git checkout -b forward-porting upstream/3.8 pomerge --no-overwrite --to-files *.po */*.po powrap -m - git add -p + git add --patch git commit -m "Forward porting from 3.7" git push -u origin HEAD From 5623bf4c986bea1a953efbab6726b471c590d734 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 16:58:42 +0200 Subject: [PATCH 07/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 7444410a4..7f1dfd84d 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -743,7 +743,7 @@ sur une autre, par exemple pour copier de la 3.7 à la 3.8 : powrap -m git add --patch git commit -m "Forward porting from 3.7" - git push -u origin HEAD + git push --set-upstream origin HEAD Notes : From 637db45ed9f3d421a99efea536409a69d61738b1 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 16:58:54 +0200 Subject: [PATCH 08/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 7f1dfd84d..7cf95b1a8 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -752,7 +752,7 @@ Notes : toucher au réseau jusqu'au ``git push``, mais chacun fait comme il veut ; - j'utilise ``*.po */*.po`` et pas ``**/*.po``, car si vous avez un - venv il va vous trouver des traductions de Sphinx et peut être + venv dans l'arborescence il va vous trouver des traductions de Sphinx et peut-être d'autres paquets dans ``.venv/lib/python*/`` (et mettre beaucoup plus longtemps) ; - j'utilise ``pomerge --no-overwrite``, ça indique à ``pomerge`` de From f5c80f524418641e47b5036ad0597a448cd97191 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 17:01:37 +0200 Subject: [PATCH 09/13] fix rest --- CONTRIBUTING.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 7cf95b1a8..78f4f20db 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -731,8 +731,8 @@ Dans certains cas on a besoin de bouger des traductions d'une branche - d'une nouvelle branche vers des anciennes branches : pour propager de temps en temps le travail sur d'anciennes releases (*back porting*). -On utilise ``pomerge`` : on le fait lire sur une branche, puis écrire -sur une autre, par exemple pour copier de la 3.7 à la 3.8 : +On utilise ``pomerge``\  : on le fait lire sur une branche, puis écrire +sur une autre, par exemple pour copier de la 3.7 à la 3.8 :: git fetch git checkout 3.7 @@ -767,7 +767,7 @@ Notes : - attention, si vous testez sans ``--no-overwrite``, il est peut être bon de vider la mémoire de ``pomerge`` avant la lecture, pour éviter de lui faire écrire des choses lues lors des sessions précédentes, - via un ``rm -f ~/.pomerge.json`` ; + via un ``rm -f ~/.pomerge.json``\  ; - j'utilise ``git add -p`` car j'aime bien relire quand même, typiquement je n'ajoute pas les différences d'ordre dans les entêtes, mais un ``git add -u`` irait très bien ; From 20d3a6f1aa1e5f338558a2a2bf24d7c254924f89 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 17:02:39 +0200 Subject: [PATCH 10/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 78f4f20db..e6b2bed36 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -742,7 +742,7 @@ sur une autre, par exemple pour copier de la 3.7 à la 3.8 :: pomerge --no-overwrite --to-files *.po */*.po powrap -m git add --patch - git commit -m "Forward porting from 3.7" + git commit --message="Forward porting from 3.7" git push --set-upstream origin HEAD Notes : From dd2ef88c02d3466c5be8dc09585fe26484876c65 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 17:03:56 +0200 Subject: [PATCH 11/13] fix --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index e6b2bed36..81307de5e 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -770,7 +770,7 @@ Notes : via un ``rm -f ~/.pomerge.json``\  ; - j'utilise ``git add -p`` car j'aime bien relire quand même, typiquement je n'ajoute pas les différences d'ordre dans les entêtes, - mais un ``git add -u`` irait très bien ; + mais un ``git add --update`` irait très bien ; - attention au fichier dict à qui il peut manquer des lignes. From fae7c8ecf70605772208bee582b7aa78c78f758d Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 17:04:15 +0200 Subject: [PATCH 12/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 81307de5e..88e0b0461 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -771,7 +771,7 @@ Notes : - j'utilise ``git add -p`` car j'aime bien relire quand même, typiquement je n'ajoute pas les différences d'ordre dans les entêtes, mais un ``git add --update`` irait très bien ; -- attention au fichier dict à qui il peut manquer des lignes. +- attention au fichier *dict* à qui il peut manquer des lignes. Synchronisation de la traduction avec Transifex From 405f6301f7a629ef9a4c41375b3b5bf6f1da09fc Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Mon, 8 Jun 2020 17:04:27 +0200 Subject: [PATCH 13/13] Update CONTRIBUTING.rst Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com> --- CONTRIBUTING.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 88e0b0461..e4c253d3f 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -768,7 +768,7 @@ Notes : bon de vider la mémoire de ``pomerge`` avant la lecture, pour éviter de lui faire écrire des choses lues lors des sessions précédentes, via un ``rm -f ~/.pomerge.json``\  ; -- j'utilise ``git add -p`` car j'aime bien relire quand même, +- j'utilise ``git add --patch`` (ou ``-p``) car j'aime bien relire quand même, typiquement je n'ajoute pas les différences d'ordre dans les entêtes, mais un ``git add --update`` irait très bien ; - attention au fichier *dict* à qui il peut manquer des lignes.