diff --git a/dk b/dk
index 96b60dc..824c72a 100755
--- a/dk
+++ b/dk
@@ -25,6 +25,12 @@ COMMANDES
         Afficher le profil courant
     b|build [NAME=VALUE...] [SERVICE]
         Construire les images. Les variables NAME=VALUE sont des 'build args'
+        Avec les projets de type docker-compose, le fichier .env est honoré
+        normalement. Si les fichiers .shared_env et/ou .MACHINE_env existent, où
+        MACHINE est la machine actuellement sélectionnée, alors les merger pour
+        créer le fichier .env
+        Par défaut, MACHINE vaut \$DOCKER_MACHINE_NAME. Si cette variable n'est
+        pas définie, prendre \$HOSTNAME
     p|push
     p|push [SERVICES...]
         La première syntaxe est utilisable avec un projet docker. Elle permet de
@@ -980,7 +986,7 @@ function build_update_apps() {
 }
 
 function build_merge_env() {
-    # si les fichiers .env-all et/ou .env-machine-$MACHINE existent, où $MACHINE
+    # si les fichiers .shared_env et/ou .${MACHINE}_env existent, où $MACHINE
     # est la machine actuellement sélectionnée, alors les merger pour créer le
     # fichier .env
     # Si DOCKER_MACHINE n'est pas défini, prendre par défaut HOSTNAME