Author: dsahlberg Date: Sun Jan 4 20:53:43 2026 New Revision: 1931109 Log: Replace version 1.4 with 1.5 in all @since docstrings.
1.4 was never released so this should make it less confusing for everyone * serf.h, serf_bucket_types.h, serf_bucket_utils.h: As above See SERF-210 Suggested by: brane [1] https://lists.apache.org/thread/s7mznhp5hsr2x3t2p9copqczcz5g7gdg Modified: serf/trunk/serf.h serf/trunk/serf_bucket_types.h serf/trunk/serf_bucket_util.h Modified: serf/trunk/serf.h ============================================================================== --- serf/trunk/serf.h Sun Jan 4 18:36:06 2026 (r1931108) +++ serf/trunk/serf.h Sun Jan 4 20:53:43 2026 (r1931109) @@ -505,7 +505,7 @@ typedef void (*serf_connection_closed_t) /** * Like serf_connection_closed_t, but applies to incoming connections. * - * @since New in 1.4. + * @since New in 1.5. */ typedef apr_status_t (*serf_incoming_closed_t)( serf_incoming_t *incoming, @@ -648,7 +648,7 @@ apr_status_t serf_connection_create2( * * All temporary allocations should be made in @a pool. * - * @since New in 1.4. + * @since New in 1.5. */ /* FIXME: EXPERIMENTAL */ typedef void (*serf_address_resolved_t)( @@ -677,7 +677,7 @@ typedef void (*serf_address_resolved_t)( * * All temporary allocations should be made in @a pool. * - * @since New in 1.4. + * @since New in 1.5. */ /* FIXME: EXPERIMENTAL */ apr_status_t serf_address_resolve_async( @@ -702,7 +702,7 @@ apr_status_t serf_address_resolve_async( * * All temporary allocations should be made in @a pool. * - * @since New in 1.4. + * @since New in 1.5. */ /* FIXME: EXPERIMENTAL */ typedef void (*serf_connection_created_t)( @@ -726,7 +726,7 @@ typedef void (*serf_connection_created_t * of @a ctx and @a host_info, the connection may be created and this callback * be invoked synchronously during the scope of this function call. * - * @since New in 1.4. + * @since New in 1.5. */ /* FIXME: EXPERIMENTAL */ apr_status_t serf_connection_create_async( @@ -818,7 +818,7 @@ apr_status_t serf_incoming_create( * Once the connection is fully setup incoming requests will be routed to @a * req_setup with @a req_setup_baton, to handle processing. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_incoming_create2( serf_incoming_t **client, @@ -837,7 +837,7 @@ apr_status_t serf_incoming_create2( * read. Will call the response create function if it hasn't * been called yet. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_incoming_response_create( serf_incoming_request_t *request); @@ -889,14 +889,14 @@ typedef enum serf_connection_framing_typ * requests should be written to the connection until the framing type is * set. Connections default to HTTP1 framing. * -* @since New in 1.4. +* @since New in 1.5. */ void serf_connection_set_framing_type( serf_connection_t *conn, serf_connection_framing_type_t framing_type); /** - * @since New in 1.4. + * @since New in 1.5. */ void serf_incoming_set_framing_type( serf_incoming_t *client, @@ -969,7 +969,7 @@ serf_request_t *serf_connection_priority /** * The default request priority * - * @since New in 1.4. + * @since New in 1.5. */ #define SERF_REQUEST_PRIORITY_DEFAULT 0x1000 @@ -997,7 +997,7 @@ serf_request_t *serf_connection_priority * request the only dependency of @a request. When FALSE, request will just * be added as a dependency. * - * @since New in 1.4. + * @since New in 1.5. */ void serf_connection_request_prioritize(serf_request_t *request, serf_request_t *depends_on, @@ -1013,7 +1013,7 @@ apr_interval_time_t serf_connection_get_ /** * Returns the number of requests waiting to be sent over connection CONN. * - * @since New in 1.4. + * @since New in 1.5. */ unsigned int serf_connection_queued_requests(serf_connection_t *conn); @@ -1023,7 +1023,7 @@ unsigned int serf_connection_queued_requ * - that are queued but not sent. * - that have been sent but no response has been completely received yet. * - * @since New in 1.4. + * @since New in 1.5. */ unsigned int serf_connection_pending_requests(serf_connection_t *conn); @@ -1211,7 +1211,7 @@ serf_bucket_t *serf_request_bucket_reque * * Use @a scratch_pool for temporary allocations. * - * @since New in 1.4. + * @since New in 1.5. */ typedef apr_status_t (*serf_authn_init_conn_func_t)(void **authn_baton, @@ -1245,7 +1245,7 @@ typedef apr_status_t * * Use @a scratch_pool for temporary allocations. * - * @since New in 1.4. + * @since New in 1.5. */ typedef apr_status_t (*serf_authn_get_realm_func_t)(const char **realm_name, @@ -1287,7 +1287,7 @@ typedef apr_status_t * * Use @a scratch_pool for temporary allocations. * - * @since New in 1.4. + * @since New in 1.5. */ typedef apr_status_t (*serf_authn_handle_func_t)(int *reset_pipelining, @@ -1319,7 +1319,7 @@ typedef apr_status_t * * Use @a scratch_pool for temporary allocations. * - * @since New in 1.4. + * @since New in 1.5. */ typedef apr_status_t (*serf_authn_setup_request_func_t)(int *reset_pipelining, @@ -1350,7 +1350,7 @@ typedef apr_status_t * * Use @a scratch_pool for temporary allocations. * - * @since New in 1.4. + * @since New in 1.5. */ typedef apr_status_t (*serf_authn_validate_response_func_t)(int *reset_pipelining, @@ -1392,7 +1392,7 @@ typedef apr_status_t * the pools used in calls to the serf_contex_create() family of functions. * * @see https://www.rfc-editor.org/rfc/rfc9110#section-11.1 - * @since New in 1.4 + * @since New in 1.5 */ apr_status_t serf_authn_register_scheme( int *type, @@ -1422,7 +1422,7 @@ apr_status_t serf_authn_register_scheme( * other mechanism to ensure that the scheme remains accessible while it's * in use. So in short: *do not* use this function at all. * - * @since New in 1.4 + * @since New in 1.5 */ apr_status_t serf_authn_unregister_scheme(serf_context_t *ctx, int type, @@ -1470,7 +1470,7 @@ apr_status_t serf_authn_unregister_schem * Used to indicate that length of remaining data in bucket is unknown. See * serf_bucket_type_t->get_remaining(). * - * @since New in 1.4. + * @since New in 1.5. */ #define SERF_LENGTH_UNKNOWN ((apr_uint64_t) -1) @@ -1616,7 +1616,7 @@ struct serf_bucket_type_t { /* Real pointer to read_bucket() method when read_bucket is * serf_buckets_are_v2(). * - * @since New in 1.4 / Buckets v2. + * @since New in 1.5 / Buckets v2. */ serf_bucket_t * (*read_bucket_v2)(serf_bucket_t *bucket, const serf_bucket_type_t *type); @@ -1624,14 +1624,14 @@ struct serf_bucket_type_t { /* Returns length of remaining data to be read in @a bucket. Returns * SERF_LENGTH_UNKNOWN if length is unknown. * - * @since New in 1.4 / Buckets v2. + * @since New in 1.5 / Buckets v2. */ apr_uint64_t (*get_remaining)(serf_bucket_t *bucket); /* Provides a reference to a config object containing all configuration * values relevant for this bucket. * - * @since New in 1.4 / Buckets v2 + * @since New in 1.5 / Buckets v2 */ apr_status_t (*set_config)(serf_bucket_t *bucket, serf_config_t *config); @@ -1664,7 +1664,7 @@ struct serf_bucket_type_t { /* Predefined value for read_bucket vtable member to declare v2 buckets * vtable. * - * @since New in 1.4. + * @since New in 1.5. */ serf_bucket_t * serf_buckets_are_v2(serf_bucket_t *bucket, const serf_bucket_type_t *type); @@ -1672,7 +1672,7 @@ serf_bucket_t * serf_buckets_are_v2(serf /** Gets the serf bucket type of the bucket if the bucket implements at least * buckets version, or if not a bucket type providing a default implementation * - * @since New in 1.4. + * @since New in 1.5. */ const serf_bucket_type_t *serf_get_type(serf_bucket_t *bucket, int min_version); @@ -1870,7 +1870,7 @@ typedef enum serf_config_categories_t { /** * Set a value of type const char * for configuration item CATEGORY+KEY. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_config_set_string(serf_config_t *config, serf_config_key_t key, @@ -1879,7 +1879,7 @@ apr_status_t serf_config_set_string(serf * Copy a value of type const char * and set it for configuration item * CATEGORY+KEY. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_config_set_stringc(serf_config_t *config, serf_config_key_t key, @@ -1889,7 +1889,7 @@ apr_status_t serf_config_set_stringc(ser * Set a value of generic type for configuration item CATEGORY+KEY. * See @a serf_set_config_string for COPY_FLAGS description. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_config_set_stringf(serf_config_t *config, serf_config_key_t key, @@ -1900,7 +1900,7 @@ apr_status_t serf_config_set_stringf(ser * Set a value of generic type for configuration item CATEGORY+KEY. * See @a serf_set_config_string for COPY_FLAGS description. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_config_set_object(serf_config_t *config, serf_config_key_t key, @@ -1912,7 +1912,7 @@ apr_status_t serf_config_set_object(serf * Returns APR_EINVAL when getting a key from a category that this config * object doesn't contain, APR_SUCCESS otherwise. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_config_get_string(serf_config_t *config, serf_config_key_t key, @@ -1926,7 +1926,7 @@ apr_status_t serf_config_get_object(serf * Remove the value for configuration item CATEGORY+KEY from the configuration * store. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_config_remove_value(serf_config_t *config, serf_config_key_t key); @@ -1974,7 +1974,7 @@ typedef struct serf_log_layout_t serf_lo * The lifetime of POOL should be at least the same as that of CTX, but it can * be used by multiple contexts. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_logging_create_stream_output(serf_log_output_t **output, serf_context_t *ctx, @@ -1989,7 +1989,7 @@ apr_status_t serf_logging_create_stream_ * OUTPUT is the object returned by one of the serf_logging_create_XXX_output * factory functions. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_logging_add_output(serf_context_t *ctx, const serf_log_output_t *output); Modified: serf/trunk/serf_bucket_types.h ============================================================================== --- serf/trunk/serf_bucket_types.h Sun Jan 4 18:36:06 2026 (r1931108) +++ serf/trunk/serf_bucket_types.h Sun Jan 4 20:53:43 2026 (r1931109) @@ -120,7 +120,7 @@ serf_bucket_t *serf_bucket_response_crea #define SERF_HTTP_VERSION(major, minor) ((major) * 1000 + (minor)) #define SERF_HTTP_11 SERF_HTTP_VERSION(1, 1) #define SERF_HTTP_10 SERF_HTTP_VERSION(1, 0) -/** @since New in 1.4. */ +/** @since New in 1.5. */ #define SERF_HTTP_20 SERF_HTTP_VERSION(2, 0) #define SERF_HTTP_VERSION_MAJOR(shv) ((int)shv / 1000) #define SERF_HTTP_VERSION_MINOR(shv) ((int)shv % 1000) @@ -163,7 +163,7 @@ apr_status_t serf_bucket_response_wait_f * If @a wait_for_next is TRUE, the function will wait for the next set * of informational header instead of returning success for the first set. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_bucket_response_wait_for_some_headers( serf_bucket_t *response, @@ -203,13 +203,13 @@ serf_bucket_t *serf_bucket_response_body serf_bucket_alloc_t *allocator); /* ==================================================================== */ -/** @since New in 1.4 */ +/** @since New in 1.5 */ extern const serf_bucket_type_t serf_bucket_type_outgoing_response; -/** @since New in 1.4 */ +/** @since New in 1.5 */ #define SERF_BUCKET_IS_OUTGOING_RESPONSE(b) \ SERF_BUCKET_CHECK((b), outgoing_response) -/** @since New in 1.4 */ +/** @since New in 1.5 */ serf_bucket_t *serf_bucket_outgoing_response_create( serf_bucket_t *body, int status, @@ -217,11 +217,11 @@ serf_bucket_t *serf_bucket_outgoing_resp int http_version, serf_bucket_alloc_t *allocator); -/** @since New in 1.4 */ +/** @since New in 1.5 */ serf_bucket_t *serf_bucket_outgoing_response_get_headers( serf_bucket_t *outgoing_response); -/** @since New in 1.4 */ +/** @since New in 1.5 */ void serf_bucket_outgoing_response_prepare( serf_bucket_t *outgoing_response, int http_version, @@ -712,7 +712,7 @@ typedef apr_status_t (*serf_ssl_protocol * If successful CALLBACK will be called as soon as the protocol is negotiated * or directly after the secured stream is connected. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_ssl_negotiate_protocol( serf_ssl_context_t *context, @@ -765,7 +765,7 @@ const char *serf_ssl_cert_export( * Uses @a scratch_pool for temporary allocations. * Returns NULL on failure. * - * @since New in 1.4. + * @since New in 1.5. */ const char *serf_ssl_cert_export2( const serf_ssl_certificate_t *cert, @@ -778,7 +778,7 @@ const char *serf_ssl_cert_export2( * Uses @a scratch_pool for temporary allocations. * Returns NULL on failure. * - * @since New in 1.4. + * @since New in 1.5. */ serf_ssl_certificate_t *serf_ssl_cert_import( const char *encoded_cert, @@ -807,7 +807,7 @@ apr_status_t serf_ssl_trust_cert( /** * Load a CRL .pem file from @a file_path and enable CRL checking. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_ssl_add_crl_from_file(serf_ssl_context_t *ssl_ctx, const char *file_path, @@ -818,7 +818,7 @@ apr_status_t serf_ssl_add_crl_from_file( * @a enabled = 1 to enable CRL checking, 0 to disable CRL checking. * Default = disabled. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_ssl_check_crl(serf_ssl_context_t *ssl_ctx, int enabled); @@ -829,7 +829,7 @@ apr_status_t serf_ssl_check_crl(serf_ssl * @a enabled = 1 to enable checking, 0 to disable checking. * Default = disabled. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_ssl_check_cert_status_request(serf_ssl_context_t *ssl_ctx, int enabled); @@ -848,7 +848,7 @@ apr_status_t serf_ssl_use_compression( /** * Internal representation of an OCSP request. * - * @since New in 1.4. + * @since New in 1.5. */ typedef struct serf_ssl_ocsp_request_t serf_ssl_ocsp_request_t; @@ -864,7 +864,7 @@ typedef struct serf_ssl_ocsp_request_t s * Returns @c NULL on failure, e.g., if @a issuer_cert is not the * issuer certificate of @a server_cert. * - * @since New in 1.4. + * @since New in 1.5. */ serf_ssl_ocsp_request_t *serf_ssl_ocsp_request_create( const serf_ssl_certificate_t *server_cert, @@ -883,7 +883,7 @@ serf_ssl_ocsp_request_t *serf_ssl_ocsp_r * * @see serf_ssl_ocsp_request_body_size() * - * @since New in 1.4. + * @since New in 1.5. */ const void *serf_ssl_ocsp_request_body( const serf_ssl_ocsp_request_t *ocsp_request); @@ -892,7 +892,7 @@ const void *serf_ssl_ocsp_request_body( * Returns the size of the DER-encoded OCSP request body. * @see serf_ssl_ocsp_request_body(). * - * @since New in 1.4. + * @since New in 1.5. */ apr_size_t serf_ssl_ocsp_request_body_size( const serf_ssl_ocsp_request_t *ocsp_request); @@ -905,7 +905,7 @@ apr_size_t serf_ssl_ocsp_request_body_si * * Returns @c NULL on failure. * - * @since New in 1.4. + * @since New in 1.5. */ const char *serf_ssl_ocsp_request_export( const serf_ssl_ocsp_request_t *ocsp_request, @@ -921,7 +921,7 @@ const char *serf_ssl_ocsp_request_export * * Returns @c NULL on failure. * - * @since New in 1.4. + * @since New in 1.5. */ serf_ssl_ocsp_request_t *serf_ssl_ocsp_request_import( const char *encoded_ocsp_request, @@ -931,7 +931,7 @@ serf_ssl_ocsp_request_t *serf_ssl_ocsp_r /** * Internal representation of an OCSP response. * - * @since New in 1.4. + * @since New in 1.5. */ typedef struct serf_ssl_ocsp_response_t serf_ssl_ocsp_response_t; @@ -947,7 +947,7 @@ typedef struct serf_ssl_ocsp_response_t * * Returns @c NULL on failure. * - * @since New in 1.4. + * @since New in 1.5. */ serf_ssl_ocsp_response_t *serf_ssl_ocsp_response_parse( const void *ocsp_response, @@ -984,7 +984,7 @@ serf_ssl_ocsp_response_t *serf_ssl_ocsp_ * * Uses @a scratch_pool for temporary allocations. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_ssl_ocsp_response_verify( serf_ssl_context_t *ssl_ctx, @@ -1153,7 +1153,7 @@ serf_bucket_t *serf_bucket_prefix_create * HEAD and TAIL are allocated in STREAM->allocator. STREAM will be * destroyed when no longer referenced or after EOF. * - * @since New in 1.4. + * @since New in 1.5. */ void serf_bucket_split_create(serf_bucket_t **head, serf_bucket_t **tail, @@ -1168,17 +1168,17 @@ void serf_bucket_split_create(serf_bucke * is not supported, the behavior of all related bucket functions such * as @a serf_bucket_brotli_decompress_create is undefined. * - * @since New in 1.4. + * @since New in 1.5. */ int serf_bucket_is_brotli_supported(void); -/** @since New in 1.4. */ +/** @since New in 1.5. */ extern const serf_bucket_type_t serf_bucket_type_brotli_decompress; -/** @since New in 1.4. */ +/** @since New in 1.5. */ #define SERF_BUCKET_IS_BROTLI_DECOMPRESS(b) \ SERF_BUCKET_CHECK((b), brotli_decompress) -/** @since New in 1.4. */ +/** @since New in 1.5. */ serf_bucket_t * serf_bucket_brotli_decompress_create(serf_bucket_t *stream, serf_bucket_alloc_t *alloc); Modified: serf/trunk/serf_bucket_util.h ============================================================================== --- serf/trunk/serf_bucket_util.h Sun Jan 4 18:36:06 2026 (r1931108) +++ serf/trunk/serf_bucket_util.h Sun Jan 4 20:53:43 2026 (r1931109) @@ -66,7 +66,7 @@ apr_status_t serf_default_read_iovec( * This function will use the @see read function, when possible optimized by * the @a peek function to return the requested result. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_default_readline(serf_bucket_t *bucket, int acceptable, int *found, @@ -102,7 +102,7 @@ serf_bucket_t *serf_default_read_bucket( * * This function will always state that there is no data available. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_default_peek( serf_bucket_t *bucket, @@ -133,7 +133,7 @@ void serf_default_destroy_and_data( * This function will use the @see read function, when possible optimized by * the @a peek function to return the requested result. * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_bucket_limited_readline(serf_bucket_t *bucket, int acceptable, apr_size_t requested, int *found, @@ -144,7 +144,7 @@ apr_status_t serf_bucket_limited_readlin * * This function will just return SERF_LENGTH_UNKNOWN. * - * @since New in 1.4. + * @since New in 1.5. */ apr_uint64_t serf_default_get_remaining( serf_bucket_t *bucket); @@ -155,7 +155,7 @@ apr_uint64_t serf_default_get_remaining( * This function will not do anything, it should be used in buckets * that have no use for the shared config, and do not wrap other bucket(s). * - * @since New in 1.4. + * @since New in 1.5. */ apr_status_t serf_default_ignore_config(serf_bucket_t *bucket, serf_config_t *config);
