fixed document for weighted sum functions