Documentation: Fix HTML anchor ranges

Generate anchors of the form

  <a name="..."></a>

instead of

  <a name="..."/>

to ensure browsers know that the anchor contains no text and do not try
to guess an end of the range.  Also make the "section_Index" and item
label anchors empty instead of containing the section header or label
text.  This ensures that the text associated with target anchors is not
rendered as if it were a hyperlink.
This commit is contained in:
Brad King 2012-04-23 17:15:08 -04:00
parent 5771dd2f15
commit dfccdd65fb

View File

@ -127,7 +127,7 @@ void cmDocumentationFormatterHTML
{
os << "<h2><a name=\"section_";
cmDocumentationPrintHTMLId(os, name);
os << "\"/>" << name << "</h2>\n";
os << "\"></a>" << name << "</h2>\n";
}
// Is a list needed?
@ -167,9 +167,9 @@ void cmDocumentationFormatterHTML
{
os << " <a name=\"" << prefix << ":";
cmDocumentationPrintHTMLId(os, op->Name.c_str());
os << "\"><b><code>";
os << "\"></a><b><code>";
this->PrintHTMLEscapes(os, op->Name.c_str());
os << "</code></b></a>: ";
os << "</code></b>: ";
}
this->PrintHTMLEscapes(os, op->Brief.c_str());
if(op->Full.size())
@ -269,9 +269,9 @@ void cmDocumentationFormatterHTML
return;
}
os << "<h2><a name=\"section_Index\">Master Index "
os << "<h2><a name=\"section_Index\"></a>Master Index "
<< "CMake " << cmVersion::GetCMakeVersion()
<< "</a></h2>\n";
<< "</h2>\n";
if (!sections.empty())
{