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.