Mostly documentation + Druid Resto Rotation

Mostly documentation - and fixing some function scopes while documenting
Fixed gendoc.py script - no more function-warningss in comments
Resto Rotation - this should be the final form - at least for a base rotation...
Works pretty well on normal bosses...no more mana problems, if you use tranquility wisely you won't have the hights hps, but you get along.
It's totally crap on trash....but who cares
If there's really high incoming damage because people keep on failing...(like garalon)...you'r oom...no chance to avoid it...but then you'll be top healer...
I'll add another rotation this week or in 2 weeks after my vacation...which wastes mana...so you can switch easily

PS: fixes #321