diff --git a/examples/example-en.sg b/examples/example-en.sg
index 9f647e80..33c9e477 100644
--- a/examples/example-en.sg
+++ b/examples/example-en.sg
@@ -13,7 +13,7 @@
 % http://songs.sourceforge.net/songsdoc/songs.html
 
 % You may find complementary information in the Patacrep documentation file 
-% http://www.patacrep.com/data/documents/doc.pdf
+% http://www.patacrep.com/data/documents/doc_en.pdf
 % *******************************************************************************
 
 \selectlanguage{english} %defines the song main language
@@ -24,7 +24,7 @@
 % 8-bit-lagerfeuer : the file "8-bit-lagerfeuer.jpg" that corresponds to the album art
 % 8 bit lagerfeuer : the album whose song is extracted from 
 \beginsong{Sad robot}
-  [by=Pornophonique,cov=8-bit-lagerfeuer,album=8 bit lagerfeuer]
+  [by={Pornophonique},cov={8-bit-lagerfeuer},album={8 bit lagerfeuer}]
 
   % inserts the album art (8-bit-lagerfeuer.jpg)
   \cover
@@ -34,44 +34,48 @@
   % <strings> : series of six symbols, one for each string of the guitar from lowest pitch to highest. 
   % Each symbol should be one of: X if that string is not to be played, 0 (zero or the letter O) if that 
   % string is to be played open, or one of 1 through 9 if that string is to be played on the given numbered fret.
-  \gtab{Rém}{XX0231}
-  \gtab{Fa}{1:022100}
-  \gtab{Do}{X32010}
+  \gtab{D}{XX0231}
+  \gtab{F}{1:022100}
+  \gtab{C}{X32010}
 
-  % propose minimal information to play the song (do not repeat chords)
   % insert a chord right before the corresponding syllabe (no space)
-  % put a verse between \beginverse and \endverse
-  % put a chorus between \beginchorus and \endchorus
-  % \beginverse* defines a not numbered verse
+  % put a verse between \begin{verse} and \end{verse}
+  % put a chorus between \begin{chorus} and \end{chorus}
+  % \begin{verse*} defines a not numbered verse
   % use the \rep{n} macro for a sentence repeated n times
   % use the \echo{text} macro for background singing lyrics
 
   \lilypond{Sad_robot} % inserts the music sheet corresponding to the Sad_robot.ly file in the ./lilypond directory
 
-  \beginverse
-    His \[Rém]steely skin is covered
-    By \[Fa]centuries of dust
-    \[Do]Once he was a great one
-    \[Rém]Now he's dull and rust
-  \endverse
+  % verse environments are automatically numbered
+  \begin{verse}
+    His \[Dm]steely skin is covered
+    By \[F]centuries of dust
+    \[C]Once he was a great one
+    \[Dm]Now he's dull and rust
+  \end{verse}
 
-  \beginverse*
-    An oily tear he's crying
-    Can you feel the pain
-    Of the sad, sad robot
-    And it's driving him insane
-  \endverse
+  % repeatedchords environments allow to show (for sufficiency)
+  % or hide (for readability) duplicated chords
+  \begin{repeatedchords}
+    \begin{verse*}
+      An \[Dm]oily tear he's crying
+      \[F]Can you feel the pain
+      Of the \[C]sad, sad robot
+      And it's \[Dm]driving him insane
+    \end{verse*}
 
-  \beginverse*
-    He can't turn back time nor history
-    So his life became a misery
-    He has to face the destiny
-    Nobody cares anymore
-  \endverse
+    \begin{verse*}
+      He can't \[Dm]turn back time nor history
+      So his \[F]life became a misery
+      He \[C]has to face the destiny
+      Nobody \[Dm]cares anymore
+    \end{verse*}
+  \end{repeatedchords}
 
-  \beginchorus
+  \begin{chorus}
     Sad, sad robot \rep{3}
     All alone
-  \endchorus
+  \end{chorus}
   
 \endsong
