Update packaging metadata for 2.4.0-beta

- Note that the debian changelog has its '*' bullets removed. This is
  intentional as Debian inserts its own bullets (per dpkg-parsechanges).
- References to the cbcrc(4) manpage has been restored.

Change-Id: I77cbbaa601cb8755c4657692535e9c111810cf80
Reviewed-on: http://review.couchbase.org/39336
Reviewed-by: Matt Ingenthron <matt@couchbase.com>
Tested-by: Mark Nunberg <mnunberg@haskalah.org>

Doxyfile

@@ -32,7 +32,7 @@ PROJECT_NAME           = "Couchbase C Client"
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
-PROJECT_NUMBER         = 2.4.0
+PROJECT_NUMBER         = 2.4.0-beta
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer

cmake/Modules/GetVersionInfo.cmake

@@ -39,7 +39,7 @@ IF(NOT LCB_VERSION AND EXISTS ${CMAKE_SOURCE_DIR}/VERSION)
 ENDIF()
 
 IF (NOT LCB_VERSION)
-    SET(LCB_VERSION "2.3.1")
+    SET(LCB_VERSION "2.4.0")
 ENDIF()
 IF (NOT LCB_VERSION_CHANGESET)
     SET(LCB_VERSION_CHANGESET "0xdeadbeef")

configure.ac

@@ -100,7 +100,7 @@ AC_SUBST(API_REVISION)
 AC_SUBST(API_AGE)
 
 # The actual version numbers for the developers ;)
-LCB_VERSION="2.4.0-dp1"
+LCB_VERSION="2.4.0-beta"
 LCB_VERSION_HEX=`echo ${LCB_VERSION} | awk -F. '{printf "0x%0.2d%0.2d%0.2d", $1, $2, $3}'`
 AC_SUBST(LCB_VERSION)
 AC_SUBST(LCB_VERSION_HEX)

packaging/deb/changelog

@@ -1,3 +1,61 @@
+libcouchbase (2.4.0~beta) testing; urgency=low
+
+   [minor] Communication via legacy memcached servers is possible
+   by using the `memcached://` scheme in the connection string.
+
+   [minor] Environment variables understood by the library are now
+   documented in their own section.
+
+   [major] Add `lcb_get_node()` function to retrieve addresses for
+   various nodes in the cluster. This deprecates the `lcb_get_host()`,
+   `lcb_get_port()` and `lcb_get_server_list()` functions as they are
+   constrained to only return information about the administrative API.
+   The new function is configurable to return information about various
+   ports.
+
+   [major] The `dsn` field in the `lcb_create_st` structure has been
+   renamed to `connstr`.
+
+   [major] An HTTP request which has followed redirects will cause the
+   `lcb_wait()` function to never return. This bug was introduced in
+   2.4.0-DP1 and has now been fixed.
+
+   [minor] `lcb_get_server_list()` function now returns updated information
+   from the current cluster configuration. Previously this would only return
+   a node from the list specified during initial creation.
+
+   [minor] Provide additional error classifiers. Two error classifiers have
+   been added, they are:
+     `LCB_ERRTYPE_SRVLOAD` which indicates that the server is likely under high load.
+     `LCB_ERRTYPE_SRVGEN` which indicates that the error is a direct reply from the
+      server. This code can help distinguish between client and server generated
+      return codes.
+
+   [major] Provide HTTP keepalive and connection pooling for HTTP requests.
+   This allows the client to reuse an HTTP connection for multiple requests
+   rather than creating a new connection and closing it for each operation.
+
+   The functionality may be controlled via the `LCB_CNTL_HTTP_POOLSIZE` setting
+   which limits how many open connections (per server) to maintain inside the
+   client. Setting this value to `0` will disable pooling and restore old
+   behavior.
+
+   [major] Properly schedule next invocations for retry queue. A bug was introduced
+   in 2.4.0-dp1 which would cause the next tick callback to be invoked in what is
+   effectively a busy loop. This would be reflected in higher CPU load and less
+   throughput during topology changes.
+
+   [major] Return error if empty key is passed to an operation. Empty keys will
+   cause the server to drop the connection.
+   The error code returned is the newly added `LCB_EMPTY_KEY`
+
+   [minor] Provide setting to disable refreshing the configuration when an HTTP
+   API error is encountered (from one of the HTTP callback functions). This
+   adds the `LCB_CNTL_HTTP_REFRESH_CONFIG_ON_ERROR` setting.
+
+ -- Mark Nunberg <mark.nunberg@couchbase.com>  Fri, 11 Jul 2014 16:50:01 -0700
+
+
 libcouchbase (2.4.0~dp1) unstable; urgency=low
 
     * [minor] Make `run_event_loop` and `stop_event_loop` private.

