documented new format, added missing case to tests