]> granicus.if.org Git - libevent/commitdiff
Update README with CMake build instructions.
authorJoakim Soderberg <joakim.soderberg@gmail.com>
Tue, 14 Jan 2014 17:25:07 +0000 (18:25 +0100)
committerJoakim Soderberg <joakim.soderberg@gmail.com>
Tue, 14 Jan 2014 17:25:07 +0000 (18:25 +0100)
README.md

index 3dfa10a3af24136bddc787433416de4ab9070122..bc6d72bc9bd2e007bd25f4664992f6f013f34fdd 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,11 +1,36 @@
-0. BUILDING AND INSTALLATION (Briefly)
+0. BUILDING AND INSTALLATION (Briefly)
 
+## Autoconf
+
+```
 $ ./configure
 $ make
 $ make verify   # (optional)
 $ sudo make install
+```
+
+## CMake (Windows)
+
+<http://www.cmake.org>
+
+```
+$ md build && cd build
+$ cmake -G "Visual Studio 10" ..   # Or whatever generator you want to use cmake --help for a list.
+$ start libevent.sln
+```
+
+## CMake (Unix)
 
-1. BUILDING AND INSTALLATION (In Depth)
+```
+$ mkdir build && cd build
+$ cmake ..     # Default to Unix Makefiles.
+$ make
+$ make verify  # (optional)
+```
+
+# 1. BUILDING AND INSTALLATION (In Depth)
+
+## Autoconf
 
 To build libevent, type
 
@@ -17,11 +42,15 @@ $ ./configure && make
 
 You can run the regression tests by running
 
+```
 $ make verify
+```
 
 Install as root via
 
-# make install
+```
+$ make install
+```
 
 Before reporting any problems, please run the regression tests.
 
@@ -44,20 +73,54 @@ The configure script also supports the following flags:
    --disable-openssl         Disable support for OpenSSL encryption.
    --disable-thread-support  Don't support multithreaded environments.
 
-2. USEFUL LINKS:
+## CMake (Windows)
+
+First of all install <http://www.cmake.org>.
+
+To build libevent using Microsoft Visual studio open the "Visual Studio Command prompt" and type:
+
+```
+$ cd <libevent source dir>
+$ cmake -G "Visual Studio 10" ..   # Or whatever generator you want to use cmake --help for a list.
+$ start libevent.sln
+```
+
+Then build the entire solution via the Build menu. 
+
+the "NMake Makefiles" CMake generator can be used to build entirely via the command line.
+
+To get a list of settings available for the project you can type:
+
+```
+$ cmake -LH ..
+```
+
+CMake also provides a GUI that lets you specify the source directory and output (binary) directory
+that the build should be placed in. 
+
+### OpenSSL support
+
+To build Libevent with OpenSSL support you will need to have OpenSSL binaries available when building,
+these can be found here: <http://www.openssl.org/related/binaries.html>
+
+# 2. USEFUL LINKS:
 
 For the latest released version of Libevent, see the official website at
 http://libevent.org/ .
 
 There's a pretty good work-in-progress manual up at
-   http://www.wangafu.net/~nickm/libevent-book/ .
+   <http://www.wangafu.net/~nickm/libevent-book/> .
 
 For the latest development versions of Libevent, access our Git repository
 via
-   "git clone git://levent.git.sourceforge.net/gitroot/levent/libevent"
 
-You can browse the git repository online at
-http://levent.git.sourceforge.net/git/gitweb-index.cgi .
+```
+$ git clone git://levent.git.sourceforge.net/gitroot/levent/libevent
+```
+
+You can browse the git repository online at:
+<http://levent.git.sourceforge.net/git/gitweb-index.cgi> .
+<https://github.com/libevent/Libevent>
 
 To report bugs, request features, or submit patches to Libevent,
 use the Sourceforge trackers at
@@ -66,7 +129,7 @@ https://sourceforge.net/tracker/?group_id=50884 .
 There's also a libevent-users mailing list for talking about Libevent
 use and development: http://archives.seul.org/libevent/users/
 
-3. ACKNOWLEDGMENTS
+3. ACKNOWLEDGMENTS
 
 The following people have helped with suggestions, ideas, code or
 fixing bugs: