From: Richard W.M. Jones <"Richard W.M. Jones "> Date: Sat, 16 Feb 2008 14:06:52 +0000 (+0000) Subject: Rewrite the requirements section of the README file to make it X-Git-Tag: 1.0.4~44 X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=d81bd95b04381b8e3c49eea7c0f98b5cb72be863;p=virt-top.git Rewrite the requirements section of the README file to make it clearer. --- diff --git a/README b/README index b5df0f5..57063ba 100644 --- a/README +++ b/README @@ -12,55 +12,113 @@ known functionality to OCaml programs. Requirements ---------------------------------------------------------------------- -To build the bindings, examples, and mlvirsh (required): - - GNU make, gcc - libvirt >= 0.2.1 (from http://libvirt.org/, - get the latest version if you can) - ocaml >= 3.08 (from http://caml.inria.fr/) - -Optional, but highly recommended: - - findlib (from http://www.ocaml-programming.de/packages/) - -To build the OCaml interface documentation (optional): - - ocamldoc (part of OCaml itself) - -To build virt-top (optional): - - ocaml-curses (from http://www.nongnu.org/ocaml-tmk/) - Extlib (from http://ocaml-lib.sourceforge.net/) - xml-light (from http://tech.motion-twin.com/doc/xml-light/) - ocaml CSV library (from http://merjis.com/developers/csv) - ocaml-calendar (http://www.lri.fr/~signoles/prog.en.html) - - [Only ocaml-curses and Extlib are required for building virt-top. - The other packages are not required, but you will get reduced - functionality]. - -To build virt-ctrl (optional): - - GTK2 (from http://gtk.org/) - lablgtk2 (from http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgtk.html) - -To build the manpages (optional): - - perldoc (part of Perl) - -To build a Windows installer (optional): - - NSIS (http://nsis.sf.net) - -OCaml packages are available for Fedora 7 and above (ocaml, -ocaml-findlib, ocaml-findlib-devel, ocaml-ocamldoc, ocaml-extlib, -ocaml-extlib-devel, ocaml-lablgtk, ocaml-lablgtk-devel, ocaml-curses, -ocaml-xml-light, ocaml-csv). - - http://www.annexia.org/tmp/ocaml/ - http://fedoraproject.org/wiki/SIGs/OCaml - -Debian/Ubuntu have all the packages you require. +PLEASE NOTE: The list of requirements looks long but you DO NOT NEED +all of these packages, so pay careful attention to what is required +('R') and what is optional ('O'). + +ALSO NOTE: Binaries are available for many platforms. You only need +the packages below if you want to build from source. + + W h a t y o u w a n t t o b u i l d + + |Bindings, |Docs, |virt-top |virt-ctrl |Windows + |examples, |manpages | | |version + |mlvirsh | | | | + --------------+----------+---------+---------+----------+--------- + GNU make | R | R | R | R | R + | | | | | + gcc | R | | R | R | R + | | | | | + libvirt | R | | R | R | R + | >= 0.2.1 | | | | + | | | | | + ocaml | R | | R | R | R + | >= 3.08 | | | | + | | | | | + findlib | HR | R | HR | HR | n/a + | | | | | + MinGW + MSYS | | | | | R + --------------+----------+---------+---------+----------+--------- + ocamldoc | | R | | | O + | | | | | + perldoc | | O | | | + --------------+----------+---------+---------+----------+--------- + ocaml-curses | | | R | | + | | | | | + Extlib | | | R | | + | | | | | + xml-light | | | O | | + | | | | | + ocaml-calendar| | | O | | + | | | | | + ocaml CSV | | | O | | + --------------+----------+---------+---------+----------+--------- + GTK2 | | | | R | O + | | | | | + lablgtk2 | | | | R | O + | | | | | + ocaml-dbus | | | | O | + --------------+----------+---------+---------+----------+--------- + NSIS | | | | | O + --------------+----------+---------+---------+----------+--------- + + R = required + HR = highly recommended (use if possible) + O = optional (just improves functionality, but not required) + n/a = not available + +Where to get the packages: + + libvirt >= 0.2.1 from http://libvirt.org/ (get the latest version available) + or packaged in Debian, Ubuntu and Fedora + + ocaml >= 3.08 from http://caml.inria.fr/ + or packaged in Debian, Ubuntu and Fedora + + findlib from http://www.ocaml-programming.de/packages/ + or packaged in Debian, Ubuntu and Fedora as 'ocaml-findlib' + + MinGW + MSYS from http://www.mingw.org/ (only needed for Windows) + + ocamldoc part of OCaml itself + or part of the ocaml package in Debian, Ubuntu + or packaged in Fedora as 'ocaml-ocamldoc' + + perldoc part of Perl + or packaged in Debian, Ubuntu and Fedora + + ocaml-curses from http://www.nongnu.org/ocaml-tmk/ + or packaged in Debian, Ubuntu as 'libcurses-ocaml-dev' + or packaged in Fedora as 'ocaml-curses-devel' + + Extlib from http://ocaml-lib.sourceforge.net/ + or packaged in Debian, Unbuntu as 'libextlib-ocaml-dev' + or packaged in Fedora as 'ocaml-extlib-devel' + + xml-light from http://tech.motion-twin.com/doc/xml-light/ + or packaged in Debian, Ubuntu as 'libxml-light-ocaml-dev' + or packaged in Fedora as 'ocaml-xml-light-devel' + + ocaml CSV from http://merjis.com/developers/csv + or packaged in Debian, Ubuntu as 'libcsv-ocaml-dev' + or packaged in Fedora as 'ocaml-csv-devel' + + ocaml-calendar from http://www.lri.fr/~signoles/prog.en.html + or packaged in Debian, Ubuntu as 'libcalendar-ocaml-dev' + or packaged in Fedora as 'ocaml-calendar-devel' + + GTK2 from http://gtk.org/ + or packaged in Debian, Ubuntu and Fedora + + lablgtk2 from http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgtk.html + or packaged in Debian, Ubuntu as 'liblablgtk2-ocaml-dev' + or packaged in Fedora as 'ocaml-lablgtk-devel' + + ocaml-dbus from http://tab.snarc.org/projects/ocaml_dbus/ + or packaged in Fedora 9 as 'ocaml-dbus-devel' + (not yet available for Debian or Ubuntu AFAIK) + + NSIS from http://nsis.sf.net Building @@ -76,7 +134,8 @@ Building make doc # Build HTML documentation in html/ subdirectory. -Then have a look at the programs 'mlvirsh.opt' and 'virt-ctrl.opt'. +Then have a look at the programs 'mlvirsh.opt', 'virt-top.opt' +and 'virt-ctrl.opt'. Note: If you want to run the programs without first installing, you may need to set your $LD_LIBRARY_PATH environment variable so it