From 29be65ea91d9946c350c8a65e90cecaabf03e8e4 Mon Sep 17 00:00:00 2001
From: Maximilien Siavelis <maximilien.siavelis@simulease.com>
Date: 周日, 14 1月 2018 21:11:59 +0800
Subject: [PATCH] adding an example

---
 README.md |  102 +++++++++++++++++++++++++++++++++++++++++++++------
 1 files changed, 90 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index b90e7cc..88c64b4 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,93 @@
-license-manager-cpp
-===================
+# Open License Manager
+![Build Status](https://travis-ci.org/open-license-manager/open-license-manager.png "Build Status")
 
-A lincense manager written in C++
+A lincense manager written in C/C++ for Windows and Linux environments.
 
-Linux
-===================
+It allows to protect the software you develop from unauthorized copies,
+limit the usage in time, to a specific set of machines, or prevent the usage in 
+virtualized environments. It is an Open License Manager that helps to keep your 
+software closed ;-)
 
-apt-get install 
-libboost-dev libboost-filesystem-dev
-libboost-program-options-dev libboost-test-dev libboost-date-time-dev
-libssl-dev?
-libdbus-1-dev
-#libcrypto++dev (version 5.6.1)
-openssl genrsa -out src/license-generator/privkey.pem 2048
\ No newline at end of file
+The software is made by 2 main sub-components:
+ * a C library with no (or minimal) external dependencies (the part you have to integrate in your software).
+ * a license generator written in C++ (allows you to generate a license).
+ 
+these modules are planned....
+ * a license [backoffice](../../issues/7) in php (in order to handle multiple licenses).
+ * a license debugger to be sent to the final customer when there are licensing problems. 
+ * a [log decriptor](../../issues/8) in order to decrypt logs generated by the license system.
+
+You can notice 2 more sub-projects:
+ * bootstrap: allows to generate private keys and modify the library on the fly after the downloading.
+ * testing  : runs the tests (and publish the results on cdash)
+ 
+Licensing
+=====================
+The project comes out with a very large freedom of use for everyone (and it will always be). 
+It uses a BSD 3 clauses licensing schema. 
+
+How to build
+============
+
+## prerequisites
+GCC (Linux), MINGW or MSVC (Windows)
+cmake, boost, openssl (Linux/MINGW)
+
+```
+git clone https://github.com/open-license-manager/open-license-manager.git
+cd open-license-manager/
+mkdir build
+cd build
+```
+
+## on Linux
+```
+cmake .. -DCMAKE_INSTALL_PREFIX=../install
+make
+make install
+```
+
+## on Windows (with MSVC 2010)
+```
+cmake .. -G "Visual Studio 10 2010 Win64" -DCMAKE_INSTALL_PREFIX=../install
+cmake --build . --target install --config Release
+```
+
+## cross compile with MINGW on Linux
+```
+x86_64-w64-mingw32.static-cmake .. -DCMAKE_INSTALL_PREFIX=../install
+make
+make install
+```
+
+How to test
+===========
+
+## on Linux
+```
+make test
+```
+
+## on Windows (MSVC)
+```
+ctest -C Release
+```
+
+How to use
+==========
+
+This simple example shows how to integrate open-licence-manager into your project
+
+```
+$ cd example
+$ cmake .
+$ make
+$ ./example
+license ERROR :
+    license file not found
+the pc signature is :
+    Jaaa-aaaa-MG9F-ZhBB
+$ ../install/bin/license_generator example -s Jaaa-aaaa-MG9F-ZhBB -o example.lic 
+$ ./example
+licence OK
+```

--
Gitblit v1.9.1