gras: added docs + tweaks to tool