svn commit: r45576 - head/en_US.ISO8859-1/books/porters-handbook/porting-samplem

[Mathieu Arnold]

Author: mat (ports committer)
Date: Tue Sep  9 15:26:20 2014
New Revision: 45576
URL: http://svnweb.freebsd.org/changeset/doc/45576

Log:
  igor -Ry and some other rewording and fixes.
  
  Differential Revision:	https://reviews.freebsd.org/D648
  Reviewed by:	wblock
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml	Tue Sep  9 15:22:02 2014	(r45575)
+++ head/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml	Tue Sep  9 15:26:20 2014	(r45576)
@@ -11,14 +11,14 @@
 
   <title>A Sample <filename>Makefile</filename></title>
 
-  <para>Here is a sample <filename>Makefile</filename> that you can
-    use to create a new port.  Make sure you remove all the extra
-    comments (ones between brackets)!</para>
+  <para>Here is a sample <filename>Makefile</filename> that can be
+    used to create a new port.  Make sure to remove all the extra
+    comments (ones between brackets).</para>
 
-  <para>It is recommended that you follow this format (ordering of
-    variables, empty lines between sections, etc.).  This format is
+  <para>The format shown is the recommended one for ordering
+    variables, empty lines between sections, and so on.  This format is
     designed so that the most important information is easy to locate.
-    We recommend that you use
+    We recommend using
     <link linkend="porting-portlint">portlint</link> to check the
     <filename>Makefile</filename>.</para>
 
@@ -27,7 +27,7 @@
 [The optional <emphasis>Created by:</emphasis> line names the person who originally
 created the port.  Note that the <quote>:</quote> is followed by a space
 and not a tab character.
-If this line is present, future maintainers should
+If this line is present, future maintainers must
 not change or remove it except at the original author's request.]
 
 # $FreeBSD$
@@ -45,7 +45,7 @@ PORTNAME=	xdvi
 PORTVERSION=	18.2
 CATEGORIES=	print
 [do not forget the trailing slash ("/")!
- if you are not using MASTER_SITE_* macros]
+ if not using MASTER_SITE_* macros]
 MASTER_SITES=	${MASTER_SITE_XCONTRIB}
 MASTER_SITE_SUBDIR=	applications
 PKGNAMEPREFIX=	ja-
@@ -74,8 +74,8 @@ RUN_DEPENDS=	gs:${PORTSDIR}/print/ghosts
 IS_INTERACTIVE=	yes
 [If it extracts to a directory other than ${DISTNAME}...]
 WRKSRC=		${WRKDIR}/xdvi-new
-[If the distributed patches were not made relative to ${WRKSRC}, you
- may need to tweak this]
+[If the distributed patches were not made relative to ${WRKSRC},
+ this may need to be tweaked]
 PATCH_DIST_STRIP=	-p1
 [If it requires a "configure" script generated by GNU autoconf to be run]
 GNU_CONFIGURE=	yes