#1031422 gnumeric: Included documentation of python use in gnumeric is incorrect

Package:
gnumeric
Source:
gnumeric
Description:
spreadsheet application for GNOME - main program
Submitter:
Alex King
Date:
2023-02-16 23:03:04 UTC
Severity:
normal
#1031422#5
Date:
2023-02-16 21:54:20 UTC
From:
To:
Dear Maintainer,

I was looking to do some python scripting in gnumeric.

I checked the documentation (in the gnumeric-doc package in bullseye) for
how to do it.  In "The Python Console" section of the documentation, it
mentions editing a file in ~/.gnumeric/$version/plugins/.  This doesn't
exist.  It appears this type of configuration is now in dconf instead.

Under the "Installing and Building Gnumeric for Python" section, it is
mentioned to "apt-get install gnumeric gnumeric-python python".
gnumeric-python does not exist in the archive, and likely the bulk of these
instructons are obselete since the transition to python3.

It would be nice to have instructons that tell me how to use python3 with
gnumeric.  If that isn't available (a google search didn't turn up much
promising), at least the obsolete stuff should be removed from the
documentation.

I downloaded the testing version of gnumeric (gnumeric_1.12.55-1), and
looked in /usr/share/doc/gnumeric/README.Debian (it has not changed since
stable).  It includes the obsolete text:

Q: Where is the <foo> plugin?
A: Plugins that require additional libraries or programs are packaged
   separately (e.g. "gnumeric-python"). Do "apt-cache search gnumeric" to
   find them.

As already mentioned, the gnumeric-python package no longer exists, and the
only relevant plugins package seems to be gnumeric-plugins-extra.

It would be better if the obsolete documentation was removed.

It would be ideal if it were possible to use python3 with gnumeric, and if
instructions for doing so were included in a README.

Thanks,
Alex