From 5e7289e06822a0fba83c6fc8ec5b2b74b04b58fd Mon Sep 17 00:00:00 2001 From: Erik Skultety Date: Fri, 12 Mar 2021 12:09:01 +0100 Subject: [PATCH] docs: html.in: Convert bindings to rst Signed-off-by: Erik Skultety Reviewed-by: Peter Krempa --- docs/bindings.html.in | 101 ------------------------------------------ docs/bindings.rst | 62 ++++++++++++++++++++++++++ docs/meson.build | 2 +- 3 files changed, 63 insertions(+), 102 deletions(-) delete mode 100644 docs/bindings.html.in create mode 100644 docs/bindings.rst diff --git a/docs/bindings.html.in b/docs/bindings.html.in deleted file mode 100644 index a1520707c5..0000000000 --- a/docs/bindings.html.in +++ /dev/null @@ -1,101 +0,0 @@ - - - - -

Bindings for other languages and integration API modules

- -

- Libvirt supports C and C++ directly, and has bindings available - for other languages: -

- -
    -
  • - C#: Arnaud Champion develops - C# bindings. -
    • -
  • - Go: Daniel Berrange develops - Go bindings. -
    • -
  • - Java: Daniel Veillard develops - Java bindings. -
    • -
  • - OCaml: Richard Jones develops - OCaml bindings. -
    • -
  • - Perl: Daniel Berrange develops - Perl bindings. -
    • -
  • -

    - PHP: Radek Hladik started developing - PHP bindings in 2010. -

    -

    - In February 2011 the binding development has been moved to the libvirt.org website as - libvirt-php project. -

    -

    - The project is now maintained by Michal Novotny and it's heavily based - on Radek's version. For more information, including - information on posting patches to libvirt-php, please refer - to the PHP bindings site. -

    -
    • -
  • -

    - Python: Libvirt's python bindings are split to a - separate package - since version 1.2.0, older versions came with direct support for the - Python language. -

    -

    - If your libvirt is installed as packages, rather than compiled - by you from source code, ensure you have the appropriate - package installed. -

    -

    - This is named libvirt-python on RHEL/Fedora, - python-libvirt - on Ubuntu, and may be named differently on others. -

    -

    - For usage information, see the - Python API bindings page. -

    -
    • -
  • - Ruby: Chris Lalancette develops - Ruby bindings. -
    • -
- -

- Integration API modules: -

- -
    -
  • - D-Bus: Pavel Hrdina develops - D-Bus API. -
    • -
- -

- For information on using libvirt on Windows - please see the Windows support page. -

- -

- Support, requests or help for libvirt bindings are welcome on the - mailing list, - as usual try to provide enough background information and make sure - you use recent version, see the help page. -

- - - diff --git a/docs/bindings.rst b/docs/bindings.rst new file mode 100644 index 0000000000..c5b6b94519 --- /dev/null +++ b/docs/bindings.rst @@ -0,0 +1,62 @@ +======================================================== +Bindings for other languages and integration API modules +======================================================== + +.. contents:: + +Libvirt supports C and C++ directly, and has bindings available for +other languages: + +- **C#**: Arnaud Champion develops `C# bindings `__. + +- **Go**: Daniel Berrange develops `Go + bindings `__. + +- **Java**: Daniel Veillard develops `Java bindings `__. + +- **OCaml**: Richard Jones develops `OCaml + bindings `__. + +- **Perl**: Daniel Berrange develops `Perl + bindings `__. + +- **PHP**: Radek Hladik started developing `PHP + bindings `__ in 2010. + + In February 2011 the binding development has been moved to the + libvirt.org website as libvirt-php project. + + The project is now maintained by Michal Novotny and it's heavily + based on Radek's version. For more information, including information + on posting patches to libvirt-php, please refer to the `PHP + bindings `__ site. + +- **Python**: Libvirt's python bindings are split to a separate + `package `__ since version + 1.2.0, older versions came with direct support for the Python + language. + + If your libvirt is installed as packages, rather than compiled by you + from source code, ensure you have the appropriate package installed. + + This is named **libvirt-python** on RHEL/Fedora, + `python-libvirt `__ + on Ubuntu, and may be named differently on others. + + For usage information, see the `Python API bindings `__ + page. + +- **Ruby**: Chris Lalancette develops `Ruby + bindings `__. + +Integration API modules: + +- **D-Bus**: Pavel Hrdina develops `D-Bus API `__. + +For information on using libvirt on **Windows** `please see the Windows +support page `__. + +Support, requests or help for libvirt bindings are welcome on the +`mailing list `__, +as usual try to provide enough background information and make sure you +use recent version, see the `help page `__. diff --git a/docs/meson.build b/docs/meson.build index 4f922864fe..c54d033f48 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -34,7 +34,6 @@ docs_html_in_files = [ '404', 'architecture', 'auth', - 'bindings', 'bugs', 'cgroups', 'compiling', @@ -107,6 +106,7 @@ docs_rst_files = [ 'api', 'apps', 'auditlog', + 'bindings', 'best-practices', 'ci', 'coding-style',