comments about somewhat obscure functions
switched comments
moved this to 'todo' (probably wont get done:))
added some clarifications