aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/INSTALL.cmake55
1 files changed, 40 insertions, 15 deletions
diff --git a/docs/INSTALL.cmake b/docs/INSTALL.cmake
index 2a19e5dee..e44f514e5 100644
--- a/docs/INSTALL.cmake
+++ b/docs/INSTALL.cmake
@@ -18,6 +18,25 @@ Building with CMake
CMake builds can be configured either from the command line, or from one
of CMake's GUI's.
+Current flaws in the curl CMake build
+=====================================
+
+ Missing features in the cmake build:
+
+ - Builds libcurl without large file support
+ - It doesn't build src/hugehelp.c which creates the --manual output
+ - Can't select which SSL library to build with, only OpenSSL
+ - Doesn't build with SCP and SFTP support (libssh2)
+ - Doesn't allow different resolver backends (no c-ares build support)
+ - No RTMP support built
+ - Doesn't allow build curl and libcurl debug enabled
+ - Doesn't allow a custom CA bundle path
+ - Doesn't allow you to disable specific protocols from the build
+ - Doesn't properly enable IPv6 support by default
+ - Doesn't find or use krb4 or GSS
+ - Rebuilds test files too eagerly, but still can't run the tests
+
+
Important notice
==================
If you got your curl sources from a distribution tarball, make sure to
@@ -31,22 +50,28 @@ Important notice
Command Line CMake
==================
- A command line build of Curl is similar to the autotools build of Curl. It
+ A CMake build of curl is similar to the autotools build of curl. It
consists of the following steps after you have unpacked the source.
- # 1st create an out of source build tree parallel to the curl source
- # tree and change into that directory
- mkdir curl-build
- cd curl-build
- # now run CMake from the build tree, giving it the path to the top of
- # the Curl source tree. CMake will pick a compiler for you. If you
- # want to specify the compile, you can set the CC environment
- # variable prior to running CMake.
- cmake ../curl
- make
- # currently make test is not implemented
- #make test
- # Install to default location:
- make install
+
+ 1. Create an out of source build tree parallel to the curl source
+ tree and change into that directory
+
+ $ mkdir curl-build
+ $ cd curl-build
+
+ 2. Run CMake from the build tree, giving it the path to the top of
+ the curl source tree. CMake will pick a compiler for you. If you
+ want to specify the compile, you can set the CC environment
+ variable prior to running CMake.
+
+ $ cmake ../curl
+ $ make
+
+ 3. Install to default location:
+
+ $ make install
+
+ (The teste suit does not work with the cmake build)
ccmake
=========