Add libmangle minimalist "mainpage"
git-svn-id: svn+ssh://svn.code.sf.net/p/mingw-w64/code/trunk@1471 4407c894-4637-0410-b4f5-ada5f102cad1
diff --git a/mingw-w64-libraries/libmangle/Doxyfile b/mingw-w64-libraries/libmangle/Doxyfile
index 51adc67..b5b7d01 100644
--- a/mingw-w64-libraries/libmangle/Doxyfile
+++ b/mingw-w64-libraries/libmangle/Doxyfile
@@ -124,7 +124,7 @@
HTML_OUTPUT = html
HTML_FILE_EXTENSION = .html
HTML_HEADER =
-HTML_FOOTER =
+HTML_FOOTER = html/footer.html
HTML_STYLESHEET =
HTML_ALIGN_MEMBERS = YES
HTML_DYNAMIC_SECTIONS = NO
diff --git a/mingw-w64-libraries/libmangle/html/files.html b/mingw-w64-libraries/libmangle/html/files.html
index a215cd6..c997a60 100644
--- a/mingw-w64-libraries/libmangle/html/files.html
+++ b/mingw-w64-libraries/libmangle/html/files.html
@@ -30,6 +30,7 @@
<tr><td class="indexkey">src/<a class="el" href="m__ms_8h.html">m_ms.h</a> <a href="m__ms_8h_source.html">[code]</a></td><td class="indexvalue"></td></tr>
<tr><td class="indexkey">src/<a class="el" href="m__token_8c.html">m_token.c</a></td><td class="indexvalue"></td></tr>
<tr><td class="indexkey">src/<a class="el" href="m__token_8h.html">m_token.h</a> <a href="m__token_8h_source.html">[code]</a></td><td class="indexvalue"></td></tr>
+ <tr><td class="indexkey">src/<a class="el" href="mainpage_8h.html">mainpage.h</a> <a href="mainpage_8h_source.html">[code]</a></td><td class="indexvalue"></td></tr>
</table>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 10 Oct 2009 for libmangle by
diff --git a/mingw-w64-libraries/libmangle/html/footer.html b/mingw-w64-libraries/libmangle/html/footer.html
new file mode 100644
index 0000000..0b26718
--- /dev/null
+++ b/mingw-w64-libraries/libmangle/html/footer.html
@@ -0,0 +1,5 @@
+<hr size="1"/><address style="text-align: right;"><small>Generated on $date for $projectname by
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> $doxygenversion </small></address>
+</body>
+</html>
diff --git a/mingw-w64-libraries/libmangle/html/index.html b/mingw-w64-libraries/libmangle/html/index.html
index 9544a05..0bad1a2 100644
--- a/mingw-w64-libraries/libmangle/html/index.html
+++ b/mingw-w64-libraries/libmangle/html/index.html
@@ -2,7 +2,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
-<title>libmangle: Main Page</title>
+<title>libmangle: Libmange</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
@@ -18,8 +18,28 @@
</div>
</div>
<div class="contents">
-<h1>libmangle Documentation</h1><h3><dl class="rcs"><dt><b>Revision</b></dt><dd>1467</dd></dl>
-</h3></div>
+<h1>Libmange</h1><h3><dl class="rcs"><dt><b>Revision</b></dt><dd>1467</dd></dl>
+</h3><dl class="author"><dt><b>Author:</b></dt><dd>The mingw-w64 Dev Team </dd></dl>
+<dl class="version"><dt><b>Version:</b></dt><dd>1.0 </dd></dl>
+<h2><a class="anchor" id="intro_sec">
+Introduction</a></h2>
+<p>Libmangle is library for translating C++ symbols produced by Microsoft Visual Studio C++ suite of tools into human readable names. </p>
+<h3><a class="anchor" id="info_subsec">
+Name Mangling</a></h3>
+<p>Name mangling is a technique used by modern compilers to add addition information about a function, a structure or a datatype to a symbol name. Information can include call parameter type and return type, symbol namespace and etc. Often, the way the information is encoded in specific to a compiler vendor. </p>
+<h3><a class="anchor" id="cpp_subsec">
+C++ and Name Mangling</a></h3>
+<p>Languages such as the C++ language do not define a standard name decoration scheme, most often code produced by one compiler is also incompatible with another C++ compiler ABI wise. Name mangling prevents accidentally linking to code meant for another compiler. </p>
+<h3><a class="anchor" id="decde_subsec">
+Deciphering Mangled Names</a></h3>
+<p>Libmangle allows symbol names on objects created by Microsoft Visual C++ tools to be decoded into human readable names. In addition to easing debugging, it also allows the possibility of non-MSVC tools to examine the objects. </p>
+<h3><a class="anchor" id="external_subsec">
+External Links</a></h3>
+<p>For more information, see: <a href="http://en.wikipedia.org/wiki/Name_mangling">http://en.wikipedia.org/wiki/Name_mangling</a> </p>
+<h2><a class="anchor" id="install_sec">
+Installation</a></h2>
+<p>Use the shell script "configure" and pass "--help" for library build and install options. </p>
+</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 10 Oct 2009 for libmangle by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
diff --git a/mingw-w64-libraries/libmangle/html/mainpage_8h.html b/mingw-w64-libraries/libmangle/html/mainpage_8h.html
new file mode 100644
index 0000000..9aa8e03
--- /dev/null
+++ b/mingw-w64-libraries/libmangle/html/mainpage_8h.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>libmangle: src/mainpage.h File Reference</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<!-- Generated by Doxygen 1.6.1 -->
+<div class="navigation" id="top">
+ <div class="tabs">
+ <ul>
+ <li><a href="index.html"><span>Main Page</span></a></li>
+ <li><a href="annotated.html"><span>Data Structures</span></a></li>
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
+ </ul>
+ </div>
+ <div class="tabs">
+ <ul>
+ <li><a href="files.html"><span>File List</span></a></li>
+ <li><a href="globals.html"><span>Globals</span></a></li>
+ </ul>
+ </div>
+</div>
+<div class="contents">
+<h1>src/mainpage.h File Reference</h1>
+<p><a href="mainpage_8h_source.html">Go to the source code of this file.</a></p>
+<table border="0" cellpadding="0" cellspacing="0">
+</table>
+</div>
+<hr size="1"/><address style="text-align: right;"><small>Generated on 10 Oct 2009 for libmangle by
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
+</body>
+</html>
diff --git a/mingw-w64-libraries/libmangle/html/mainpage_8h_source.html b/mingw-w64-libraries/libmangle/html/mainpage_8h_source.html
new file mode 100644
index 0000000..4a04296
--- /dev/null
+++ b/mingw-w64-libraries/libmangle/html/mainpage_8h_source.html
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>libmangle: src/mainpage.h Source File</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<!-- Generated by Doxygen 1.6.1 -->
+<div class="navigation" id="top">
+ <div class="tabs">
+ <ul>
+ <li><a href="index.html"><span>Main Page</span></a></li>
+ <li><a href="annotated.html"><span>Data Structures</span></a></li>
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
+ </ul>
+ </div>
+ <div class="tabs">
+ <ul>
+ <li><a href="files.html"><span>File List</span></a></li>
+ <li><a href="globals.html"><span>Globals</span></a></li>
+ </ul>
+ </div>
+<h1>src/mainpage.h</h1><a href="mainpage_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// This is the mainpage file for doxygen</span>
+<a name="l00002"></a>00002 <span class="comment">// See <http://www.doxygen.nl/commands.html></span>
+<a name="l00003"></a>00003 <span class="comment">// for command help.</span>
+<a name="l00004"></a>00004
+</pre></div></div>
+<hr size="1"/><address style="text-align: right;"><small>Generated on 10 Oct 2009 for libmangle by
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
+</body>
+</html>
diff --git a/mingw-w64-libraries/libmangle/src/mainpage.h b/mingw-w64-libraries/libmangle/src/mainpage.h
new file mode 100644
index 0000000..d80ebc2
--- /dev/null
+++ b/mingw-w64-libraries/libmangle/src/mainpage.h
@@ -0,0 +1,22 @@
+// This is the mainpage file for doxygen
+// See <http://www.doxygen.nl/commands.html>
+// for command help.
+
+/*! \mainpage Libmange
+ \author The mingw-w64 Dev Team
+ \version 1.0
+ \section intro_sec Introduction
+
+ Libmangle is library for translating C++ symbols produced by Microsoft Visual Studio C++ suite of tools into human readable names.
+ \subsection info_subsec Name Mangling
+ Name mangling is a technique used by modern compilers to add addition information about a function, a structure or a datatype to a symbol name. Information can include call parameter type and return type, symbol namespace and etc. Often, the way the information is encoded in specific to a compiler vendor.
+ \subsection cpp_subsec C++ and Name Mangling
+ Languages such as the C++ language do not define a standard name decoration scheme, most often code produced by one compiler is also incompatible with another C++ compiler ABI wise. Name mangling prevents accidentally linking to code meant for another compiler.
+ \subsection decde_subsec Deciphering Mangled Names
+ Libmangle allows symbol names on objects created by Microsoft Visual C++ tools to be decoded into human readable names. In addition to easing debugging, it also allows the possibility of non-MSVC tools to examine the objects.
+ \subsection external_subsec External Links
+ For more information, see: http://en.wikipedia.org/wiki/Name_mangling
+ \section install_sec Installation
+
+ Use the shell script "configure" and pass "--help" for library build and install options.
+ */
