bugfix: weights read from file were not being lowercased; also updated some documentation