Date: Fri, 2 Aug 2002 06:32:09 -0700 (PDT) From: Eric Anderson <anderson@centtech.com> To: freebsd-gnats-submit@FreeBSD.org Subject: misc/41263: [PATCH] Clarifications and minor grammer changes to Upgrading Ports Message-ID: <200208021332.g72DW9v7008338@www.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 41263
>Category: misc
>Synopsis: [PATCH] Clarifications and minor grammer changes to Upgrading Ports
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-bugs
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: sw-bug
>Submitter-Id: current-users
>Arrival-Date: Fri Aug 02 06:40:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Eric Anderson
>Release: 4.5-RELEASE
>Organization:
>Environment:
FreeBSD insert.hosthere.com 4.5-RELEASE FreeBSD 4.5-RELEASE #0: Mon Jan 28 14:31:56 GMT 2002
>Description:
Cleared up some minor grammer errors, added some additional information for port maintainers, and added a link to the send-pr webpage.
>How-To-Repeat:
See: http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/port-upgrading.html
>Fix:
Diff below:
--- book.sgml Wed Jul 31 13:59:33 2002
+++ book.sgml-patch Fri Aug 2 08:24:15 2002
@@ -3817,9 +3817,9 @@
sites. You may also use CVSup to keep your whole ports collection
up-to-date, as described in <ulink url="../handbook/synching.html#CVSUP-CONFIG">the Handbook</ulink>.</para>
- <para>The next step is to send a mail to the maintainer, if one is
+ <para>The next step is to send an e-mail to the maintainer, if one is
listed in the port's <filename>Makefile</filename>. That person may
- already be working on an upgrade, or have a reason to not upgrade the
+ already be working on an upgrade, or have a reason not to upgrade the
port right now (because of, for example, stability problems of the new
version).</para>
@@ -3828,15 +3828,18 @@
recursive diff (either unified or context diff is fine, but port
committers appear to prefer unified diff more) of the new and old
ports directories to us (e.g., if your modified port directory is
- called <filename>superedit</filename> and the original as in our tree
- is <filename>superedit.bak</filename>, then send us the result of
+ called <filename>superedit</filename> and the original is in our tree
+ as <filename>superedit.bak</filename>, then send us the result of
<command>diff -ruN superedit.bak superedit</command>). Please examine
the output to make sure all the changes make sense. The best way to
- send us the diff is by including it via &man.send-pr.1; (category
- <literal>ports</literal>). Please mention any added or deleted files
- in the message, as they have to be explicitly specified to CVS when
- doing a commit. If the diff is more than about 20KB, please compress
- and uuencode it; otherwise, just include it in the PR as is.</para>
+ send us the diff is by including it via &man.send-pr.1; or
+ <ulink url="../../../../send-pr.html">send-pr web interface</ulink> (category
+ <literal>ports</literal>). If you are the maintainer for the port,
+ be sure to put <literal>MAINTAINER UPDATE</literal> in the one line summary.
+ Please mention any added or deleted files in the message, as they
+ have to be explicitly specified to CVS when doing a commit.
+ If the diff is more than about 20KB, please compress and uuencode
+ it; otherwise, just include it in the PR as is.</para>
<note>
<para>Once again, please use &man.diff.1; and not &man.shar.1; to send
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200208021332.g72DW9v7008338>