kolan
/
CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

docbook: Fix the DocBook section output 

The DocBook formatter used to generate something like:

  <para id="section"><sect2><title>Title</title></sect2>Some Text</para>

Which was completely wrong. In DocBook, a section should look like this:

  <sect2 id="section"><title>Title</title><para>Some Text</para></sect2>
This commit is contained in:
Daniel Pfeifer 2012-09-07 10:35:55 +02:00 committed by Brad King
parent dbfe335099
commit 55146ed0f0
1 changed files with 15 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
Source/cmDocumentationFormatterDocbook.cxx
View File

@ -120,40 +120,31 @@ void cmDocumentationFormatterDocbook
section.GetEntries();
for(std::vector<cmDocumentationEntry>::const_iterator op = entries.begin();
op != entries.end();)
op != entries.end(); ++op)
{
if(op->Name.size())
{
for(;op != entries.end() && op->Name.size(); ++op)
os << "<sect2 id=\"";
this->PrintId(os, prefix.c_str(), op->Name);
os << "\">\n<title>";
cmDocumentationPrintDocbookEscapes(os, op->Name.c_str());
os << "</title>\n";
if(op->Full.size())
{
if(op->Name.size())
{
os << " <para id=\"";
this->PrintId(os, prefix.c_str(), op->Name);
os << "\"><sect2><title>";
cmDocumentationPrintDocbookEscapes(os, op->Name.c_str());
os << "</title></sect2> ";
}
os << "<abstract>\n<para>";
cmDocumentationPrintDocbookEscapes(os, op->Brief.c_str());
if(op->Name.size())
{
os << "</para>\n";
}
if(op->Full.size())
{
// a line break seems to be simply a line break with docbook
os << "\n ";
this->PrintFormatted(os, op->Full.c_str());
}
os << "\n";
os << "</para>\n</abstract>\n";
this->PrintFormatted(os, op->Full.c_str());
}
else
{
this->PrintFormatted(os, op->Brief.c_str());
}
os << "</sect2>\n";
}
else
{
this->PrintFormatted(os, op->Brief.c_str());
os << "\n";
++op;
}
}
if(name)