Summary: | Some port manual pages include version number in filename, breaking intuitive man use | ||
---|---|---|---|
Product: | Ports & Packages | Reporter: | freebsd |
Component: | Individual Port(s) | Assignee: | freebsd-ports-bugs (Nobody) <ports-bugs> |
Status: | Open --- | ||
Severity: | Affects Some People | CC: | cem, cy, gnome, jhale, koobs, multimedia, ports-bugs, tijl, w.schwarzenfeld |
Priority: | --- | Keywords: | needs-qa |
Version: | Latest | ||
Hardware: | Any | ||
OS: | Any |
Description
freebsd
2018-03-19 16:31:25 UTC
For me, 'man autoconf<tab>' tab-completes to autoconf-2.69. However, I can see it as a nuisance. I think the right thing to do is get the ports to install unversioned man pages -- either as links or just renaming any versioned page. The idea to automatically detect such issues in ports is not a bad one either, but it does seem rare enough that maybe we can just fix problems when people complain. Anyway -- I don't have a ports bit so I can't really help with those parts. This do not belong to portmgr, but rather to individual port maintainer. which should be contacted on the case per case basis. (In reply to Baptiste Daroussin from comment #2) What are our thoughts on adding a ports sanity check for version-suffixed man pages? That would help to highlight issues during ports QA I don't think this bug will progress without someone dedicated to identifying all ports with this issue and opening separate bugs for them. The least we can do at a framework level, if that's possible, is to highlight it if we can, and if it's something we agree should happen, ie: un-version-suffixed man pages CC'd maintainer: gnome for enchant, gconf and gimp multimedia for gstreamer1 and gstreamer fox16 for reswrap and shutterbug tijl for automake and autoconf cy for fvwm (In reply to freebsd from comment #0) > I don't have all that many installed, so I have no idea what the > extent of the problem is I guess mostly the Makefile or Makefile.in files. example for autoconf: +--- man/Makefile.in.orig 2019-09-06 16:15:02 UTC ++++ man/Makefile.in +@@ -252,9 +252,7 @@ install-man1: $(dist_man_MANS) + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ i=> +- sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ i=> +- -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ =>+- sed 'N;N;s,\n, ,g' | { \ ++ { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ (needs pkg-plist change) or automake ---- Makefile.in.orig 2018-03-11 21:21:08 UTC +--- Makefile.in.orig 2019-09-06 16:48:14 UTC +++ Makefile.in -@@ -3690,9 +3690,9 @@ doc/aclocal.1 doc/automake.1: +@@ -2735,9 +2735,7 @@ install-man1: $(man1_MANS) + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ => +- sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ => +- -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ => +- sed 'N;N;s,\n, ,g' | { \ ++ { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ +@@ -3690,9 +3688,9 @@ doc/aclocal.1 doc/automake.1: && echo ".so man1/$$f-$(APIVERSION).1" > $@ doc/aclocal-$(APIVERSION).1: $(aclocal_script) lib/Automake/Config.pm (needs no pkg-plist change) The sed commands "transform" e.g. autoconf.1 to autoconf-2.69.1. (In reply to Walter Schwarzenfeld from comment #4) Are enchant and gstreamer relevant to this issue? You can install both enchant (1.x) and enchant2 (2.x) on the same system, so it should be expected for enchant2 to install versioned man pages. You can install both gstreamer (0.10.x) and gstreamer1 (1.x), too. For the gimp case, I think you mean gimptool-2.0.1.gz. Since there is no unversioned gimptool command, it is expected for gimp-app to install only the versioned man page for it. (In reply to Walter Schwarzenfeld from comment #5) automake already installs unversioned man pages, so it needs no change for this issue. You are right with enchant and automake. But no of the gst-* manpages work. |