Try to ensure future-proofness of references to polymorphic variants

Signed-off-by: Paul-Elliot <peada@free.fr>

Author: panglesd

src/document/url.ml

@@ -272,6 +272,11 @@ module Anchor = struct
     let page = Path.from_identifier parent in
     Ok { page; anchor = str_name; kind }
 
+  (* This is needed to ensure that references to polymorphic constructors have
+     links that use the right suffix: those resolved references are turned into
+     _constructor_ identifiers. *)
+  let suffix_for_constructor x = x
+
   let rec from_identifier : Identifier.t -> (t, Error.t) result =
     let open Error in
     function
@@ -371,7 +376,7 @@ module Anchor = struct
     | { iv = `Constructor (parent, name); _ } ->
         from_identifier (parent :> Identifier.t) >>= fun page ->
         let kind = `Constructor in
-        let suffix = ConstructorName.to_string name in
+        let suffix = suffix_for_constructor (ConstructorName.to_string name) in
         Ok (add_suffix ~kind page suffix)
     | { iv = `Field (parent, name); _ } ->
         from_identifier (parent :> Identifier.t) >>= fun page ->
@@ -424,7 +429,7 @@ module Anchor = struct
             add_suffix ~kind url suffix
         | Constructor { name; _ } ->
             let kind = `Constructor in
-            let suffix = name in
+            let suffix = suffix_for_constructor name in
             add_suffix ~kind url suffix)
 
   (** The anchor looks like

src/model/paths.ml

@@ -987,6 +987,8 @@ module Reference = struct
           (label_parent_identifier r :> Identifier.t)
       | `Field (p, n) -> Identifier.Mk.field (field_parent_identifier p, n)
       | `PolyConstructor (s, n) ->
+          (* Uses an identifier for constructor even though it is not
+             one. Document must make the links correspond. *)
           Identifier.Mk.constructor
             ((parent_type_identifier s :> Identifier.DataType.t), n)
       | `Constructor (s, n) ->