openbsd/src/lib/libcrypto/man/EC_POINT_new.3, branch OPENBSD_7_9_BASEA mirror of https://github.com/libressl/openbsd.git
https://git.lua4.win/openbsd/atom?h=OPENBSD_7_9_BASE2025-06-13T18:34:00+00:00The mdoc(7) .Ft macro does not need quoting of its arguments, but about2025-06-13T18:34:00+00:00schwarze2025-06-13T18:34:00+00:00urn:sha1:d939c0f8976619330bcf368e12700a6ab1d14f99
10% of our manual pages using this macro employed useless quoting anyway.
Remove these quotes such that they do not incite fear, uncertainty,
and doubt in developers who happen to look at these pages.
jmc@ and tb@ agree with the direction.
.Lb libcrypto ; OK tb@2025-06-08T22:40:31+00:00schwarze2025-06-08T22:40:31+00:00urn:sha1:8be86af02fed1bda350c8dd14ee064cb66e3b0f5EC_POINT_new: wording tweaks in the BUGS section2025-05-18T20:44:30+00:00tb2025-05-18T20:44:30+00:00urn:sha1:fade7de7f38b7697809f64980d76a6dad65b039dRework EC documentation2025-04-25T19:57:12+00:00tb2025-04-25T19:57:12+00:00urn:sha1:60904c983d054a3655c2d3ac38828e2b8c9cc067
This replaces the giant, poor quality and outdated EC_GROUP_copy.3,
EC_GROUP_new.3, and EC_POINT_new.3 manuals with seven new manuals
written from scratch.
* EC_GROUP_new_by_curve_name() is the entry point for builtin curves,
* EC_GROUP_new_curve_GFp() describes lower level API that should not
usually be needed apart from a handful of accessors.
* EC_GROUP_check() contains two functions that applications should not
need because either you know for certain something is an elliptic
curve (so these checks are pointless) or you should not use it.
* EC_GROUP_get_curve_name() describes some low level ASN.1 footguns
and corresponding getters.
* EC_POINT_new() contains the simple EC_POINT allocation and freeing API
* EC_POINT_get_affine_coordinates() contains the coordinate accessors
* EC_POINT_point2oct() is about encoding elliptic curve points
While all this is quite far from perfect, the diff is getting too big
and it will be easier to improve this in tree. It is definitely more
repetitive than I would like it to be.
Reviews, tweaks and general feedback are of course welcome.
discussed with jsing
Remove EC_POINT_method_of() docs2025-03-08T17:04:07+00:00tb2025-03-08T17:04:07+00:00urn:sha1:af4ae1af0d915e773ed7c7261d1b45125efed84bRemove EC_PIONT_{get,set}_Jprojective_coordinates_GFp docs2025-03-08T16:51:34+00:00tb2025-03-08T16:51:34+00:00urn:sha1:dc6ea91565aca6d53cbd8ea4ae03a728e0c5f1b2Remove EC_GFp_* and EC_METHOD_get_field_type docs2025-03-08T16:38:13+00:00tb2025-03-08T16:38:13+00:00urn:sha1:f9782c9acfdbef308a07a85a3f2b07c5b67a833eRemove documentation of GF2m point stuff2023-04-27T09:39:52+00:00tb2023-04-27T09:39:52+00:00urn:sha1:9f1b60cd2921c7509dc2c0300bc57e9eb2c9e317Add missing .Pp2021-05-13T05:52:28+00:00tb2021-05-13T05:52:28+00:00urn:sha1:513e9ef0945bc73cec3297bf73bae8be35827b54Merge documentation for EC_POINT_{get,set}_coordinates and2021-05-10T20:00:58+00:00tb2021-05-10T20:00:58+00:00urn:sha1:18389bc9c7a37d5b1efd648339275ec07dec32d3
for EC_POINT_set_compressed_coordinates from OpenSSL 1.1.1.