Date: Mon, 26 Feb 2024 08:04:26 +0100 From: Moin Rahman <bofh@freebsd.org> To: "ports@FreeBSD.org" <ports@freebsd.org> Cc: Gleb Popov <arrowd@freebsd.org> Subject: Re: Call for help: moving manpages to share/man Message-ID: <1B813C75-BE57-4A78-AB92-E63FA4B57CFE@freebsd.org> In-Reply-To: <CALH631nfXW%2BhQ%2Bzm6Czm_Ag_pZEHuvHAr3ZJMFU0_0c8OV9vvg@mail.gmail.com> References: <CALH631=312%2Bz8-1Gr32gZL_X3QduNCiMEyM3ZOwvqmAh6eRW7A@mail.gmail.com> <CALH631nfXW%2BhQ%2Bzm6Czm_Ag_pZEHuvHAr3ZJMFU0_0c8OV9vvg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--Apple-Mail=_7E0773C1-EBA2-4CB5-9520-2300DD180C57
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
charset=utf-8
> On Feb 23, 2024, at 11:29 AM, Gleb Popov <arrowd@freebsd.org> wrote:
>=20
> On Sun, Jan 21, 2024 at 1:19=E2=80=AFPM Gleb Popov =
<arrowd@freebsd.org> wrote:
>>=20
>> Ahoy there fellow porters!
>>=20
>> portmgr@ is currently working on switching the directory into which
>> man pages are installed from "${PREFIX}/man" to =
"${PREFIX}/share/man".
>> It is quite a tedious process, as you might imagine.
>> ...
>=20
> It's been a month since the initial call was made. Despite the fact
> that the separate branch approach didn't really work out, the process
> of moving manpages to share/man is still ongoing. I'd like to thank
> everyone who sent me PRs and plain patches - they were all integrated
> into the main branch and all were helpful for our cause.
>=20
> Still, there is a lot more to process, so I'm making another call for
> help, hopefully more concrete this time.
> moin@ created a list of problematic ports [1] along with MAINTAINER
> field, so you can quickly find if any of your ports need fixing. In
> this list "failed" ports are confirmed to be broken if we change the
> default mandir prefix in the framework. The "skipped" ports may
> probably be dependent on the "failed" ones, so it is better to deal
> with "failed" first.
>=20
> We have an established ways to fix Autotools and CMake-based ports:
> - Autotools ports are generally identified by the presence of
> GNU_CONFIGURE=3Dyes knob. To fix such a port one should add
> GNU_CONFIGURE_MANPREFIX=3D${PREFIX}/share knob and fix pkg-plist.
> - CMake already defaults to a correct mandir location, so CMake ports
> usually have some patching that replaces share/man with man. To fix
> such ports it is sufficient to remove that patching and then again fix
> the plist.
>=20
> We don't yet care of Meson ports (although it also should be as simple
> as the Autotools case). Feel free to skip them for now.
>=20
> Finally, there are ports with homegrown ad-hoc build systems. There is
> no general way to fix them.
>=20
> When making a mandir-converting change remember to put "Approved by:
> portmgr (blanket)" tag into the commit message. This also means that
> if you're fixing someone else's port, you don't need to wait for a
> maintainer timeout (although it might be still a good idea to wait for
> the feedback if the port in question is complex or the change itself
> is big).
>=20
> Thanks in advance to everyone who will help us in this quest.
>=20
> [1] =
https://people.freebsd.org/~bofh/dropzone/manprefix-fail.maintainer.txt
>=20
Some of you reached me mentioning that their ports are mentioned in
skipped list and those ports don't have any man pages at all.
Sorry for the confusion. But let me iterate on how I am fixing things.
I started with a fresh ports tree with share/man as the only
place for manpages. And while others are fixing the tree and committing
my build system is just taking the last failed and skipped list to
build and check the next set of remaining ports. So there might be
some ports which are false positives. If that is the case please
send me a mail with your ports which do not have any man pages at
all so that I can manually remove that.
And sorry for the spams. But we are very close to what we planned
to achieve.
Kind regards,
Moin
--Apple-Mail=_7E0773C1-EBA2-4CB5-9520-2300DD180C57
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
filename=signature.asc
Content-Type: application/pgp-signature;
name=signature.asc
Content-Description: Message signed with OpenPGP
-----BEGIN PGP SIGNATURE-----
iQKTBAEBCgB9FiEETfdREoUGjQZKBS+fvbm1phfAvJEFAmXcN/pfFIAAAAAALgAo
aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDRE
Rjc1MTEyODUwNjhEMDY0QTA1MkY5RkJEQjlCNUE2MTdDMEJDOTEACgkQvbm1phfA
vJG8+g/9G/HvLGnzGTwPUIsYG7fBKh3K50fuzuNKnCCtFZtGgGkd3QRXZnYVoHZx
dwsNavfB3VN7SEHsm5VqGpzV6oavL0PQ71kfBSDUApGzvlaPiWXGbsWHu7soRVbP
msVUjSuru/uuAJojXdsbG4S9iTBOlHpkvB8zcyrVPlWebcHiTBHsVJEey8yL4z63
6l2A7jtdw1Z3BevEK3uhHtYcidenTUspih2F61xjiil3KnJ/656XzUrwZne3rJ4Z
f6WB4XJ2IdsctNRpFJXUI2uuH3tajc/Qx6oVnpMWD+Z5zCgaWtPoJuQTP/qwmfL+
Gm4ovAVw/PqnhgFmxgA3jNKl2RhPEOlLaswXH/8ZcyPoAfDAioCM04GGLje3OOcT
t+76891ZnCtHynId1BPHLX4UMM95a5qiSWZiyZrn6N+Tphg3m9qyeQFUt0I9/1c0
YZhZhVNqOJFNbdGFpyM09BEvfyFtNi3GGQkV2i/e0px8oK1k1zJdfgQDNagUoB7Y
AjhyMblIR9YUZl/0JfF/BNp4VcRk+/6lMDwyjm4M4hCHZcTAqwi3ePfAcO0ig8WG
9LaJtjCo6CZij1uPusiakrWlvbMslR9z4pTER77r1yCCW8mFBxrQi/Sa5dtgkcgC
l8w3akksCtsKldVhngGqVE7j6I41qVvit9B3qRGBmKpWpGk0dAA=
=b1Z0
-----END PGP SIGNATURE-----
--Apple-Mail=_7E0773C1-EBA2-4CB5-9520-2300DD180C57--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1B813C75-BE57-4A78-AB92-E63FA4B57CFE>