Page MenuHomeFreeBSD
Files F143351745

D342.id587.diff
No OneTemporary
Actions

D342.id587.diff
View Options

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 @@
<!-- smiley-->
<emphasis>:-)</emphasis></para>
- <para>Note that only a single address without the comment part is
+ <para>Only a single address without the comment part is
allowed as a <varname>MAINTAINER</varname> value. The format
- used should be <literal>user@hostname.domain</literal>. Please
- do not include any descriptive text such as your real name in
- this entry&mdash;that merely confuses
- <filename>bsd.port.mk</filename>.</para>
+ used is <literal>user@hostname.domain</literal>. 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.</para>
<para>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 <link
+ to <link
xlink:href="&url.articles.contributing-ports;/maintain-port.html">The
- challenge for port maintainers</link> section.</para>
+ challenge for port maintainers</link>.</para>
- <para>Changes to the port will be sent to the maintainer of a port
+ <note>
+ <para>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 <quote>blanket approval</quote>, allowing any
+ committer to fix those categories of problems on any
+ port.</para>
+ </note>
+
+ <para>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 <email
+ role="nolink">autotools@FreeBSD.org</email>, <email
+ role="nolink">x11@FreeBSD.org</email>, <email
+ role="nolink">gnome@FreeBSD.org</email>, or <email
+ role="nolink">kde@FreeBSD.org</email> who uses external
+ repositories and can have work in the way. Those are:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Most infrastructure changes to a port (that is,
+ modernising, but not changing the functionality). For
+ example, converting to staging, <varname>USE_GMAKE</varname>
+ to <literal>USES=gmake</literal>, the new
+ <varname>LIB_DEPENDS</varname> format...</para>
+ </listitem>
+
+ <listitem>
+ <para>Trivial and <emphasis>tested</emphasis> build
+ fixes.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>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 @@
<para>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.</para>

File Metadata

Mime Type
text/plain
Expires
Fri, Jan 30, 7:10 AM (14 h, 46 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
28096421
Default Alt Text
D342.id587.diff (4 KB)

Event Timeline