forked from OSchip/llvm-project
132 lines
3.3 KiB
C++
132 lines
3.3 KiB
C++
//===--- CommentBriefParser.cpp - Dumb comment parser ---------------------===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "clang/AST/CommentBriefParser.h"
|
|
#include "llvm/ADT/StringSwitch.h"
|
|
|
|
namespace clang {
|
|
namespace comments {
|
|
|
|
namespace {
|
|
/// Convert all whitespace into spaces, remove leading and trailing spaces,
|
|
/// compress multiple spaces into one.
|
|
void cleanupBrief(std::string &S) {
|
|
bool PrevWasSpace = true;
|
|
std::string::iterator O = S.begin();
|
|
for (std::string::iterator I = S.begin(), E = S.end();
|
|
I != E; ++I) {
|
|
const char C = *I;
|
|
if (C == ' ' || C == '\n' || C == '\r' ||
|
|
C == '\t' || C == '\v' || C == '\f') {
|
|
if (!PrevWasSpace) {
|
|
*O++ = ' ';
|
|
PrevWasSpace = true;
|
|
}
|
|
continue;
|
|
} else {
|
|
*O++ = C;
|
|
PrevWasSpace = false;
|
|
}
|
|
}
|
|
if (O != S.begin() && *(O - 1) == ' ')
|
|
--O;
|
|
|
|
S.resize(O - S.begin());
|
|
}
|
|
|
|
bool isBlockCommand(StringRef Name) {
|
|
return llvm::StringSwitch<bool>(Name)
|
|
.Cases("brief", "short", true)
|
|
.Cases("result", "return", "returns", true)
|
|
.Cases("author", "authors", true)
|
|
.Case("pre", true)
|
|
.Case("post", true)
|
|
.Cases("param", "arg", true)
|
|
.Default(false);
|
|
}
|
|
} // unnamed namespace
|
|
|
|
std::string BriefParser::Parse() {
|
|
std::string FirstParagraphOrBrief;
|
|
std::string ReturnsParagraph;
|
|
bool InFirstParagraph = true;
|
|
bool InBrief = false;
|
|
bool InReturns = false;
|
|
|
|
while (Tok.isNot(tok::eof)) {
|
|
if (Tok.is(tok::text)) {
|
|
if (InFirstParagraph || InBrief)
|
|
FirstParagraphOrBrief += Tok.getText();
|
|
else if (InReturns)
|
|
ReturnsParagraph += Tok.getText();
|
|
ConsumeToken();
|
|
continue;
|
|
}
|
|
|
|
if (Tok.is(tok::command)) {
|
|
StringRef Name = Tok.getCommandName();
|
|
if (Name == "brief" || Name == "short") {
|
|
FirstParagraphOrBrief.clear();
|
|
InBrief = true;
|
|
ConsumeToken();
|
|
continue;
|
|
}
|
|
if (Name == "result" || Name == "return" || Name == "returns") {
|
|
InReturns = true;
|
|
ReturnsParagraph += "Returns ";
|
|
}
|
|
// Block commands implicitly start a new paragraph.
|
|
if (isBlockCommand(Name)) {
|
|
// We found an implicit paragraph end.
|
|
InFirstParagraph = false;
|
|
if (InBrief)
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (Tok.is(tok::newline)) {
|
|
if (InFirstParagraph || InBrief)
|
|
FirstParagraphOrBrief += ' ';
|
|
else if (InReturns)
|
|
ReturnsParagraph += ' ';
|
|
ConsumeToken();
|
|
|
|
if (Tok.is(tok::newline)) {
|
|
ConsumeToken();
|
|
// We found a paragraph end.
|
|
InFirstParagraph = false;
|
|
InReturns = false;
|
|
if (InBrief)
|
|
break;
|
|
}
|
|
continue;
|
|
}
|
|
|
|
// We didn't handle this token, so just drop it.
|
|
ConsumeToken();
|
|
}
|
|
|
|
cleanupBrief(FirstParagraphOrBrief);
|
|
if (!FirstParagraphOrBrief.empty())
|
|
return FirstParagraphOrBrief;
|
|
|
|
cleanupBrief(ReturnsParagraph);
|
|
return ReturnsParagraph;
|
|
}
|
|
|
|
BriefParser::BriefParser(Lexer &L) : L(L) {
|
|
// Get lookahead token.
|
|
ConsumeToken();
|
|
}
|
|
|
|
} // end namespace comments
|
|
} // end namespace clang
|
|
|
|
|