Index: head/en_US.ISO8859-1/books/porters-handbook/keeping-up/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/keeping-up/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/keeping-up/chapter.xml
@@ -19,30 +19,29 @@
One of the easiest ways to learn about updates that have
already been committed is by subscribing to FreshPorts.
- You can select multiple ports to monitor. Maintainers are
+ Multiple ports can be monitored. Maintainers are
strongly encouraged to subscribe, because they will receive
notification of not only their own changes, but also any changes
that any other &os; committer has made. (These are often
necessary to keep up with changes in the underlying ports
framework—although it would be most polite to receive an
advance heads-up from those committing such changes, sometimes
- this is overlooked or just simply impractical. Also, in some
+ this is overlooked or impractical. Also, in some
cases, the changes are very minor in nature. We expect everyone
to use their best judgement in these cases.)
- If you wish to use FreshPorts, all you need is an account.
- If your registered email address is
- @FreeBSD.org, you will see the opt-in link on
- the right hand side of the webpages. For those of you who
- already have a FreshPorts account, but are not using your
- @FreeBSD.org email address, just change your
- email to @FreeBSD.org, subscribe, then change
- it back again.
+ To use FreshPorts, an account is required. Those with
+ registered email addresses at @FreeBSD.org
+ will see the opt-in link on the right-hand side of the web
+ pages. Those who already have a FreshPorts account but are not
+ using a @FreeBSD.org email address can change
+ the email to @FreeBSD.org, subscribe, then
+ change it back again.FreshPorts also has a sanity test feature which
automatically tests each commit to the &os; ports tree. If
- subscribed to this service, you will be notified of any errors
- which FreshPorts detects during sanity testing of your
+ subscribed to this service, a committer will receive notifications
+ of any errors which FreshPorts detects during sanity testing of their
commits.
@@ -65,14 +64,14 @@
The &os; Ports Mailing List
- If you maintain ports, you should consider following the
+ As a ports maintainer, consider subscribing to
&a.ports;. Important changes to the way ports work will be
announced there, and then committed to
CHANGES.
- If this mailing list is too high volume you may consider
- following &a.ports-announce; which is moderated and has no
- discussion.
+ If the volume of messages on this mailing list is too high,
+ consider following &a.ports-announce; which contains only
+ announcements.
@@ -113,8 +112,8 @@
the maintainer is responsible for, the number of those ports
with new distfiles, and the percentage of those ports that are
out-of-date. The search function allows for searching by email
- address for a specific maintainer, and for selecting whether or
- not only out-of-date ports should be shown.
+ address for a specific maintainer, and for selecting whether
+ only out-of-date ports are shown.
Upon clicking on a maintainer's email address, a list of
all of their ports is displayed, along with port category,
@@ -142,18 +141,18 @@
future, this will be expanded to include the distfile survey, as
well as other sources.
- To get started, you can view all information about a
- particular port by using the To get started, use the Overview
- of One Port.
+ of One Port search page to find all the information
+ about a port.
- As of this writing, this is the only resource available that
- maps GNATS PR entries to portnames. (PR submitters do not
+ This is the only resource available that
+ maps PR entries to portnames. PR submitters do not
always include the portname in their Synopsis, although we would
- prefer that they did.) So, portsmon is a
- good place to start if you want to find out whether an existing
- port has any PRs filed against it and/or any build errors; or,
- to find out if a new port that you may be thinking about
+ prefer that they did. So, portsmon is a
+ good place to find out whether an existing
+ port has any PRs filed against it, any build errors, or
+ if a new port the porter is considering
creating has already been submitted.