Source

mutated_ocaml / ocamlspot /

The branch 'default' does not exist.
Filename Size Date modified Message
..
tests
25 B
279 B
1005 B
1.5 KB
31.1 KB
3.6 KB
2.7 KB
889 B
5.5 KB
36.5 KB
2.8 KB
1.5 KB
2.6 KB
1.8 KB
3.4 KB
OCamlSpotter : OCaml source browsing
====================================

  Camel spotter: Oh, it was extremely interesting, very, very -
    quite... it was dull; dull, dull, dull, oh God it was dull. 
    Sitting in the Waterloo waiting room. ...

                                     from You're No Fun Anymore, 
                                    Monty Python's Flying Circus

OCaml module language is powerful. So extremely powerful that you can 
be lost yourself easily inside a huge OCaml project with tons of modules. 
Spotting the definition of a variable is sometimes "extremely interesting".
Let's see such an "exciting" example:

  include M
  open N
  open O
  let _ = f 1

Suppose you are not familiar with the function f and want to spot its
definition. Where to find it? Just from the code you are looking at,
it is not sure: if you are enough lucky it may be f in m.ml, n.ml or
o.ml. Otherwise, it may be O.f in n.ml. Or probably N.O.f in
m.ml. If you are unlucky and the project is so sophisticated, there could
be complex module operations in m.ml (i.e includes, functor applications) 
and therefore the definition might be found somewhere completely unexpected.
Module packing, module load paths and library installation without .ml files 
complicate the situation even worse. 

You first days after joining a large OCaml project should be this kind
of manual value definition spotting with find + grep commands. Yes, actually 
it is very educational: you can learn a lot about the project struggling
in the source tree (only if your collegues have organized things very
well :-P), but it is still a dull job...

To say short, OCamlSpotter is a tool which does this dull job automatically
for you and permits your energy for something more "interesting" like Yeti 
spotting:

 - The -annot option of ocamlc and ocamlopt is extended and creates 
   <module>.spot files (<module>.spit for .mli), which record the location 
   information of the names defined and used in the module.

 - A small application ocamlspot provides automatic where-about spotting 
   of the definition of the name you are interested in.

 - ocamlspot.el provides interactive ocaml-spotting of definition 
   locations in emacs.

 - Interfaces for other editors such as vi can be built easily, if you want. 

Bugs and future works
=====================

Due to the artificial setting of the release dead line (2008/12/25), this
software contain lots of bugs and todos.

License
=======

Read LICENSE file in this directory. 

Author
======

  Jun FURUSE (jun.furuse@gmail.com). Bug reports and comments are welcome.
  Patches are appreciated. Donating camel related gadgets is the most 
  wonderful. Complaints might be simply ignored.