summaryrefslogtreecommitdiff
path: root/testsuite/tests/tool-ocamldoc/Linebreaks.mli
blob: 1baf3db31444a24a859f01efb1e9371f1a210cf8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
(* TEST
 ocamldoc with html;
 output = "type_Linebreaks.html";
 reference = "${test_source_directory}/type_Linebreaks.reference";
 check-program-output;
*)

(**
   This file tests the encoding of linebreak inside OCaml code by the
   ocamldoc html backend.

   Two slightly different aspects are tested in this very file.

   - First, inside a "pre" tags, blanks character should not be escaped.
   For instance, the generated html code for this test fragment should not
   contain any <br> tag:
   {[
     let f x =
       let g x =
         let h x = x in
         h x in
       g x
   ]}
   See {{:http://caml.inria.fr/mantis/view.php?id=6341} MPR#6341} for more
   details or the file Linebreaks.html generated by ocamldoc from this file.
   - Second, outside of a "pre"  tags, blank characters in embedded code
   should be escaped, in order to make them render in a "pre"-like fashion.
   A good example should be the files type_{i Modulename}.html generated by
   ocamldoc that should contains the signature of the module [Modulename] in
   a "code" tags.
   For instance with the following type definitions,
*)

type a = A
type 'a b = {field:'a}
type c = C: 'a -> c

type s = ..
type s += B

val x : a

module S: sig module I:sig end end
module type s = sig end

class type d = object end

exception E of {inline:int}


(** type_Linebreaks.html should contain

{[
sig
  type a = A
  type 'a b = { field : 'a; }
  type c = C : 'a -> Linebreaks.c
  type s = ..
  type s += B
  val x : Linebreaks.a
  module S : sig module I : sig  end end
  module type s = sig  end
  class type d = object  end
  exception E of { inline : int; }
end
]}

with <br> tags used for linebreaks.
Another example would be [ let f x =
x] which is rendered with a <br> linebreak inside Linebreaks.html.

See {{:http://caml.inria.fr/mantis/view.php?id=7272}MPR#7272} for more
information.

*)