On Sun, Sep 03, 2023 at 04:19:07PM +0100, Stefan Hagen wrote: > Marc Espie wrote (2023-09-01 22:08 IST): > > On Thu, Aug 31, 2023 at 11:20:17PM +0200, Ingo Schwarze wrote: > > > Hi Stefan, > > > > > > Stefan Hagen wrote on Wed, Aug 30, 2023 at 09:41:20AM +0200: > > > > > > > There's no good way to handle a conflict that's introduced with an > > > > update. So what we would do is to move the manpages into the install > > > > directory. (thanks to espie@ for the suggestion) > > > > > > Actually, i regard that as bad advice, espie@ shouldn't say such things. > > > > I don't know. The ability of install versioned manpages for the same > > software doesn't seem to be a bad idea to me. > > > > And /etc/man.conf does feature new default paths, so why not ? > > > > If adding new directories isn't the right level, maybe new sections ? > > or explicit versionned stuff. > > > > Yeah, we've installed several versions of tcl for a long time. > > > > Oh, and man has a "-a" option to display ALL manual pages. > > > > We have currently ZERO mechanism to desambiguate anything outside of > > sections... > > > > if you say, man foo, it will give you the first foo, not even hinting > > there might be a second food behind it. > > > > Yeah, we can rename stuff so that man doesn't get confused, but why > > does man get confused in the first place ? > > I think Espies suggestion is more discoverable because the user gets a > message on install he might see. > > Ingos suggestion is technically "more correct". However, I asked 6 devs > and only one knew what -a/w does. So I don't think this is used. > > From a user perspective, I think it would be nice if we cold make the > manpage display a tiny bit dynamic and show the output of man -w at the > bottom. > > Example.... > > MANPAGE VERSIONS: > fvwm3-FvwmButtons(1), FvwmButtons(1) > > This would bring discoverability to Ingos solution. And we could freely > rename manpages, because our man(1) is clever enough to find them > anyway. (compared to linux man, which can't do this) > > Another idea would be to print something to stderr when more than one > manpage for the search term is available. Either before the pager is > started or after the pager is closed. > > I don't like what some linuxes do: SuSE for example shows the user a > list and asks which one to display. This is annoying. > > --- > > I'm sending another diff with Ingos suggestion. I'm happy with this as > well. Both is inconvenient in a way, but at least the man pages are > there. > > OK? > > - Stefan
Hi Stefan and everyone else involved, thanks for all the feedback and explanations! The latest revision by Stefan looks good to me, tested on amd64.
