changing doc strings in preparation for the changeover to valid html5