Skip to content

Commit 7b1ac48

Browse files
committed
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 git-svn-id: https://svn.apache.org/repos/asf/serf/trunk@1931109 13f79535-47bb-0310-9956-ffa450edef68
1 parent 07b0312 commit 7b1ac48

3 files changed

Lines changed: 66 additions & 66 deletions

File tree

serf.h

Lines changed: 34 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -505,7 +505,7 @@ typedef void (*serf_connection_closed_t)(
505505
/**
506506
* Like serf_connection_closed_t, but applies to incoming connections.
507507
*
508-
* @since New in 1.4.
508+
* @since New in 1.5.
509509
*/
510510
typedef apr_status_t (*serf_incoming_closed_t)(
511511
serf_incoming_t *incoming,
@@ -648,7 +648,7 @@ apr_status_t serf_connection_create2(
648648
*
649649
* All temporary allocations should be made in @a pool.
650650
*
651-
* @since New in 1.4.
651+
* @since New in 1.5.
652652
*/
653653
/* FIXME: EXPERIMENTAL */
654654
typedef void (*serf_address_resolved_t)(
@@ -677,7 +677,7 @@ typedef void (*serf_address_resolved_t)(
677677
*
678678
* All temporary allocations should be made in @a pool.
679679
*
680-
* @since New in 1.4.
680+
* @since New in 1.5.
681681
*/
682682
/* FIXME: EXPERIMENTAL */
683683
apr_status_t serf_address_resolve_async(
@@ -702,7 +702,7 @@ apr_status_t serf_address_resolve_async(
702702
*
703703
* All temporary allocations should be made in @a pool.
704704
*
705-
* @since New in 1.4.
705+
* @since New in 1.5.
706706
*/
707707
/* FIXME: EXPERIMENTAL */
708708
typedef void (*serf_connection_created_t)(
@@ -726,7 +726,7 @@ typedef void (*serf_connection_created_t)(
726726
* of @a ctx and @a host_info, the connection may be created and this callback
727727
* be invoked synchronously during the scope of this function call.
728728
*
729-
* @since New in 1.4.
729+
* @since New in 1.5.
730730
*/
731731
/* FIXME: EXPERIMENTAL */
732732
apr_status_t serf_connection_create_async(
@@ -818,7 +818,7 @@ apr_status_t serf_incoming_create(
818818
* Once the connection is fully setup incoming requests will be routed to @a
819819
* req_setup with @a req_setup_baton, to handle processing.
820820
*
821-
* @since New in 1.4.
821+
* @since New in 1.5.
822822
*/
823823
apr_status_t serf_incoming_create2(
824824
serf_incoming_t **client,
@@ -837,7 +837,7 @@ apr_status_t serf_incoming_create2(
837837
* read. Will call the response create function if it hasn't
838838
* been called yet.
839839
*
840-
* @since New in 1.4.
840+
* @since New in 1.5.
841841
*/
842842
apr_status_t serf_incoming_response_create(
843843
serf_incoming_request_t *request);
@@ -889,14 +889,14 @@ typedef enum serf_connection_framing_type_t {
889889
* requests should be written to the connection until the framing type is
890890
* set. Connections default to HTTP1 framing.
891891
*
892-
* @since New in 1.4.
892+
* @since New in 1.5.
893893
*/
894894
void serf_connection_set_framing_type(
895895
serf_connection_t *conn,
896896
serf_connection_framing_type_t framing_type);
897897

898898
/**
899-
* @since New in 1.4.
899+
* @since New in 1.5.
900900
*/
901901
void serf_incoming_set_framing_type(
902902
serf_incoming_t *client,
@@ -969,7 +969,7 @@ serf_request_t *serf_connection_priority_request_create(
969969
/**
970970
* The default request priority
971971
*
972-
* @since New in 1.4.
972+
* @since New in 1.5.
973973
*/
974974
#define SERF_REQUEST_PRIORITY_DEFAULT 0x1000
975975

@@ -997,7 +997,7 @@ serf_request_t *serf_connection_priority_request_create(
997997
* request the only dependency of @a request. When FALSE, request will just
998998
* be added as a dependency.
999999
*
1000-
* @since New in 1.4.
1000+
* @since New in 1.5.
10011001
*/
10021002
void serf_connection_request_prioritize(serf_request_t *request,
10031003
serf_request_t *depends_on,
@@ -1013,7 +1013,7 @@ apr_interval_time_t serf_connection_get_latency(serf_connection_t *conn);
10131013
/**
10141014
* Returns the number of requests waiting to be sent over connection CONN.
10151015
*
1016-
* @since New in 1.4.
1016+
* @since New in 1.5.
10171017
*/
10181018
unsigned int serf_connection_queued_requests(serf_connection_t *conn);
10191019

@@ -1023,7 +1023,7 @@ unsigned int serf_connection_queued_requests(serf_connection_t *conn);
10231023
* - that are queued but not sent.
10241024
* - that have been sent but no response has been completely received yet.
10251025
*
1026-
* @since New in 1.4.
1026+
* @since New in 1.5.
10271027
*/
10281028
unsigned int serf_connection_pending_requests(serf_connection_t *conn);
10291029

@@ -1211,7 +1211,7 @@ serf_bucket_t *serf_request_bucket_request_create(
12111211
*
12121212
* Use @a scratch_pool for temporary allocations.
12131213
*
1214-
* @since New in 1.4.
1214+
* @since New in 1.5.
12151215
*/
12161216
typedef apr_status_t
12171217
(*serf_authn_init_conn_func_t)(void **authn_baton,
@@ -1245,7 +1245,7 @@ typedef apr_status_t
12451245
*
12461246
* Use @a scratch_pool for temporary allocations.
12471247
*
1248-
* @since New in 1.4.
1248+
* @since New in 1.5.
12491249
*/
12501250
typedef apr_status_t
12511251
(*serf_authn_get_realm_func_t)(const char **realm_name,
@@ -1287,7 +1287,7 @@ typedef apr_status_t
12871287
*
12881288
* Use @a scratch_pool for temporary allocations.
12891289
*
1290-
* @since New in 1.4.
1290+
* @since New in 1.5.
12911291
*/
12921292
typedef apr_status_t
12931293
(*serf_authn_handle_func_t)(int *reset_pipelining,
@@ -1319,7 +1319,7 @@ typedef apr_status_t
13191319
*
13201320
* Use @a scratch_pool for temporary allocations.
13211321
*
1322-
* @since New in 1.4.
1322+
* @since New in 1.5.
13231323
*/
13241324
typedef apr_status_t
13251325
(*serf_authn_setup_request_func_t)(int *reset_pipelining,
@@ -1350,7 +1350,7 @@ typedef apr_status_t
13501350
*
13511351
* Use @a scratch_pool for temporary allocations.
13521352
*
1353-
* @since New in 1.4.
1353+
* @since New in 1.5.
13541354
*/
13551355
typedef apr_status_t
13561356
(*serf_authn_validate_response_func_t)(int *reset_pipelining,
@@ -1392,7 +1392,7 @@ typedef apr_status_t
13921392
* the pools used in calls to the serf_contex_create() family of functions.
13931393
*
13941394
* @see https://www.rfc-editor.org/rfc/rfc9110#section-11.1
1395-
* @since New in 1.4
1395+
* @since New in 1.5
13961396
*/
13971397
apr_status_t serf_authn_register_scheme(
13981398
int *type,
@@ -1422,7 +1422,7 @@ apr_status_t serf_authn_register_scheme(
14221422
* other mechanism to ensure that the scheme remains accessible while it's
14231423
* in use. So in short: *do not* use this function at all.
14241424
*
1425-
* @since New in 1.4
1425+
* @since New in 1.5
14261426
*/
14271427
apr_status_t serf_authn_unregister_scheme(serf_context_t *ctx,
14281428
int type,
@@ -1470,7 +1470,7 @@ apr_status_t serf_authn_unregister_scheme(serf_context_t *ctx,
14701470
* Used to indicate that length of remaining data in bucket is unknown. See
14711471
* serf_bucket_type_t->get_remaining().
14721472
*
1473-
* @since New in 1.4.
1473+
* @since New in 1.5.
14741474
*/
14751475
#define SERF_LENGTH_UNKNOWN ((apr_uint64_t) -1)
14761476

@@ -1616,22 +1616,22 @@ struct serf_bucket_type_t {
16161616
/* Real pointer to read_bucket() method when read_bucket is
16171617
* serf_buckets_are_v2().
16181618
*
1619-
* @since New in 1.4 / Buckets v2.
1619+
* @since New in 1.5 / Buckets v2.
16201620
*/
16211621
serf_bucket_t * (*read_bucket_v2)(serf_bucket_t *bucket,
16221622
const serf_bucket_type_t *type);
16231623

16241624
/* Returns length of remaining data to be read in @a bucket. Returns
16251625
* SERF_LENGTH_UNKNOWN if length is unknown.
16261626
*
1627-
* @since New in 1.4 / Buckets v2.
1627+
* @since New in 1.5 / Buckets v2.
16281628
*/
16291629
apr_uint64_t (*get_remaining)(serf_bucket_t *bucket);
16301630

16311631
/* Provides a reference to a config object containing all configuration
16321632
* values relevant for this bucket.
16331633
*
1634-
* @since New in 1.4 / Buckets v2
1634+
* @since New in 1.5 / Buckets v2
16351635
*/
16361636
apr_status_t (*set_config)(serf_bucket_t *bucket, serf_config_t *config);
16371637

@@ -1664,15 +1664,15 @@ struct serf_bucket_type_t {
16641664
/* Predefined value for read_bucket vtable member to declare v2 buckets
16651665
* vtable.
16661666
*
1667-
* @since New in 1.4.
1667+
* @since New in 1.5.
16681668
*/
16691669
serf_bucket_t * serf_buckets_are_v2(serf_bucket_t *bucket,
16701670
const serf_bucket_type_t *type);
16711671

16721672
/** Gets the serf bucket type of the bucket if the bucket implements at least
16731673
* buckets version, or if not a bucket type providing a default implementation
16741674
*
1675-
* @since New in 1.4.
1675+
* @since New in 1.5.
16761676
*/
16771677
const serf_bucket_type_t *serf_get_type(serf_bucket_t *bucket,
16781678
int min_version);
@@ -1870,7 +1870,7 @@ typedef enum serf_config_categories_t {
18701870
/**
18711871
* Set a value of type const char * for configuration item CATEGORY+KEY.
18721872
*
1873-
* @since New in 1.4.
1873+
* @since New in 1.5.
18741874
*/
18751875
apr_status_t serf_config_set_string(serf_config_t *config,
18761876
serf_config_key_t key,
@@ -1879,7 +1879,7 @@ apr_status_t serf_config_set_string(serf_config_t *config,
18791879
* Copy a value of type const char * and set it for configuration item
18801880
* CATEGORY+KEY.
18811881
*
1882-
* @since New in 1.4.
1882+
* @since New in 1.5.
18831883
*/
18841884
apr_status_t serf_config_set_stringc(serf_config_t *config,
18851885
serf_config_key_t key,
@@ -1889,7 +1889,7 @@ apr_status_t serf_config_set_stringc(serf_config_t *config,
18891889
* Set a value of generic type for configuration item CATEGORY+KEY.
18901890
* See @a serf_set_config_string for COPY_FLAGS description.
18911891
*
1892-
* @since New in 1.4.
1892+
* @since New in 1.5.
18931893
*/
18941894
apr_status_t serf_config_set_stringf(serf_config_t *config,
18951895
serf_config_key_t key,
@@ -1900,7 +1900,7 @@ apr_status_t serf_config_set_stringf(serf_config_t *config,
19001900
* Set a value of generic type for configuration item CATEGORY+KEY.
19011901
* See @a serf_set_config_string for COPY_FLAGS description.
19021902
*
1903-
* @since New in 1.4.
1903+
* @since New in 1.5.
19041904
*/
19051905
apr_status_t serf_config_set_object(serf_config_t *config,
19061906
serf_config_key_t key,
@@ -1912,7 +1912,7 @@ apr_status_t serf_config_set_object(serf_config_t *config,
19121912
* Returns APR_EINVAL when getting a key from a category that this config
19131913
* object doesn't contain, APR_SUCCESS otherwise.
19141914
*
1915-
* @since New in 1.4.
1915+
* @since New in 1.5.
19161916
*/
19171917
apr_status_t serf_config_get_string(serf_config_t *config,
19181918
serf_config_key_t key,
@@ -1926,7 +1926,7 @@ apr_status_t serf_config_get_object(serf_config_t *config,
19261926
* Remove the value for configuration item CATEGORY+KEY from the configuration
19271927
* store.
19281928
*
1929-
* @since New in 1.4.
1929+
* @since New in 1.5.
19301930
*/
19311931
apr_status_t serf_config_remove_value(serf_config_t *config,
19321932
serf_config_key_t key);
@@ -1974,7 +1974,7 @@ typedef struct serf_log_layout_t serf_log_layout_t;
19741974
* The lifetime of POOL should be at least the same as that of CTX, but it can
19751975
* be used by multiple contexts.
19761976
*
1977-
* @since New in 1.4.
1977+
* @since New in 1.5.
19781978
*/
19791979
apr_status_t serf_logging_create_stream_output(serf_log_output_t **output,
19801980
serf_context_t *ctx,
@@ -1989,7 +1989,7 @@ apr_status_t serf_logging_create_stream_output(serf_log_output_t **output,
19891989
* OUTPUT is the object returned by one of the serf_logging_create_XXX_output
19901990
* factory functions.
19911991
*
1992-
* @since New in 1.4.
1992+
* @since New in 1.5.
19931993
*/
19941994
apr_status_t serf_logging_add_output(serf_context_t *ctx,
19951995
const serf_log_output_t *output);

0 commit comments

Comments
 (0)