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,19 +2719,35 @@
:-)
- 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.
+
+
+ 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.
+ Changes to the port will be sent to the maintainer of a port
for review and approval before being committed. If the
@@ -2748,7 +2764,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.