fixes #1782

1 files changed, 8 insertions, 0 deletions

diff --git a/doc/manual/procs.txt b/doc/manual/procs.txt
index 9d00b7e3c..ee74b2ea6 100644
--- a/doc/manual/procs.txt
+++ b/doc/manual/procs.txt
@@ -137,6 +137,14 @@ to supply any type of first argument for procedures:
 Another way to look at the method call syntax is that it provides the missing
 postfix notation.
 
+The method call syntax conflicts with explicit generic instantiations:
+``p[T](x)`` cannot be written as ``x.p[T]`` because ``x.p[T]`` is always
+parsed as ``(x.p)[T]``.
+
+**Future directions**: ``p[.T.]`` might be introduced as an alternative syntax
+to pass explict types to a generic and then ``x.p[.T.]`` can be parsed as
+``x.(p[.T.])``.
+
 See also: `Limitations of the method call syntax`_.