libvirt/docs/libvirt-go.rst
Peter Krempa 9f49f60aca docs: go: Add 'go-import' metadata via rST
The '.. meta::' rST directive allows adding header metadata. Move the
specific metadata from page.xsl into the individual files and pass them
through into the header from page.xsl.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Martin Kletzander <mkletzan@redhat.com>
2023-06-02 09:39:10 +02:00

1.3 KiB

Obsolete libvirt Go Language API (no Go modules)

The obsolete Go package libvirt.org/libvirt-go provided CGo binding from the OS native Libvirt API.

This package is replaced by the new libvirt.org/go/libvirt package in order to switch to using semver and Go modules. Aside from the changed import path and versioning scheme, the new package API is fully compatible with this legacy package.

Software currently using this package will keep working, but no further development will take place. libvirt APIs/constants introduced after 7.4.0 will never be available. Authors are strongly recommended to switch imports to point to the new package, to prepare for future Go toolchains which will mandate Go module support and semver.

In general the Go representation is a direct 1-1 mapping from native API concepts to Go, so the native API documentation should serve as a reference for most behaviour.

For details of Go specific behaviour consult the Go package documentation.