gsw.R: some new notes in general docs, near top of file