From nobody Sat Feb 24 00:25:54 2024 X-Original-To: ports@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ThSNR43sLz5BZnL for ; Sat, 24 Feb 2024 00:26:15 +0000 (UTC) (envelope-from portmaster@bsdforge.com) Received: from udns.ultimatedns.net (udns.ultimatedns.net [24.113.41.81]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "ultimatedns.net", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ThSNP6r2hz4RpM; Sat, 24 Feb 2024 00:26:13 +0000 (UTC) (envelope-from portmaster@bsdforge.com) Authentication-Results: mx1.freebsd.org; none Received: from ultimatedns.net (localhost [127.0.0.1]) by udns.ultimatedns.net (8.16.1/8.16.1) with ESMTP id 41O0PtmE048371; Fri, 23 Feb 2024 16:26:01 -0800 (PST) (envelope-from portmaster@bsdforge.com) List-Id: Porting software to FreeBSD List-Archive: https://lists.freebsd.org/archives/freebsd-ports List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-ports@freebsd.org X-BeenThere: freebsd-ports@freebsd.org MIME-Version: 1.0 Date: Fri, 23 Feb 2024 16:25:54 -0800 From: Chris To: Gleb Popov Cc: "ports@FreeBSD.org" Subject: Re: Call for help: moving manpages to share/man In-Reply-To: References: User-Agent: UDNSMS/17.0 Message-ID: <9b0f5fcd93ac2a20c49ea77d408b77e9@bsdforge.com> X-Sender: portmaster@bsdforge.com Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Spamd-Bar: ---- X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:11404, ipnet:24.113.0.0/16, country:US] X-Rspamd-Queue-Id: 4ThSNP6r2hz4RpM On 2024-02-23 02:29, Gleb Popov wrote: > On Sun, Jan 21, 2024 at 1:19 PM Gleb Popov wrote: >> >> Ahoy there fellow porters! >> >> 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. >> ... > > 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. > > 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. Thank you for all your hard work so far! In an effort to eliminate duplicate work. I'd like to announce my intention to tackle all of x11. I'd also like to mention pr(1) 276759 addresses the the one port of mine that's in the list. Thanks again! --Chris > > We have an established ways to fix Autotools and CMake-based ports: > - Autotools ports are generally identified by the presence of > GNU_CONFIGURE=yes knob. To fix such a port one should add > GNU_CONFIGURE_MANPREFIX=${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. > > 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. > > Finally, there are ports with homegrown ad-hoc build systems. There is > no general way to fix them. > > 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). > > Thanks in advance to everyone who will help us in this quest. > > [1] https://people.freebsd.org/~bofh/dropzone/manprefix-fail.maintainer.txt