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