improved docstring

Author: Jonathan Kliem

src/sage/geometry/polyhedron/base.py

@@ -4439,11 +4439,14 @@ def stack(self, face, position=None):
             sage: stack.backend()
             'field'
 
-        The stacked vertex may not satisfy any inequality
-        defining the original polyhedron::
+        Taking the stacking vertex too far with the parameter `position`
+        may result in a failure to produce the desired
+        (combinatorial type of) polytope.
+        The interval of permittable values is always open.
+        This is the smallest non-permittable value::
 
             sage: P = polytopes.octahedron()
-            sage: P.stack(P.faces(2)[0],4)
+            sage: P.stack(P.faces(2)[0], position=4)
             Traceback (most recent call last):
             ...
             ValueError: the chosen position is too large

src/sage/geometry/polyhedron/representation.py

@@ -466,20 +466,20 @@ def neighbors(self):
 
         Checking that :trac:`28463` is fixed::
 
-        sage: P = polytopes.simplex()
-        sage: F1 = P.Hrepresentation()[1]
-        sage: list(F1.neighbors())
-        [An inequality (0, 1, 0, 0) x + 0 >= 0,
-         An inequality (0, 0, 1, 0) x + 0 >= 0,
-         An inequality (0, 0, 0, 1) x + 0 >= 0]
+            sage: P = polytopes.simplex()
+            sage: F1 = P.Hrepresentation()[1]
+            sage: list(F1.neighbors())
+            [An inequality (0, 1, 0, 0) x + 0 >= 0,
+             An inequality (0, 0, 1, 0) x + 0 >= 0,
+             An inequality (0, 0, 0, 1) x + 0 >= 0]
 
         Does not work for equalities::
 
-        sage: F0 = P.Hrepresentation()[0]
-        sage: list(F0.neighbors())
-        Traceback (most recent call last):
-        ...
-        TypeError: must be inequality
+            sage: F0 = P.Hrepresentation()[0]
+            sage: list(F0.neighbors())
+            Traceback (most recent call last):
+            ...
+            TypeError: must be inequality
         """
         # The adjacency matrix does not include equations.
         n_eqs = self.polyhedron().n_equations()