DOC : whole bunch of documentation clean up

It is the most easily accessible tool for keeping track of/discussing changes to the code.  It is unweildy to have many (very) old issues around.  We should probably be better about closing things we really aren't going to implement.  Maybe we should ask people to mail feature requests to the mailing list which get converted to issues when there is consensus they should be done (or some one just starts doing it).

When all you have is an issue tracker everthing looks like an issue....