From owner-svn-doc-head@FreeBSD.ORG Sun Dec 8 20:39:08 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D866645C; Sun, 8 Dec 2013 20:39:07 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C331F1E07; Sun, 8 Dec 2013 20:39:07 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id rB8Kd7dR039267; Sun, 8 Dec 2013 20:39:07 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.7/Submit) id rB8Kd7Rk039266; Sun, 8 Dec 2013 20:39:07 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201312082039.rB8Kd7Rk039266@svn.freebsd.org> From: Warren Block Date: Sun, 8 Dec 2013 20:39:07 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43308 - head/en_US.ISO8859-1/books/porters-handbook X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 08 Dec 2013 20:39:08 -0000 Author: wblock Date: Sun Dec 8 20:39:07 2013 New Revision: 43308 URL: http://svnweb.freebsd.org/changeset/doc/43308 Log: Set all the tags to . Replace SVN with Subversion. Rewrite some sentences to avoid "you" and for clarity. Replace many instances of FreeBSD with &os;. Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Dec 8 20:03:50 2013 (r43307) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Dec 8 20:39:07 2013 (r43308) @@ -15,11 +15,11 @@ xml:lang="en"> - FreeBSD Porter's Handbook + &os; Porter's Handbook - The FreeBSD Documentation Project + The &os; Documentation Project @@ -40,7 +40,7 @@ 2011 2012 2013 - The FreeBSD Documentation + The &os; Documentation Project @@ -59,13 +59,13 @@ Introduction - The FreeBSD ports collection is the way almost everyone - installs applications ("ports") on FreeBSD. Like everything - else about FreeBSD, it is primarily a volunteer effort. + The &os; Ports Collection is the way almost everyone + installs applications ("ports") on &os;. Like everything + else about &os;, it is primarily a volunteer effort. It is important to keep this in mind when reading this document. - In FreeBSD, anyone may submit a new port, or volunteer + In &os;, anyone may submit a new port, or volunteer to maintain an existing port if it is unmaintained—you do not need any special commit privileges to do so. @@ -78,7 +78,7 @@ upgrading an existing one? Great! What follows are some guidelines for creating a new port for - FreeBSD. If you want to upgrade an existing port, you should + &os;. If you want to upgrade an existing port, you should read this and then read . When this document is not sufficiently detailed, you should @@ -124,7 +124,7 @@ The following assumes that the software compiled out-of-the-box, i.e., there was absolutely no change required - for the port to work on your FreeBSD box. If you needed to + for the port to work on your &os; box. If you needed to change something, you will have to refer to the next section too. @@ -168,7 +168,7 @@ COMMENT= Cat chasing a mouse all over th See if you can figure it out. Do not worry about the contents of the $FreeBSD$ - line, it will be filled in automatically by SVN when the port + line, it will be filled in automatically by Subversion when the port is imported to our main ports tree. You can find a more detailed example in the sample Makefile @@ -421,8 +421,8 @@ PLIST_DIRS= lib/X11/oneko Thorough automated testing can be done with - ports-mgmt/tinderbox or - ports-mgmt/poudriere from the Ports + ports-mgmt/tinderbox or + ports-mgmt/poudriere from the Ports Collection. These applications maintain jails where all of the steps shown above can be tested without affecting the state of the host @@ -435,7 +435,7 @@ PLIST_DIRS= lib/X11/onekoPlease use portlint to see if your port conforms to our guidelines. The - ports-mgmt/portlint + ports-mgmt/portlint program is part of the ports collection. In particular, you may want to check if the Makefile is in the @@ -503,7 +503,7 @@ PLIST_DIRS= lib/X11/onekoAdditional - FreeBSD Contributors and other files. + &os; Contributors and other files. @@ -787,7 +787,7 @@ PLIST_DIRS= lib/X11/onekopatch-ab etc, always mention the path and file name in patch names. - Do not put RCS strings in patches. SVN will mangle them + Do not put RCS strings in patches. Subversion will mangle them when we put the files into the ports tree, and when we check them out again, they will come out different and the patch will fail. RCS strings are surrounded by dollar @@ -818,7 +818,7 @@ PLIST_DIRS= lib/X11/onekoSubversion repository but makes it hard to find out what exactly caused the problem and what you changed at all. @@ -1067,7 +1067,7 @@ DOS2UNIX_GLOB= *.c *.cpp *.h <varname>PORTEPOCH</varname> - From time to time a software vendor or FreeBSD porter + From time to time a software vendor or &os; porter will do something silly and release a version of their software which is actually numerically less than the previous version. An example of this is a port which goes @@ -1122,7 +1122,7 @@ DOS2UNIX_GLOB= *.c *.cpp *.hPORTVERSION can often preempt it becoming necessary if a future release of the software should change the version structure. However, care is - needed by FreeBSD porters when a vendor release is made + needed by &os; porters when a vendor release is made without an official version number — such as a code snapshot release. The temptation is to label the release with the release date, which will cause @@ -1152,7 +1152,7 @@ PORTVERSION= 0.10 gtkmumble-0.10. A security hole is discovered which requires a local - FreeBSD patch. PORTREVISION is bumped + &os; patch. PORTREVISION is bumped accordingly. PORTNAME= gtkmumble @@ -1284,7 +1284,7 @@ PORTEPOCH= 1 - FreeBSD strives to support the native language of + &os; strives to support the native language of its users. The language- part should be a two letter abbreviation of the natural language defined by ISO-639 if the port is specific to a @@ -1693,7 +1693,7 @@ PORTEPOCH= 1 docs* - Meta-ports for FreeBSD documentation. + Meta-ports for &os; documentation. @@ -1987,7 +1987,7 @@ PORTEPOCH= 1 ports-mgmt Ports for managing, installing and developing - FreeBSD ports and packages. + &os; ports and packages. @@ -2803,7 +2803,7 @@ EXTRACT_ONLY= source.tar.gz In the next sections, information will follow on the - FreeBSD implementation of this idea. We improved a bit on + &os; implementation of this idea. We improved a bit on OpenBSD's concept. @@ -3613,7 +3613,7 @@ ALWAYS_KEEP_DISTFILES= yes When URLs listing the available versions differ from the download URLs. For example, to limit distfile version checks to the download page for the - databases/pgtune + databases/pgtune port, add: PORTSCOUT= site:http://pgfoundry.org/frs/?group_id=1000416 @@ -3735,7 +3735,7 @@ ALWAYS_KEEP_DISTFILES= yes ports/Mk/bsd.*.mk to augment initial build dependencies. For example, USES= gmake adds - devel/gmake to + devel/gmake to BUILD_DEPENDS. To prevent such additional dependencies from polluting RUN_DEPENDS, take care to assign with @@ -4027,7 +4027,7 @@ ALWAYS_KEEP_DISTFILES= yes The ports building technology does not tolerate circular dependencies. If you introduce one, you will have someone, - somewhere in the world, whose FreeBSD installation will + somewhere in the world, whose &os; installation will break almost immediately, with many others quickly to follow. These can really be hard to detect; if in doubt, before you make that change, make sure you have done the @@ -4107,7 +4107,7 @@ LIB_DEPENDS= libbar.so:${PORTSDIR}/foo/b For more control over dependencies in some cases, WANT_ variables are available to more precisely specify what is needed. For example, consider the - mail/squirrelmail port. + mail/squirrelmail port. This port needs some PHP modules, which are listed in the USE_PHP variable: @@ -4159,7 +4159,7 @@ RESOLUTION?= 300 @${FALSE} .endif - japanese/xdvi300 also + japanese/xdvi300 also has all the regular patches, package files, etc. If you type make there, it will take the default value for the resolution (300) and build the port normally. @@ -4211,7 +4211,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 uses a different location. However, this is not recommended. These entries contain just the path relative to PREFIX/INFO_PATH. - For example, lang/gcc34 + For example, lang/gcc34 installs info files to PREFIX/INFO_PATH/gcc34, and INFO will be something like @@ -4296,7 +4296,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 WITH_OPENSSL_PORT Installs the version of OpenSSL from - security/openssl, even + security/openssl, even if the base is up to date. @@ -5436,10 +5436,10 @@ PORTVERSION= 1.0 Please double-check, often this is not necessary at all or can be avoided through -rpath or setting LD_RUN_PATH during linking (see - lang/moscow_ml for an + lang/moscow_ml for an example), or through a shell-wrapper which sets LD_LIBRARY_PATH before invoking the binary, - like www/seamonkey + like www/seamonkey does. When installing 32-bit libraries on 64-bit system, use @@ -5466,7 +5466,7 @@ PORTVERSION= 1.0 It is your responsibility as a porter to read the licensing terms of the software and make sure that the - FreeBSD project will not be held accountable for violating + &os; project will not be held accountable for violating them by redistributing the source or compiled binaries either via FTP/HTTP or CD-ROM. If in doubt, please contact the &a.ports;. @@ -5810,7 +5810,7 @@ IGNORE= may not be redistributed because exported to the PLIST_SUB and should be used if port installs *.cmake files depending on the build type (see - deskutils/strigi for an + deskutils/strigi for an example). Please note that some projects may define their own build profiles and/or force particular build type by setting CMAKE_BUILD_TYPE in @@ -6099,7 +6099,7 @@ CMAKE_SOURCE_PATH= ${WRKSRC}/subp If your port requires gettext, set USES= gettext, and your port will inherit a dependency on - devel/gettext. Other + devel/gettext. Other values for gettext usage are listed in . @@ -6189,7 +6189,7 @@ PLIST_SUB+= NLS="@comment " in PORTSDIR/Templates/BSD.local.dist. The directories for many other languages are governed by the - devel/gettext port. + devel/gettext port. Consult its pkg-plist and see whether the port is going to install a message catalog file for a unique language. @@ -6445,9 +6445,9 @@ USE_XORG= x11 xpm USES= motif in the Makefile. Default Motif implementation is - x11-toolkits/open-motif. + x11-toolkits/open-motif. Users can choose - x11-toolkits/lesstif + x11-toolkits/lesstif instead by setting WANT_LESSTIF variable. @@ -6596,11 +6596,11 @@ USE_XORG= x11 xpm Using GNOME - The FreeBSD/GNOME project uses its own set of variables to + The &os;/GNOME project uses its own set of variables to define which GNOME components a particular port uses. A comprehensive list of these variables exists within the - FreeBSD/GNOME project's homepage. + &os;/GNOME project's homepage. @@ -6981,7 +6981,7 @@ USE_QT4= qmake_build Sometimes data such as icons or .desktop files are by default installed into directories which are not scanned by XDG-compatible applications. - editors/texmaker is + editors/texmaker is an example for this - look at patch-texmaker.pro in the files directory of that port for a @@ -7206,7 +7206,7 @@ USE_QT4= moc_build qmake_build rcc_build various vendors, and in several versions. If your port must use one of these versions, you can define which one. The most current version, and &os; default is - java/openjdk6. + java/openjdk6. Variables Which May be Set by Ports That Use @@ -7564,7 +7564,7 @@ USE_QT4= moc_build qmake_build rcc_build If you ever think that your port needs more sophisticated Java support, please first have a look at the <link xlink:href="http://svnweb.FreeBSD.org/ports/head/Mk/bsd.java.mk?view=markup">bsd.java.mk - SVN log</link> as it usually takes some time to document + <application>Subversion</application> log</link> as it usually takes some time to document the latest features. Then, if you think the support you are lacking would be beneficial to many other Java ports, feel free to discuss it on the &a.java;.</para> @@ -8216,52 +8216,52 @@ _DOCSDIR= . <para>The <varname>USE_SDL</varname> variable is used to autoconfigure the dependencies for ports which use an SDL - based library like <package>devel/sdl12</package> and - <package>graphics/sdl_image</package>.</para> + based library like <package role="port">devel/sdl12</package> and + <package role="port">graphics/sdl_image</package>.</para> <para>The following SDL libraries for version 1.2 are recognized at the moment:</para> <itemizedlist> <listitem> - <para>sdl: <package>devel/sdl12</package></para> + <para>sdl: <package role="port">devel/sdl12</package></para> </listitem> <listitem> - <para>console: <package>devel/sdl_console</package></para> + <para>console: <package role="port">devel/sdl_console</package></para> </listitem> <listitem> - <para>gfx: <package>graphics/sdl_gfx</package></para> + <para>gfx: <package role="port">graphics/sdl_gfx</package></para> </listitem> <listitem> - <para>image: <package>graphics/sdl_image</package></para> + <para>image: <package role="port">graphics/sdl_image</package></para> </listitem> <listitem> - <para>mixer: <package>audio/sdl_mixer</package></para> + <para>mixer: <package role="port">audio/sdl_mixer</package></para> </listitem> <listitem> - <para>mm: <package>devel/sdlmm</package></para> + <para>mm: <package role="port">devel/sdlmm</package></para> </listitem> <listitem> - <para>net: <package>net/sdl_net</package></para> + <para>net: <package role="port">net/sdl_net</package></para> </listitem> <listitem> <para>pango: - <package>x11-toolkits/sdl_pango</package></para> + <package role="port">x11-toolkits/sdl_pango</package></para> </listitem> <listitem> - <para>sound: <package>audio/sdl_sound</package></para> + <para>sound: <package role="port">audio/sdl_sound</package></para> </listitem> <listitem> - <para>ttf: <package>graphics/sdl_ttf</package></para> + <para>ttf: <package role="port">graphics/sdl_ttf</package></para> </listitem> </itemizedlist> @@ -8270,41 +8270,41 @@ _DOCSDIR= . <itemizedlist> <listitem> - <para>sdl: <package>devel/sdl20</package></para> + <para>sdl: <package role="port">devel/sdl20</package></para> </listitem> <listitem> - <para>gfx: <package>graphics/sdl2_gfx</package></para> + <para>gfx: <package role="port">graphics/sdl2_gfx</package></para> </listitem> <listitem> - <para>image: <package>graphics/sdl2_image</package></para> + <para>image: <package role="port">graphics/sdl2_image</package></para> </listitem> <listitem> - <para>mixer: <package>audio/sdl2_mixer</package></para> + <para>mixer: <package role="port">audio/sdl2_mixer</package></para> </listitem> <listitem> - <para>net: <package>net/sdl2_net</package></para> + <para>net: <package role="port">net/sdl2_net</package></para> </listitem> <listitem> - <para>ttf: <package>graphics/sdl2_ttf</package></para> + <para>ttf: <package role="port">graphics/sdl2_ttf</package></para> </listitem> </itemizedlist> <para>Therefore, if a port has a dependency on - <package>net/sdl_net</package> and - <package>audio/sdl_mixer</package>, + <package role="port">net/sdl_net</package> and + <package role="port">audio/sdl_mixer</package>, the syntax will be:</para> <programlisting>USE_SDL= net mixer</programlisting> <para>The dependency - <package>devel/sdl12</package>, which is - required by <package>net/sdl_net</package> - and <package>audio/sdl_mixer</package>, is + <package role="port">devel/sdl12</package>, which is + required by <package role="port">net/sdl_net</package> + and <package role="port">audio/sdl_mixer</package>, is automatically added as well.</para> <para>If you use <varname>USE_SDL</varname> with entries using @@ -8448,17 +8448,17 @@ USE_SDL+= mixer <tbody> <row> <entry><literal>2.4</literal></entry> - <entry><package>x11-toolkits/wxgtk24</package></entry> + <entry><package role="port">x11-toolkits/wxgtk24</package></entry> </row> <row> <entry><literal>2.6</literal></entry> - <entry><package>x11-toolkits/wxgtk26</package></entry> + <entry><package role="port">x11-toolkits/wxgtk26</package></entry> </row> <row> <entry><literal>2.8</literal></entry> - <entry><package>x11-toolkits/wxgtk28</package></entry> + <entry><package role="port">x11-toolkits/wxgtk28</package></entry> </row> </tbody> </tgroup> @@ -9026,17 +9026,17 @@ PLIST_SUB+= VERSION="${VER_STR}" <tbody> <row> <entry><literal>4.0</literal></entry> - <entry><package>lang/lua4</package></entry> + <entry><package role="port">lang/lua4</package></entry> </row> <row> <entry><literal>5.0</literal></entry> - <entry><package>lang/lua50</package></entry> + <entry><package role="port">lang/lua50</package></entry> </row> <row> <entry><literal>5.1</literal></entry> - <entry><package>lang/lua</package></entry> + <entry><package role="port">lang/lua</package></entry> </row> </tbody> </tgroup> @@ -9495,7 +9495,7 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR <para>After 2013-10-08 (<revnumber>254273</revnumber>), &os;  10-CURRENT and newer versions have a native <command>iconv</command> in the operating system. On earlier - versions, <package>converters/libiconv</package> was used as a + versions, <package role="port">converters/libiconv</package> was used as a dependency.</para> <para>For software that needs <command>iconv</command>, define @@ -9503,7 +9503,7 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR 10-CURRENT on 2013-08-13 (<revnumber>254273</revnumber>) do not have a native <command>iconv</command>. On these earlier versions, a dependency on - <package>converters/libiconv</package> will be added + <package role="port">converters/libiconv</package> will be added automatically.</para> <para>When a port defines <literal>USES=iconv</literal>, these @@ -9569,7 +9569,7 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR <para>These two examples automatically populate the variables with the correct value for systems using - <package>converters/libiconv</package> or the + <package role="port">converters/libiconv</package> or the native <command>iconv</command> respectively:</para> <example xml:id="iconv-simple-use"> @@ -9636,49 +9636,49 @@ post-patch: <para>The <varname>USE_XFCE</varname> variable is used to autoconfigure the dependencies for ports which use an Xfce based library or application like - <package>x11-toolkits/libxfce4gui</package> - and <package>x11-wm/xfce4-panel</package>.</para> + <package role="port">x11-toolkits/libxfce4gui</package> + and <package role="port">x11-wm/xfce4-panel</package>.</para> <para>The following Xfce libraries and applications are recognized at the moment:</para> <itemizedlist> <listitem> - <para>libexo: <package>x11/libexo</package></para> + <para>libexo: <package role="port">x11/libexo</package></para> </listitem> <listitem> <para>libgui: - <package>x11-toolkits/libxfce4gui</package></para> + <package role="port">x11-toolkits/libxfce4gui</package></para> </listitem> <listitem> - <para>libutil: <package>x11/libxfce4util</package></para> + <para>libutil: <package role="port">x11/libxfce4util</package></para> </listitem> <listitem> - <para>libmcs: <package>x11/libxfce4mcs</package></para> + <para>libmcs: <package role="port">x11/libxfce4mcs</package></para> </listitem> <listitem> <para>mcsmanager: - <package>sysutils/xfce4-mcs-manager</package></para> + <package role="port">sysutils/xfce4-mcs-manager</package></para> </listitem> <listitem> - <para>panel: <package>x11-wm/xfce4-panel</package></para> + <para>panel: <package role="port">x11-wm/xfce4-panel</package></para> </listitem> <listitem> - <para>thunar: <package>x11-fm/thunar</package></para> + <para>thunar: <package role="port">x11-fm/thunar</package></para> </listitem> <listitem> - <para>wm: <package>x11-wm/xfce4-wm</package></para> + <para>wm: <package role="port">x11-wm/xfce4-wm</package></para> </listitem> <listitem> - <para>xfdev: <package>dev/xfce4-dev-tools</package></para> + <para>xfdev: <package role="port">dev/xfce4-dev-tools</package></para> </listitem> </itemizedlist> @@ -9698,7 +9698,7 @@ post-patch: </itemizedlist> <para>Therefore, if a port has a dependency on - <package>sysutils/xfce4-mcs-manager</package> + <package role="port">sysutils/xfce4-mcs-manager</package> and requires the special CPPFLAGS in its configure environment, the syntax will be:</para> @@ -9804,7 +9804,7 @@ post-patch: <entry><varname>USE_BDB</varname></entry> <entry>If variable is set to <literal>yes</literal>, add dependency on - <package>databases/db41</package> + <package role="port">databases/db41</package> port. The variable may also be set to values: 40, 41, 42, 43, 44, 46, 47, 48, or 51. You can declare a range of acceptable values, @@ -9817,7 +9817,7 @@ post-patch: <entry><varname>USE_MYSQL</varname></entry> <entry>If the variable is set to <literal>yes</literal>, add a dependency on the - <package>databases/mysql55-client</package> port. An + <package role="port">databases/mysql55-client</package> port. An associated variable, <varname>WANT_MYSQL_VER</varname>, may be set to values such as 323, 40, 41, 50, 51, 52, 55, or @@ -9827,7 +9827,7 @@ post-patch: <row> <entry><varname>USE_PGSQL</varname></entry> <entry>If set to <literal>yes</literal>, add dependency - on <package>databases/postgresql90-client</package> + on <package role="port">databases/postgresql90-client</package> port. An associated variable, <varname>WANT_PGSQL_VER</varname>, may be set to values such as 83, 84, 90, 91 or 92. You can declare @@ -9841,7 +9841,7 @@ post-patch: <entry><varname>USE_SQLITE</varname></entry> <entry>If variable is set to <literal>yes</literal>, add dependency on - <package>databases/sqlite3</package> + <package role="port">databases/sqlite3</package> port. The variable may also be set to values: 3, 2.</entry> </row> @@ -10029,7 +10029,7 @@ run_rc_command "$1"</programlisting> <step> <para>Make sure there is no - <literal>KEYWORD: FreeBSD</literal> present. This has + <literal>KEYWORD: &os;</literal> present. This has not been necessary or desirable for years. It is also an indication that the new script was copy/pasted from an old script, so extra caution should be given to the @@ -10717,7 +10717,7 @@ as .putsy.conf and edit it.</programlist <title>Port ToolsThe - ports-mgmt/porttools + ports-mgmt/porttools program is part of the Ports Collection.port is the front-end script, which can @@ -10825,7 +10825,7 @@ as .putsy.conf and edit it.Tinderbox using - ports-mgmt/tinderbox port. + ports-mgmt/tinderbox port. Be sure to read supplied documentation since the configuration is not trivial. @@ -10862,7 +10862,7 @@ as .putsy.conf and edit it.However, sometimes people forget to put the name of the port into the Synopsis field in an unambiguous fashion. In that case, you can try the - FreeBSD Ports Monitoring System + &os; Ports Monitoring System (also known as portsmon). This system attempts to classify port PRs by portname. To search for PRs about a particular port, use the . - Using <literal>SVN</literal> to Make Patches + Using <application>Subversion</application> to Make Patches - If you can, please submit a &man.svn.1; diff — they + When possible, please submit a &man.svn.1; diff. They are easier to handle than diffs between - new and old directories. Plus it is easier for - you to see what you have changed and to update your diff if - something is modified in the Ports Collection from when you - started to work on it until you submit your changes, or if the - committer asks you to fix something. + new and old directories. It is easier + to see what has changed, and to update the diff if + something was modified in the Ports Collection since you + began work on it, or if the + committer asks for something to be fixed. &prompt.user; cd ~/my_wrkdir &prompt.user; svn co https://svn0.us-west.FreeBSD.org/ports/head/dns/pdnsd @@ -10991,7 +10991,7 @@ as .putsy.conf and edit it. svn0.us-west.FreeBSD.org - is a public SVN server. Select the + is a public Subversion server. Select the closest mirror and verify the mirror server certificate from the list of Subversion @@ -11016,7 +11016,7 @@ as .putsy.conf and edit it. This will try to merge the differences between your - patch and current SVN; watch the output carefully. The + patch and current repository version; watch the output carefully. The letter in front of each file name indicates what was done with it. See for a complete list. @@ -11024,7 +11024,7 @@ as .putsy.conf and edit it.
- <literal>SVN</literal> Update File Prefixes + <application>Subversion</application> Update File Prefixes @@ -11055,17 +11055,17 @@ as .putsy.conf and edit it.
- If you get C as a result of - svn update it means something changed in - the SVN repository and &man.svn.1; was not able to merge your - local changes and those from the repository. It is always a + If C is displayed as a result of + svn update, it means something changed in + the Subversion repository and &man.svn.1; was not able to merge the + local changes with those from the repository. It is always a good idea to inspect the changes anyway, since &man.svn.1; does not know anything about how a port should be, so it might (and probably will) merge things that do not make sense. The last step is to make a unified &man.diff.1; - of the files against SVN: + of the changes: &prompt.user; svn diff > ../`basename ${PWD}`.diff @@ -11243,7 +11243,7 @@ as .putsy.conf and edit it.The VuXML database is an XML document. Its source file vuln.xml is kept right inside the port - security/vuxml. Therefore the file's + security/vuxml. Therefore the file's full pathname will be PORTSDIR/security/vuxml/vuln.xml. Each time you discover a security vulnerability in a port, please @@ -11543,10 +11543,10 @@ as .putsy.conf and edit it.As a prerequisite, you need to install fresh versions of the ports - ports-mgmt/portaudit, - ports-mgmt/portaudit-db, + ports-mgmt/portaudit, + ports-mgmt/portaudit-db, and - security/vuxml. + security/vuxml. To run packaudit you must have @@ -11587,8 +11587,8 @@ as .putsy.conf and edit it. You will need at least one of the following packages installed: - textproc/libxml2, - textproc/jade. + textproc/libxml2, + textproc/jade. Now rebuild the portaudit database @@ -11891,7 +11891,7 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD CXX= g++ Both CC and CXX - variables can be defined on FreeBSD systems in + variables can be defined on &os; systems in /etc/make.conf. The first example defines a value if it was not previously set in /etc/make.conf, preserving any @@ -11925,7 +11925,7 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD CFLAGS= -Wall -Werror The CFLAGS variable is defined on - FreeBSD systems in /etc/make.conf. The + &os; systems in /etc/make.conf. The first example appends additional flags to the CFLAGS variable, preserving any system-wide definitions. The second example clobbers anything previously @@ -12052,7 +12052,7 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD FORBIDDEN is used for ports that contain a security vulnerability or induce grave concern - regarding the security of a FreeBSD system with a given + regarding the security of a &os; system with a given port installed (e.g., a reputably insecure program or a program that provides easily exploitable services). Ports should be marked as FORBIDDEN @@ -12060,7 +12060,7 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD vulnerability and there is no released upgrade. Ideally ports should be upgraded as soon as possible when a security vulnerability is discovered so as to reduce the - number of vulnerable FreeBSD hosts (we like being known + number of vulnerable &os; hosts (we like being known for being secure), however sometimes there is a noticeable time gap between disclosure of a vulnerability and an updated release of the vulnerable @@ -12096,8 +12096,8 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD does not work with some other currently installed port (for instance, the port depends on - www/apache20 but - www/apache22 is + www/apache20 but + www/apache22 is installed) @@ -12476,7 +12476,7 @@ pre-install: change it back again. FreshPorts also has a sanity test feature which - automatically tests each commit to the FreeBSD ports tree. If + 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. @@ -12568,7 +12568,7 @@ pre-install: The &os; Ports Monitoring System Another handy resource is the - FreeBSD Ports + &os; Ports Monitoring System (also known as portsmon). This system comprises a database that processes information from several sources and