Documentation for hierarchical clustering options

[rlbarter]

There is currently no documentation explaining the distance and linkage options for clustering...

[jeremycfd]

Request: in distance documentation, explicitly state if euclidean distance matrices are squared or not (ward.D is only appropriate for squared distances, whereas ward.D2 is appropriate for non-squared distances).