X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=HACKING;h=6ca33be31c7d1692baa2e931f62caecfae3abd90;hp=85d094b38457fcedc8d64df999859f0b881b9303;hb=bdf7a27a790ff26664f91d95239ec33c5467bfeb;hpb=0232e722826cfda0f6042da983f9eb871f24e946 diff --git a/HACKING b/HACKING index 85d094b..6ca33be 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,33 +27,63 @@ Please test any changes. Directories ---------------------------------------------------------------------- +appliance/ + The qemu appliance, build scripts and so on. + +cat/ + The virt-cat tool. + +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. Also contains some files used by the test suite. +inspector/ + Virtual machine image inspector (virt-inspector). + +java/ + Java bindings. + m4/ M4 macros used by autoconf. ocaml/ OCaml bindings. +po/ + Translations. + perl/ Perl bindings. python/ Python bindings. +regressions/ + Regression tests. + ruby/ Ruby bindings. @@ -65,6 +91,9 @@ src/ Source code to the C library. Also contains the crucial generator program. +v2v/ + Xen to KVM (V2V) conversion tool. + Debugging ---------------------------------------------------------------------- @@ -77,6 +106,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.