Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 25 Nov 2021 09:14:58 -0600
From:      Kyle Evans <kevans91@ksu.edu>
To:        Andriy Gapon <avg@freebsd.org>
Cc:        Baptiste Daroussin <bapt@freebsd.org>, =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= <fernape@freebsd.org>,  Ed Maste <emaste@freebsd.org>, src-committers <src-committers@freebsd.org>,  "<dev-commits-src-all@freebsd.org>" <dev-commits-src-all@freebsd.org>, dev-commits-src-main@freebsd.org
Subject:   Re: git: 0a0f7486413c - main - man: Build manpages for all architectures
Message-ID:  <CACNAnaHrps0-DL0BdM4C0KqoxasrdbBumS20P=L3HQ5yU=KHGA@mail.gmail.com>
In-Reply-To: <9226a616-d279-9702-f13f-cee7299afc7a@FreeBSD.org>
References:  <202106300806.15U86pGq037942@gitrepo.freebsd.org> <20210706090311.aomxh4n45tkpktdc@aniel.nours.eu> <c272868f-8552-d914-9d63-32a4af8e51ce@FreeBSD.org> <20211125142339.zxkjpbohkxk4hete@aniel.nours.eu> <9226a616-d279-9702-f13f-cee7299afc7a@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Nov 25, 2021 at 8:30 AM Andriy Gapon <avg@freebsd.org> wrote:
>
> On 25/11/2021 16:23, Baptiste Daroussin wrote:
>  > On Thu, Nov 25, 2021 at 03:57:41PM +0200, Andriy Gapon wrote:
> >> Looking at the output I got another thought: do we need architecture sub-dir
> >> links at all now that we install manpages to a main directory?
> >> Is there any benefit to having the same manpage in a directory (like man4)
> >> and its immediate subdirectory (like man4/arm) ?
> >>
> > Hardlink not in the same directory is imho a fragile setup anyway, what if a
> > user has different mount points here, the hardlink would be broken. while there
> > is little chances someone is doing that, history told me people are doing weird
> > things and if they haven't yet, they will soon.
> >
> > I continue to think this kind of links should be 1/ symlinks, 2/ relative
> > symlinks if they are in a situation which can become a cross device issue.
>
> Yeah... but are they needed at all? :-)
>

It's handy in the sense that it'd be nice to install all arch manpages
on some machines, e.g., I develop arm stuff on amd64 and there are
some drivers that simply aren't applicable to amd64, I'd like to be
able to find those. I think the implementation is a bit odd, though,
leading into:

> I mean, whichever way we install manpages they are always installed into manX.
> I do not see a point / benefit of having another copy / link / whatever in
> manX/arch.
>

I guess I haven't read the context much here, but I don't see why
either. /usr/bin/man's built-in search behavior checks
$mandir/$machine and $mandir/$machine_arch before $mandir, it seems
like we should be leaving them there and letting man do its thing. If
you need a non-native arch then you can hopefully just poke around the
arch subdirs (presumably mostly section 4 pages) to figure it out.
There's a reason they're arch subdirs, and trying to install links or
arch-specific pages into the main $mandir is asking for trouble when
we actually have conflicting pages for whatever reason between archs.

Thanks,

Kyle Evans



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CACNAnaHrps0-DL0BdM4C0KqoxasrdbBumS20P=L3HQ5yU=KHGA>