1
2
3
4
5
6
7
8UTOP(1)                     General Commands Manual                    UTOP(1)
9
10
11

NAME

13       utop - Universal toplevel for OCaml
14
15

SYNOPSIS

17       utop [ options ] [ object-files ] [ script-file ]
18
19

DESCRIPTION

21       utop  is  a  enhanced  toplevel for OCaml with many features, including
22       context sensitive completion.
23
24       When you start utop what you see is the prompt followed by a  bar  con‐
25       taining  words.  This  is  the completion bar, it contains the possible
26       completion and is updated as you type. The highlighted word in the com‐
27       pletion  bar  is  the  selected  word.  You can navigate using the keys
28       Alt+Left and  Alt+Right  and  you  can  complete  using  the  currently
29       selected  word by pressing Alt+Tab (you can configure these bindings in
30       the  file  ~/.lambda-term-inputrc  ,  see  lambda-term-inputrc(5)   for
31       details).
32
33       utop supports completion on:
34
35               * directives and directive arguments
36               * identifiers
37               * record fields
38               * variants
39               * function labels
40               * object methods
41
42       Colors  are  by default configured for terminals with dark colors, such
43       as white on black, so the prompt may looks too bright on  light  colors
44       terminals.  You  can  change that by setting the color profile of utop.
45       For that type:
46
47               UTop.set_profile UTop.Light;;
48
49       You can then add this line to your ~/.ocamlinit file.
50
51       You can enable basic syntax highlighting in utop by writing a ~/.utoprc
52       file. See utoprc(5) for that.
53
54       Finally  utop  can run in emacs. For that you have to add the following
55       line to your ~/.emacs file:
56
57               (autoload 'utop "utop" "Toplevel for OCaml" t)
58
59       then you can run utop by pressing M-x and typing "utop".  utop  support
60       completion  in  emacs  mode. Just press Tab to complete a word. You can
61       also integrate it with the tuareg, caml or typerex mode. For  that  add
62       the following lines to your ~/.emacs file:
63
64               (autoload 'utop-minor-mode "utop" "Minor mode for utop" t)
65               (add-hook 'tuareg-mode-hook 'utop-minor-mode)
66
67

OPTIONS

69       Same as ocaml(1).
70
71

FILES

73       ~/.ocamlinit
74              The initialization file of the toplevel.
75       ~/.utoprc
76              The configuration file for utop. See utoprc(5).
77       ~/.lambda-term-inputrc
78              The file containing key bindings. See lambda-term-inputrc(5).
79
80

AUTHOR

82       Jérémie Dimino <jeremie@dimino.org>
83
84

SEE ALSO

86       utoprc(5), lambda-term-inputrc(5), ocaml(1).
87
88
89
90                                  August 2011                          UTOP(1)
Impressum