diff --git a/man/elixir.1.in b/man/elixir.1.in
index 0ffab5d18d..66d16947a0 100644
--- a/man/elixir.1.in
+++ b/man/elixir.1.in
@@ -3,12 +3,16 @@
 .Os
 .Sh NAME
 .Nm elixir
-.Nd TODO: come up with some short description
+.Nd The Elixir script runner
 .Sh SYNOPSIS
 .Nm
 .Op Ar OPTIONS
 .Sh DESCRIPTION
-TODO: come up with some description.
+The program starts the runtime system typically for the execution of one or more scripts. It is similar to
+.Xr iex 1 ,
+but
+.Nm
+exits when the executed script does.
 .Sh OPTIONS
 Note that many of the options mentioned here were borrowed from the Erlang shell, therefore
 .Xr erl 1
diff --git a/man/iex.1.in b/man/iex.1.in
index 517ea3a8f2..fb432be00b 100644
--- a/man/iex.1.in
+++ b/man/iex.1.in
@@ -8,7 +8,7 @@
 .Nm
 .Op Ar OPTIONS
 .Sh DESCRIPTION
-The interactive shell allows testing the work of small pieces of code escaping the stage of saving the code in a file.
+The interactive shell is used for evaluation, debugging and introspection of the Elixir runtime system. It is also possible to use the program for testing the work of small pieces of code escaping the stage of saving the code in a file.
 .Sh OPTIONS
 Note that many of the options mentioned here were borrowed from the Erlang shell, therefore
 .Xr erl 1