STYLE: move the code for the different formats of the generated help into
their own classes, making cmDocumentation smaller and also making it easier to eventually add another format Alex
This commit is contained in:
Alexander Neundorf
parent
b4f02ec0bd
commit
c5f249bdbd
|
|
@ -101,6 +101,11 @@ SET(SRCS
|
||||||
cmDependsJavaParserHelper.cxx
|
cmDependsJavaParserHelper.cxx
|
||||||
cmDependsJavaParserHelper.h
|
cmDependsJavaParserHelper.h
|
||||||
cmDocumentation.cxx
|
cmDocumentation.cxx
|
||||||
|
cmDocumentationFormatter.cxx
|
||||||
|
cmDocumentationFormatterHTML.cxx
|
||||||
|
cmDocumentationFormatterMan.cxx
|
||||||
|
cmDocumentationFormatterText.cxx
|
||||||
|
cmDocumentationFormatterUsage.cxx
|
||||||
cmDynamicLoader.cxx
|
cmDynamicLoader.cxx
|
||||||
cmDynamicLoader.h
|
cmDynamicLoader.h
|
||||||
cmExprLexer.cxx
|
cmExprLexer.cxx
|
||||||
|
|
|
||||||
|
|
@ -277,10 +277,9 @@ cmDocumentation::cmDocumentation()
|
||||||
"SOURCEFILE PROPERTIES")
|
"SOURCEFILE PROPERTIES")
|
||||||
,VariablePropertiesSection ("Variables", "VARIABLES")
|
,VariablePropertiesSection ("Variables", "VARIABLES")
|
||||||
,CachedVariablePropertiesSection("Cached Variables", "CACHE VARIABLES")
|
,CachedVariablePropertiesSection("Cached Variables", "CACHE VARIABLES")
|
||||||
|
,CurrentFormatter(0)
|
||||||
{
|
{
|
||||||
this->CurrentForm = TextForm;
|
this->SetForm(TextForm);
|
||||||
this->TextIndent = "";
|
|
||||||
this->TextWidth = 77;
|
|
||||||
|
|
||||||
this->PropertySections[cmProperty::GLOBAL] = &this->GlobalPropertiesSection;
|
this->PropertySections[cmProperty::GLOBAL] = &this->GlobalPropertiesSection;
|
||||||
this->PropertySections[cmProperty::DIRECTORY] =
|
this->PropertySections[cmProperty::DIRECTORY] =
|
||||||
|
|
@ -314,13 +313,13 @@ bool cmDocumentation::PrintCopyright(std::ostream& os)
|
||||||
if(op->name)
|
if(op->name)
|
||||||
{
|
{
|
||||||
os << " * ";
|
os << " * ";
|
||||||
this->TextIndent = " ";
|
this->TextFormatter.SetIndent(" ");
|
||||||
this->PrintColumn(os, op->brief);
|
this->TextFormatter.PrintColumn(os, op->brief);
|
||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
this->TextIndent = "";
|
this->TextFormatter.SetIndent("");
|
||||||
this->PrintColumn(os, op->brief);
|
this->TextFormatter.PrintColumn(os, op->brief);
|
||||||
}
|
}
|
||||||
os << "\n";
|
os << "\n";
|
||||||
}
|
}
|
||||||
|
|
@ -348,7 +347,7 @@ void cmDocumentation::AddSection(const cmSection& section)
|
||||||
{
|
{
|
||||||
if (!section.IsEmpty())
|
if (!section.IsEmpty())
|
||||||
{
|
{
|
||||||
this->Names.push_back(section.GetName(this->CurrentForm));
|
this->Names.push_back(section.GetName(this->CurrentFormatter->GetForm()));
|
||||||
this->Sections.push_back(section.GetEntries());
|
this->Sections.push_back(section.GetEntries());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -363,7 +362,8 @@ void cmDocumentation::ClearSections()
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
bool cmDocumentation::PrintDocumentation(Type ht, std::ostream& os)
|
bool cmDocumentation::PrintDocumentation(Type ht, std::ostream& os)
|
||||||
{
|
{
|
||||||
if ((this->CurrentForm != HTMLForm) && (this->CurrentForm != ManForm))
|
if ((this->CurrentFormatter->GetForm() != HTMLForm)
|
||||||
|
&& (this->CurrentFormatter->GetForm() != ManForm))
|
||||||
{
|
{
|
||||||
this->PrintVersion(os);
|
this->PrintVersion(os);
|
||||||
}
|
}
|
||||||
|
|
@ -532,7 +532,7 @@ bool cmDocumentation::PrintRequestedDocumentation(std::ostream& os)
|
||||||
i != this->RequestedHelpItems.end();
|
i != this->RequestedHelpItems.end();
|
||||||
++i)
|
++i)
|
||||||
{
|
{
|
||||||
this->CurrentForm = i->HelpForm;
|
this->SetForm(i->HelpForm);
|
||||||
this->CurrentArgument = i->Argument;
|
this->CurrentArgument = i->Argument;
|
||||||
// If a file name was given, use it. Otherwise, default to the
|
// If a file name was given, use it. Otherwise, default to the
|
||||||
// given stream.
|
// given stream.
|
||||||
|
|
@ -739,7 +739,7 @@ bool cmDocumentation::CheckOptions(int argc, const char* const* argv)
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
void cmDocumentation::Print(Form f, std::ostream& os)
|
void cmDocumentation::Print(Form f, std::ostream& os)
|
||||||
{
|
{
|
||||||
this->CurrentForm = f;
|
this->SetForm(f);
|
||||||
Print(os);
|
Print(os);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -748,7 +748,7 @@ void cmDocumentation::Print(std::ostream& os)
|
||||||
{
|
{
|
||||||
for(unsigned int i=0; i < this->Sections.size(); ++i)
|
for(unsigned int i=0; i < this->Sections.size(); ++i)
|
||||||
{
|
{
|
||||||
this->PrintSection(os, this->Sections[i], this->Names[i]);
|
this->CurrentFormatter->PrintSection(os,this->Sections[i], this->Names[i]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -865,483 +865,6 @@ void cmDocumentation::SetSeeAlsoList(const cmDocumentationEntry* also)
|
||||||
this->SeeAlsoSection.Append(e);
|
this->SeeAlsoSection.Append(e);
|
||||||
}
|
}
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintSection(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name)
|
|
||||||
{
|
|
||||||
switch (this->CurrentForm)
|
|
||||||
{
|
|
||||||
case TextForm: this->PrintSectionText(os, section, name); break;
|
|
||||||
case HTMLForm: this->PrintSectionHTML(os, section, name); break;
|
|
||||||
case ManForm: this->PrintSectionMan(os, section, name); break;
|
|
||||||
case UsageForm: this->PrintSectionUsage(os, section, name); break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintSectionText(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name)
|
|
||||||
{
|
|
||||||
if(name)
|
|
||||||
{
|
|
||||||
os <<
|
|
||||||
"---------------------------------------"
|
|
||||||
"---------------------------------------\n";
|
|
||||||
os << name << "\n\n";
|
|
||||||
}
|
|
||||||
if(!section) { return; }
|
|
||||||
for(const cmDocumentationEntry* op = section; op->brief; ++op)
|
|
||||||
{
|
|
||||||
if(op->name)
|
|
||||||
{
|
|
||||||
if(op->name[0])
|
|
||||||
{
|
|
||||||
os << " " << op->name << "\n";
|
|
||||||
}
|
|
||||||
this->TextIndent = " ";
|
|
||||||
this->PrintFormatted(os, op->brief);
|
|
||||||
if(op->full)
|
|
||||||
{
|
|
||||||
os << "\n";
|
|
||||||
this->PrintFormatted(os, op->full);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
this->TextIndent = "";
|
|
||||||
this->PrintFormatted(os, op->brief);
|
|
||||||
}
|
|
||||||
os << "\n";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintSectionHTML(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name)
|
|
||||||
{
|
|
||||||
if(name)
|
|
||||||
{
|
|
||||||
os << "<h2>" << name << "</h2>\n";
|
|
||||||
}
|
|
||||||
if(!section) { return; }
|
|
||||||
for(const cmDocumentationEntry* op = section; op->brief;)
|
|
||||||
{
|
|
||||||
if(op->name)
|
|
||||||
{
|
|
||||||
os << "<ul>\n";
|
|
||||||
for(;op->name;++op)
|
|
||||||
{
|
|
||||||
os << " <li>\n";
|
|
||||||
if(op->name[0])
|
|
||||||
{
|
|
||||||
os << " <b><code>";
|
|
||||||
this->PrintHTMLEscapes(os, op->name);
|
|
||||||
os << "</code></b>: ";
|
|
||||||
}
|
|
||||||
this->PrintHTMLEscapes(os, op->brief);
|
|
||||||
if(op->full)
|
|
||||||
{
|
|
||||||
os << "<br>\n ";
|
|
||||||
this->PrintFormatted(os, op->full);
|
|
||||||
}
|
|
||||||
os << "\n";
|
|
||||||
os << " </li>\n";
|
|
||||||
}
|
|
||||||
os << "</ul>\n";
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
this->PrintFormatted(os, op->brief);
|
|
||||||
os << "\n";
|
|
||||||
++op;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintSectionMan(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name)
|
|
||||||
{
|
|
||||||
if(name)
|
|
||||||
{
|
|
||||||
os << ".SH " << name << "\n";
|
|
||||||
}
|
|
||||||
if(!section) { return; }
|
|
||||||
for(const cmDocumentationEntry* op = section; op->brief; ++op)
|
|
||||||
{
|
|
||||||
if(op->name)
|
|
||||||
{
|
|
||||||
os << ".TP\n"
|
|
||||||
<< ".B " << (op->name[0]?op->name:"*") << "\n";
|
|
||||||
this->PrintFormatted(os, op->brief);
|
|
||||||
this->PrintFormatted(os, op->full);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
os << ".PP\n";
|
|
||||||
this->PrintFormatted(os, op->brief);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintSectionUsage(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name)
|
|
||||||
{
|
|
||||||
if(name)
|
|
||||||
{
|
|
||||||
os << name << "\n";
|
|
||||||
}
|
|
||||||
if(!section) { return; }
|
|
||||||
for(const cmDocumentationEntry* op = section; op->brief; ++op)
|
|
||||||
{
|
|
||||||
if(op->name)
|
|
||||||
{
|
|
||||||
os << " " << op->name;
|
|
||||||
this->TextIndent = " ";
|
|
||||||
int align = static_cast<int>(strlen(this->TextIndent))-4;
|
|
||||||
for(int i = static_cast<int>(strlen(op->name)); i < align; ++i)
|
|
||||||
{
|
|
||||||
os << " ";
|
|
||||||
}
|
|
||||||
if ( strlen(op->name) > strlen(this->TextIndent)-4 )
|
|
||||||
{
|
|
||||||
os << "\n";
|
|
||||||
os.write(this->TextIndent, strlen(this->TextIndent)-2);
|
|
||||||
}
|
|
||||||
os << "= ";
|
|
||||||
this->PrintColumn(os, op->brief);
|
|
||||||
os << "\n";
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
os << "\n";
|
|
||||||
this->TextIndent = "";
|
|
||||||
this->PrintFormatted(os, op->brief);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
os << "\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintFormatted(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
if(!text)
|
|
||||||
{
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const char* ptr = text;
|
|
||||||
while(*ptr)
|
|
||||||
{
|
|
||||||
// Any ptrs starting in a space are treated as preformatted text.
|
|
||||||
std::string preformatted;
|
|
||||||
while(*ptr == ' ')
|
|
||||||
{
|
|
||||||
for(char ch = *ptr; ch && ch != '\n'; ++ptr, ch = *ptr)
|
|
||||||
{
|
|
||||||
preformatted.append(1, ch);
|
|
||||||
}
|
|
||||||
if(*ptr)
|
|
||||||
{
|
|
||||||
++ptr;
|
|
||||||
preformatted.append(1, '\n');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if(preformatted.length())
|
|
||||||
{
|
|
||||||
this->PrintPreformatted(os, preformatted.c_str());
|
|
||||||
}
|
|
||||||
|
|
||||||
// Other ptrs are treated as paragraphs.
|
|
||||||
std::string paragraph;
|
|
||||||
for(char ch = *ptr; ch && ch != '\n'; ++ptr, ch = *ptr)
|
|
||||||
{
|
|
||||||
paragraph.append(1, ch);
|
|
||||||
}
|
|
||||||
if(*ptr)
|
|
||||||
{
|
|
||||||
++ptr;
|
|
||||||
paragraph.append(1, '\n');
|
|
||||||
}
|
|
||||||
if(paragraph.length())
|
|
||||||
{
|
|
||||||
this->PrintParagraph(os, paragraph.c_str());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintPreformatted(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
switch (this->CurrentForm)
|
|
||||||
{
|
|
||||||
case TextForm: this->PrintPreformattedText(os, text); break;
|
|
||||||
case HTMLForm: this->PrintPreformattedHTML(os, text); break;
|
|
||||||
case ManForm: this->PrintPreformattedMan(os, text); break;
|
|
||||||
case UsageForm: this->PrintPreformattedText(os, text); break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintParagraph(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
switch (this->CurrentForm)
|
|
||||||
{
|
|
||||||
case TextForm: this->PrintParagraphText(os, text); break;
|
|
||||||
case HTMLForm: this->PrintParagraphHTML(os, text); break;
|
|
||||||
case ManForm: this->PrintParagraphMan(os, text); break;
|
|
||||||
case UsageForm: this->PrintParagraphText(os, text); break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation
|
|
||||||
::PrintPreformattedText(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
bool newline = true;
|
|
||||||
for(const char* ptr = text; *ptr; ++ptr)
|
|
||||||
{
|
|
||||||
if(newline)
|
|
||||||
{
|
|
||||||
os << this->TextIndent;
|
|
||||||
newline = false;
|
|
||||||
}
|
|
||||||
os << *ptr;
|
|
||||||
if(*ptr == '\n')
|
|
||||||
{
|
|
||||||
newline = true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
os << "\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintParagraphText(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
os << this->TextIndent;
|
|
||||||
this->PrintColumn(os, text);
|
|
||||||
os << "\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation
|
|
||||||
::PrintPreformattedHTML(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
os << "<pre>";
|
|
||||||
this->PrintHTMLEscapes(os, text);
|
|
||||||
os << "</pre>\n ";
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintParagraphHTML(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
os << "<p>";
|
|
||||||
this->PrintHTMLEscapes(os, text);
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintPreformattedMan(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
std::string man_text = text;
|
|
||||||
cmSystemTools::ReplaceString(man_text, "\\", "\\\\");
|
|
||||||
os << man_text << "\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintParagraphMan(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
std::string man_text = text;
|
|
||||||
cmSystemTools::ReplaceString(man_text, "\\", "\\\\");
|
|
||||||
os << man_text << "\n\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintColumn(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
// Print text arranged in an indented column of fixed witdh.
|
|
||||||
const char* l = text;
|
|
||||||
int column = 0;
|
|
||||||
bool newSentence = false;
|
|
||||||
bool firstLine = true;
|
|
||||||
int width = this->TextWidth - static_cast<int>(strlen(this->TextIndent));
|
|
||||||
|
|
||||||
// Loop until the end of the text.
|
|
||||||
while(*l)
|
|
||||||
{
|
|
||||||
// Parse the next word.
|
|
||||||
const char* r = l;
|
|
||||||
while(*r && (*r != '\n') && (*r != ' ')) { ++r; }
|
|
||||||
|
|
||||||
// Does it fit on this line?
|
|
||||||
if(r-l < (width-column-(newSentence?1:0)))
|
|
||||||
{
|
|
||||||
// Word fits on this line.
|
|
||||||
if(r > l)
|
|
||||||
{
|
|
||||||
if(column)
|
|
||||||
{
|
|
||||||
// Not first word on line. Separate from the previous word
|
|
||||||
// by a space, or two if this is a new sentence.
|
|
||||||
if(newSentence)
|
|
||||||
{
|
|
||||||
os << " ";
|
|
||||||
column += 2;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
os << " ";
|
|
||||||
column += 1;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
// First word on line. Print indentation unless this is the
|
|
||||||
// first line.
|
|
||||||
os << (firstLine?"":this->TextIndent);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Print the word.
|
|
||||||
os.write(l, static_cast<long>(r-l));
|
|
||||||
newSentence = (*(r-1) == '.');
|
|
||||||
}
|
|
||||||
|
|
||||||
if(*r == '\n')
|
|
||||||
{
|
|
||||||
// Text provided a newline. Start a new line.
|
|
||||||
os << "\n";
|
|
||||||
++r;
|
|
||||||
column = 0;
|
|
||||||
firstLine = false;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
// No provided newline. Continue this line.
|
|
||||||
column += static_cast<long>(r-l);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
// Word does not fit on this line. Start a new line.
|
|
||||||
os << "\n";
|
|
||||||
firstLine = false;
|
|
||||||
if(r > l)
|
|
||||||
{
|
|
||||||
os << this->TextIndent;
|
|
||||||
os.write(l, static_cast<long>(r-l));
|
|
||||||
column = static_cast<long>(r-l);
|
|
||||||
newSentence = (*(r-1) == '.');
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
column = 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Move to beginning of next word. Skip over whitespace.
|
|
||||||
l = r;
|
|
||||||
while(*l && (*l == ' ')) { ++l; }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
static bool cmDocumentationIsHyperlinkChar(char c)
|
|
||||||
{
|
|
||||||
// This is not a complete list but works for CMake documentation.
|
|
||||||
return ((c >= 'A' && c <= 'Z') ||
|
|
||||||
(c >= 'a' && c <= 'z') ||
|
|
||||||
(c >= '0' && c <= '9') ||
|
|
||||||
c == '-' || c == '.' || c == '/' || c == '~' || c == '@' ||
|
|
||||||
c == ':' || c == '_' || c == '&' || c == '?' || c == '=');
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
static void cmDocumentationPrintHTMLChar(std::ostream& os, char c)
|
|
||||||
{
|
|
||||||
// Use an escape sequence if necessary.
|
|
||||||
static cmDocumentationEntry escapes[] =
|
|
||||||
{
|
|
||||||
{"<", "<", 0},
|
|
||||||
{">", ">", 0},
|
|
||||||
{"&", "&", 0},
|
|
||||||
{"\n", "<br>", 0},
|
|
||||||
{0,0,0}
|
|
||||||
};
|
|
||||||
for(const cmDocumentationEntry* op = escapes; op->name; ++op)
|
|
||||||
{
|
|
||||||
if(op->name[0] == c)
|
|
||||||
{
|
|
||||||
os << op->brief;
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// No escape sequence is needed.
|
|
||||||
os << c;
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
const char* cmDocumentationPrintHTMLLink(std::ostream& os, const char* begin)
|
|
||||||
{
|
|
||||||
// Look for the end of the link.
|
|
||||||
const char* end = begin;
|
|
||||||
while(cmDocumentationIsHyperlinkChar(*end))
|
|
||||||
{
|
|
||||||
++end;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Print the hyperlink itself.
|
|
||||||
os << "<a href=\"";
|
|
||||||
for(const char* c = begin; c != end; ++c)
|
|
||||||
{
|
|
||||||
cmDocumentationPrintHTMLChar(os, *c);
|
|
||||||
}
|
|
||||||
os << "\">";
|
|
||||||
|
|
||||||
// The name of the hyperlink is the text itself.
|
|
||||||
for(const char* c = begin; c != end; ++c)
|
|
||||||
{
|
|
||||||
cmDocumentationPrintHTMLChar(os, *c);
|
|
||||||
}
|
|
||||||
os << "</a>";
|
|
||||||
|
|
||||||
// Return the position at which to continue scanning the input
|
|
||||||
// string.
|
|
||||||
return end;
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintHTMLEscapes(std::ostream& os, const char* text)
|
|
||||||
{
|
|
||||||
// Hyperlink prefixes.
|
|
||||||
static const char* hyperlinks[] = {"http://", "ftp://", "mailto:", 0};
|
|
||||||
|
|
||||||
// Print each character.
|
|
||||||
for(const char* p = text; *p;)
|
|
||||||
{
|
|
||||||
// Handle hyperlinks specially to make them active.
|
|
||||||
bool found_hyperlink = false;
|
|
||||||
for(const char** h = hyperlinks; !found_hyperlink && *h; ++h)
|
|
||||||
{
|
|
||||||
if(strncmp(p, *h, strlen(*h)) == 0)
|
|
||||||
{
|
|
||||||
p = cmDocumentationPrintHTMLLink(os, p);
|
|
||||||
found_hyperlink = true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Print other characters normally.
|
|
||||||
if(!found_hyperlink)
|
|
||||||
{
|
|
||||||
cmDocumentationPrintHTMLChar(os, *p++);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
bool cmDocumentation::PrintDocumentationSingle(std::ostream& os)
|
bool cmDocumentation::PrintDocumentationSingle(std::ostream& os)
|
||||||
{
|
{
|
||||||
|
|
@ -1545,9 +1068,9 @@ bool cmDocumentation::PrintDocumentationUsage(std::ostream& os)
|
||||||
bool cmDocumentation::PrintDocumentationFull(std::ostream& os)
|
bool cmDocumentation::PrintDocumentationFull(std::ostream& os)
|
||||||
{
|
{
|
||||||
this->CreateFullDocumentation();
|
this->CreateFullDocumentation();
|
||||||
this->PrintHeader(GetNameString(), os);
|
this->CurrentFormatter->PrintHeader(GetNameString(), os);
|
||||||
this->Print(os);
|
this->Print(os);
|
||||||
this->PrintFooter(os);
|
this->CurrentFormatter->PrintFooter(os);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -1555,9 +1078,9 @@ bool cmDocumentation::PrintDocumentationFull(std::ostream& os)
|
||||||
bool cmDocumentation::PrintDocumentationModules(std::ostream& os)
|
bool cmDocumentation::PrintDocumentationModules(std::ostream& os)
|
||||||
{
|
{
|
||||||
this->CreateModulesDocumentation();
|
this->CreateModulesDocumentation();
|
||||||
this->PrintHeader(GetNameString(), os);
|
this->CurrentFormatter->PrintHeader(GetNameString(), os);
|
||||||
this->Print(os);
|
this->Print(os);
|
||||||
this->PrintFooter(os);
|
this->CurrentFormatter->PrintFooter(os);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -1565,9 +1088,9 @@ bool cmDocumentation::PrintDocumentationModules(std::ostream& os)
|
||||||
bool cmDocumentation::PrintDocumentationProperties(std::ostream& os)
|
bool cmDocumentation::PrintDocumentationProperties(std::ostream& os)
|
||||||
{
|
{
|
||||||
this->CreatePropertiesDocumentation();
|
this->CreatePropertiesDocumentation();
|
||||||
this->PrintHeader(GetNameString(), os);
|
this->CurrentFormatter->PrintHeader(GetNameString(), os);
|
||||||
this->Print(os);
|
this->Print(os);
|
||||||
this->PrintFooter(os);
|
this->CurrentFormatter->PrintFooter(os);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -1575,9 +1098,9 @@ bool cmDocumentation::PrintDocumentationProperties(std::ostream& os)
|
||||||
bool cmDocumentation::PrintDocumentationCurrentCommands(std::ostream& os)
|
bool cmDocumentation::PrintDocumentationCurrentCommands(std::ostream& os)
|
||||||
{
|
{
|
||||||
this->CreateCurrentCommandsDocumentation();
|
this->CreateCurrentCommandsDocumentation();
|
||||||
this->PrintHeader(GetNameString(), os);
|
this->CurrentFormatter->PrintHeader(GetNameString(), os);
|
||||||
this->Print(os);
|
this->Print(os);
|
||||||
this->PrintFooter(os);
|
this->CurrentFormatter->PrintFooter(os);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -1585,48 +1108,12 @@ bool cmDocumentation::PrintDocumentationCurrentCommands(std::ostream& os)
|
||||||
bool cmDocumentation::PrintDocumentationCompatCommands(std::ostream& os)
|
bool cmDocumentation::PrintDocumentationCompatCommands(std::ostream& os)
|
||||||
{
|
{
|
||||||
this->CreateCompatCommandsDocumentation();
|
this->CreateCompatCommandsDocumentation();
|
||||||
this->PrintHeader(GetNameString(), os);
|
this->CurrentFormatter->PrintHeader(GetNameString(), os);
|
||||||
this->Print(os);
|
this->Print(os);
|
||||||
this->PrintFooter(os);
|
this->CurrentFormatter->PrintFooter(os);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintHeader(const char* name, std::ostream& os)
|
|
||||||
{
|
|
||||||
switch(this->CurrentForm)
|
|
||||||
{
|
|
||||||
case HTMLForm:
|
|
||||||
os << "<html><body>\n";
|
|
||||||
break;
|
|
||||||
case ManForm:
|
|
||||||
os << ".TH " << name << " 1 \""
|
|
||||||
<< cmSystemTools::GetCurrentDateTime("%B %d, %Y").c_str()
|
|
||||||
<< "\" \"" << this->GetNameString()
|
|
||||||
<< " " << cmVersion::GetCMakeVersion()
|
|
||||||
<< "\"\n";
|
|
||||||
break;
|
|
||||||
case TextForm:
|
|
||||||
case UsageForm:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
|
||||||
void cmDocumentation::PrintFooter(std::ostream& os)
|
|
||||||
{
|
|
||||||
switch(this->CurrentForm)
|
|
||||||
{
|
|
||||||
case HTMLForm:
|
|
||||||
os << "</body></html>\n";
|
|
||||||
break;
|
|
||||||
case ManForm:
|
|
||||||
case TextForm:
|
|
||||||
case UsageForm:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
void cmDocumentation::PrintDocumentationCommand(std::ostream& os,
|
void cmDocumentation::PrintDocumentationCommand(std::ostream& os,
|
||||||
const cmDocumentationEntry* entry)
|
const cmDocumentationEntry* entry)
|
||||||
|
|
@ -1671,10 +1158,10 @@ void cmDocumentation::CreateFullDocumentation()
|
||||||
this->AddSection(this->VariablePropertiesSection);
|
this->AddSection(this->VariablePropertiesSection);
|
||||||
this->AddSection(this->CachedVariablePropertiesSection);
|
this->AddSection(this->CachedVariablePropertiesSection);
|
||||||
|
|
||||||
this->AddSection(this->CopyrightSection.GetName(this->CurrentForm),
|
this->AddSection(this->CopyrightSection.GetName(
|
||||||
cmDocumentationCopyright);
|
this->CurrentFormatter->GetForm()), cmDocumentationCopyright);
|
||||||
|
|
||||||
if(this->CurrentForm == ManForm)
|
if(this->CurrentFormatter->GetForm() == ManForm)
|
||||||
{
|
{
|
||||||
this->AddSection(this->SeeAlsoSection);
|
this->AddSection(this->SeeAlsoSection);
|
||||||
this->AddSection(this->AuthorSection.GetName(ManForm),
|
this->AddSection(this->AuthorSection.GetName(ManForm),
|
||||||
|
|
@ -1691,22 +1178,23 @@ void cmDocumentation::CreateCurrentCommandsDocumentation()
|
||||||
{
|
{
|
||||||
this->ClearSections();
|
this->ClearSections();
|
||||||
this->AddSection(this->CommandsSection);
|
this->AddSection(this->CommandsSection);
|
||||||
this->AddSection(this->CopyrightSection.GetName(CurrentForm),
|
this->AddSection(this->CopyrightSection.GetName(
|
||||||
cmDocumentationCopyright);
|
this->CurrentFormatter->GetForm()), cmDocumentationCopyright);
|
||||||
this->AddSection(this->SeeAlsoSection.GetName(CurrentForm),
|
this->AddSection(this->SeeAlsoSection.GetName(
|
||||||
cmDocumentationStandardSeeAlso);
|
this->CurrentFormatter->GetForm()), cmDocumentationStandardSeeAlso);
|
||||||
}
|
}
|
||||||
|
|
||||||
void cmDocumentation::CreateCompatCommandsDocumentation()
|
void cmDocumentation::CreateCompatCommandsDocumentation()
|
||||||
{
|
{
|
||||||
this->ClearSections();
|
this->ClearSections();
|
||||||
this->AddSection(this->DescriptionSection.GetName(CurrentForm),
|
this->AddSection(this->DescriptionSection.GetName(
|
||||||
|
this->CurrentFormatter->GetForm()),
|
||||||
cmCompatCommandsDocumentationDescription);
|
cmCompatCommandsDocumentationDescription);
|
||||||
this->AddSection(this->CompatCommandsSection);
|
this->AddSection(this->CompatCommandsSection);
|
||||||
this->AddSection(this->CopyrightSection.GetName(CurrentForm),
|
this->AddSection(this->CopyrightSection.GetName(
|
||||||
cmDocumentationCopyright);
|
this->CurrentFormatter->GetForm()), cmDocumentationCopyright);
|
||||||
this->AddSection(this->SeeAlsoSection.GetName(CurrentForm),
|
this->AddSection(this->SeeAlsoSection.GetName(
|
||||||
cmDocumentationStandardSeeAlso);
|
this->CurrentFormatter->GetForm()), cmDocumentationStandardSeeAlso);
|
||||||
}
|
}
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
|
|
@ -1714,21 +1202,21 @@ void cmDocumentation::CreateModulesDocumentation()
|
||||||
{
|
{
|
||||||
this->ClearSections();
|
this->ClearSections();
|
||||||
this->CreateModulesSection();
|
this->CreateModulesSection();
|
||||||
this->AddSection(this->DescriptionSection.GetName(CurrentForm),
|
this->AddSection(this->DescriptionSection.GetName(
|
||||||
cmModulesDocumentationDescription);
|
this->CurrentFormatter->GetForm()), cmModulesDocumentationDescription);
|
||||||
this->AddSection(this->ModulesSection);
|
this->AddSection(this->ModulesSection);
|
||||||
this->AddSection(this->CopyrightSection.GetName(CurrentForm),
|
this->AddSection(this->CopyrightSection.GetName(
|
||||||
cmDocumentationCopyright);
|
this->CurrentFormatter->GetForm()), cmDocumentationCopyright);
|
||||||
this->AddSection(this->SeeAlsoSection.GetName(CurrentForm),
|
this->AddSection(this->SeeAlsoSection.GetName(
|
||||||
cmDocumentationStandardSeeAlso);
|
this->CurrentFormatter->GetForm()), cmDocumentationStandardSeeAlso);
|
||||||
}
|
}
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
void cmDocumentation::CreatePropertiesDocumentation()
|
void cmDocumentation::CreatePropertiesDocumentation()
|
||||||
{
|
{
|
||||||
this->ClearSections();
|
this->ClearSections();
|
||||||
this->AddSection(this->DescriptionSection.GetName(CurrentForm),
|
this->AddSection(this->DescriptionSection.GetName(
|
||||||
cmPropertiesDocumentationDescription);
|
this->CurrentFormatter->GetForm()), cmPropertiesDocumentationDescription);
|
||||||
this->AddSection(this->GlobalPropertiesSection);
|
this->AddSection(this->GlobalPropertiesSection);
|
||||||
this->AddSection(this->DirectoryPropertiesSection);
|
this->AddSection(this->DirectoryPropertiesSection);
|
||||||
this->AddSection(this->TargetPropertiesSection);
|
this->AddSection(this->TargetPropertiesSection);
|
||||||
|
|
@ -1736,12 +1224,33 @@ void cmDocumentation::CreatePropertiesDocumentation()
|
||||||
this->AddSection(this->SourceFilePropertiesSection);
|
this->AddSection(this->SourceFilePropertiesSection);
|
||||||
this->AddSection(this->VariablePropertiesSection);
|
this->AddSection(this->VariablePropertiesSection);
|
||||||
this->AddSection(this->CachedVariablePropertiesSection);
|
this->AddSection(this->CachedVariablePropertiesSection);
|
||||||
this->AddSection(this->CopyrightSection.GetName(CurrentForm),
|
this->AddSection(this->CopyrightSection.GetName(
|
||||||
cmDocumentationCopyright);
|
this->CurrentFormatter->GetForm()), cmDocumentationCopyright);
|
||||||
this->AddSection(this->SeeAlsoSection.GetName(CurrentForm),
|
this->AddSection(this->SeeAlsoSection.GetName(
|
||||||
cmDocumentationStandardSeeAlso);
|
this->CurrentFormatter->GetForm()), cmDocumentationStandardSeeAlso);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
void cmDocumentation::SetForm(Form f)
|
||||||
|
{
|
||||||
|
switch(f)
|
||||||
|
{
|
||||||
|
case HTMLForm:
|
||||||
|
this->CurrentFormatter = &this->HTMLFormatter;
|
||||||
|
break;
|
||||||
|
case ManForm:
|
||||||
|
this->CurrentFormatter = &this->ManFormatter;
|
||||||
|
break;
|
||||||
|
case TextForm:
|
||||||
|
this->CurrentFormatter = &this->TextFormatter;
|
||||||
|
break;
|
||||||
|
case UsageForm:
|
||||||
|
this->CurrentFormatter = & this->UsageFormatter;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
//----------------------------------------------------------------------------
|
//----------------------------------------------------------------------------
|
||||||
void cmDocumentation::cmSection::Set(const cmDocumentationEntry* header,
|
void cmDocumentation::cmSection::Set(const cmDocumentationEntry* header,
|
||||||
const cmDocumentationEntry* section,
|
const cmDocumentationEntry* section,
|
||||||
|
|
|
||||||
|
|
@ -19,26 +19,11 @@
|
||||||
|
|
||||||
#include "cmStandardIncludes.h"
|
#include "cmStandardIncludes.h"
|
||||||
#include "cmProperty.h"
|
#include "cmProperty.h"
|
||||||
|
#include "cmDocumentationFormatter.h"
|
||||||
/** This is just a helper class to make it build with MSVC 6.0.
|
#include "cmDocumentationFormatterHTML.h"
|
||||||
Actually the enums and internal classes could directly go into
|
#include "cmDocumentationFormatterMan.h"
|
||||||
cmDocumentation, but then MSVC6 complains in RequestedHelpItem that
|
#include "cmDocumentationFormatterText.h"
|
||||||
cmDocumentation is an undefined type and so it doesn't know the enums.
|
#include "cmDocumentationFormatterUsage.h"
|
||||||
Moving the enums to a class which is then already completely parsed helps.
|
|
||||||
against this. */
|
|
||||||
class cmDocumentationEnums
|
|
||||||
{
|
|
||||||
public:
|
|
||||||
/** Types of help provided. */
|
|
||||||
enum Type
|
|
||||||
{ None, Usage, Single, SingleModule, SingleProperty,
|
|
||||||
List, ModuleList, PropertyList,
|
|
||||||
Full, Properties, Modules, Commands, CompatCommands,
|
|
||||||
Copyright, Version };
|
|
||||||
|
|
||||||
/** Forms of documentation output. */
|
|
||||||
enum Form { TextForm, HTMLForm, ManForm, UsageForm };
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
/** Class to generate documentation. */
|
/** Class to generate documentation. */
|
||||||
|
|
@ -176,34 +161,7 @@ public:
|
||||||
static Form GetFormFromFilename(const std::string& filename);
|
static Form GetFormFromFilename(const std::string& filename);
|
||||||
|
|
||||||
private:
|
private:
|
||||||
void PrintHeader(const char* title, std::ostream& os);
|
void SetForm(Form f);
|
||||||
void PrintFooter(std::ostream& os);
|
|
||||||
|
|
||||||
void PrintSection(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name);
|
|
||||||
void PrintSectionText(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name);
|
|
||||||
void PrintSectionHTML(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name);
|
|
||||||
void PrintSectionMan(std::ostream& os, const cmDocumentationEntry* section,
|
|
||||||
const char* name);
|
|
||||||
void PrintSectionUsage(std::ostream& os,
|
|
||||||
const cmDocumentationEntry* section,
|
|
||||||
const char* name);
|
|
||||||
void PrintFormatted(std::ostream& os, const char* text);
|
|
||||||
void PrintPreformatted(std::ostream& os, const char* text);
|
|
||||||
void PrintPreformattedText(std::ostream& os, const char* text);
|
|
||||||
void PrintPreformattedHTML(std::ostream& os, const char* text);
|
|
||||||
void PrintPreformattedMan(std::ostream& os, const char* text);
|
|
||||||
void PrintParagraph(std::ostream& os, const char* text);
|
|
||||||
void PrintParagraphText(std::ostream& os, const char* text);
|
|
||||||
void PrintParagraphHTML(std::ostream& os, const char* text);
|
|
||||||
void PrintParagraphMan(std::ostream& os, const char* text);
|
|
||||||
void PrintColumn(std::ostream& os, const char* text);
|
|
||||||
void PrintHTMLEscapes(std::ostream& os, const char* text);
|
|
||||||
|
|
||||||
bool CreateSingleModule(const char* fname, const char* moduleName);
|
bool CreateSingleModule(const char* fname, const char* moduleName);
|
||||||
bool CreateModulesSection();
|
bool CreateModulesSection();
|
||||||
|
|
@ -264,10 +222,7 @@ private:
|
||||||
std::vector< char* > ModuleStrings;
|
std::vector< char* > ModuleStrings;
|
||||||
std::vector< const char* > Names;
|
std::vector< const char* > Names;
|
||||||
std::vector< const cmDocumentationEntry* > Sections;
|
std::vector< const cmDocumentationEntry* > Sections;
|
||||||
Form CurrentForm;
|
|
||||||
std::string CurrentArgument;
|
std::string CurrentArgument;
|
||||||
const char* TextIndent;
|
|
||||||
int TextWidth;
|
|
||||||
|
|
||||||
struct RequestedHelpItem
|
struct RequestedHelpItem
|
||||||
{
|
{
|
||||||
|
|
@ -279,6 +234,12 @@ private:
|
||||||
};
|
};
|
||||||
|
|
||||||
std::vector<RequestedHelpItem> RequestedHelpItems;
|
std::vector<RequestedHelpItem> RequestedHelpItems;
|
||||||
|
cmDocumentationFormatter* CurrentFormatter;
|
||||||
|
cmDocumentationFormatterHTML HTMLFormatter;
|
||||||
|
cmDocumentationFormatterMan ManFormatter;
|
||||||
|
cmDocumentationFormatterText TextFormatter;
|
||||||
|
cmDocumentationFormatterUsage UsageFormatter;
|
||||||
|
|
||||||
};
|
};
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,73 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#include "cmDocumentationFormatter.h"
|
||||||
|
|
||||||
|
cmDocumentationFormatter::cmDocumentationFormatter()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
cmDocumentationFormatter::~cmDocumentationFormatter()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatter::PrintFormatted(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
if(!text)
|
||||||
|
{
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const char* ptr = text;
|
||||||
|
while(*ptr)
|
||||||
|
{
|
||||||
|
// Any ptrs starting in a space are treated as preformatted text.
|
||||||
|
std::string preformatted;
|
||||||
|
while(*ptr == ' ')
|
||||||
|
{
|
||||||
|
for(char ch = *ptr; ch && ch != '\n'; ++ptr, ch = *ptr)
|
||||||
|
{
|
||||||
|
preformatted.append(1, ch);
|
||||||
|
}
|
||||||
|
if(*ptr)
|
||||||
|
{
|
||||||
|
++ptr;
|
||||||
|
preformatted.append(1, '\n');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if(preformatted.length())
|
||||||
|
{
|
||||||
|
this->PrintPreformatted(os, preformatted.c_str());
|
||||||
|
}
|
||||||
|
|
||||||
|
// Other ptrs are treated as paragraphs.
|
||||||
|
std::string paragraph;
|
||||||
|
for(char ch = *ptr; ch && ch != '\n'; ++ptr, ch = *ptr)
|
||||||
|
{
|
||||||
|
paragraph.append(1, ch);
|
||||||
|
}
|
||||||
|
if(*ptr)
|
||||||
|
{
|
||||||
|
++ptr;
|
||||||
|
paragraph.append(1, '\n');
|
||||||
|
}
|
||||||
|
if(paragraph.length())
|
||||||
|
{
|
||||||
|
this->PrintParagraph(os, paragraph.c_str());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
@ -0,0 +1,62 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#ifndef _cmDocumentationFormatter_h
|
||||||
|
#define _cmDocumentationFormatter_h
|
||||||
|
|
||||||
|
#include "cmStandardIncludes.h"
|
||||||
|
|
||||||
|
/** This is just a helper class to make it build with MSVC 6.0.
|
||||||
|
Actually the enums and internal classes could directly go into
|
||||||
|
cmDocumentation, but then MSVC6 complains in RequestedHelpItem that
|
||||||
|
cmDocumentation is an undefined type and so it doesn't know the enums.
|
||||||
|
Moving the enums to a class which is then already completely parsed helps
|
||||||
|
against this. */
|
||||||
|
class cmDocumentationEnums
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/** Types of help provided. */
|
||||||
|
enum Type
|
||||||
|
{ None, Usage, Single, SingleModule, SingleProperty,
|
||||||
|
List, ModuleList, PropertyList,
|
||||||
|
Full, Properties, Modules, Commands, CompatCommands,
|
||||||
|
Copyright, Version };
|
||||||
|
|
||||||
|
/** Forms of documentation output. */
|
||||||
|
enum Form { TextForm, HTMLForm, ManForm, UsageForm };
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Base class for printing the documentation in the various supported
|
||||||
|
formats. */
|
||||||
|
class cmDocumentationFormatter
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
cmDocumentationFormatter();
|
||||||
|
virtual ~cmDocumentationFormatter();
|
||||||
|
void PrintFormatted(std::ostream& os, const char* text);
|
||||||
|
|
||||||
|
virtual cmDocumentationEnums::Form GetForm() const = 0;
|
||||||
|
|
||||||
|
virtual void PrintHeader(const char* name, std::ostream& os) {}
|
||||||
|
virtual void PrintFooter(std::ostream& os) {}
|
||||||
|
virtual void PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name) = 0;
|
||||||
|
virtual void PrintPreformatted(std::ostream& os, const char* text) = 0;
|
||||||
|
virtual void PrintParagraph(std::ostream& os, const char* text) = 0;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -0,0 +1,189 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#include "cmDocumentationFormatterHTML.h"
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
static bool cmDocumentationIsHyperlinkChar(char c)
|
||||||
|
{
|
||||||
|
// This is not a complete list but works for CMake documentation.
|
||||||
|
return ((c >= 'A' && c <= 'Z') ||
|
||||||
|
(c >= 'a' && c <= 'z') ||
|
||||||
|
(c >= '0' && c <= '9') ||
|
||||||
|
c == '-' || c == '.' || c == '/' || c == '~' || c == '@' ||
|
||||||
|
c == ':' || c == '_' || c == '&' || c == '?' || c == '=');
|
||||||
|
}
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
static void cmDocumentationPrintHTMLChar(std::ostream& os, char c)
|
||||||
|
{
|
||||||
|
// Use an escape sequence if necessary.
|
||||||
|
static cmDocumentationEntry escapes[] =
|
||||||
|
{
|
||||||
|
{"<", "<", 0},
|
||||||
|
{">", ">", 0},
|
||||||
|
{"&", "&", 0},
|
||||||
|
{"\n", "<br>", 0},
|
||||||
|
{0,0,0}
|
||||||
|
};
|
||||||
|
for(const cmDocumentationEntry* op = escapes; op->name; ++op)
|
||||||
|
{
|
||||||
|
if(op->name[0] == c)
|
||||||
|
{
|
||||||
|
os << op->brief;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// No escape sequence is needed.
|
||||||
|
os << c;
|
||||||
|
}
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
const char* cmDocumentationPrintHTMLLink(std::ostream& os, const char* begin)
|
||||||
|
{
|
||||||
|
// Look for the end of the link.
|
||||||
|
const char* end = begin;
|
||||||
|
while(cmDocumentationIsHyperlinkChar(*end))
|
||||||
|
{
|
||||||
|
++end;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Print the hyperlink itself.
|
||||||
|
os << "<a href=\"";
|
||||||
|
for(const char* c = begin; c != end; ++c)
|
||||||
|
{
|
||||||
|
cmDocumentationPrintHTMLChar(os, *c);
|
||||||
|
}
|
||||||
|
os << "\">";
|
||||||
|
|
||||||
|
// The name of the hyperlink is the text itself.
|
||||||
|
for(const char* c = begin; c != end; ++c)
|
||||||
|
{
|
||||||
|
cmDocumentationPrintHTMLChar(os, *c);
|
||||||
|
}
|
||||||
|
os << "</a>";
|
||||||
|
|
||||||
|
// Return the position at which to continue scanning the input
|
||||||
|
// string.
|
||||||
|
return end;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
cmDocumentationFormatterHTML::cmDocumentationFormatterHTML()
|
||||||
|
:cmDocumentationFormatter()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterHTML::PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name)
|
||||||
|
{
|
||||||
|
if(name)
|
||||||
|
{
|
||||||
|
os << "<h2>" << name << "</h2>\n";
|
||||||
|
}
|
||||||
|
if(!section) { return; }
|
||||||
|
for(const cmDocumentationEntry* op = section; op->brief;)
|
||||||
|
{
|
||||||
|
if(op->name)
|
||||||
|
{
|
||||||
|
os << "<ul>\n";
|
||||||
|
for(;op->name;++op)
|
||||||
|
{
|
||||||
|
os << " <li>\n";
|
||||||
|
if(op->name[0])
|
||||||
|
{
|
||||||
|
os << " <b><code>";
|
||||||
|
this->PrintHTMLEscapes(os, op->name);
|
||||||
|
os << "</code></b>: ";
|
||||||
|
}
|
||||||
|
this->PrintHTMLEscapes(os, op->brief);
|
||||||
|
if(op->full)
|
||||||
|
{
|
||||||
|
os << "<br>\n ";
|
||||||
|
this->PrintFormatted(os, op->full);
|
||||||
|
}
|
||||||
|
os << "\n";
|
||||||
|
os << " </li>\n";
|
||||||
|
}
|
||||||
|
os << "</ul>\n";
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
this->PrintFormatted(os, op->brief);
|
||||||
|
os << "\n";
|
||||||
|
++op;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterHTML::PrintPreformatted(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
os << "<pre>";
|
||||||
|
this->PrintHTMLEscapes(os, text);
|
||||||
|
os << "</pre>\n ";
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterHTML::PrintParagraph(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
os << "<p>";
|
||||||
|
this->PrintHTMLEscapes(os, text);
|
||||||
|
}
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
void cmDocumentationFormatterHTML::PrintHeader(const char* name,
|
||||||
|
std::ostream& os)
|
||||||
|
{
|
||||||
|
os << "<html><body>\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
void cmDocumentationFormatterHTML::PrintFooter(std::ostream& os)
|
||||||
|
{
|
||||||
|
os << "</body></html>\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
void cmDocumentationFormatterHTML::PrintHTMLEscapes(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
// Hyperlink prefixes.
|
||||||
|
static const char* hyperlinks[] = {"http://", "ftp://", "mailto:", 0};
|
||||||
|
|
||||||
|
// Print each character.
|
||||||
|
for(const char* p = text; *p;)
|
||||||
|
{
|
||||||
|
// Handle hyperlinks specially to make them active.
|
||||||
|
bool found_hyperlink = false;
|
||||||
|
for(const char** h = hyperlinks; !found_hyperlink && *h; ++h)
|
||||||
|
{
|
||||||
|
if(strncmp(p, *h, strlen(*h)) == 0)
|
||||||
|
{
|
||||||
|
p = cmDocumentationPrintHTMLLink(os, p);
|
||||||
|
found_hyperlink = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Print other characters normally.
|
||||||
|
if(!found_hyperlink)
|
||||||
|
{
|
||||||
|
cmDocumentationPrintHTMLChar(os, *p++);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,44 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#ifndef _cmDocumentationFormatterHTML_h
|
||||||
|
#define _cmDocumentationFormatterHTML_h
|
||||||
|
|
||||||
|
#include "cmStandardIncludes.h"
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatter.h"
|
||||||
|
|
||||||
|
/** Class to print the documentation as HTML. */
|
||||||
|
class cmDocumentationFormatterHTML : public cmDocumentationFormatter
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
cmDocumentationFormatterHTML();
|
||||||
|
|
||||||
|
virtual cmDocumentationEnums::Form GetForm() const
|
||||||
|
{ return cmDocumentationEnums::HTMLForm;}
|
||||||
|
|
||||||
|
virtual void PrintHeader(const char* name, std::ostream& os);
|
||||||
|
virtual void PrintFooter(std::ostream& os);
|
||||||
|
virtual void PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name);
|
||||||
|
virtual void PrintPreformatted(std::ostream& os, const char* text);
|
||||||
|
virtual void PrintParagraph(std::ostream& os, const char* text);
|
||||||
|
private:
|
||||||
|
void PrintHTMLEscapes(std::ostream& os, const char* text);
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -0,0 +1,82 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatterMan.h"
|
||||||
|
|
||||||
|
#include "cmSystemTools.h"
|
||||||
|
#include "cmVersion.h"
|
||||||
|
|
||||||
|
|
||||||
|
cmDocumentationFormatterMan::cmDocumentationFormatterMan()
|
||||||
|
:cmDocumentationFormatter()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterMan::PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name)
|
||||||
|
{
|
||||||
|
if(name)
|
||||||
|
{
|
||||||
|
os << ".SH " << name << "\n";
|
||||||
|
}
|
||||||
|
if(!section) { return; }
|
||||||
|
for(const cmDocumentationEntry* op = section; op->brief; ++op)
|
||||||
|
{
|
||||||
|
if(op->name)
|
||||||
|
{
|
||||||
|
os << ".TP\n"
|
||||||
|
<< ".B " << (op->name[0]?op->name:"*") << "\n";
|
||||||
|
this->PrintFormatted(os, op->brief);
|
||||||
|
this->PrintFormatted(os, op->full);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
os << ".PP\n";
|
||||||
|
this->PrintFormatted(os, op->brief);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterMan::PrintPreformatted(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
std::string man_text = text;
|
||||||
|
cmSystemTools::ReplaceString(man_text, "\\", "\\\\");
|
||||||
|
os << man_text << "\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterMan::PrintParagraph(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
std::string man_text = text;
|
||||||
|
cmSystemTools::ReplaceString(man_text, "\\", "\\\\");
|
||||||
|
os << man_text << "\n\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
void cmDocumentationFormatterMan::PrintHeader(const char* name,
|
||||||
|
std::ostream& os)
|
||||||
|
{
|
||||||
|
os << ".TH " << name << " 1 \""
|
||||||
|
<< cmSystemTools::GetCurrentDateTime("%B %d, %Y").c_str()
|
||||||
|
// << "\" \"" << this->GetNameString()
|
||||||
|
<< " " << cmVersion::GetCMakeVersion()
|
||||||
|
<< "\"\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
|
@ -0,0 +1,41 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#ifndef _cmDocumentationFormatterMan_h
|
||||||
|
#define _cmDocumentationFormatterMan_h
|
||||||
|
|
||||||
|
#include "cmStandardIncludes.h"
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatter.h"
|
||||||
|
|
||||||
|
/** Class to print the documentation as man page. */
|
||||||
|
class cmDocumentationFormatterMan : public cmDocumentationFormatter
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
cmDocumentationFormatterMan();
|
||||||
|
|
||||||
|
virtual cmDocumentationEnums::Form GetForm() const
|
||||||
|
{ return cmDocumentationEnums::ManForm;}
|
||||||
|
|
||||||
|
virtual void PrintHeader(const char* name, std::ostream& os);
|
||||||
|
virtual void PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name);
|
||||||
|
virtual void PrintPreformatted(std::ostream& os, const char* text);
|
||||||
|
virtual void PrintParagraph(std::ostream& os, const char* text);
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -0,0 +1,183 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatterText.h"
|
||||||
|
|
||||||
|
cmDocumentationFormatterText::cmDocumentationFormatterText()
|
||||||
|
:cmDocumentationFormatter()
|
||||||
|
,TextWidth(77)
|
||||||
|
,TextIndent("")
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterText::PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name)
|
||||||
|
{
|
||||||
|
if(name)
|
||||||
|
{
|
||||||
|
os <<
|
||||||
|
"---------------------------------------"
|
||||||
|
"---------------------------------------\n";
|
||||||
|
os << name << "\n\n";
|
||||||
|
}
|
||||||
|
if(!section) { return; }
|
||||||
|
for(const cmDocumentationEntry* op = section; op->brief; ++op)
|
||||||
|
{
|
||||||
|
if(op->name)
|
||||||
|
{
|
||||||
|
if(op->name[0])
|
||||||
|
{
|
||||||
|
os << " " << op->name << "\n";
|
||||||
|
}
|
||||||
|
this->TextIndent = " ";
|
||||||
|
this->PrintFormatted(os, op->brief);
|
||||||
|
if(op->full)
|
||||||
|
{
|
||||||
|
os << "\n";
|
||||||
|
this->PrintFormatted(os, op->full);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
this->TextIndent = "";
|
||||||
|
this->PrintFormatted(os, op->brief);
|
||||||
|
}
|
||||||
|
os << "\n";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterText::PrintPreformatted(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
bool newline = true;
|
||||||
|
for(const char* ptr = text; *ptr; ++ptr)
|
||||||
|
{
|
||||||
|
if(newline)
|
||||||
|
{
|
||||||
|
os << this->TextIndent;
|
||||||
|
newline = false;
|
||||||
|
}
|
||||||
|
os << *ptr;
|
||||||
|
if(*ptr == '\n')
|
||||||
|
{
|
||||||
|
newline = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
os << "\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterText::PrintParagraph(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
os << this->TextIndent;
|
||||||
|
this->PrintColumn(os, text);
|
||||||
|
os << "\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterText::SetIndent(const char* indent)
|
||||||
|
{
|
||||||
|
this->TextIndent = indent;
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterText::PrintColumn(std::ostream& os,
|
||||||
|
const char* text)
|
||||||
|
{
|
||||||
|
// Print text arranged in an indented column of fixed witdh.
|
||||||
|
const char* l = text;
|
||||||
|
int column = 0;
|
||||||
|
bool newSentence = false;
|
||||||
|
bool firstLine = true;
|
||||||
|
int width = this->TextWidth - static_cast<int>(strlen(this->TextIndent));
|
||||||
|
|
||||||
|
// Loop until the end of the text.
|
||||||
|
while(*l)
|
||||||
|
{
|
||||||
|
// Parse the next word.
|
||||||
|
const char* r = l;
|
||||||
|
while(*r && (*r != '\n') && (*r != ' ')) { ++r; }
|
||||||
|
|
||||||
|
// Does it fit on this line?
|
||||||
|
if(r-l < (width-column-(newSentence?1:0)))
|
||||||
|
{
|
||||||
|
// Word fits on this line.
|
||||||
|
if(r > l)
|
||||||
|
{
|
||||||
|
if(column)
|
||||||
|
{
|
||||||
|
// Not first word on line. Separate from the previous word
|
||||||
|
// by a space, or two if this is a new sentence.
|
||||||
|
if(newSentence)
|
||||||
|
{
|
||||||
|
os << " ";
|
||||||
|
column += 2;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
os << " ";
|
||||||
|
column += 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
// First word on line. Print indentation unless this is the
|
||||||
|
// first line.
|
||||||
|
os << (firstLine?"":this->TextIndent);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Print the word.
|
||||||
|
os.write(l, static_cast<long>(r-l));
|
||||||
|
newSentence = (*(r-1) == '.');
|
||||||
|
}
|
||||||
|
|
||||||
|
if(*r == '\n')
|
||||||
|
{
|
||||||
|
// Text provided a newline. Start a new line.
|
||||||
|
os << "\n";
|
||||||
|
++r;
|
||||||
|
column = 0;
|
||||||
|
firstLine = false;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
// No provided newline. Continue this line.
|
||||||
|
column += static_cast<long>(r-l);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
// Word does not fit on this line. Start a new line.
|
||||||
|
os << "\n";
|
||||||
|
firstLine = false;
|
||||||
|
if(r > l)
|
||||||
|
{
|
||||||
|
os << this->TextIndent;
|
||||||
|
os.write(l, static_cast<long>(r-l));
|
||||||
|
column = static_cast<long>(r-l);
|
||||||
|
newSentence = (*(r-1) == '.');
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
column = 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Move to beginning of next word. Skip over whitespace.
|
||||||
|
l = r;
|
||||||
|
while(*l && (*l == ' ')) { ++l; }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,45 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#ifndef _cmDocumentationFormatterText_h
|
||||||
|
#define _cmDocumentationFormatterText_h
|
||||||
|
|
||||||
|
#include "cmStandardIncludes.h"
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatter.h"
|
||||||
|
|
||||||
|
/** Class to print the documentation as plain text. */
|
||||||
|
class cmDocumentationFormatterText : public cmDocumentationFormatter
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
cmDocumentationFormatterText();
|
||||||
|
|
||||||
|
virtual cmDocumentationEnums::Form GetForm() const
|
||||||
|
{ return cmDocumentationEnums::TextForm;}
|
||||||
|
|
||||||
|
virtual void PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name);
|
||||||
|
virtual void PrintPreformatted(std::ostream& os, const char* text);
|
||||||
|
virtual void PrintParagraph(std::ostream& os, const char* text);
|
||||||
|
void PrintColumn(std::ostream& os, const char* text);
|
||||||
|
void SetIndent(const char* indent);
|
||||||
|
protected:
|
||||||
|
int TextWidth;
|
||||||
|
const char* TextIndent;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -0,0 +1,63 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatterUsage.h"
|
||||||
|
|
||||||
|
cmDocumentationFormatterUsage::cmDocumentationFormatterUsage()
|
||||||
|
:cmDocumentationFormatterText()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void cmDocumentationFormatterUsage::PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name)
|
||||||
|
{
|
||||||
|
if(name)
|
||||||
|
{
|
||||||
|
os << name << "\n";
|
||||||
|
}
|
||||||
|
if(!section) { return; }
|
||||||
|
for(const cmDocumentationEntry* op = section; op->brief; ++op)
|
||||||
|
{
|
||||||
|
if(op->name)
|
||||||
|
{
|
||||||
|
os << " " << op->name;
|
||||||
|
this->TextIndent = " ";
|
||||||
|
int align = static_cast<int>(strlen(this->TextIndent))-4;
|
||||||
|
for(int i = static_cast<int>(strlen(op->name)); i < align; ++i)
|
||||||
|
{
|
||||||
|
os << " ";
|
||||||
|
}
|
||||||
|
if ( strlen(op->name) > strlen(this->TextIndent)-4 )
|
||||||
|
{
|
||||||
|
os << "\n";
|
||||||
|
os.write(this->TextIndent, strlen(this->TextIndent)-2);
|
||||||
|
}
|
||||||
|
os << "= ";
|
||||||
|
this->PrintColumn(os, op->brief);
|
||||||
|
os << "\n";
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
os << "\n";
|
||||||
|
this->TextIndent = "";
|
||||||
|
this->PrintFormatted(os, op->brief);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
os << "\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
|
@ -0,0 +1,36 @@
|
||||||
|
/*=========================================================================
|
||||||
|
|
||||||
|
Program: CMake - Cross-Platform Makefile Generator
|
||||||
|
Module: $RCSfile$
|
||||||
|
Language: C++
|
||||||
|
Date: $Date$
|
||||||
|
Version: $Revision$
|
||||||
|
|
||||||
|
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
|
||||||
|
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
|
||||||
|
|
||||||
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
||||||
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. See the above copyright notices for more information.
|
||||||
|
|
||||||
|
=========================================================================*/
|
||||||
|
#ifndef _cmDocumentationFormatterUsage_h
|
||||||
|
#define _cmDocumentationFormatterUsage_h
|
||||||
|
|
||||||
|
#include "cmDocumentationFormatterText.h"
|
||||||
|
|
||||||
|
/** Class to print the documentation as usage on the command line. */
|
||||||
|
class cmDocumentationFormatterUsage : public cmDocumentationFormatterText
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
cmDocumentationFormatterUsage();
|
||||||
|
|
||||||
|
virtual cmDocumentationEnums::Form GetForm() const
|
||||||
|
{ return cmDocumentationEnums::UsageForm;}
|
||||||
|
|
||||||
|
virtual void PrintSection(std::ostream& os,
|
||||||
|
const cmDocumentationEntry* section,
|
||||||
|
const char* name);
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
Loading…
Reference in New Issue