From 82311da10ee3dfa6f29ddfb9225f9f05c29dca31 Mon Sep 17 00:00:00 2001
From: Erik Martin-Dorel
Date: Wed, 21 Apr 2021 00:23:00 +0200
Subject: Document the "Proof using" requirement for 'proof-omit-proofs-option

---
 doc/ProofGeneral.texi | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'doc/ProofGeneral.texi')

diff --git a/doc/ProofGeneral.texi b/doc/ProofGeneral.texi
index 43f3ccb0..bbd2515d 100644
--- a/doc/ProofGeneral.texi
+++ b/doc/ProofGeneral.texi
@@ -5225,6 +5225,16 @@ If a nested proof is detected while searching for opaque proofs
 to omit, a warning is displayed and the complete remainder of the
 asserted region is sent unmodified to Coq. 
 
+If the proof script relies on sections, it is highly recommended to use
+a @code{Proof using} annotation for all lemmas contained in a Section,
+otherwise @code{Coq} will compute a wrong type for these lemmas when
+this omitting-proofs feature is enabled.
+
+To automate this, we recall that ProofGeneral provides a dedicated
+feature to generate these @code{Proof using} annotations (a defective
+form being e.g. @code{Proof using Type} if no section hypothesis is
+used), see the menu command @code{Coq > "Proof using" mode} and
+@ref{Proof using annotations} for details.
 
 @node Editing multiple proofs
 @section Editing multiple proofs
-- 
cgit v1.2.3