aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEmilio Jesus Gallego Arias2019-03-15 19:16:30 +0100
committerEmilio Jesus Gallego Arias2019-03-27 23:56:18 +0100
commit91dfe5163fd4405977ad8fc8fe178ba5bcd73c88 (patch)
tree1a310ae4bb1e455fda99cb72220a33b3d734b5ed
parent8fd017fee158ed6b37ed26462691ca9a62695a47 (diff)
[doc] [abstract] Document a bit some problems with abstract.
-rw-r--r--doc/sphinx/proof-engine/ltac.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/sphinx/proof-engine/ltac.rst b/doc/sphinx/proof-engine/ltac.rst
index 52e3029b8f..0322b43694 100644
--- a/doc/sphinx/proof-engine/ltac.rst
+++ b/doc/sphinx/proof-engine/ltac.rst
@@ -1071,6 +1071,16 @@ Proving a subgoal as a separate lemma
It may be useful to generate lemmas minimal w.r.t. the assumptions they
depend on. This can be obtained thanks to the option below.
+ .. warning::
+
+ The abstract tactic, while very useful, still has some known
+ limitations, see https://github.com/coq/coq/issues/9146 for more
+ details. Thus we recommend using it caution in some
+ "non-standard" contexts. In particular, ``abstract`` won't
+ properly work when used inside quotations ``ltac:(...)``, or
+ if used as part of typeclass resolution, it may produce wrong
+ terms when in universe polymorphic mode.
+
.. tacv:: abstract @expr using @ident
Give explicitly the name of the auxiliary lemma.