Vastely update and rewrite the text
Include commends from bicatali

Signed-off-by: Justin Lecher <jlec@gentoo.org>