src/README

   1 The code is structured into these files:
   2
   3   utils.mli, utils.ml
   4
   5     String functions and other small utility functions.  This is
   6     included directly into virt_top.ml.
   7
   8   types.mli, types.ml
   9
  10     Various internally used types and functions operating on those
  11     types.
  12
  13   collect.mli, collect.ml
  14
  15     Stats information is collected in these functions.
  16
  17   screen.mli, screen.ml
  18
  19     Various useful functions for drawing to the curses screen.
  20
  21   redraw.mli, redraw.ml
  22
  23     Redraw the main display.
  24
  25   csv_output.mli, csv_output.ml
  26
  27     Functions which implement --csv mode.
  28
  29   stream_output.mli, stream_output.ml
  30
  31     Functions which implement --stream mode.
  32
  33   top.mli, top.ml
  34
  35     This is the virt-top program.
  36
  37     'start_up' handles all start-up stuff, eg. command line arguments,
  38     connecting to the hypervisor, enabling curses.
  39
  40     The function 'main_loop' runs the main loop and has sub-functions
  41     to deal with keypresses, help screens and so on.
  42
  43   opt_gettext.ml
  44
  45     A generated file which adds gettext support if ocaml-gettext
  46     was found at configure time, or else stubs it out.
  47
  48   opt_calendar.ml
  49
  50     Any code which needs the optional ocaml-calendar library
  51     (v2) goes in here.  This implements the --end-time command
  52     line option.
  53
  54   main.ml
  55
  56     This is just a small bit of code to glue the modules together
  57     Top + Opt_calendar?
  58
  59 The man-page is generated from the single file:
  60
  61   virt-top.pod
  62
  63 which generates (using perldoc) the following:
  64
  65   virt-top.1
  66   virt-top.txt