X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=README.html;h=83a04d48e3b014271199844b671d65bf5ee491eb;hb=b6091380a65b0d3b26e40be98f0c34c94a28e048;hp=f37977124032a01f869aed82eef9ac9661372052;hpb=53830e0b96810dbf5bb71966a7cbbc6935213a98;p=mutilities%2FMUtilities.git diff --git a/README.html b/README.html index f379771..83a04d4 100644 --- a/README.html +++ b/README.html @@ -1,12 +1,19 @@ - + - - - - + + + + MUtilities â README - + @@ -29,20 +36,16 @@ -

MUtilities â README

Created by LoRd_MuldeR <> â check http://muldersoft.com/ for news and updates!

Created by LoRd_MuldeR <mulder2@gmx> â check http://muldersoft.com/ for news and updates!

+ -

1 Introduction

The MUtilities library is a collection of routines and classes to extend the Qt cross-platform framework. 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 LameXP application: Over the years, a lot of code, not 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 MUtilities (aka "MuldeR's Utilities for Qt") library. This library now forms the foundation of LameXP and other OpenSource projects.

2 Project Structure

1 Introduction

2 Project Structure

The MUtilities project directory is organized as follows:

bin/ â compiled library files (static or shared), link those files in projects that use the MUtilities library

'+e+'<\

etc/ â miscellaneous files, everything that doesn't fit in anywhere else

include/ â public header files, include this directory in projects that use the MUtilities library

obj/ â object code files, intermediate files generated during the build process

res/ â resouce files, required for building the MUtilities library

res/ â resource files, required for building the MUtilities library

src/ â source code files, required for building the MUtilities library (third-party code in src/3rd_party/)

test/ â unit tests, based on Google Test framework

tmp/ â temporary files, automatically generated during the build process

3 Example

Here is a minimal example on how to use the MUtilities library in your project:

//MUtils
 #include <MUtils/Global.h>
@@ -74,19 +77,19 @@ int main(int argc, char **argv)
 {
     qDebug("Random number: %u\n", MUtils::next_rand_u32());
 }

3.1 Build Notes

In order to use the MUtilities library in your project, your build environment must have already been set up for building Qt-based projects. Setting up Qt is not covered by this document.
Additionally, make sure that MUtilities' include/ directory is contained in your "Additional Include Directories" and that the MUtilities' bin/ directory is contained in your "Additional Library Directories".
Finally, make sure that your project links against the MUtils32-1.lib library file. For each build configuration you have to pick the proper .lib file from the correspnding bin/<platform>/<config>/ directory!
If your projects intends to use the MUtilities library as a static library, then the macro MUTILS_STATIC_LIB must be added to your project's "Preprocessor Definitions".
Additionally, make sure that MUtilities' include/ directory is contained in your "Additional Include Directories" and that the MUtilities' bin/ directory is contained in your "Additional Library Directories".
Finally, make sure that your project links against the MUtils32-1.lib library file. For each build configuration, pick the proper .lib file from the corresponding bin/<platform>/<config>/ directory!
If your projects intends to use the MUtilities library as a static library, then the macro MUTILS_STATIC_LIB must be added to your project's "Preprocessor Definitions".

4 API Documentation

A fully-fledged documentation of the MUtilities programming interface (API) is available thanks to Doxygen. Please see docs/index.html for details!

5 License

This library is free software. It is released under the terms of the GNU Lesser General Public License (LGPL), Version 2.1.

MUtilities - MuldeR's Utilities for Qt
-Copyright (C) 2004-2016 LoRd_MuldeR <MuldeR2@GMX.de>. Some rights reserved.
+Copyright (C) 2004-2021 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
@@ -101,19 +104,19 @@ 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.

6 Acknowledgement

The following people have contributed in the development of the MUtilities library:

John Buonagurio <jbuonagurio@exponent.com>
+Support for Qt5

The following third-party code is used in the MUtilities library:

Keccak/SHA-3 Reference Implementation
Implementation by the Keccak, Keyak and Ketje Teams, namely, Guido Bertoni, Joan Daemen, MichaÃ«l Peeters, Gilles Van Assche and Ronny Van Keer
No Copyright / Dedicated to the Public Domain
Natural Order String Comparison
-Copyright (C) 2000, 2004 by Martin Pool
+Copyright (C) 2000, 2004 by Martin Pool <mbp@sourcefrog.net>
Released under the zlib License
Adler-32 Checksum Algorithm (from zlib)
Copyright (C) 1995-2013 Jean-loup Gailly and Mark Adler