From 9a271795f84eb5402ce1ecfbcfd21392ad1560d0 Mon Sep 17 00:00:00 2001 From: Dimitri Papadopoulos <3234522+DimitriPapadopoulos@users.noreply.github.com> Date: Wed, 10 May 2023 12:10:57 +0200 Subject: Fix typos found by codespell Fix only typos in doc/man* for inclusion in 3.* branches. Other typos have been fixed in a different commit. Reviewed-by: Paul Dale Reviewed-by: Tomas Mraz (Merged from https://github.com/openssl/openssl/pull/20924) --- doc/man3/DTLSv1_get_timeout.pod | 2 +- doc/man3/DTLSv1_handle_timeout.pod | 2 +- doc/man3/EC_GROUP_copy.pod | 2 +- doc/man3/EC_KEY_new.pod | 2 +- doc/man3/EC_POINT_add.pod | 2 +- doc/man3/EC_POINT_new.pod | 26 +++++++++++++------------- doc/man3/OSSL_CRMF_MSG_set0_validity.pod | 2 +- doc/man3/OSSL_PARAM.pod | 6 +++--- doc/man3/OSSL_PARAM_int.pod | 2 +- doc/man3/PKCS7_sign.pod | 2 +- doc/man3/SSL_CTX_set_options.pod | 2 +- doc/man3/X509_STORE_CTX_new.pod | 2 +- doc/man3/X509_get_default_cert_file.pod | 2 +- doc/man7/provider-base.pod | 2 +- 14 files changed, 28 insertions(+), 28 deletions(-) (limited to 'doc') diff --git a/doc/man3/DTLSv1_get_timeout.pod b/doc/man3/DTLSv1_get_timeout.pod index fbaf0f9612..8ef916415c 100644 --- a/doc/man3/DTLSv1_get_timeout.pod +++ b/doc/man3/DTLSv1_get_timeout.pod @@ -32,7 +32,7 @@ Once the timeout expires, DTLSv1_handle_timeout() should be called to handle any internal processing which is due; for more information, see L. -L supercedes all use cases for this this function and +L supersedes all use cases for this this function and may be used instead of it. =head1 RETURN VALUES diff --git a/doc/man3/DTLSv1_handle_timeout.pod b/doc/man3/DTLSv1_handle_timeout.pod index 77c1a89ab4..a188f08924 100644 --- a/doc/man3/DTLSv1_handle_timeout.pod +++ b/doc/man3/DTLSv1_handle_timeout.pod @@ -21,7 +21,7 @@ when to call DTLSv1_handle_timeout(). This function is only applicable to DTLS objects. It returns 0 if called on any other kind of SSL object. -L supercedes all use cases for this this function and may be used +L supersedes all use cases for this this function and may be used instead of it. =head1 RETURN VALUES diff --git a/doc/man3/EC_GROUP_copy.pod b/doc/man3/EC_GROUP_copy.pod index 279fd0d197..25c91d731b 100644 --- a/doc/man3/EC_GROUP_copy.pod +++ b/doc/man3/EC_GROUP_copy.pod @@ -129,7 +129,7 @@ point_conversion_form_t is an enum defined as follows: For POINT_CONVERSION_UNCOMPRESSED the point is encoded as an octet signifying the UNCOMPRESSED form has been used followed by the octets for x, followed by the octets for y. -For any given x co-ordinate for a point on a curve it is possible to derive two possible y values. For +For any given x coordinate for a point on a curve it is possible to derive two possible y values. For POINT_CONVERSION_COMPRESSED the point is encoded as an octet signifying that the COMPRESSED form has been used AND which of the two possible solutions for y has been used, followed by the octets for x. diff --git a/doc/man3/EC_KEY_new.pod b/doc/man3/EC_KEY_new.pod index 98c9adc8ae..3c152d0aad 100644 --- a/doc/man3/EC_KEY_new.pod +++ b/doc/man3/EC_KEY_new.pod @@ -128,7 +128,7 @@ EC_KEY_check_key() performs various sanity checks on the EC_KEY object to confirm that it is valid. EC_KEY_set_public_key_affine_coordinates() sets the public key for I based -on its affine co-ordinates; i.e., it constructs an EC_POINT object based on +on its affine coordinates; i.e., it constructs an EC_POINT object based on the supplied I and I values and sets the public key to be this EC_POINT. It also performs certain sanity checks on the key to confirm that it is valid. diff --git a/doc/man3/EC_POINT_add.pod b/doc/man3/EC_POINT_add.pod index 10036c9596..57f1dd87d0 100644 --- a/doc/man3/EC_POINT_add.pod +++ b/doc/man3/EC_POINT_add.pod @@ -44,7 +44,7 @@ EC_POINT_is_on_curve tests whether the supplied point is on the curve or not. EC_POINT_cmp compares the two supplied points and tests whether or not they are equal. The functions EC_POINT_make_affine and EC_POINTs_make_affine force the internal representation of the EC_POINT(s) into the affine -co-ordinate system. In the case of EC_POINTs_make_affine the value B provides the number of points in the array B to be +coordinate system. In the case of EC_POINTs_make_affine the value B provides the number of points in the array B to be forced. These functions were deprecated in OpenSSL 3.0 and should no longer be used. Modern versions automatically perform this conversion when needed. diff --git a/doc/man3/EC_POINT_new.pod b/doc/man3/EC_POINT_new.pod index e2e2c129eb..fc8643cd60 100644 --- a/doc/man3/EC_POINT_new.pod +++ b/doc/man3/EC_POINT_new.pod @@ -124,9 +124,9 @@ public concept. A valid point on a curve is the special point at infinity. A point is set to be at infinity by calling EC_POINT_set_to_infinity(). -The affine co-ordinates for a point describe a point in terms of its x and y +The affine coordinates for a point describe a point in terms of its x and y position. The function EC_POINT_set_affine_coordinates() sets the B and B -co-ordinates for the point B

defined over the curve given in B. The +coordinates for the point B

defined over the curve given in B. The function EC_POINT_get_affine_coordinates() sets B and B, either of which may be NULL, to the corresponding coordinates of B

. @@ -140,27 +140,27 @@ EC_POINT_get_affine_coordinates_GF2m() are synonyms for EC_POINT_get_affine_coordinates(). They are defined for backwards compatibility only and should not be used. -As well as the affine co-ordinates, a point can alternatively be described in -terms of its Jacobian projective co-ordinates (for Fp curves only). Jacobian -projective co-ordinates are expressed as three values x, y and z. Working in -this co-ordinate system provides more efficient point multiplication -operations. A mapping exists between Jacobian projective co-ordinates and -affine co-ordinates. A Jacobian projective co-ordinate (x, y, z) can be written -as an affine co-ordinate as (x/(z^2), y/(z^3)). Conversion to Jacobian -projective from affine co-ordinates is simple. The co-ordinate (x, y) is mapped +As well as the affine coordinates, a point can alternatively be described in +terms of its Jacobian projective coordinates (for Fp curves only). Jacobian +projective coordinates are expressed as three values x, y and z. Working in +this coordinate system provides more efficient point multiplication +operations. A mapping exists between Jacobian projective coordinates and +affine coordinates. A Jacobian projective coordinate (x, y, z) can be written +as an affine coordinate as (x/(z^2), y/(z^3)). Conversion to Jacobian +projective from affine coordinates is simple. The coordinate (x, y) is mapped to (x, y, 1). Although deprecated in OpenSSL 3.0 and should no longer be used, -to set or get the projective co-ordinates in older versions use +to set or get the projective coordinates in older versions use EC_POINT_set_Jprojective_coordinates_GFp() and EC_POINT_get_Jprojective_coordinates_GFp() respectively. Modern versions should instead use EC_POINT_set_affine_coordinates() and EC_POINT_get_affine_coordinates(), performing the conversion manually using the above maps in such rare circumstances. -Points can also be described in terms of their compressed co-ordinates. For a +Points can also be described in terms of their compressed coordinates. For a point (x, y), for any given value for x such that the point is on the curve there will only ever be two possible values for y. Therefore, a point can be set using the EC_POINT_set_compressed_coordinates() function where B is the x -co-ordinate and B is a value 0 or 1 to identify which of the two +coordinate and B is a value 0 or 1 to identify which of the two possible values for y should be used. The functions EC_POINT_set_compressed_coordinates_GFp() and diff --git a/doc/man3/OSSL_CRMF_MSG_set0_validity.pod b/doc/man3/OSSL_CRMF_MSG_set0_validity.pod index 5984abe51b..4add69c40d 100644 --- a/doc/man3/OSSL_CRMF_MSG_set0_validity.pod +++ b/doc/man3/OSSL_CRMF_MSG_set0_validity.pod @@ -68,7 +68,7 @@ may be NULL to select the defaults. In case the method is OSSL_CRMF_POPO_SIGNATURE the POPO is calculated using the private key I and the digest method I, where the I argument is ignored if I is of a type (such as -Ed25519 and Ed448) that is implicitly associated with a digest alorithm. +Ed25519 and Ed448) that is implicitly associated with a digest algorithm. I can be one of the following: diff --git a/doc/man3/OSSL_PARAM.pod b/doc/man3/OSSL_PARAM.pod index db669c28ea..a1a275e092 100644 --- a/doc/man3/OSSL_PARAM.pod +++ b/doc/man3/OSSL_PARAM.pod @@ -40,11 +40,11 @@ suitable form for the internal structure of the object. =item * Request parameters of some object -The caller (the I) sets up the B array and +The caller (the I) sets up the B array and calls some function (the I) that has intimate knowledge about the object, which can take the internal data of the object and copy (possibly convert) that to the memory prepared by the -I and pointed at with the B I. +I and pointed at with the B I. =item * Request parameter descriptors @@ -111,7 +111,7 @@ size should be set to the size of the buffer to be populated, which should accommodate enough space for a terminating NUL byte. When I, it's acceptable for I to be NULL. -This can be used by the I to figure out dynamically exactly +This can be used by the I to figure out dynamically exactly how much buffer space is needed to store the parameter data. In this case, I is ignored. diff --git a/doc/man3/OSSL_PARAM_int.pod b/doc/man3/OSSL_PARAM_int.pod index ffe7c8c76a..091a9e9e36 100644 --- a/doc/man3/OSSL_PARAM_int.pod +++ b/doc/man3/OSSL_PARAM_int.pod @@ -367,7 +367,7 @@ This example is for setting parameters on some object: =head2 Example 2 This example is for requesting parameters on some object, and also -demonstrates that the requestor isn't obligated to request all +demonstrates that the requester isn't obligated to request all available parameters: const char *foo = NULL; diff --git a/doc/man3/PKCS7_sign.pod b/doc/man3/PKCS7_sign.pod index b255ab61fe..3ad8cbf339 100644 --- a/doc/man3/PKCS7_sign.pod +++ b/doc/man3/PKCS7_sign.pod @@ -96,7 +96,7 @@ not be NULL. PKCS7_sign() is like PKCS7_sign_ex() except that it uses default values of NULL for the library context I and the property query I. -This is retained for API backward compatibiliy. +This is retained for API backward compatibility. =head1 BUGS diff --git a/doc/man3/SSL_CTX_set_options.pod b/doc/man3/SSL_CTX_set_options.pod index bed8c275a3..c7170b160a 100644 --- a/doc/man3/SSL_CTX_set_options.pod +++ b/doc/man3/SSL_CTX_set_options.pod @@ -221,7 +221,7 @@ description of the replay protection feature. Anti-replay measures are required to comply with the TLSv1.3 specification. Some applications may be able to mitigate the replay risks in other ways and in such cases the built in OpenSSL functionality is not required. Those applications can turn this feature off by -setting this option. This is a server-side opton only. It is ignored by +setting this option. This is a server-side option only. It is ignored by clients. =item SSL_OP_NO_TX_CERTIFICATE_COMPRESSION diff --git a/doc/man3/X509_STORE_CTX_new.pod b/doc/man3/X509_STORE_CTX_new.pod index 7a34719767..d59599ed7b 100644 --- a/doc/man3/X509_STORE_CTX_new.pod +++ b/doc/man3/X509_STORE_CTX_new.pod @@ -106,7 +106,7 @@ this can be also set indirectly using X509_STORE_CTX_set0_untrusted(). X509_STORE_CTX_init_rpk() sets up I for a subsequent verification operation for the I raw public key. It behaves similarly to X509_STORE_CTX_init(). -The I raw public key can aslo be supplied separately, via +The I raw public key can also be supplied separately, via X509_STORE_CTX_set0_rpk(). The I public key is not copied (its reference count is not updated), and the caller must not free it before verification is complete. diff --git a/doc/man3/X509_get_default_cert_file.pod b/doc/man3/X509_get_default_cert_file.pod index ad426956b0..f3d9f397ff 100644 --- a/doc/man3/X509_get_default_cert_file.pod +++ b/doc/man3/X509_get_default_cert_file.pod @@ -53,7 +53,7 @@ value returned by the corresponding function above should be used. X509_get_default_cert_path_env() returns the environment variable name which is recommended to specify a nondefault value to be used instead of the value -returned by X509_get_default_cert_dir(). This environment variable supercedes +returned by X509_get_default_cert_dir(). This environment variable supersedes the deprecated environment variable whose name is returned by X509_get_default_cert_dir_env(). This environment variable was deprecated as its contents can be interpreted ambiguously; see NOTES. diff --git a/doc/man7/provider-base.pod b/doc/man7/provider-base.pod index 9f50771b38..c015b54967 100644 --- a/doc/man7/provider-base.pod +++ b/doc/man7/provider-base.pod @@ -310,7 +310,7 @@ get_nonce() retrieves a nonce using the passed I parameter of length I and operating system specific information. The I should contain uniquely identifying information and this is included, in an unspecified manner, as part of the output. -The output is stored in a buffer which contrains at least I and at +The output is stored in a buffer which contains at least I and at most I bytes. The buffer address is stored in I<*pout> and the buffer length returned to the caller. On error, zero is returned. -- cgit v1.2.1