[Bug 1893513] Re: man page of lsof command broken

[Eric Desrochers]

[Regressions Focal]

# Pending SRU page:
lsof
Regression in autopkgtest for gvfs (arm64): test log

# Autopkgtest gvfs [focal/arm64]
1.44.1-1ubuntu1	lsof/4.93.2+dfsg-1ubuntu0.20.04.1	2021-01-08 17:10:35 UTC	0h 13m 34s	slashd	fail	log   artifacts   ♻

I ran the test 3 times and it fails all the time.

It also failed with the previous version just right before this SRU:

1.42.2-1ubuntu3 lsof/4.93.2+dfsg-1 2020-02-02 08:23:53 UTC 3h 03m 42s -
fail log   artifacts   ♻

and this change only affect manpage, so this test failure can be ignored
since we are not touching lsof code here and it the failure was also
ignore back then.

- Eric

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to lsof in Ubuntu.
https://bugs.launchpad.net/bugs/1893513

Title:
  man page of lsof command broken

Status in lsof package in Ubuntu:
  Fix Released
Status in lsof source package in Focal:
  Fix Committed
Status in lsof source package in Groovy:
  Fix Committed
Status in lsof source package in Hirsute:
  Fix Released
Status in lsof package in Debian:
  New

Bug description:
  [Impact]
  One cannot consult the 'lsof' manpage in various ways:
  * Using CLI: man lsof
  * Ubuntu Manpage: http://manpages.ubuntu.com/cgi-bin/search.py?q=lsof

  You will notice the manpage is missing for F and G.

  Workarounds would be:

  * Use '--help' parameter
  * Use a search engine to find an 'lsof' online man page.

  This has been first introduced with the new upstream release of
  '4.93.2+dfsg-1'.

   lsof | 4.93.2+dfsg-1       | focal
   lsof | 4.93.2+dfsg-1       | groovy

  [Test Case]

   == CLI ==
  * On an F/G system, perform "man lsof"

  It will errors out as follows:
  "
  man: can't open /usr/share/man/./version: No such file or directory
  No manual entry for lsof
  "

   == Ubuntu Manpage ==
  * Browse the Ubuntu Manpage:
  http://manpages.ubuntu.com/cgi-bin/search.py?q=lsof

  No 'lsof' manpage is found for F/G.

  [Where problem could occur]

  If a problem arise, it will only affect the lsof manpage.

  The fix adds a build dependency 'groff-base'[0] that is found in
  'main' for all affected release above and pretty much at the same
  level of code base.

  debian:
   groff-base | 1.22.4-5      | unstable

  ubuntu:
   groff-base | 1.22.4-4build1 | focal
   groff-base | 1.22.4-5       | groovy
   groff-base | 1.22.4-5       | hirsute

  [0] - https://www.gnu.org/software/groff/manual/groff.html#man

  [Other info]

  In theory, I would possibly wait for the next bug fixing SRU as an
  opportunity to merge that change, but according to the d/changelog,
  there is not much frequent SRU(s) done for 'lsof', so we might have to
  just fix 'lsof' for this particular case which can be an annoyance for
  certain Ubuntu users.

  The package has been fixed in Debian upstream '4.93.2+dfsg-1.1' and
  auto-synced in Hirsute. It is now needing an SRU for F/G.

  Debian bug:
  https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=950601

  [Original Description]

  When trying to view the manpage of lsof, this happens:

  desktop ~ $ LANG=C man lsof
  man: can't open /usr/share/man/./version: No such file or directory
  No manual entry for lsof

  The man page is present at /usr/share/man/man8/lsof.8.gz.

  This:  zless /usr/share/man/man8/lsof.8.gz
  reveals that there is the line ".so ./version" at the beginning, with the  file "version" not existing.

  Other man pages don't seem to be affected.

  ProblemType: Bug
  DistroRelease: Ubuntu 20.04
  Package: lsof 4.93.2+dfsg-1
  ProcVersionSignature: Ubuntu 5.4.0-42.46-generic 5.4.44
  Uname: Linux 5.4.0-42-generic x86_64
  ApportVersion: 2.20.11-0ubuntu27.8
  Architecture: amd64
  CasperMD5CheckResult: skip
  CurrentDesktop: ubuntu:GNOME
  Date: Sat Aug 29 13:50:47 2020
  InstallationDate: Installed on 2020-08-03 (26 days ago)
  InstallationMedia: Ubuntu 20.04 LTS "Focal Fossa" - Release amd64 (20200423)
  ProcEnviron:
   TERM=xterm
   PATH=(custom, no user)
   XDG_RUNTIME_DIR=<set>
   LANG=de_DE.UTF-8
   SHELL=/bin/bash
  SourcePackage: lsof
  UpgradeStatus: No upgrade log present (probably fresh install)

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/lsof/+bug/1893513/+subscriptions