1
0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-25 12:12:47 +01:00
llvm-mirror/utils/TableGen/OptRSTEmitter.cpp
Reid Kleckner 80428fb35f Avoid including FileSystem.h from MemoryBuffer.h
Lots of headers pass around MemoryBuffer objects, but very few open
them. Let those that do include FileSystem.h.

Saves ~250 includes of Chrono.h & FileSystem.h:

$ diff -u thedeps-before.txt thedeps-after.txt | grep '^[-+] ' | sort | uniq -c | sort -nr
    254 -    ../llvm/include/llvm/Support/FileSystem.h
    253 -    ../llvm/include/llvm/Support/Chrono.h
    237 -    ../llvm/include/llvm/Support/NativeFormatting.h
    237 -    ../llvm/include/llvm/Support/FormatProviders.h
    192 -    ../llvm/include/llvm/ADT/StringSwitch.h
    190 -    ../llvm/include/llvm/Support/FormatVariadicDetails.h
...

This requires duplicating the file_t typedef, which is unfortunate. I
sunk the choice of mapping mode down into the cpp file using variable
template specializations instead of class members in headers.
2020-02-29 12:30:23 -08:00

88 lines
2.7 KiB
C++

//===- OptParserEmitter.cpp - Table Driven Command Line Parsing -----------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#include "OptEmitter.h"
#include "llvm/ADT/STLExtras.h"
#include "llvm/ADT/SmallString.h"
#include "llvm/ADT/StringMap.h"
#include "llvm/ADT/Twine.h"
#include "llvm/TableGen/Error.h"
#include "llvm/TableGen/Record.h"
#include "llvm/TableGen/TableGenBackend.h"
#include <cctype>
#include <cstring>
#include <map>
using namespace llvm;
/// OptParserEmitter - This tablegen backend takes an input .td file
/// describing a list of options and emits a RST man page.
namespace llvm {
void EmitOptRST(RecordKeeper &Records, raw_ostream &OS) {
llvm::StringMap<std::vector<Record *>> OptionsByGroup;
std::vector<Record *> OptionsWithoutGroup;
// Get the options.
std::vector<Record *> Opts = Records.getAllDerivedDefinitions("Option");
array_pod_sort(Opts.begin(), Opts.end(), CompareOptionRecords);
// Get the option groups.
const std::vector<Record *> &Groups =
Records.getAllDerivedDefinitions("OptionGroup");
for (unsigned i = 0, e = Groups.size(); i != e; ++i) {
const Record &R = *Groups[i];
OptionsByGroup.try_emplace(R.getValueAsString("Name"));
}
// Map options to their group.
for (unsigned i = 0, e = Opts.size(); i != e; ++i) {
const Record &R = *Opts[i];
if (const DefInit *DI = dyn_cast<DefInit>(R.getValueInit("Group"))) {
OptionsByGroup[DI->getDef()->getValueAsString("Name")].push_back(Opts[i]);
} else {
OptionsByGroup["options"].push_back(Opts[i]);
}
}
// Print options under their group.
for (const auto &KV : OptionsByGroup) {
std::string GroupName = KV.getKey().upper();
OS << GroupName << '\n';
OS << std::string(GroupName.size(), '-') << '\n';
OS << '\n';
for (Record *R : KV.getValue()) {
OS << ".. option:: ";
// Print the prefix.
std::vector<StringRef> Prefixes = R->getValueAsListOfStrings("Prefixes");
if (!Prefixes.empty())
OS << Prefixes[0];
// Print the option name.
OS << R->getValueAsString("Name");
// Print the meta-variable.
if (!isa<UnsetInit>(R->getValueInit("MetaVarName"))) {
OS << '=';
OS.write_escaped(R->getValueAsString("MetaVarName"));
}
OS << "\n\n";
// The option help text.
if (!isa<UnsetInit>(R->getValueInit("HelpText"))) {
OS << ' ';
OS.write_escaped(R->getValueAsString("HelpText"));
OS << "\n\n";
}
}
}
}
} // end namespace llvm