Compatibility with <=4.06

test/cases/toplevel_comments.mli

@@ -37,6 +37,7 @@ module type Include_inline_T' = sig
 end
 
 module M : sig
+
   (** Doc of [M] *)
 end
 
@@ -45,6 +46,7 @@ module M' : sig end
 
 (** Doc of [M''], part 1. *)
 module M'' : sig
+
   (** Doc of [M''], part 2. *)
 end
 

test/xref2/module_list.t/main.mli

@@ -14,22 +14,29 @@ module Internal : sig
       @canonical Main.C1 *)
 
   module C2 : sig
+
     (* Doc for [C2]. *)
   end
   (** @canonical Main.C2 *)
 end
 
 module Z : sig
+
   (** Doc for [Z]. *)
 end
 
 module F () : sig
+
   (** Doc for [F ()]. *)
 end
 
 module Type_of : module type of F ()
 
+(* Without the extra blank lines in sig/struct, OCaml<4.06 doesn't see the doc
+   comments. *)
+
 module Type_of_str : module type of struct
+
   (** Doc of [Type_of_str]. *)
 end
 

test/xref2/references_to_pages.t/bad_references.mli

@@ -1,4 +1,5 @@
-(** *)
+(* Make sure that the next doc comment is not the top-comment. *)
+type t
 
 (** Page not found: {!page-not_found} *)