From be328e477d56ab07bea331c8e386ec46af238486 Mon Sep 17 00:00:00 2001 From: Warren Block Date: Tue, 3 Jan 2012 01:31:44 +0000 Subject: [PATCH] Some spelling, grammar, and clarity fixes. Approved by: gjb (mentor) --- .../books/porters-handbook/book.sgml | 51 +++++++++---------- 1 file changed, 25 insertions(+), 26 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 55c209c99e..d3ae6b8f87 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -460,7 +460,7 @@ PLIST_DIRS= lib/X11/oneko But do not worry if you do not really understand what bsd.port.mk is doing, not many people - do... :-> + do... :-) @@ -484,7 +484,7 @@ PLIST_DIRS= lib/X11/oneko The extract target is run. It looks for your port's distribution file (typically a - gzip'd tarball) in DISTDIR and unpacks + gzipped tarball) in DISTDIR and unpacks it into a temporary subdirectory specified by WRKDIR (defaults to work). @@ -842,7 +842,7 @@ DOS2UNIX_REGEX= .*\.(c|cpp|h) The original source Does it live in DISTDIR as a standard - gzip'd tarball named something like + gzipped tarball named something like foozolix-1.2.tar.gz? If so, you can go on to the next step. If not, you should look at overriding any of the DISTVERSION, @@ -2443,7 +2443,7 @@ MASTER_SITE_SUBDIR= make MASTER_SITES= SF - If the guess is incorrect, it can be overriden as + If the guess is incorrect, it can be overridden as follows. MASTER_SITES= SF/stardict/WyabdcRealPeopleTTS/${PORTVERSION} @@ -2635,7 +2635,7 @@ EXTRACT_ONLY= source.tar.gz .gz or .Z. If the patch is distributed with some other files, such - as documentation, in a gzip'd tarball, you cannot just use + as documentation, in a gzipped tarball, you cannot just use PATCHFILES. If that is the case, add the name and the location of the patch tarball to DISTFILES and @@ -2650,7 +2650,7 @@ EXTRACT_ONLY= source.tar.gz The tarball will have been extracted alongside the regular source by then, so there is no need to explicitly - extract it if it is a regular gzip'd or compress'd + extract it if it is a regular gzipped or compressed tarball. If you do the latter, take extra care not to overwrite something that already exists in that directory. Also, do not forget to add a command to remove the copied @@ -2671,8 +2671,7 @@ EXTRACT_ONLY= source.tar.gz This section has information on the fetching mechanism known as both MASTER_SITES:n and MASTER_SITES_NN. We will refer to this - mechanism as MASTER_SITES:n - hereon. + mechanism as MASTER_SITES:n. A little background first. OpenBSD has a neat feature inside the DISTFILES and @@ -3442,11 +3441,11 @@ ALWAYS_KEEP_DISTFILES= yes Dependencies - Many ports depend on other ports. This is very convenient - and nice feature of most Unix-like operating systems, - including &os;. It allows not having to bundle common - dependencies with every port or package, since a lot of ports - would share them. There are seven variables that can be used + Many ports depend on other ports. This is a very + convenient feature of most Unix-like operating systems, + including &os;. Multiple ports can share a common dependency, + rather than bundling that dependency with every port or + package that needs it. There are seven variables that can be used to ensure that all the required bits will be on the user's machine. There are also some pre-supported dependency variables for common cases, plus a few more to control the @@ -4463,7 +4462,7 @@ PORTVERSION= 1.0 INSTALL_KLD is a command to install kernel loadable modules. Some architectures - don't like it when the modules are stripped, therefor + do not like having the modules stripped, so use this command instead of INSTALL_PROGRAM. @@ -4516,12 +4515,12 @@ PORTVERSION= 1.0 Installing a whole tree of files Sometimes, there is a need to install a big number of - files, preserving their hierarchical organization, ie. + files, preserving their hierarchical organization, i.e., copying over a whole directory tree from WRKSRC to a target directory under PREFIX. - Two macros exists for this situation. The advantage of + Two macros exist for this situation. The advantage of using these macros instead of cp is that they guarantee proper file ownership and permissions on target files. The first macro, @@ -5309,7 +5308,7 @@ IGNORE= may not be redistributed because of licensing reasons. Please visit AUTOMAKE_ARGS and ACLOCAL_ARGS respectively, which may be - overriden by the port Makefile if + overridden by the port Makefile if required. @@ -5840,9 +5839,9 @@ USE_XORG= x11 xpm The list of possible categories is available on the Freedesktop - website. The StartupNotify - indicates, if the application will clear the status in - startup notification aware environment. + website. StartupNotify + indicates whether the application will clear the status in + a startup notification-aware environment. Example: @@ -6787,13 +6786,13 @@ QT_COMPONENTS= qmake_build moc_build rcc_build uic_build APXS Full path to the apxs - binary. Can be overriden in your port. + binary. Can be overridden in your port. HTTPD Full path to the httpd - binary. Can be overriden in your port. + binary. Can be overridden in your port. @@ -6846,7 +6845,7 @@ QT_COMPONENTS= qmake_build moc_build rcc_build uic_build SHORTMODNAME Short name of the module. Automatically derived from MODULENAME, but can - be overriden. Example: + be overridden. Example: hello @@ -8259,8 +8258,8 @@ PLIST_SUB+= VERSION="${VER_STR}" The following fragment is from a port which can use Lua version 5.0 or 5.1, and uses - 5.0 by default. It can be overriden by - the user using WITH_LUA_VER. + 5.0 by default. It can be overridden + by the user with WITH_LUA_VER. USE_LUA= 5.0-5.1 WANT_LUA_VER= 5.0 @@ -14207,7 +14206,7 @@ Reference: <http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00 March 18, 2009 8.0-CURRENT after the dynamic string token substitution has been implemented for rpath and needed - pathes. + paths.