From nobody Sat Feb 24 10:05:17 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 4ThjDn2sC7z5CSt4 for ; Sat, 24 Feb 2024 10:05:29 +0000 (UTC) (envelope-from junchoon@dec.sakura.ne.jp) Received: from www121.sakura.ne.jp (www121.sakura.ne.jp [153.125.133.21]) (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 did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4ThjDm5b9Cz4Zrx; Sat, 24 Feb 2024 10:05:28 +0000 (UTC) (envelope-from junchoon@dec.sakura.ne.jp) Authentication-Results: mx1.freebsd.org; none Received: from kalamity.joker.local (123-1-21-232.area1b.commufa.jp [123.1.21.232]) (authenticated bits=0) by www121.sakura.ne.jp (8.17.1/8.17.1/[SAKURA-WEB]/20201212) with ESMTPA id 41OA5IcP082812; Sat, 24 Feb 2024 19:05:18 +0900 (JST) (envelope-from junchoon@dec.sakura.ne.jp) Date: Sat, 24 Feb 2024 19:05:17 +0900 From: Tomoaki AOKI To: Gleb Popov Cc: "ports@FreeBSD.org" Subject: Re: Call for help: moving manpages to share/man Message-Id: <20240224190517.204fa1055412ea673267d92d@dec.sakura.ne.jp> In-Reply-To: References: Organization: Junchoon corps X-Mailer: Sylpheed 3.7.0 (GTK+ 2.24.33; amd64-portbld-freebsd14.0) 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 Content-Type: text/plain; charset=UTF-8 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:7684, ipnet:153.125.128.0/18, country:JP] X-Rspamd-Queue-Id: 4ThjDm5b9Cz4Zrx On Fri, 23 Feb 2024 13:29:48 +0300 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. > > 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 FYI: Not-yet-obsoleted patches uploaded at Bug 277028 [2] include fix for relocating manpage under /usr/local/man/ into /usr/local/share/man/. Both version of patches are monolithic patches including updates for multiple related ports. The update for relocation was not trivial, but fortunately, not interferring other changes, so I can cut out the changes from others easily, if required. As I'm not a maintainer of any updated ports, not a committer, and not an insider of nvidia, so whether or not the fix is committed as-is is on maintainers of each 3 ports. [2] https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=277028 -- Tomoaki AOKI