added README file - TODO: make install

Thu, 05 Sep 2013 13:55:04 +0200

author
Mike Becker <universe@uap-core.de>
date
Thu, 05 Sep 2013 13:55:04 +0200
changeset 151
fc8d05972af7
parent 150
1cf2eabf94ed
child 152
3238f65db163

added README file - TODO: make install

README file | annotate | diff | comparison | revisions
ucx/ucx.h file | annotate | diff | comparison | revisions
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Thu Sep 05 13:55:04 2013 +0200
@@ -0,0 +1,70 @@
+
+-------------------------------------------------------------------------------
+                     UAP Common eXtensions - UCX
+-------------------------------------------------------------------------------
+
+0. Table of Contents:
+
+  1. Introduction  ........................................................ 14
+  2. Build and Installation  .............................................. 24
+  3. Documentation  ....................................................... 57
+  4. Contact  ............................................................. 65
+
+
+1. Introduction
+
+UAP Common eXtensions provide useful data structures and algorithms for common
+programmatic tasks in C language. By design the features are divided into
+modules to minimize the library footprint. Using the build files you can create
+a static lib containing all modules, but you might also want use the UCX sources
+in your project and compile against specific modules to further minimize the
+footprint. Feel free to do so.
+
+
+2. Build and Installation
+
+Untar the source archive and run
+
+  make CONF=<yourconfig>
+
+If you are using gcc, then simply run
+
+  make
+
+The further available configurations are gcc-debug, g++, g++-debug, osx,
+osx-debug, suncc, suncc-debug and windows. The later uses microsoft visual C++
+compiler. If you want to use mingw oder cygwin, you can use the default gcc
+configuration.
+
+The build files are placed into a build subdirectory, which is created if it
+does not exists.
+
+To install UCX, run
+
+  make install
+
+or
+
+  make install PREFIX=<install_dir>
+
+The default prefix is /usr/local.
+
+If you want to test you build, run
+
+  make run CONF=<yourconfig>
+
+
+3. Documentation
+
+The code uses doxygen source code documentation. A html version of the
+documentation is also available here:
+
+  http://develop.uap-core.de/ucx/1.0/index.html
+
+
+4. Contact
+
+Copyright (c) 2013 Olaf Wintermann
+
+  Mike "UniversE" Becker        (universe@uap-core.de)
+  Olaf "Prometheus" Wintermann  (prometheus@uap-core.de)
--- a/ucx/ucx.h	Mon Aug 19 13:41:53 2013 +0200
+++ b/ucx/ucx.h	Thu Sep 05 13:55:04 2013 +0200
@@ -36,6 +36,15 @@
 #ifndef UCX_H
 #define	UCX_H
 
+/** Major UCX version as integer constant. */
+#define UCX_VERSION_MAJOR   1
+
+/** Minor UCX version as integer constant. */
+#define UCX_VERSION_MINOR   0
+
+/** The UCX version in format [major].[minor] */
+#define UCX_VERSION UCX_VERSION_MAJOR.UCX_VERSION_MINOR
+
 #include <stdlib.h>
 
 #ifdef _WIN32

mercurial