gobject: Mark the gobject bindings as deprecated

They will be removed in libguestfs 1.58 (the next but one version).
Currently they don't actually compile.  The larger problem is that
they don't handle 64 bit quantities properly (using floats instead),
meaning that any disk size or offset above a certain size will be
improperly passed through the API, usually rounded to the nearest
53 bits.

docs/guestfs-recipes.pod

@@ -722,7 +722,6 @@ L<guestfs(3)>,
 L<guestfish(1)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,

docs/guestfs-release-notes-1.56.pod

@@ -47,6 +47,9 @@ the command line I<-n> flag.
 Previously C<-L../lib/.libs> got embedded in the distributed OCaml
 bindings.  This has been fixed.
 
+GObject bindings have been deprecated and will be removed in
+S<libguestfs 1.58>.
+
 =head2 Build changes
 
 json-c is now required.  This replaces Jansson which was previously

erlang/examples/guestfs-erlang.pod

@@ -96,7 +96,6 @@ C<Arg> is the name of the unknown argument.
 
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,

gobject/guestfs-gobject.pod

@@ -2,6 +2,10 @@
 
 guestfs-gobject - How to use libguestfs with the GObject bindings
 
+=head1 DEPRECATED
+
+These bindings are deprecated and will be removed in libguestfs 1.58.
+
 =head1 SYNOPSIS
 
 From Javascript using gjs:

golang/examples/guestfs-golang.pod

@@ -78,7 +78,6 @@ UUIDs are not returned in structures.
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,
 L<guestfs-ocaml(3)>,

java/examples/guestfs-java.pod

@@ -161,7 +161,6 @@ on the class path, as well as the path of your program.  For example:
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-lua(3)>,
 L<guestfs-ocaml(3)>,

lib/guestfs.pod

@@ -1105,13 +1105,6 @@ at the top of F<csharp/Libguestfs.cs>.
 
 See L<guestfs-erlang(3)>.
 
-=item B<GObject>
-
-Experimental GObject bindings (with GObject Introspection support) are
-available.
-
-See L<guestfs-gobject(3)>.
-
 =item B<Go>
 
 See L<guestfs-golang(3)>.
@@ -3202,7 +3195,6 @@ L<guestfs-examples(3)>.
 
 Language bindings:
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,

lua/examples/guestfs-lua.pod

@@ -138,7 +138,6 @@ returned when you registered the callback:
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-ocaml(3)>,

ocaml/examples/guestfs-ocaml.pod

@@ -82,7 +82,6 @@ function that you called.
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,

perl/examples/guestfs-perl.pod

@@ -41,7 +41,6 @@ L<Sys::Guestfs(3)>,
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,

python/examples/guestfs-python.pod

@@ -65,7 +65,6 @@ You can use it like this:
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,

ruby/examples/guestfs-ruby.pod

@@ -36,7 +36,6 @@ string).
 L<guestfs(3)>,
 L<guestfs-examples(3)>,
 L<guestfs-erlang(3)>,
-L<guestfs-gobject(3)>,
 L<guestfs-golang(3)>,
 L<guestfs-java(3)>,
 L<guestfs-lua(3)>,