Merge PR #8266: Minor Sphinx improvements in the bullet documentation.

1 files changed, 15 insertions, 9 deletions

diff --git a/doc/sphinx/proof-engine/proof-handling.rst b/doc/sphinx/proof-engine/proof-handling.rst
index a9d0c16376..e9aacba3a5 100644
--- a/doc/sphinx/proof-engine/proof-handling.rst
+++ b/doc/sphinx/proof-engine/proof-handling.rst
@@ -358,8 +358,10 @@ same bullet ``b``. See the example below.
 
 Different bullets can be used to nest levels. The scope of bullet does
 not go beyond enclosing ``{`` and ``}``, so bullets can be reused as further
-nesting levels provided they are delimited by these. Available bullets
-are ``-``, ``+``, ``*``, ``--``, ``++``, ``**``, ``---``, ``+++``, ``***``, ... (without a terminating period).
+nesting levels provided they are delimited by these. Bullets are made of
+repeated ``-``, ``+`` or ``*`` symbols:
+
+.. prodn:: bullet ::= {+ - } %| {+ + } %| {+ * }
 
 Note again that when a focused goal is proved a message is displayed
 together with a suggestion about the right bullet or ``}`` to unfocus it
@@ -392,19 +394,23 @@ The following example script illustrates all these features:
     - assert True.
     { trivial. }
     assumption.
+    Qed.
 
+.. exn:: Wrong bullet @bullet__1: Current bullet @bullet__2 is not finished.
 
-.. exn:: Wrong bullet @bullet1: Current bullet @bullet2 is not finished.
-
-   Before using bullet :n:`@bullet1` again, you should first finish proving the current focused goal. Note that :n:`@bullet1` and :n:`@bullet2` may be the same.
+   Before using bullet :n:`@bullet__1` again, you should first finish proving
+   the current focused goal.
+   Note that :n:`@bullet__1` and :n:`@bullet__2` may be the same.
 
-.. exn:: Wrong bullet @bullet1: Bullet @bullet2 is mandatory here.
+.. exn:: Wrong bullet @bullet__1: Bullet @bullet__2 is mandatory here.
 
-   You must put :n:`@bullet2` to focus next goal. No other bullet is allowed here.
+   You must put :n:`@bullet__2` to focus on the next goal. No other bullet is
+   allowed here.
 
 .. exn:: No such goal. Focus next goal with bullet @bullet.
 
-   You tried to apply a tactic but no goals were under focus. Using :n:`@bullet` is  mandatory here.
+   You tried to apply a tactic but no goals were under focus.
+   Using :n:`@bullet` is  mandatory here.
 
 .. exn:: No such goal. Try unfocusing with %{.
 
@@ -433,7 +439,7 @@ Requesting information
 
    .. cmdv:: Show @num
 
-      Displays only the :token:`num` th subgoal.
+      Displays only the :token:`num`\-th subgoal.
 
       .. exn:: No such goal.