bdca8b01d2
#pragma once is a widely supported compiler pragma, even though it is not part of the C++ standard. Many of the issues keeping #pragma once from being standardized (distributed filesystems, build farms, hard links, etc.) do not apply to CMake - it is easy to build CMake on a single machine. CMake also does not install any header files which can be consumed by other projects (though cmCPluginAPI.h has been deliberately omitted from this conversion in case anyone is still using it.) Finally, #pragma once has been required to build CMake since at least August 2017 (7f29bbe6enabled server mode unconditionally, which had been using #pragma once since September 2016 (b13d3e0d)). The fact that we now require C++11 filters out old compilers, and it is unlikely that there is a compiler which supports C++11 but does not support #pragma once.
99 lines
2.8 KiB
C++
99 lines
2.8 KiB
C++
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
file Copyright.txt or https://cmake.org/licensing for details. */
|
|
#pragma once
|
|
|
|
#include "cmConfigure.h" // IWYU pragma: keep
|
|
|
|
#include <iosfwd>
|
|
#include <map>
|
|
#include <set>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "cmsys/RegularExpression.hxx"
|
|
|
|
/** \class cmRST
|
|
* \brief Perform basic .rst processing for command-line help
|
|
*
|
|
* This class implements a subset of reStructuredText and Sphinx
|
|
* document processing. It is used to print command-line help.
|
|
*
|
|
* If you modify the capabilities of this class, be sure to update
|
|
* the Help/manual/cmake-developer.7.rst documentation and to update
|
|
* the Tests/CMakeLib/testRST.(rst|expect) test input and output.
|
|
*/
|
|
class cmRST
|
|
{
|
|
public:
|
|
cmRST(std::ostream& os, std::string docroot);
|
|
bool ProcessFile(std::string const& fname, bool isModule = false);
|
|
|
|
private:
|
|
enum IncludeType
|
|
{
|
|
IncludeNormal,
|
|
IncludeModule,
|
|
IncludeTocTree
|
|
};
|
|
enum MarkupType
|
|
{
|
|
MarkupNone,
|
|
MarkupNormal,
|
|
MarkupEmpty
|
|
};
|
|
enum DirectiveType
|
|
{
|
|
DirectiveNone,
|
|
DirectiveParsedLiteral,
|
|
DirectiveLiteralBlock,
|
|
DirectiveCodeBlock,
|
|
DirectiveReplace,
|
|
DirectiveTocTree
|
|
};
|
|
|
|
void ProcessRST(std::istream& is);
|
|
void ProcessModule(std::istream& is);
|
|
void Reset();
|
|
void ProcessLine(std::string const& line);
|
|
void NormalLine(std::string const& line);
|
|
void OutputLine(std::string const& line, bool inlineMarkup);
|
|
std::string ReplaceSubstitutions(std::string const& line);
|
|
void OutputMarkupLines(bool inlineMarkup);
|
|
bool ProcessInclude(std::string file, IncludeType type);
|
|
void ProcessDirectiveParsedLiteral();
|
|
void ProcessDirectiveLiteralBlock();
|
|
void ProcessDirectiveCodeBlock();
|
|
void ProcessDirectiveReplace();
|
|
void ProcessDirectiveTocTree();
|
|
static void UnindentLines(std::vector<std::string>& lines);
|
|
|
|
std::ostream& OS;
|
|
std::string DocRoot;
|
|
int IncludeDepth;
|
|
bool OutputLinePending;
|
|
bool LastLineEndedInColonColon;
|
|
MarkupType Markup;
|
|
DirectiveType Directive;
|
|
cmsys::RegularExpression CMakeDirective;
|
|
cmsys::RegularExpression CMakeModuleDirective;
|
|
cmsys::RegularExpression ParsedLiteralDirective;
|
|
cmsys::RegularExpression CodeBlockDirective;
|
|
cmsys::RegularExpression ReplaceDirective;
|
|
cmsys::RegularExpression IncludeDirective;
|
|
cmsys::RegularExpression TocTreeDirective;
|
|
cmsys::RegularExpression ProductionListDirective;
|
|
cmsys::RegularExpression NoteDirective;
|
|
cmsys::RegularExpression ModuleRST;
|
|
cmsys::RegularExpression CMakeRole;
|
|
cmsys::RegularExpression InlineLink;
|
|
cmsys::RegularExpression InlineLiteral;
|
|
cmsys::RegularExpression Substitution;
|
|
cmsys::RegularExpression TocTreeLink;
|
|
|
|
std::vector<std::string> MarkupLines;
|
|
std::string DocDir;
|
|
std::map<std::string, std::string> Replace;
|
|
std::set<std::string> Replaced;
|
|
std::string ReplaceName;
|
|
};
|