diff --git a/i18n-gen.sh b/i18n-gen.sh
index 5bf137b0..4c5524b3 100755
--- a/i18n-gen.sh
+++ b/i18n-gen.sh
@@ -1,5 +1,6 @@
 #!/bin/bash
 
+#Calculates the direcory of the script in case it is run from another directory
 ROOT="${0%%i18n-gen.sh}"
 
 function usage() {
@@ -42,12 +43,15 @@ fi
 
 case "$OPERATION" in
 	init)
+		# If there is already a language file for specified language there is no need to generate a new one
+		# doing so would result in a loss of all already translated strings for that language
 		if [ -f "${ROOT}i18n/$1/LC_MESSAGES/glances.po" ]; then
 			echo "Error:"
 			echo "Language file for language $1 already exists"
 			echo "Please run \"$0 help\" for more information"
 			exit 1
 		fi
+		# Actual generation
 		mkdir -p ${ROOT}i18n/$1/LC_MESSAGES/
 		gen_pot
 		msginit --input=${ROOT}i18n/glances.pot --output=${ROOT}i18n/XX/LC_MESSAGES/glances.po
@@ -55,6 +59,8 @@ case "$OPERATION" in
 		exit 0
 		;;
 	update)
+		# When the language code is ALL fetch all language codes and save them
+		# else test if the specified language code really exists
 		if [ "$1" = "ALL" ]; then
 			LANG_LIST="$(ls -d ${ROOT}i18n/*/ | awk -F / '{print $(NF-1)}')"
 		else
@@ -66,6 +72,7 @@ case "$OPERATION" in
 			fi
 			LANG_LIST="$1"
 		fi
+		# regenerate the pot file so that it conatins the new strings and then update the language files accordingly
 		gen_pot
 		for i in $LANG_LIST; do
 			msgmerge --update --no-fuzzy-matching --backup=off ${ROOT}i18n/$i/LC_MESSAGES/glances.po ${ROOT}i18n/glances.pot
@@ -74,6 +81,8 @@ case "$OPERATION" in
 		exit 0
 		;;
 	gen)
+		# When the language code is ALL fetch all language codes and save them
+		# else test if the specified language code really exists
 		if [ "$1" = "ALL" ]; then
 			LANG_LIST="$(ls -d ${ROOT}i18n/*/ | awk -F / '{print $(NF-1)}')"
 		else
@@ -85,6 +94,7 @@ case "$OPERATION" in
 			fi
 			LANG_LIST="$1"
 		fi
+		# compile the language files 
 		for i in $LANG_LIST; do
 			msgfmt ${ROOT}i18n/$i/LC_MESSAGES/glances.po --output-file ${ROOT}i18n/$i/LC_MESSAGES/glances.mo
 			echo "Compiled language file for language $i generated"
@@ -92,6 +102,8 @@ case "$OPERATION" in
 		exit 0
 		;;
 	*)
+		# if anything other is entered as first argument print the usage overview
+		# so, the message to run "i18n-gen.sh help" is a LIE but who cares since the cake was a lie in the first place!
 		usage
 		;;
 esac