updated javadoc for Matrix interface