Date: Sun, 18 Aug 2024 07:47:06 +0200 From: Mathieu Arnold <mat@freebsd.org> To: Gleb Popov <arrowd@freebsd.org> Cc: Nicola Vitale <nicola.stanislao.vitale@gmail.com>, Nicola Vitale <nivit@freebsd.org>, 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: <elk2xa5di5kgossh2nnaeh2ujdmudfaisgdoinozrbobtohauz@oycjg3d5onwf> In-Reply-To: <CALH631mie8VjSwkHr7c=aAxwJPC--uPVCQUt08MvBFqdJupWcg@mail.gmail.com> References: <202408170839.47H8d1f6010111@gitrepo.freebsd.org> <CALH631kWKg1o8MmU=TZcPO7%2B5vOAAdOj1XpJSAyN1G-EEAKOPA@mail.gmail.com> <7ad037a5-a92c-455e-b54c-9287e4fe5749@gmail.com> <CALH631mie8VjSwkHr7c=aAxwJPC--uPVCQUt08MvBFqdJupWcg@mail.gmail.com>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Sat, Aug 17, 2024 at 11:57:53PM GMT, Gleb Popov wrote: > On Sat, Aug 17, 2024 at 4:41 PM Nicola Vitale > <nicola.stanislao.vitale@gmail.com> wrote: > > > > Hi, > > > > thanks for the advice, but [1] the option MANPAGES is not present in the Porter's Handbook, and the section 5.12 (Man pages) says only that "manual 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. > > 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. ;-) > > 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. -- Mathieu Arnold [-- Attachment #2 --] -----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-----home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?elk2xa5di5kgossh2nnaeh2ujdmudfaisgdoinozrbobtohauz>