Rework EC documentation

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

1 files changed, 7 insertions, 3 deletions

diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile
index 9f3d448432..b8dfe86d49 100644
--- a/src/lib/libcrypto/man/Makefile
+++ b/src/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile,v 1.307 2025/03/08 17:12:55 tb Exp $
+# $OpenBSD: Makefile,v 1.308 2025/04/25 19:57:12 tb Exp $
 
 .include <bsd.own.mk>
 
@@ -133,12 +133,16 @@ MAN=	\
         DSA_size.3 \
         ECDH_compute_key.3 \
         ECDSA_SIG_new.3 \
-        EC_GROUP_copy.3 \
-        EC_GROUP_new.3 \
+        EC_GROUP_check.3 \
+        EC_GROUP_get_curve_name.3 \
+        EC_GROUP_new_by_curve_name.3 \
+        EC_GROUP_new_curve_GFp.3 \
         EC_KEY_METHOD_new.3 \
         EC_KEY_new.3 \
         EC_POINT_add.3 \
+        EC_POINT_get_affine_coordinates.3 \
         EC_POINT_new.3 \
+        EC_POINT_point2oct.3 \
         ENGINE_new.3 \
         ERR.3 \
         ERR_GET_LIB.3 \