add aliases and a bit of documentation