documentation on metadata methods now mostly complete