-<!doctype html>
+<!DOCTYPE html>
<html>
<head>
- <title>MUtilites</title>
- <meta charset="utf-8" />
- <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
- <style type="text/css">
- <!--
- body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; }
- tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; }
- a { color: #0000BB; text-decoration: none; }
- a:visited { color: #0000BB; text-decoration: none; }
- a:active { color: #0000FF; text-decoration: none; }
- a:hover { color: #0000FF; text-decoration: underline; }
- -->
- </style>
+ <meta charset="utf-8">
+ <meta name="generator" content="pandoc">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+ <meta name="author" content="Created by LoRd_MuldeR <mulder2@gmx> – check http://muldersoft.com/ for news and updates!">
+ <title>MUtilities – README</title>
+ <style type="text/css">code{white-space: pre;}</style>
+ <!--[if lt IE 9]>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+ <![endif]-->
+ <style type="text/css">
+ <!--
+ body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; }
+ p { text-align: justify; }
+ tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; }
+ h1:not(.title) { margin-top: 2.25em; }
+ h2:not(.author) { margin-top: 2.0em; }
+ h3, h4 { margin-top: 1.75em; }
+ a { color: #0000BB; text-decoration: none; }
+ a:visited { color: #0000BB; text-decoration: none; }
+ a:active { color: #0000FF; text-decoration: none; }
+ a:hover { color: #0000FF; text-decoration: underline; }
+ img { margin-bottom: 0.75em; }
+ ul, ol { margin-bottom: 2.0em; }
+ li>ul, li>ol { margin-bottom: 0em; }
+ -->
+ </style>
</head>
<body>
- <h1>MUtilities – MuldeR's Utilities for Qt</h1>
- <p><b>Please visit <a href="http://muldersoft.com/">http://muldersoft.com/</a> or <a href="https://github.com/lordmulder?tab=repositories">https://github.com/lordmulder</a> for more information!</b></p>
- <hr>
- <h2>About this Library</h2>
- <p>This library is a collection of routines and classes to extend the <a href="http://qt-project.org/">Qt cross-platform framework</a>. It contains various convenience and utility functions as well as wrappers for OS-specific functionalities. The library was originally created as a "side product" of the <a href="http://lamexp.sourceforge.net/">LameXP</a> application: Over the years, a lot of code, <i>not</i> really specific to LameXP, had accumulated in the LameXP code base. Some of that code even had been used in other projects too, in a "copy & paste" fashion – which had lead to redundancy and much complicated maintenance. In order to clean-up the LameXP code base, to eliminate the ugly redundancy and to simplify maintenance, the code in question has finally been refactored into the <i>MUtilities</i> (aka "MuldeR's Utilities for Qt") library. This library now forms the foundation of LameXP and various other OpenSource projects.
- <hr>
- <h2>License Information</h2>
- <p>This library is free software. It is released under the terms of the <a href="https://www.gnu.org/licenses/lgpl-2.1.html">GNU Lesser General Public License (LGPL), Version 2.1</a>.</p>
- <p><pre><code>MUtilities – MuldeR's Utilities for Qt<br>Copyright (C) 2004-2014 LoRd_MuldeR <MuldeR2@GMX.de>. Some rights reserved.<br><br>This library is free software; you can redistribute it and/or<br>modify it under the terms of the GNU Lesser General Public<br>License as published by the Free Software Foundation; either<br>version 2.1 of the License, or (at your option) any later version.<br><br>This library is distributed in the hope that it will be useful,<br>but WITHOUT ANY WARRANTY; without even the implied warranty of<br>MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU<br>Lesser General Public License for more details.<br><br>You should have received a copy of the GNU Lesser General Public<br>License along with this library; if not, write to the Free Software<br>Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</code></pre>
- <hr>
- <h2>Acknowledgement</h2>
- <p>The following <u>third-party</u> code is used in the <i>MUtilities</i> library:
- <ul>
- <li>
- <b>Keccak/SHA-3 Reference Implementation</b><br>
- Implementation by the Keccak, Keyak and Ketje Teams, namely, Guido Bertoni, Joan Daemen, Michaël Peeters, Gilles Van Assche and Ronny Van Keer<br>
- No Copyright / Dedicated to the Public Domain<br><br>
- </li>
- <li>
- <b>Natural Order String Comparison</b><br>
- Copyright (C) 2000, 2004 by Martin Pool <a href="mailto:mbp@sourcefrog.net"><mbp@sourcefrog.net></a><br>
- Released under the zlib License<br><br>
- </li>
- <li>
- <b>Adler-32 Checksum Algorithm (from zlib)</b><br>
- Copyright (C) 1995-2013 Jean-loup Gailly and Mark Adler<br>
- Released under the zlib License<br><br>
- </li>
- </ul>
- <hr>
- <p>e.o.f.</p>
+<header>
+<h1 class="title">MUtilities – README</h1>
+<h2 class="author">Created by LoRd_MuldeR <<script type="text/javascript">
+<!--
+h='gmx';a='@';n='mulder2';e=n+a+h;
+document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'" clas'+'s="em' + 'ail">'+e+'<\/'+'a'+'>');
+// -->
+</script><noscript>mulder2 at gmx</noscript>> – check <a href="http://muldersoft.com/" class="uri">http://muldersoft.com/</a> for news and updates!</h2>
+</header>
+<nav id="TOC">
+<ul>
+<li><a href="#introduction"><span class="toc-section-number">1</span> Introduction</a></li>
+<li><a href="#project-structure"><span class="toc-section-number">2</span> Project Structure</a></li>
+<li><a href="#example"><span class="toc-section-number">3</span> Example</a><ul>
+<li><a href="#build-notes"><span class="toc-section-number">3.1</span> Build Notes</a></li>
+</ul></li>
+<li><a href="#api-documentation"><span class="toc-section-number">4</span> API Documentation</a></li>
+<li><a href="#license"><span class="toc-section-number">5</span> License</a></li>
+<li><a href="#acknowledgement"><span class="toc-section-number">6</span> Acknowledgement</a></li>
+</ul>
+</nav>
+<h1 id="introduction"><span class="header-section-number">1</span> Introduction</h1>
+<p>The <strong>MUtilities</strong> library is a collection of routines and classes to extend the <a href="http://qt-project.org/"><em>Qt cross-platform framework</em></a>. It contains various convenience and utility functions as well as wrappers for OS-specific functionalities. The library was originally created as a "side product" of the <a href="http://lamexp.sourceforge.net/"><strong>LameXP</strong></a> application: Over the years, a lot of code, <strong>not</strong> really specific to <em>LameXP</em>, had accumulated in the <em>LameXP</em> code base. Some of that code even had been used in other projects too, in a "copy & paste" fashion – which had lead to redundancy and much complicated maintenance. In order to clean-up the LameXP code base, to eliminate the ugly redundancy and to simplify maintenance, the code in question has finally been refactored into the <strong>MUtilities</strong> (aka "MuldeR's Utilities for Qt") library. This library now forms the foundation of <em>LameXP</em> and <a href="https://github.com/lordmulder"><em>other OpenSource projects</em></a>.</p>
+<h1 id="project-structure"><span class="header-section-number">2</span> Project Structure</h1>
+<p>The <em>MUtilities</em> project directory is organized as follows:</p>
+<ul>
+<li><code>bin/</code> – compiled library files (static or shared), link those files in projects that use the MUtilities library</li>
+<li><code>docs/</code> – programming interface documentation, generated with Doxygen tool</li>
+<li><code>etc/</code> – miscellaneous files, everything that doesn't fit in anywhere else</li>
+<li><code>include/</code> – public header files, include this directory in projects that use the MUtilities library</li>
+<li><code>obj/</code> – object code files, intermediate files generated during the build process</li>
+<li><code>res/</code> – resource files, required for building the MUtilities library</li>
+<li><code>src/</code> – source code files, required for building the MUtilities library (third-party code in <code>src/3rd_party/</code>)</li>
+<li><code>test/</code> – unit tests, based on Google Test framework</li>
+<li><code>tmp/</code> – temporary files, automatically generated during the build process</li>
+</ul>
+<h1 id="example"><span class="header-section-number">3</span> Example</h1>
+<p>Here is a minimal example on how to use the <em>MUtilities</em> library in your project:</p>
+<pre><code>//MUtils
+#include <MUtils/Global.h>
+
+int main(int argc, char **argv)
+{
+ qDebug("Random number: %u\n", MUtils::next_rand_u32());
+}</code></pre>
+<h2 id="build-notes"><span class="header-section-number">3.1</span> Build Notes</h2>
+<ul>
+<li>In order to use the <em>MUtilities</em> library in your project, your build environment must have already been set up for building Qt-based projects. Setting up Qt is <em>not</em> covered by this document.</li>
+<li>Additionally, make sure that <em>MUtilities'</em> <code>include/</code> directory is contained in your "Additional Include Directories" and that the <em>MUtilities'</em> <code>bin/</code> directory is contained in your "Additional Library Directories".</li>
+<li>Finally, make sure that your project links against the <code>MUtils32-1.lib</code> library file. For each build configuration, pick the proper <strong>.lib</strong> file from the corresponding <code>bin/<platform>/<config>/</code> directory!</li>
+<li>If your projects intends to use the <em>MUtilities</em> library as a <strong>static</strong> library, then the macro <code>MUTILS_STATIC_LIB</code> <em>must</em> be added to your project's "Preprocessor Definitions".</li>
+</ul>
+<h1 id="api-documentation"><span class="header-section-number">4</span> API Documentation</h1>
+<p>A fully-fledged documentation of the <em>MUtilities</em> programming interface (API) is available thanks to <a href="http://www.stack.nl/~dimitri/doxygen/"><em>Doxygen</em></a>. Please see <a href="docs/index.html"><strong><code>docs/index.html</code></strong></a> for details!</p>
+<h1 id="license"><span class="header-section-number">5</span> License</h1>
+<p>This library is free software. It is released under the terms of the <a href="https://www.gnu.org/licenses/lgpl-2.1.html"><em>GNU Lesser General Public License (LGPL), Version 2.1</em></a>.</p>
+<pre><code>MUtilities - MuldeR's Utilities for Qt
+Copyright (C) 2004-2019 LoRd_MuldeR <MuldeR2@GMX.de>. Some rights reserved.
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</code></pre>
+<h1 id="acknowledgement"><span class="header-section-number">6</span> Acknowledgement</h1>
+<p>The following people have contributed in the development of the MUtilities library:</p>
+<ul>
+<li><strong>John Buonagurio <<script type="text/javascript">
+<!--
+h='exponent.com';a='@';n='jbuonagurio';e=n+a+h;
+document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'" clas'+'s="em' + 'ail">'+e+'<\/'+'a'+'>');
+// -->
+</script><noscript>jbuonagurio at exponent dot com</noscript>></strong><br />
+Support for Qt5</li>
+</ul>
+<p>The following third-party code is used in the MUtilities library:</p>
+<ul>
+<li><p><strong>Keccak/SHA-3 Reference Implementation</strong><br />
+Implementation by the Keccak, Keyak and Ketje Teams, namely, Guido Bertoni, Joan Daemen, Michaël Peeters, Gilles Van Assche and Ronny Van Keer<br />
+No Copyright / Dedicated to the Public Domain</p></li>
+<li><p><strong>Natural Order String Comparison</strong><br />
+Copyright (C) 2000, 2004 by Martin Pool <<script type="text/javascript">
+<!--
+h='sourcefrog.net';a='@';n='mbp';e=n+a+h;
+document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'" clas'+'s="em' + 'ail">'+e+'<\/'+'a'+'>');
+// -->
+</script><noscript>mbp at sourcefrog dot net</noscript>><br />
+Released under the zlib License</p></li>
+<li><p><strong>Adler-32 Checksum Algorithm (from zlib)</strong><br />
+Copyright (C) 1995-2013 Jean-loup Gailly and Mark Adler<br />
+Released under the zlib License</p></li>
+</ul>
+<p> </p>
+<p><strong>e.o.f.</strong></p>
</body>
</html>