diff --git a/examples/example-fr.sg b/examples/example-fr.sg
index e9c56819..2eeddd95 100644
--- a/examples/example-fr.sg
+++ b/examples/example-fr.sg
@@ -15,7 +15,7 @@
 
 % Vous trouverez des informations complémentations dans le fichier de
 % documentation sur Patacrep
-% http://www.patacrep.com/data/documents/doc.pdf
+% http://www.patacrep.com/data/documents/doc_fr.pdf
 % *******************************************************************************
 
 \selectlanguage{english} % définit la langue principale de la chanson
@@ -26,7 +26,7 @@
 % 8-bit-lagerfeuer : le fichier "8-bit-lagerfeuer.jpg" correspondant à la pochette de l'album
 % 8 bit lagerfeuer : le nom de l'album dont la chanson est extraite
 \beginsong{Sad robot}
-  [by=Pornophonique,cov=8-bit-lagerfeuer,album=8 bit lagerfeuer]
+  [by={Pornophonique},cov={8-bit-lagerfeuer},album={8 bit lagerfeuer}]
 
   % insère la pochette de l'album (8-bit-lagerfeuer.jpg)
   \cover
@@ -36,44 +36,47 @@
   % <cordes> : série de 6 symboles, un pour chaque corde, de la plus grave à la plus aigue
   % Ces symboles sont : X si la corde ne doit pas être jouée, 0 si la corde est jouée à vide,
   % un chiffre de 1 à 9 indiquant la fret adéquate
-  \gtab{Rém}{XX0231}
-  \gtab{Fa}{1:022100}
-  \gtab{Do}{X32010}
+  \gtab{Dm}{XX0231}
+  \gtab{F}{1:022100}
+  \gtab{C}{X32010}
 
-  % proposez l'information minimale pour rejouer la chanson (ne pas répeter les accords)
-  % insérer chaque accord avant la syllable correspondante (pas d'espace)
-  % mettez un couplet entre \beginverse et \endverse
-  % mettez un refrain entre \beginchorus et \endchorus
-  % \beginverse* est un couplet non numéroté
+  % insérez chaque accord avant la syllable correspondante (pas d'espace)
+  % mettez un couplet entre \begin{verse} et \end{verse}
+  % mettez un refrain entre \begin{chorus} et \end{chorus}
+  % \begin{verse*} est un couplet non numéroté
   % utilisez la macro \rep{n} pour une phrase répétée n fois
   % utilisez la macro \echo{text} pour les phrases chantées en arrière plan
 
   \lilypond{Sad_robot} % insère la partition correspondant au fichier Sad_robot.ly du répertoire ./lilypond
 
-  \beginverse
-    His \[Rém]steely skin is covered
-    By \[Fa]centuries of dust
-    \[Do]Once he was a great one
-    \[Rém]Now he's dull and rust
-  \endverse
+  \begin{verse}
+    His \[Dm]steely skin is covered
+    By \[F]centuries of dust
+    \[C]Once he was a great one
+    \[Dm]Now he's dull and rust
+  \end{verse}
 
-  \beginverse*
-    An oily tear he's crying
-    Can you feel the pain
-    Of the sad, sad robot
-    And it's driving him insane
-  \endverse
+  % l'environnement repeatedchords permet d'afficher (exhaustivité)
+  % ou de masquer (lisibilité) les accords répétés
+  \begin{repeatedchords}
+    \begin{verse*}
+      An \[Dm]oily tear he's crying
+      \[F]Can you feel the pain
+      Of the \[C]sad, sad robot
+      And it's \[Dm]driving him insane
+    \end{verse}
 
-  \beginverse*
-    He can't turn back time nor history
-    So his life became a misery
-    He has to face the destiny
-    Nobody cares anymore
-  \endverse
+    \begin{verse*}
+      He can't \[Dm]turn back time nor history
+      So his \[F]life became a misery
+      He \[C]has to face the destiny
+      Nobody \[Dm]cares anymore
+    \end{verse}
+  \end{repeatedchords}
 
-  \beginchorus
+  \begin{chorus}
     Sad, sad robot \rep{3}
     All alone
-  \endchorus
+  \end{chorus}
   
 \endsong