|
 |
59834e |
From 2df154c93069ab97f38fbb8e290527f74ace5e62 Mon Sep 17 00:00:00 2001
|
|
|
fbac9f |
From: "Richard W.M. Jones" <rjones@redhat.com>
|
|
|
fbac9f |
Date: Mon, 27 Mar 2017 12:30:01 +0100
|
|
|
59834e |
Subject: [PATCH 09/23] Refresh HACKING file.
|
|
|
fbac9f |
|
|
|
fbac9f |
Fixes commit b7c3ef13cbd9c9cd49005a32ffb70faf6f5bbe8c.
|
|
|
fbac9f |
---
|
|
|
fbac9f |
HACKING | 72 ++-------------------------------------------------------
|
|
|
fbac9f |
1 file changed, 2 insertions(+), 70 deletions(-)
|
|
|
fbac9f |
|
|
|
fbac9f |
diff --git a/HACKING b/HACKING
|
|
|
fbac9f |
index bce40a9..3cd266b 100644
|
|
|
fbac9f |
--- a/HACKING
|
|
|
fbac9f |
+++ b/HACKING
|
|
|
fbac9f |
@@ -7,75 +7,7 @@ General OCaml advice:
|
|
|
fbac9f |
|
|
|
fbac9f |
(2) Emacs users: use tuareg-mode for editing OCaml.
|
|
|
fbac9f |
|
|
|
fbac9f |
-(3) http://www.ocaml-tutorial.org/
|
|
|
fbac9f |
+(3) https://realworldocaml.org/ is the definitive book which is also
|
|
|
fbac9f |
+ available online in full.
|
|
|
fbac9f |
|
|
|
fbac9f |
(4) http://camltastic.blogspot.com/2008/08/3-things-that-will-confuse-you-when.html
|
|
|
fbac9f |
-
|
|
|
fbac9f |
-The code is structured into these files:
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_utils.mli / virt_top_utils.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- String functions and other small utility functions. This is
|
|
|
fbac9f |
- included directly into virt_top.ml.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_version.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- The version number (automatically generated by configure).
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top.mli / virt_top.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- This is the virt-top program.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- The two interesting functions are called 'collect' and 'redraw'.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- 'collect' collects all the information about domains, etc.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- 'redraw' updates the display on each frame.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- Another interesting function is 'start_up' which handles all
|
|
|
fbac9f |
- start-up stuff, eg. command line arguments, connecting to the
|
|
|
fbac9f |
- hypervisor, enabling curses.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- The function 'main_loop' runs the main loop and has sub-functions
|
|
|
fbac9f |
- to deal with keypresses, help screens and so on.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_xml.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- Any code which needs the optional xml-light library goes
|
|
|
fbac9f |
- in here. Mainly for parsing domain XML descriptions to get
|
|
|
fbac9f |
- the list of block devices and network interfaces.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- The reason for having it in a separate file is so that we
|
|
|
fbac9f |
- don't depend on xml-light.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_csv.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- Any code which needs the optional ocaml-csv library goes
|
|
|
fbac9f |
- in here. This implements the --csv command line option.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_calendar1.ml
|
|
|
fbac9f |
- virt_top_calendar2.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- Any code which needs the optional ocaml-calendar library
|
|
|
fbac9f |
- goes in here. This implements the --end-time command line
|
|
|
fbac9f |
- option. Note there are two incompatible versions of the
|
|
|
fbac9f |
- ocaml-calendar library, which is why we have two
|
|
|
fbac9f |
- implementations. The Makefile works out which one to use.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_gettext.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- Gettext interaction (this is generated by ./configure).
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt_top_main.ml
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- This is just a small bit of code to glue the modules above
|
|
|
fbac9f |
- together.
|
|
|
fbac9f |
-
|
|
|
fbac9f |
-The man-page is generated from the single file:
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt-top.pod
|
|
|
fbac9f |
-
|
|
|
fbac9f |
-which generates (using perldoc) the following:
|
|
|
fbac9f |
-
|
|
|
fbac9f |
- virt-top.1
|
|
|
fbac9f |
- virt-top.txt
|
|
|
fbac9f |
--
|
|
|
59834e |
2.31.1
|
|
|
fbac9f |
|