From nobody Sun Aug 18 05:47:06 2024 X-Original-To: dev-commits-ports-main@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 4Wml9W4QDWz5SQHg; Sun, 18 Aug 2024 05:47:11 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Wml9W3m3Qz5485; Sun, 18 Aug 2024 05:47:11 +0000 (UTC) (envelope-from mat@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1723960031; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=gZxWmGghYffLGTjVFMrjTquYFTT+nvIhhm9KWo/JT/k=; b=wKvUdIZYzFRF5TLXQAs7xVMA8xOO/wtRgrIy+23wgThLwO0mb1yNO7jlbp0jNErEK0EQ0i QRSotxN0sGqaMeJnPZ0mQqJI8pzbKuEQNEXpWUEf9IOO4AleW9Zu1EPiCT4uUZ6YjvHQBK deE4uoy7wHjoYQmB+OqrXKcn9dAzyz7Lsna+zoQ2/1Ij3rd8mbse6XZ6J+q+fV/Wg/7KBB QCAfWkyLn+z12bjGo7OfF3BWYL0zoAWbyQhIFWamfk50yC+UI5hyySrkp2ho2x36sKpHKY j2q8qvnvvV5mzGL9aNZ5Xo5t5z8J4tmASI35iCWdACcbWZi/N9RRDgHaE8lITg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1723960031; a=rsa-sha256; cv=none; b=u2khOSZ5gkuGrBECiev/0ipPqXIWROPv8x/1Bu0ee/dOVsjckAfIaz/n+Zl1mq6zfYtAGL tNVaVWun8BsGdX/ZynoIUyS70gPS0hvqg6HqjwLg/K8r6vENQAs4Jf5XOzsNoa+WBuOvFb uQKz9RAwDSxcuKwrqlNa+W9dxxrsMK8AuVx+FrFEIfig0kRcs4mG7aZkAVsQrWSILK3411 2wf8l018M8hpdmfywMhzSMxqOogTxb19gRh0BZqOkZRqyN+BB0j9nwA7/mY3ydSrgDIHd7 ECuE/3Lu7TNE7Z0lPXXbzktt7OPKIfPPWRPDkZC5BkpeSJxFziW/qBLaLVU8Ow== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1723960031; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=gZxWmGghYffLGTjVFMrjTquYFTT+nvIhhm9KWo/JT/k=; b=YxNHeJU92k8PClHdUMEM4Jkkeov39sc1GSWLQ3XMIpF1QETYMuXlNBg7jwfnOclGQ+I4r+ gRTBqYqDX+WBtNRyk00wcl/ELk0Xm7gfML0s5pgeYovSHLlCjTll2IzoCho+bznB01qRla idYWkgjcdY3Z8OnZJuc0m9MqI2ZnYfTwEInZ1dx8gA7SFh12qRFMP4HO6LVVocOosEvwQ6 ptRv/yZ+5VC4GVArpm4OOiU/bOJWvfz0FrNmunlLwnvtIe4JdmgbjiJTTN3CvfukkDFEsV c8T+5f50zZU0QwwHo0TAruXH/5aoVoSykqxP6mJJLpvX1k6aHPGa7OkYMggj1Q== Received: from relay.mat.cc (cow.mat.cc [79.143.244.49]) (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 "cow.mat.cc", Issuer "R11" (verified OK)) (Authenticated sender: mat/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4Wml9W2f84z162N; Sun, 18 Aug 2024 05:47:11 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:e0a:836:f670:5eef:3468:1f2d:687f]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by relay.mat.cc (Postfix) with ESMTPSA id EBF811FEC0; Sun, 18 Aug 2024 07:47:08 +0200 (CEST) Date: Sun, 18 Aug 2024 07:47:06 +0200 From: Mathieu Arnold To: Gleb Popov Cc: Nicola Vitale , Nicola Vitale , ports-committers@freebsd.org, dev-commits-ports-all@freebsd.org, dev-commits-ports-main@freebsd.org Subject: Re: git: d191d48e545e - main - x11/kitty: Fix pkg-plist when DOCS option is off Message-ID: References: <202408170839.47H8d1f6010111@gitrepo.freebsd.org> <7ad037a5-a92c-455e-b54c-9287e4fe5749@gmail.com> List-Id: Commits to the main branch of the FreeBSD ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-ports-main@freebsd.org Sender: owner-dev-commits-ports-main@FreeBSD.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="ybfu7hpntxcdfi3s" Content-Disposition: inline In-Reply-To: --ybfu7hpntxcdfi3s Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Aug 17, 2024 at 11:57:53PM GMT, Gleb Popov wrote: > On Sat, Aug 17, 2024 at 4:41=E2=80=AFPM Nicola Vitale > wrote: > > > > Hi, > > > > thanks for the advice, but [1] the option MANPAGES is not present in th= e Porter's Handbook, and the section 5.12 (Man pages) says only that "manua= l pages must be placed in pkg-plist along with the rest of the files". This= distinction between man pages and other docs is misleading in my opinion. = "What are docs?" [2] > > > > Furthermore, x11/kitty is not the only one that uses %%PORTDOCS%%/share= /man in pkg-plist, and NO_INSTALL_MANPAGES was removed a long time ago. >=20 > Hum, it looks you're right. The `portgrep -o MANPAGES | wc -l` gives > only 204. It seems that MANPAGES option is indeed getting demoted. Well, not at all. Man pages have to always be installed when they are present in the distfiles. The MANPAGES option is only present when man pages need to be generated during the build, and the maintainer decided the tools needed were heavy and that it should be possible to disable building the man pages. (For example, you need doxygen, or some other big tool) > > [1] I don't remember swearing allegiance to the Porter's Handb...Bible.= ;-) >=20 > I believe, every Ports committer has to follow Porter's Handbook. Let > portmgr@ correct me if I'm wrong. You are correct, every ports committer must follow the porter's handbook. It defines a set of rules and guidelines that we all must follow so that all ports are written in the same way, and anyone can work on any port. You don't have to swear allegiance on it, it is a packaged deal, you become a committer, so you have to follow its rules, it's not optional. --=20 Mathieu Arnold --ybfu7hpntxcdfi3s Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQITBAABCgB9FiEE9XJBpJetWizkEBUef2IOCp6dQb4FAmbBithfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldEY1 NzI0MUE0OTdBRDVBMkNFNDEwMTUxRTdGNjIwRTBBOUU5RDQxQkUACgkQf2IOCp6d Qb6xUQv+JS3HCHCCyxjiA1eCXiFgdfbqVOvQFoCqji61sQeRrvrkZm4y+zjE7UhA ppfg/VTlg5Dx2uawMVURFHmc8KK1kxdgyXd2mSxHiGrHeDsKVcmcViDaknOsPw4k EcH3ojhAozmECIkb/coiEcssIrLgiQcQKVF97PTI0oVnrZyM8jcLGzDllCp3sNZp 8XjbsrNl1LZZSMT/4+N9PYE1G8P8GLcgbCKu87z1GELfwCVWjAFqnNS29HJGwIbr FuQs08QmAEdEGckaAFdzp69vOMn1Qr3tgoW356/DIhekcByHtDkXYqNVL2aDpwyy 2NdUhvPl0dYwCNaRs8VD6ureVx4S45FFwdojt7AIuE70s6PjSJzYaxN2Exbth4aN rNyAAUg/rR4M3X2YTxusc3ugGtBDLtQ6nc0NBZaXh6xJgK4a4I1pakeg0Rdz3e0r qV93PEEBFuzx17xvgKega2kn9Xu0g6xbOtFoIwVL3EeC9NWZ9C6Ofv1bJypO5ibb cQZzIPkr =y9dZ -----END PGP SIGNATURE----- --ybfu7hpntxcdfi3s--