[PATCH 5/9] docs: Add sub-page for all golang modules

[Daniel P. Berrangé]

On Tue, Feb 14, 2023 at 10:51:13PM +0100, Peter Krempa wrote:
> Our documentation has pages for 4 go modules, 2 current and 2 obsolete
> ones, but points only to one of them and directly to golang's docs page.
> 
> Add a sub-page where all 4 sub-pages for the modules are linked.
> 
> Signed-off-by: Peter Krempa <pkrempa at redhat.com>
> ---
>  docs/docs.rst    |  2 +-
>  docs/golang.rst  | 21 +++++++++++++++++++++
>  docs/meson.build |  1 +
>  3 files changed, 23 insertions(+), 1 deletion(-)
>  create mode 100644 docs/golang.rst



> diff --git a/docs/golang.rst b/docs/golang.rst
> new file mode 100644
> index 0000000000..77821cee24
> --- /dev/null
> +++ b/docs/golang.rst
> @@ -0,0 +1,21 @@
> +====================
> +Go Language bindings
> +====================
> +
> +Modern libvirt API bindings with Go modules
> +-------------------------------------------
> +
> +The libvirt API bindings package and module for XML manipulation:
> +
> + - `libvirt.org/go/libvirt <go/libvirt.html>`__ package https://pkg.go.dev/libvirt.org/go/libvirt
> + - `libvirt.org/go/libvirtxml <go/libvirtxml.html>`__ package https://pkg.go.dev/libvirt.org/go/libvirtxml
> +
> +
> +Obsolete libvirt language bindings
> +----------------------------------
> +
> +The following two go packages were superseded, but software currently using them

Missing words at the end

> +No further development will take place.
> +
> + - `libvirt.org/libvirt-go <libvirt-go.html>`__ - CGo binding to the native API
> + - `libvirt.org/libvirt-go-xml <libvirt-go-xml.html>`)) - annotated Go struct definitions for XML handling

If that above is fixed in some obvious manner

  Reviewed-by: Daniel P. Berrangé <berrange at redhat.com>


With regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|