This is an automated email from the ASF dual-hosted git repository.
andor pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/zookeeper.git
The following commit(s) were added to refs/heads/master by this push:
new 4f35790b3 ZOOKEEPER-4782: The installation guide in
zookeeper-client/zookeeper-…
4f35790b3 is described below
commit 4f35790b30dd5918bcc02558716d124648966571
Author: yzx1983 <[email protected]>
AuthorDate: Fri Feb 9 19:22:18 2024 +0800
ZOOKEEPER-4782: The installation guide in zookeeper-client/zookeeper-…
ZOOKEEPER-4782: The installation guide in
zookeeper-client/zookeeper-client-c/README is outdated.
Reviewers: anmolnar
Author: yzx1983
Closes #2101 from yzx1983/master-fixcclientdoc
---
zookeeper-client/zookeeper-client-c/README | 66 +-----------------------------
1 file changed, 2 insertions(+), 64 deletions(-)
diff --git a/zookeeper-client/zookeeper-client-c/README
b/zookeeper-client/zookeeper-client-c/README
index ade5ad98f..24869756b 100644
--- a/zookeeper-client/zookeeper-client-c/README
+++ b/zookeeper-client/zookeeper-client-c/README
@@ -34,70 +34,8 @@ Sync and Async API.
INSTALLATION
-If you're building the client from a source checkout you need to
-follow the steps outlined below. If you're building from a release
-tar downloaded from Apache please skip to step 2.
-
-1) do a "ant compile_jute" from the zookeeper top level directory (.../trunk).
- This will create a directory named "generated" under
zookeeper-client/zookeeper-client-c.
- Skip to step 3.
-2) unzip/untar the source tarball and cd to the
zookeeper-x.x.x/zookeeper-client/zookeeper-client-c directory
-3) change directory to zookeeper-client/zookeeper-client-c and do a
"autoreconf -if" to bootstrap
- autoconf, automake and libtool. Please make sure you have autoconf
- version 2.59 or greater installed. If cppunit is installed in a non-standard
- directory, you need to specify where to find cppunit.m4. For example, if
- cppunit is installed under /usr/local, run:
-
- ACLOCAL="aclocal -I /usr/local/share/aclocal" autoreconf -if
-
-4) do a "./configure [OPTIONS]" to generate the makefile. See INSTALL
- for general information about running configure. Additionally, the
- configure supports the following options:
- --enable-debug enables optimization and enables debug info compiler
- options, disabled by default
- --without-syncapi disables Sync API support; zookeeper_mt library won't
- be built, enabled by default
- --disable-static do not build static libraries, enabled by default
- --disable-shared do not build shared libraries, enabled by default
- --without-cppunit do not build the test library, enabled by default.
-
-5) do a "make" or "make install" to build the libraries and install them.
- Alternatively, you can also build and run a unit test suite (and
- you probably should). Please make sure you have cppunit-1.10.x or
- higher installed before you execute step 4. Once ./configure has
- finished, do a "make check". It will build the libraries, build
- the tests and run them.
-6) to generate doxygen documentation do a "make doxygen-doc". All
- documentations will be placed to a new subfolder named docs. By
- default only HTML documentation is generated. For information on
- other document formats please use "./configure --help"
-
-Alternatively you can use the CMake build system. On Windows, this is required.
-Follow steps 1 and 2 above, and then continue here.
-
-1) do a "cmake [OPTIONS]" to generate the makefile or msbuild files (the
correct
- build system will be generated based on your platform). Some options from
above
- are supported:
- -DCMAKE_BUILD_TYPE Debug by default, Release enables optimzation etc.
- -DWANT_SYNCAPI ON by default, OFF disables the Sync API support
- -DWANT_CPPUNIT ON except on Windows, OFF disables the tests
- -DWITH_OPENSSL ON by default, OFF disables the SSL support. You can
also
- specify a custom path by
-DWITH_OPENSSL=/path/to/openssl/
- -DWITH_CYRUS_SASL ON by default, OFF disables SASL support. You can also
- specify a custom path by
-DWITH_CYRUS_SASL=/path/to/cyrus-sasl/
- -DBUILD_SHARED_LIBS not yet supported, only static libraries are built
- other CMake options see "cmake --help" for generic options, such as
generator
-
-2) do a "cmake --build ." to build the default targets. Alternatively you can
- invoke "make" or "msbuild" manually. If the tests were enabled, use "ctest
-V"
- to run them.
-
-Current limitations of the CMake build system include lack of Solaris support,
-no shared library option, no explicitly exported symbols (all are exported by
-default), no versions on the libraries, and no documentation generation.
-Features of CMake include a single, easily consumed cross-platform build system
-to generate the ZooKeeper C Client libraries for any project, with little to no
-configuration.
+Please refer to the "Installation" item under "C Binding" section in file
+".../trunk/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md"
EXAMPLE/SAMPLE C CLIENT SHELL