Index: en_US.ISO8859-1/books/porters-handbook/keeping-up/chapter.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/keeping-up/chapter.xml +++ en_US.ISO8859-1/books/porters-handbook/keeping-up/chapter.xml @@ -19,31 +19,30 @@ 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 + There can be multiple ports selected for monitor. 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 - commits. + subscribed to this service, notifications of any errors + which FreshPorts detects during sanity testing of the + committer's commits will be sent to him. @@ -65,12 +64,12 @@ 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 + If this mailing list is too high volume, consider following &a.ports-announce; which is moderated and has no discussion. @@ -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.