# # add_file "INSTALL" # # patch "INSTALL" # from [] # to [f4e6f306f6a19cf698f77b8ac43c8db16af19c4c] # # patch "Makefile" # from [708d8e7dcb45b060fa892a40b91495e259c3fd36] # to [46bdb9e6aa9b5ca46b291ce4143f4615db588a2f] # # patch "NEWS" # from [17aa2aca5ca090cf3d46bfc1590fd8bf3bea6536] # to [3602e8bd4779572b71e1b69ed41097bfcfadacda] # # patch "README" # from [90c6b1e59affd24a1a0fcc844980140dd518e456] # to [18d17ed5745ddbe7b13cedd87304dd32a7126bbf] # --- INSTALL +++ INSTALL @@ -0,0 +1,58 @@ + +Compiling monotone-viz from sources +=================================== + +* OCaml +Monotone-viz is written in Objective caml, so you'll need the ocaml +compilers [1]. They are binaries available, from the ocaml homepage or +from other vendors (e.g. Linux distributions). It is also easy to +compile from source, something like this should work: + + $ ./configure -prefix /opt/caml + $ make world.opt + $ make install + + +* GTK+ & libgnomecanvas +You'll need the development packages of GTK+ 2.4 (or newer) and +libgnomecanvas. + + +* LablGTK +LablGTK is a GTK+ bindings for ocaml [2]. It is packaged for some +Linux distributions, but make sure you have *at least* version 2.4.0. +The latest version is lablgtk2-20050218. + + $ ./configure --with-gnomecanvas + $ make world + $ make install + + +* Monotone +You need the compiled monotone sources, for monotone-viz statically +links the sqlite library embedded in monotone. So, in the +monotone-viz directory, create a link named monotone : + + $ ln -s /path/to/monotone-tree monotone + + +* Monotone-viz +Compiling monotone-viz should now be as simple as : + + $ ./configure + $ make + + +* Installing & cleaning +There is no `install' target for the Makefile : monotone-viz is a +single executable, just copy it somewhere in your PATH. +Also the ocaml compiler statically links everything caml-related so +you can delete your ocaml installation if you so wish : + + $ rm -Rf /opt/ocaml + + + + +[1] http://caml.inria.fr/ocaml/release.en.html +[2] http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/lablgtk.html --- Makefile +++ Makefile @@ -31,7 +31,7 @@ OBJX = $(patsubst %.ml,%.cmx,$(filter %.ml, $(SRC))) DISTSRC = Makefile configure.ac config.make.in ocaml.m4 configure aclocal.m4 \ - monotone-viz.style.sample README NEWS \ + monotone-viz.style.sample README INSTALL NEWS \ viz_misc.ml viz_misc.mli viz_types.ml viz_types.mli q.ml q.mli \ autocolor.ml autocolor.mli viz_style.ml viz_style.mli heap.ml heap.mli \ dot_types.mli dot_lexer.mll dot_parser.mly \ @@ -116,7 +116,7 @@ tar zcvf $(@F) $(addprefix $(NAME)-$(VERSION)/,$(DISTSRC)) && \ mv $(NAME)-$(VERSION) "$$DIRNAME" -# not config.make +# no config.make ifndef OCAMLLEX $(error run ./configure first (cf README)) endif --- NEWS +++ NEWS @@ -1,3 +1,10 @@ +0.9: +- the application window has an icon ! +- the layout is a bit more compact +- the find box also finds tags regexps and dates +- the diff window has a save button + + 0.8: - update to sqlite3 - fix the keyboard navigation for left-to-right layout --- README +++ README @@ -30,7 +30,9 @@ - make - install the binary monotone-viz somewhere +see INSTALL for an in-depth description of this procedure. + RUNNING ======= usage: monotone-viz [options] [db [branch]] @@ -38,16 +40,15 @@ -noaa don't use an anti-aliased canvas If db and branch are not specified on the command line and -monotone-viz is run from a monotone-controlled directory (i.e. with a -MT/ subdirectory), it will automatically use the database and branch -specified in the MT/options file. +monotone-viz is run from a monotone-controlled directory, it will +automatically use the database and branch specified in the MT/options +file. STYLE FILE ========== Appearance can be controlled via a style file, named -`.mononote-viz.style', in the home directory or in the current -directory. +`.mononote-viz.style', in the home directory. grammar: "font"