LLVM
13.0.0git
|
Typedefs | |
using | char_16 = char[16] |
using | uuid_t = raw_ostream::uuid_t |
using | ErrorHandler = llvm::function_ref< void(const Twine &Msg)> |
using | BBNumberMap = DenseMap< int, int > |
Functions | |
bool | operator== (const BinaryRef &LHS, const BinaryRef &RHS) |
bool | yaml2archive (ArchYAML::Archive &Doc, raw_ostream &Out, ErrorHandler EH) |
bool | yaml2coff (COFFYAML::Object &Doc, raw_ostream &Out, ErrorHandler EH) |
bool | yaml2elf (ELFYAML::Object &Doc, raw_ostream &Out, ErrorHandler EH, uint64_t MaxSize) |
bool | yaml2macho (YamlObjectFile &Doc, raw_ostream &Out, ErrorHandler EH) |
bool | yaml2minidump (MinidumpYAML::Object &Doc, raw_ostream &Out, ErrorHandler EH) |
bool | yaml2wasm (WasmYAML::Object &Doc, raw_ostream &Out, ErrorHandler EH) |
bool | convertYAML (Input &YIn, raw_ostream &Out, ErrorHandler ErrHandler, unsigned DocNum=1, uint64_t MaxSize=UINT64_MAX) |
std::unique_ptr< object::ObjectFile > | yaml2ObjectFile (SmallVectorImpl< char > &Storage, StringRef Yaml, ErrorHandler ErrHandler) |
Convenience function for tests. More... | |
bool | dumpTokens (StringRef Input, raw_ostream &) |
Dump all the tokens in this stream to OS. More... | |
bool | scanTokens (StringRef Input) |
Scans all tokens in input without outputting anything. More... | |
std::string | escape (StringRef Input, bool EscapePrintable=true) |
Escape Input for a double quoted scalar; if EscapePrintable is true, all UTF8 sequences will be escaped, if EscapePrintable is false, those UTF8 sequences encoding printable unicode scalars will not be escaped, but emitted verbatim. More... | |
llvm::Optional< bool > | parseBool (StringRef S) |
Parse S as a bool according to https://yaml.org/type/bool.html. More... | |
template<class CollectionType > | |
CollectionType::iterator | begin (CollectionType &C) |
template<class CollectionType > | |
void | skip (CollectionType &C) |
static void | commonSectionMapping (IO &IO, ELFYAML::Section &Section) |
static void | sectionMapping (IO &IO, ELFYAML::DynamicSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::RawContentSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::BBAddrMapSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::StackSizesSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::HashSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::NoteSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::GnuHashSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::NoBitsSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::VerdefSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::SymverSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::VerneedSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::RelocationSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::RelrSection &Section) |
static void | groupSectionMapping (IO &IO, ELFYAML::GroupSection &Group) |
static void | sectionMapping (IO &IO, ELFYAML::SymtabShndxSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::AddrsigSection &Section) |
static void | fillMapping (IO &IO, ELFYAML::Fill &Fill) |
static void | sectionHeaderTableMapping (IO &IO, ELFYAML::SectionHeaderTable &SHT) |
static void | sectionMapping (IO &IO, ELFYAML::LinkerOptionsSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::DependentLibrariesSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::CallGraphProfileSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::ARMIndexTableSection &Section) |
static void | sectionMapping (IO &IO, ELFYAML::MipsABIFlags &Section) |
static StringRef | getStringValue (IO &IO, const char *Key) |
static void | setStringValue (IO &IO, const char *Key, StringRef Val) |
static bool | isInteger (StringRef Val) |
template<typename StructType > | |
void | mapLoadCommandData (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
template<> | |
void | mapLoadCommandData< MachO::segment_command > (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
template<> | |
void | mapLoadCommandData< MachO::segment_command_64 > (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
template<> | |
void | mapLoadCommandData< MachO::dylib_command > (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
template<> | |
void | mapLoadCommandData< MachO::rpath_command > (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
template<> | |
void | mapLoadCommandData< MachO::dylinker_command > (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
template<> | |
void | mapLoadCommandData< MachO::build_version_command > (IO &IO, MachOYAML::LoadCommand &LoadCommand) |
static void | commonSectionMapping (IO &IO, WasmYAML::Section &Section) |
static void | sectionMapping (IO &IO, WasmYAML::DylinkSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::NameSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::LinkingSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::ProducersSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::TargetFeaturesSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::CustomSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::TypeSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::ImportSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::FunctionSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::TableSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::MemorySection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::EventSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::GlobalSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::ExportSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::StartSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::ElemSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::CodeSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::DataSection &Section) |
static void | sectionMapping (IO &IO, WasmYAML::DataCountSection &Section) |
bool | convertYAML (yaml::Input &YIn, raw_ostream &Out, ErrorHandler ErrHandler, unsigned DocNum, uint64_t MaxSize) |
using llvm::yaml::BBNumberMap = typedef DenseMap<int, int> |
Definition at line 188 of file WebAssemblyMachineFunctionInfo.h.
using llvm::yaml::char_16 = typedef char[16] |
Definition at line 281 of file MachOYAML.h.
using llvm::yaml::ErrorHandler = typedef llvm::function_ref<void(const Twine &Msg)> |
Definition at line 51 of file yaml2obj.h.
using llvm::yaml::uuid_t = typedef raw_ostream::uuid_t |
Definition at line 291 of file MachOYAML.h.
CollectionType::iterator llvm::yaml::begin | ( | CollectionType & | C | ) |
Definition at line 386 of file YAMLParser.h.
References assert(), and ret().
Referenced by llvm::yaml::MappingNode::begin(), llvm::yaml::SequenceNode::begin(), and skip().
|
static |
Definition at line 1196 of file ELFYAML.cpp.
References assert(), and llvm::ARMBuildAttrs::Section.
Referenced by groupSectionMapping(), and sectionMapping().
|
static |
Definition at line 45 of file WasmYAML.cpp.
References llvm::ARMBuildAttrs::Section.
bool llvm::yaml::convertYAML | ( | Input & | YIn, |
raw_ostream & | Out, | ||
ErrorHandler | ErrHandler, | ||
unsigned | DocNum = 1 , |
||
uint64_t | MaxSize = UINT64_MAX |
||
) |
Referenced by yaml2ObjectFile().
bool llvm::yaml::convertYAML | ( | yaml::Input & | YIn, |
raw_ostream & | Out, | ||
ErrorHandler | ErrHandler, | ||
unsigned | DocNum, | ||
uint64_t | MaxSize | ||
) |
Definition at line 21 of file yaml2obj.cpp.
References yaml2archive(), yaml2coff(), yaml2elf(), yaml2macho(), yaml2minidump(), and yaml2wasm().
bool llvm::yaml::dumpTokens | ( | StringRef | Input, |
raw_ostream & | OS | ||
) |
Dump all the tokens in this stream to OS.
Definition at line 586 of file YAMLParser.cpp.
References llvm::yaml::Scanner::getNext(), T, llvm::yaml::Token::TK_Alias, llvm::yaml::Token::TK_Anchor, llvm::yaml::Token::TK_BlockEnd, llvm::yaml::Token::TK_BlockEntry, llvm::yaml::Token::TK_BlockMappingStart, llvm::yaml::Token::TK_BlockScalar, llvm::yaml::Token::TK_BlockSequenceStart, llvm::yaml::Token::TK_DocumentEnd, llvm::yaml::Token::TK_DocumentStart, llvm::yaml::Token::TK_Error, llvm::yaml::Token::TK_FlowEntry, llvm::yaml::Token::TK_FlowMappingEnd, llvm::yaml::Token::TK_FlowMappingStart, llvm::yaml::Token::TK_FlowSequenceEnd, llvm::yaml::Token::TK_FlowSequenceStart, llvm::yaml::Token::TK_Key, llvm::yaml::Token::TK_Scalar, llvm::yaml::Token::TK_StreamEnd, llvm::yaml::Token::TK_StreamStart, llvm::yaml::Token::TK_Tag, llvm::yaml::Token::TK_TagDirective, llvm::yaml::Token::TK_Value, and llvm::yaml::Token::TK_VersionDirective.
Escape Input for a double quoted scalar; if EscapePrintable
is true, all UTF8 sequences will be escaped, if EscapePrintable
is false, those UTF8 sequences encoding printable unicode scalars will not be escaped, but emitted verbatim.
Definition at line 683 of file YAMLParser.cpp.
References llvm::append_range(), llvm::StringRef::begin(), decodeUTF8(), llvm::numbers::e, encodeUTF8(), llvm::StringRef::end(), i, and llvm::sys::unicode::isPrintable().
|
static |
Definition at line 1329 of file ELFYAML.cpp.
References llvm::ELFYAML::Chunk::Name, llvm::ELFYAML::Chunk::Offset, llvm::ELFYAML::Fill::Pattern, and llvm::ELFYAML::Fill::Size.
Referenced by llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping().
Definition at line 1390 of file ELFYAML.cpp.
Referenced by llvm::AttributeImpl::getValueAsString(), llvm::yaml::MappingTraits< ELFYAML::ARMIndexTableEntry >::mapping(), and llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping().
|
static |
Definition at line 1313 of file ELFYAML.cpp.
References commonSectionMapping(), llvm::ELFYAML::GroupSection::Members, and llvm::ELFYAML::GroupSection::Signature.
Referenced by llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping().
|
static |
Definition at line 1400 of file ELFYAML.cpp.
References llvm::StringRef::getAsInteger().
Referenced by emitConjunctionRec(), llvm::NVPTXTargetLowering::LowerCall(), llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping(), and llvm::PatchLocation::set().
void llvm::yaml::mapLoadCommandData | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 204 of file MachOYAML.cpp.
void llvm::yaml::mapLoadCommandData< MachO::build_version_command > | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 237 of file MachOYAML.cpp.
References llvm::MachOYAML::LoadCommand::Tools.
void llvm::yaml::mapLoadCommandData< MachO::dylib_command > | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 219 of file MachOYAML.cpp.
References llvm::MachOYAML::LoadCommand::PayloadString.
void llvm::yaml::mapLoadCommandData< MachO::dylinker_command > | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 231 of file MachOYAML.cpp.
References llvm::MachOYAML::LoadCommand::PayloadString.
void llvm::yaml::mapLoadCommandData< MachO::rpath_command > | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 225 of file MachOYAML.cpp.
References llvm::MachOYAML::LoadCommand::PayloadString.
void llvm::yaml::mapLoadCommandData< MachO::segment_command > | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 207 of file MachOYAML.cpp.
References llvm::MachOYAML::LoadCommand::Sections.
void llvm::yaml::mapLoadCommandData< MachO::segment_command_64 > | ( | IO & | IO, |
MachOYAML::LoadCommand & | LoadCommand | ||
) |
Definition at line 213 of file MachOYAML.cpp.
References llvm::MachOYAML::LoadCommand::Sections.
Definition at line 98 of file YAML.h.
References llvm::ArrayRef< T >::empty().
llvm::Optional< bool > llvm::yaml::parseBool | ( | StringRef | S | ) |
Parse S
as a bool according to https://yaml.org/type/bool.html.
Definition at line 749 of file YAMLParser.cpp.
References LLVM_FALLTHROUGH, llvm::None, and S.
bool llvm::yaml::scanTokens | ( | StringRef | Input | ) |
Scans all tokens in input without outputting anything.
This is used for benchmarking the tokenizer.
Definition at line 670 of file YAMLParser.cpp.
References llvm::yaml::Scanner::getNext(), T, llvm::yaml::Token::TK_Error, and llvm::yaml::Token::TK_StreamEnd.
|
static |
Definition at line 1336 of file ELFYAML.cpp.
References llvm::ELFYAML::SectionHeaderTable::Excluded, llvm::ELFYAML::SectionHeaderTable::NoHeaders, llvm::ELFYAML::Chunk::Offset, and llvm::ELFYAML::SectionHeaderTable::Sections.
Referenced by llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping().
|
static |
Definition at line 1324 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1365 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1244 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1355 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1349 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1223 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
Referenced by llvm::yaml::MappingTraits< std::unique_ptr< WasmYAML::Section > >::mapping(), and llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping().
|
static |
Definition at line 1274 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1255 of file ELFYAML.cpp.
References assert(), commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1344 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1370 of file ELFYAML.cpp.
References llvm::Mips::AFL_EXT_NONE, llvm::Mips::AFL_REG_NONE, commonSectionMapping(), llvm::ARMBuildAttrs::Section, and llvm::Mips::Val_GNU_MIPS_ABI_FP_ANY.
|
static |
Definition at line 1281 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1268 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1228 of file ELFYAML.cpp.
References assert(), commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1302 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1308 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1250 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1319 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1291 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1285 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 1296 of file ELFYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 148 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 92 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 158 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 153 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 50 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 143 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 123 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 133 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 108 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 128 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 103 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 68 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 118 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 60 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 78 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 138 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 113 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 86 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
|
static |
Definition at line 98 of file WasmYAML.cpp.
References commonSectionMapping(), and llvm::ARMBuildAttrs::Section.
Definition at line 1396 of file ELFYAML.cpp.
Referenced by llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping().
void llvm::yaml::skip | ( | CollectionType & | C | ) |
Definition at line 394 of file YAMLParser.h.
References assert(), begin(), llvm::numbers::e, and i.
Referenced by llvm::yaml::MappingNode::skip(), and llvm::yaml::SequenceNode::skip().
bool llvm::yaml::yaml2archive | ( | ArchYAML::Archive & | Doc, |
raw_ostream & | Out, | ||
ErrorHandler | EH | ||
) |
Definition at line 20 of file ArchiveEmitter.cpp.
References llvm::ArchYAML::Archive::Content, llvm::StringRef::data(), I, llvm::ArchYAML::Archive::Magic, llvm::ArchYAML::Archive::Members, P, llvm::Check::Size, llvm::StringRef::size(), and llvm::raw_ostream::write().
Referenced by convertYAML().
bool llvm::yaml::yaml2coff | ( | COFFYAML::Object & | Doc, |
raw_ostream & | Out, | ||
ErrorHandler | EH | ||
) |
Definition at line 603 of file COFFEmitter.cpp.
References llvm::HexagonISD::CP, layoutCOFF(), layoutOptionalHeader(), and writeCOFF().
Referenced by convertYAML().
bool llvm::yaml::yaml2elf | ( | ELFYAML::Object & | Doc, |
raw_ostream & | Out, | ||
ErrorHandler | EH, | ||
uint64_t | MaxSize | ||
) |
Definition at line 1942 of file ELFEmitter.cpp.
References llvm::ELFYAML::FileHeader::Class, llvm::ELFYAML::FileHeader::Data, llvm::ELF::ELFCLASS64, llvm::ELF::ELFDATA2LSB, and llvm::ELFYAML::Object::Header.
Referenced by convertYAML().
bool llvm::yaml::yaml2macho | ( | YamlObjectFile & | Doc, |
raw_ostream & | Out, | ||
ErrorHandler | EH | ||
) |
Definition at line 635 of file MachOEmitter.cpp.
Referenced by convertYAML().
bool llvm::yaml::yaml2minidump | ( | MinidumpYAML::Object & | Doc, |
raw_ostream & | Out, | ||
ErrorHandler | EH | ||
) |
Definition at line 229 of file MinidumpEmitter.cpp.
References llvm::enumerate(), File, llvm::MinidumpYAML::Object::Header, layout(), llvm::makeArrayRef(), llvm::minidump::Header::NumberOfStreams, llvm::minidump::Header::StreamDirectoryRVA, and llvm::MinidumpYAML::Object::Streams.
Referenced by convertYAML().
std::unique_ptr< object::ObjectFile > llvm::yaml::yaml2ObjectFile | ( | SmallVectorImpl< char > & | Storage, |
StringRef | Yaml, | ||
ErrorHandler | ErrHandler | ||
) |
Convenience function for tests.
Definition at line 59 of file yaml2obj.cpp.
References llvm::SmallVectorImpl< T >::clear(), convertYAML(), llvm::object::ObjectFile::createObjectFile(), move, llvm::raw_svector_ostream::str(), llvm::Expected< T >::takeError(), and llvm::toString().
bool llvm::yaml::yaml2wasm | ( | WasmYAML::Object & | Doc, |
raw_ostream & | Out, | ||
ErrorHandler | EH | ||
) |
Definition at line 667 of file WasmEmitter.cpp.
Referenced by convertYAML().