From 30464f7b9e582a0fbd4c29e72d89651754e3eb9d Mon Sep 17 00:00:00 2001 From: Michael Orlitzky Date: Mon, 6 May 2024 12:47:57 -0400 Subject: [PATCH] src/sage/geometry/cone_critical_angles.py: add another "internal" warning The existing warning about this module being internal is easy to miss. This one should appear in bright red at the top of the module documentation. --- src/sage/geometry/cone_critical_angles.py | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/sage/geometry/cone_critical_angles.py b/src/sage/geometry/cone_critical_angles.py index f422c54e244..3e39102426a 100644 --- a/src/sage/geometry/cone_critical_angles.py +++ b/src/sage/geometry/cone_critical_angles.py @@ -1,6 +1,13 @@ r""" Find maximal angles between polyhedral convex cones +.. WARNING:: + + This module is considered internal and its contents are subject to + change at any time without (deprecation) warning. The stable + interface is + :meth:`sage.geometry.cone.ConvexRationalPolyhedralCone.max_angle`. + Finding the maximal (or equivalently, the minimal) angle between two polyhedral convex cones is a hard nonconvex optimization problem. The problem for a single cone was introduced in [IS2005]_, and was later