packaging/deb/libcouchbase2-bin.install

@@ -1,2 +1,3 @@
 usr/bin/cbc*
 usr/share/man/man1/cbc*.1*
+usr/share/man/man4/cbcrc*.4*

packaging/rpm/libcouchbase.spec.in

@@ -90,6 +90,7 @@ Development files for the Couchbase Client & Protocol Library
 %defattr(-, root, root)
 %{_bindir}/cbc*
 %{_mandir}/man1/cbc*.1*
+%{_mandir}/man4/cbcrc*.4*
 
 %files devel
 %defattr(-, root, root)
@@ -99,6 +100,62 @@ Development files for the Couchbase Client & Protocol Library
 
 %changelog
 
+* Fri Jul 11 2014 Mark Nunberg <mark.nunberg@couchbase.com> - 2.4.0-0.beta
+
+- [minor] Communication via legacy memcached servers is possible
+  by using the `memcached://` scheme in the connection string.
+
+- [minor] Environment variables understood by the library are now
+  documented in their own section.
+
+- [major] Add `lcb_get_node()` function to retrieve addresses for
+  various nodes in the cluster. This deprecates the `lcb_get_host()`,
+  `lcb_get_port()` and `lcb_get_server_list()` functions as they are
+  constrained to only return information about the administrative API.
+  The new function is configurable to return information about various
+  ports.
+
+- [major] The `dsn` field in the `lcb_create_st` structure has been
+  renamed to `connstr`.
+
+- [major] An HTTP request which has followed redirects will cause the
+  `lcb_wait()` function to never return. This bug was introduced in
+  2.4.0-DP1 and has now been fixed.
+
+- [minor] `lcb_get_server_list()` function now returns updated information
+  from the current cluster configuration. Previously this would only return
+  a node from the list specified during initial creation.
+
+- [minor] Provide additional error classifiers. Two error classifiers have
+  been added, they are:
+
+  * `LCB_ERRTYPE_SRVLOAD` which indicates that the server is likely under high load.
+  * `LCB_ERRTYPE_SRVGEN` which indicates that the error is a direct reply from the
+    server. This code can help distinguish between client and server generated
+    return codes.
+
+- [major] Provide HTTP keepalive and connection pooling for HTTP requests.
+  This allows the client to reuse an HTTP connection for multiple requests
+  rather than creating a new connection and closing it for each operation.
+
+  The functionality may be controlled via the `LCB_CNTL_HTTP_POOLSIZE` setting
+  which limits how many open connections (per server) to maintain inside the
+  client. Setting this value to `0` will disable pooling and restore old
+  behavior.
+
+- [major] Properly schedule next invocations for retry queue. A bug was introduced
+  in 2.4.0-dp1 which would cause the next tick callback to be invoked in what is
+  effectively a busy loop. This would be reflected in higher CPU load and less
+  throughput during topology changes.
+
+- [major] Return error if empty key is passed to an operation. Empty keys will
+  cause the server to drop the connection.
+  The error code returned is the newly added `LCB_EMPTY_KEY`
+
+- [minor] Provide setting to disable refreshing the configuration when an HTTP
+  API error is encountered (from one of the HTTP callback functions). This
+  adds the `LCB_CNTL_HTTP_REFRESH_CONFIG_ON_ERROR` setting.
+
 * Fri Jun 20 2014 Mark Nunberg <mark.nunberg@couchbase.com> - 2.4.0-0.dp1
 
 - [minor] Make `run_event_loop` and `stop_event_loop` private.