Source: grpcio
Severity: wishlist

Hello Laszlo,

could you please provide also a -doc package for the python3-grpcio
package?
Most of such package are named in the DPT in a way that the name for the
additional package would be here python-grpcio-doc and contain the HTML
documentation in the folder

/usr/share/doc/$(package_name)/html

For example

https://packages.debian.org/sid/all/python-werkzeug-doc/filelist

The advantage of such packages is we can use the object.inv files from
these packages while building other -doc packages so we have a usefull
interlinking between the documentations. This requires the other linked
to packages are installed on the system of course.

I will try to provide some patches or a MR to src:grpcio so the new
package could be added more easily.

The Sphinx based documentation can be found upstream here:

https://github.com/grpc/grpc/tree/master/doc/python/sphinx

Regards & Thanks
Carsten

PS: I'm sitting right now on preparing some Python OpenTelemetry
packages and here python3-grpcio is needed as a binary dependency and
the object.inv file from the documentation under
https://grpc.github.io/grpc/python/ is used in the docu.

-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 6.12.12-amd64 (SMP w/12 CPU threads; PREEMPT)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Reply via email to