[Pkg-xmpp-devel] Bug#1072482: dino-im: manpage missing, no proxy docs

[Manny]

Package: dino-im
Version: 0.4.2-1
Severity: minor
X-Debbugs-Cc: contact at dino.im, debbug.dino-im at sideload.33mail.com

There is no man page. There is a /usr/share/doc/dino-im/README.md but
it contains no user guide. From the Debian Policy Manual¹:

  “If no manual page is available, this is considered as a bug and
   should be reported to the Debian Bug Tracking System (the maintainer
   of the package is allowed to write this bug report themselves, if
   they so desire). Do not close the bug report until a proper man page
   is available.”

¹ https://www.debian.org/doc/debian-policy/ch-docs.html

The best place to fix this is upstream. But I did not tag this bug
report as upstream because lack of manpage may or may not be
considered a bug upstream, yet nonetheless it is a bug in the Debian
scope. The upstream devs have been CC’d, hopefully.

What I was expecting to find in the man page is a way to configure a
proxy. AFAICT, there are no docs or user guides for dino-im
anywhere. The only information is in the Github bug reports and the
code.

This comment states that dino respects systemwide proxy settings:

  https://github.com/dino/dino/issues/1103#issuecomment-908595528

But it does not state /how/ dino obtains those settings from the
system. In principle, by convention, it should look at the http_proxy
and https_proxy environment variables, which would appear in an
“ENVIRONMENT” section of the man page.

According to this comment:

  https://github.com/dino/dino/issues/342#issuecomment-384610205

Dino works with proxychains. I believe proxychains is the same as
torsocks in terms of what it does and how it works. This comment seems
to imply torsocks works with dino-im:

  https://github.com/dino/dino/issues/567#issuecomment-555233336

This comment mentions using dconf (which is an overloaded word between
gnome and debian projects and deprecated in Debian). The coment also
says that dino is deliberately designed not to support any proxies:

  https://github.com/dino/dino/issues/342#issuecomment-385427600

So apparently the only way to proxy dino is to intercept systems
calls, IIUC, which is a big hackish IMO. All this confusion from
people in the bug tracker reinforces the need for a man page. Ideally
the man page would explicitly state that proxy support is not offered,
but that proxychains and torsocks works. Or if mentioning the absence
of an option is regarded as excessively verbose for a man page, even
the mere presence of a man page with no options (apart from maybe -h
to print itself) would at least signal to users that the proxy options
are likely non-existent.

-- System Information:
Debian Release: 12.5
  APT prefers stable-updates
  APT policy: (990, 'stable-updates'), (990, 'stable-security'), (990, 'stable'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.10.0-28-amd64 (SMP w/2 CPU threads)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.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

Versions of packages dino-im depends on:
ii  dino-im-common                  0.4.2-1
ii  libadwaita-1-0                  1.2.2-1
ii  libc6                           2.36-9+deb12u7
ii  libcairo2                       1.16.0-7
ii  libgcc-s1                       12.2.0-14
ii  libgcrypt20                     1.10.1-3
ii  libgdk-pixbuf-2.0-0             2.42.10+dfsg-1+b1
ii  libgee-0.8-2                    0.20.6-1
ii  libglib2.0-0                    2.74.6-2+deb12u2
ii  libgnutls30                     3.7.9-2+deb12u2
ii  libgpgme11                      1.18.0-3+b1
ii  libgraphene-1.0-0               1.10.8-1
ii  libgstreamer-plugins-base1.0-0  1.22.0-3+deb12u1
ii  libgstreamer1.0-0               1.22.0-2
ii  libgtk-4-1                      4.8.3+ds-2+deb12u1
ii  libgtk-4-media-gstreamer        4.8.3+ds-2+deb12u1
ii  libicu72                        72.1-3
ii  libnice10                       0.1.21-1
ii  libpango-1.0-0                  1.50.12+ds-1
ii  libqrencode4                    4.1.1-1
ii  libsignal-protocol-c2.3.2       2.3.3-3
ii  libsoup-3.0-0                   3.2.2-2
ii  libsqlite3-0                    3.40.1-2
ii  libsrtp2-1                      2.5.0-3
ii  libstdc++6                      12.2.0-14
ii  libwebrtc-audio-processing1     0.3-1+b1

Versions of packages dino-im recommends:
ii  ca-certificates         20230311
ii  dbus                    1.14.10-1~deb12u1
ii  fonts-noto-color-emoji  2.042-0+deb12u1
ii  network-manager         1.42.4-1

dino-im suggests no packages.

-- no debconf information