diff options
| author | Gaëtan Gilbert | 2019-07-02 15:31:21 +0200 |
|---|---|---|
| committer | Gaëtan Gilbert | 2019-07-02 15:31:21 +0200 |
| commit | 0cc7e942cd04f7fd28336045e43345b47a48b7a5 (patch) | |
| tree | ea174d1839f0f92bdfe11713bce88f522c10b580 /doc/sphinx | |
| parent | 89b3d677b05b38d4708ffd756f15695c67d0cd6a (diff) | |
| parent | a4dcca3c2e08059848bde1c47c2aa76d78a9555d (diff) | |
Merge PR #10336: Improve the ambiguous paths warning to indicate which path is ambiguous with new one
Reviewed-by: SkySkimmer
Diffstat (limited to 'doc/sphinx')
| -rw-r--r-- | doc/sphinx/addendum/implicit-coercions.rst | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/doc/sphinx/addendum/implicit-coercions.rst b/doc/sphinx/addendum/implicit-coercions.rst index d5523e8561..7fee62179b 100644 --- a/doc/sphinx/addendum/implicit-coercions.rst +++ b/doc/sphinx/addendum/implicit-coercions.rst @@ -145,19 +145,25 @@ Declaring Coercions .. exn:: Cannot recognize @class as a source class of @qualid. :undocumented: - .. exn:: @qualid does not respect the uniform inheritance condition. + .. warn:: @qualid does not respect the uniform inheritance condition. :undocumented: .. exn:: Found target class ... instead of ... :undocumented: - .. warn:: Ambiguous path. + .. warn:: New coercion path ... is ambiguous with existing ... - When the coercion :token:`qualid` is added to the inheritance graph, - invalid coercion paths are ignored. The :cmd:`Coercion` command tries to check - that they are convertible with existing ones on the same classes. - The paths for which this check fails are displayed by a warning in the form - :g:`[f₁;..;fₙ] : C >-> D`. + When the coercion :token:`qualid` is added to the inheritance graph, new + coercion paths which have the same classes as existing ones are ignored. + The :cmd:`Coercion` command tries to check the convertibility of new ones and + existing ones. The paths for which this check fails are displayed by a warning + in the form :g:`[f₁;..;fₙ] : C >-> D`. + + The convertibility checking procedure for coercion paths is complete for + paths consisting of coercions satisfying the uniform inheritance condition, + but some coercion paths could be reported as ambiguous even if they are + convertible with existing ones when they have coercions that don't satisfy + the uniform inheritance condition. .. cmdv:: Local Coercion @qualid : @class >-> @class |