Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml +++ en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml @@ -2719,21 +2719,62 @@ :-) - Note that only a single address without the comment part is + Only a single address without the comment part is allowed as a MAINTAINER value. The format - used should be user@hostname.domain. Please - do not include any descriptive text such as your real name in - this entry—that merely confuses - bsd.port.mk. + used is user@hostname.domain. Please + do not include any descriptive text such as a real name in + this entry. That merely confuses the Ports infrastructure + and most tools using it. The maintainer is responsible for keeping the port up to - date, and ensuring the port works correctly. For a detailed + date and making sure that it works correctly. For a detailed description of the responsibilities of a port maintainer, refer - to the The - challenge for port maintainers section. + challenge for port maintainers. - Changes to the port will be sent to the maintainer of a port + + A maintainer volunteers to keep a port in good working + order. Maintainers have the primary responsibility for their + ports, but not exclusive ownership. Ports exist for the + benefit of the community and, in reality, belong to the + community. What this means is that people other than the + maintainer can make changes to a port. Large changes to the + Ports Collection might require changes to many ports. The + &os; Ports Management Team or members of other teams might + modify ports to fix dependency issues or other problems, like + a version bump for a shared library update. Some types of + fixes have blanket approval, allowing any + committer to fix those categories of problems on any + port. + + + Some type of changes have a blanket approval from the + &a.portmgr;, they do not need approval from the maintainer, with + exception to ports maintained by some teams like autotools@FreeBSD.org, x11@FreeBSD.org, gnome@FreeBSD.org, or kde@FreeBSD.org who uses external + repositories and can have work in the way. Those are: + + + + Most infrastructure changes to a port (that is, + modernising, but not changing the functionality). For + example, converting to staging, USE_GMAKE + to USES=gmake, the new + LIB_DEPENDS format... + + + + Trivial and tested build + fixes. + + + + Other changes to the port will be sent to the maintainer of + a port for review and approval before being committed. If the maintainer does not respond to an update request after two weeks (excluding major public holidays), then that is considered a @@ -2748,7 +2789,8 @@ We reserve the right to modify the maintainer's submission to better match existing policies and style of the Ports - Collection without explicit blessing from the submitter. Also, + Collection without explicit blessing from the submitter or the + maintainer. Also, large infrastructural changes can result in a port being modified without the maintainer's consent. These kinds of changes will never affect the port's functionality.