X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=HACKING;h=7a4735ca03ef83bb429623b87e73d926a0d0b52b;hp=7d235bc6f539999095183eec7470e84ace1751ae;hb=67a3d3e3915a18a58702b7e68f514d9dc9a82a2e;hpb=12baf36e87c6a0968939e98b1969bc1b9d8cb0bc diff --git a/HACKING b/HACKING index 7d235bc..7a4735c 100644 --- a/HACKING +++ b/HACKING @@ -14,10 +14,6 @@ etc. to the big list called 'functions' at the top of this file. 'do_action' function. Take a look at one of the numerous examples there. -You will need to run src/generator.ml (from the top directory) which -regenerates all the auto-generated files, and then continue with the -ordinary build process. - Formatting ---------------------------------------------------------------------- @@ -31,18 +27,30 @@ Please test any changes. Directories ---------------------------------------------------------------------- +appliance/ + The qemu appliance, build scripts and so on. + +capitests/ + Automated tests of the C API. + contrib/ Outside contributions, experimental parts. daemon/ The daemon that runs inside the guest and carries out actions. +df/ + The virt-df tool. + examples/ The examples. fish/ Guestfish (the command-line program / shell) +haskell/ + Haskell bindings. + images/ Some guest images to test against. These are gzipped to save space. You have to unzip them before use. @@ -61,12 +69,18 @@ m4/ ocaml/ OCaml bindings. +po/ + Translations. + perl/ Perl bindings. python/ Python bindings. +regressions/ + Regression tests. + ruby/ Ruby bindings. @@ -74,6 +88,9 @@ src/ Source code to the C library. Also contains the crucial generator program. +v2v/ + Xen to KVM (V2V) conversion tool. + Debugging ---------------------------------------------------------------------- @@ -86,6 +103,20 @@ they will show up if you use 'guestfish -v'. Patches ---------------------------------------------------------------------- -Submit patches to the fedora-virt mailing list: -http://www.redhat.com/mailman/listinfo/fedora-virt +Submit patches to the mailing list: +http://www.redhat.com/mailman/listinfo/libguestfs and CC to rjones@redhat.com + +I18N +---------------------------------------------------------------------- + +We support i18n (gettext anyhow) in the library. + +However many messages come from the daemon, and we don't translate +those at the moment. One reason is that the appliance generally has +all locale files removed from it, because they take up a lot of space. +So we'd have to readd some of those, as well as copying our PO files +into the appliance. + +Debugging messages are never translated, since they are intended for +the programmers.