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.