openkylin
/
libvirt
mirror of https://gitee.com/openkylin/libvirt.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity
libvirt/README.rst

76 lines
2.5 KiB
ReStructuredText
Raw Normal View History

README: Add GitLab CI badge We've moved most of our CI jobs to GitLab, so we should display the corresponding badge prominently. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 21:19:54 +08:00
.. image:: https://gitlab.com/libvirt/libvirt/badges/master/pipeline.svg
:target: https://gitlab.com/libvirt/libvirt/pipelines
:alt: GitLab CI Build Status
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
.. image:: https://travis-ci.org/libvirt/libvirt.svg
:target: https://travis-ci.org/libvirt/libvirt
:alt: Travis CI Build Status
.. image:: https://bestpractices.coreinfrastructure.org/projects/355/badge
:target: https://bestpractices.coreinfrastructure.org/projects/355
:alt: CII Best Practices
po: update docs to refer to Weblate instead of Zanata The old information about managing PO files was outdated, as we're managing files in a different way with Weblate. This also introduces a badge showing the translation progress across languages. Reviewed-by: Pavel Hrdina <phrdina@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-06-05 06:01:25 +08:00
.. image:: https://translate.fedoraproject.org/widgets/libvirt/-/libvirt/svg-badge.svg
:target: https://translate.fedoraproject.org/engage/libvirt/
:alt: Translation status
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
==============================
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Libvirt API for virtualization
==============================
Libvirt provides a portable, long term stable C API for managing the
virtualization technologies provided by many operating systems. It
includes support for QEMU, KVM, Xen, LXC, bhyve, Virtuozzo, VMware
vCenter and ESX, VMware Desktop, Hyper-V, VirtualBox and the POWER
Hypervisor.
For some of these hypervisors, it provides a stateful management
daemon which runs on the virtualization host allowing access to the
API both by non-privileged local users and remote users.
Layered packages provide bindings of the libvirt C API into other
languages including Python, Perl, PHP, Go, Java, OCaml, as well as
mappings into object systems such as GObject, CIM and SNMP.
Further information about the libvirt project can be found on the
website:
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
https://libvirt.org
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
License
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
=======
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
The libvirt C API is distributed under the terms of GNU Lesser General
Public License, version 2.1 (or later). Some parts of the code that are
not part of the C library may have the more restrictive GNU General
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
Public License, version 2.0 (or later). See the files ``COPYING.LESSER``
and ``COPYING`` for full license terms & conditions.
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Installation
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
============
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
README.rst: Replace the installation instructions with link to compiling.html. Remove the installation instructions from README.rst, and add the link to compiling.html. Signed-off-by: Liao Pingfang <liao.pingfang@zte.com.cn> Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
2020-05-18 19:59:22 +08:00
Instructions on building and installing libvirt can be found on the website:
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
README.rst: Replace the installation instructions with link to compiling.html. Remove the installation instructions from README.rst, and add the link to compiling.html. Signed-off-by: Liao Pingfang <liao.pingfang@zte.com.cn> Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
2020-05-18 19:59:22 +08:00
https://libvirt.org/compiling.html
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Contributing
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
============
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
The libvirt project welcomes contributions in many ways. For most components
the best way to contribute is to send patches to the primary development
HACKING: Drop from the git repository Despite being a generated file, HACKING has been tracked in the git repository along with actual source files. As far as I'm aware, it's the only generated file for which that happens. Times and times again, people[1] have committed changes to the source file without refreshing the generated copy at the same time. The rationale for tracking the generated file is to help out people who just cloned the git repository looking to contribue; however, README-hacking already contains enough information to get perspective contributors to a place where they can simply look at docs/hacking.html instead. [1] Mostly me, to be honest Signed-off-by: Andrea Bolognani <abologna@redhat.com>
2017-06-26 14:45:44 +08:00
mailing list. Further guidance on this can be found on the website:
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
https://libvirt.org/contribute.html
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Contact
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
=======
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
The libvirt project has two primary mailing lists:
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
* libvirt-users@redhat.com (**for user discussions**)
* libvir-list@redhat.com (**for development only**)
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
README: Various minor style tweaks Signed-off-by: Andrea Bolognani <abologna@redhat.com>
2017-06-26 17:01:03 +08:00
Further details on contacting the project are available on the website:
Provide a useful README file The current README file contents has almost no useful info, and that which does exist is very outdated. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-05-16 18:48:17 +08:00
Convert all remaining Markdown files to reStructuredText We've adopted reStructuredText as the primary markup language for our documentation and, given that both GitLab and GitHub can render documents in this format just fine, it makes sense to get rid of the few last remaining bits of Markdown and standardize on reStructuredText across the board. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
2020-04-14 18:59:04 +08:00
https://libvirt.org/contact.html