diff options
author | Cole Robinson <crobinso@redhat.com> | 2013-04-15 14:04:25 -0400 |
---|---|---|
committer | Cole Robinson <crobinso@redhat.com> | 2013-04-15 14:15:47 -0400 |
commit | f347ab4381a43aa690f0045f108c1bc14c09d3ca (patch) | |
tree | a2fec98cf28c9958431136e58c0d12e926197f3a | |
parent | 351d690eab831d89299e2dbe9530cc502da8350d (diff) | |
download | virt-manager-f347ab4381a43aa690f0045f108c1bc14c09d3ca.tar.gz |
Update README
-rw-r--r-- | HACKING | 17 | ||||
-rw-r--r-- | README | 114 | ||||
-rw-r--r-- | todo.txt | 2 |
3 files changed, 41 insertions, 92 deletions
@@ -24,3 +24,20 @@ to see a code coverage report. For translations, please sign up for transifex.com and contribute to the virt-manager project. + + + Submitting patches + ================== + +Patches should be developed against a git checkout and _not_ a source +release. The git repo is at + + git://git.fedorahosted.org/git/virt-manager.git + +For an web view, see: + + https://git.fedorahosted.org/cgit/virt-manager.git/ + +Patches should be sent to the mailing list (see README for details). Using +git format-patch/send-email is preferred, but an attachment with +format-patch output is fine too. @@ -1,117 +1,49 @@ - Virtual Machine Manager - ======================= + Virtual Machine Manager + ======================= This application provides a graphical tool for managing virtual machines via the libvirt library. -The front end of the application uses the PyGTK / Glade libraries for +The front end of the application uses the GTK / Glade libraries for all user interaction components. The back end uses libvirt for managing -Xen, QEMU & KVM virtual machines. The UI is primarily tested with Xen -and QEMU, but is intended to be portable to any virtualization backend -libvirt supports. So when libvirt is ported to UML / VMware / etc the -UI should not require any significant changes to deal with these drivers. +Qemu/KVM and Xen virtual machines, as well as LXC containers. The UI is +primarily tested with KVM, but is intended to be reasonably portable to any +virtualization backend libvirt supports. -Terminology ------------ -In prose this app should be referred to as 'Virtual Machine Manager'. -For source / RPM packaging, & the command name, it is called by the -shortened form 'virt-manager' + Pre-requisite software + ====================== -Pre-requisite software ----------------------- +virt-manager was ported to GTK3 at the beginning of 2013. Older GTK3 +or pygobject3 versions likely will not work for running virt-manager. -Where versions are noted below these are the versions tested to definitely -work. For some of them you may be able to run with earlier releases, so -please report any success to the mailing lists +Earliest tested versions of major components: - python >= 2.4 - pygtk2 >= 1.99.12-6 - gnome-python2-gconf >= 1.99.11-7 - libvirt-python >= 0.4.0 - dbus-python >= 0.61 - gnome-keyring >= 0.4.9 - gnome-python-desktop >= 2.15.4 - libxml2-python >= 2.6.23 - vte >= 0.12.2 - gtk-vnc >= 0.0.1 - python-virtinst >= 0.300.0 - PolicyKit >= 0.6 + python >= 2.6 + gtk3 >= 3.6 + libvirt-python >= 0.4.0 + pygobject3 >= 3.4 -The latter is available from +A more detailed dependency list can be found in virt-manager.spec.in. -http://git.fedorahosted.org/git/python-virtinst.git -Contact -------- + Contact + ======= All comments / suggestions / patches should be directed to the virt-tools-list mailing list: http://www.redhat.com/mailman/listinfo/virt-tools-list +For IRC we use #virt on OFTC. + For bug reporting info, see: -http://virt-manager.org/page/BugReporting + http://virt-manager.org/page/BugReporting There are further project details on the website: http://virt-manager.org/ -Submitting patches ------------------- - -Patches should be submitted either as unified diffs: - - tar zxvf virt-manager-X.Y.Z.tar.gz - cp -a virt-manager-X.Y.Z virt-manager-X.Y.Z-myfeature - cd virt-manager-X.Y.Z-myfeature - ... make some changes .. - cd .. - diff -ruN virt-manager-X.Y.Z virt-manager-X.Y.Z-myfeature \ - > myfeature.patch - -Alternatively use git and submit a diff against the main source repository: - - git clone git://git.fedorahosted.org/git/virt-manager.git - cd virt-manager - ... make your changes ... - git commit -a -m "Some changelog message" - git show > my_feature.patch - -Then mail the 'my_feature.patch' file to the virt-tools-list@redhat.com list, -with [PATCH] and a brief description in the subject. - -Using git format-patch and/or git send-email is also fine. - -Related software ----------------- - -Links which are relevant: - - http://libvirt.org - http://www.linux-kvm.org - http://xensource.com/xen/ - http://pygtk.org/ - http://gtk.org/ - http://gtk-vnc.sourceforge.net/ - -Copyright / License --------------------- - -Unless otherwise noted, all the code for the Virtual Machine Manager -is covered under the GPL, and Copyright (C) Red Hat. - - Notes on translation process - ============================ - -The translations for virt-manager are handled via transifex.net. -To pull in the latest translations requires the transifex-client package: - - tx pull - make update-po - -Translators can easily sign up to contribute: - -http://help.transifex.net/ - +See the HACKING file for info about submitting patches or contributing +translations. @@ -5,7 +5,7 @@ check all XXX/TODO in the code, make sure nothing important is missing revive import blacklist for virtinst code, maybe just a unittest that checks Gtk isn't in globals ? break out osdistro bits so we don't need to carry virt-install.pod -merge README, reference that we merged virtinst and see that repo for old NEWS, etc. +gnome keyring entirely over dbus? is dbus uniqueness still working? I dropped the service file but it shouldn't be necc. |