From owner-svn-doc-head@freebsd.org Fri Aug 4 11:34:18 2017 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6A7BFDD499B; Fri, 4 Aug 2017 11:34:18 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 258D064AD8; Fri, 4 Aug 2017 11:34:18 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v74BYHfR097899; Fri, 4 Aug 2017 11:34:17 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v74BYGV0097888; Fri, 4 Aug 2017 11:34:16 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201708041134.v74BYGV0097888@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Fri, 4 Aug 2017 11:34:16 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r50632 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles new-port pkg-files porting-dads porting-why quick-porting slow-porting special testing uses versions X-SVN-Group: doc-head X-SVN-Commit-Author: mat X-SVN-Commit-Paths: in head/en_US.ISO8859-1/books/porters-handbook: makefiles new-port pkg-files porting-dads porting-why quick-porting slow-porting special testing uses versions X-SVN-Commit-Revision: 50632 X-SVN-Commit-Repository: doc 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.23 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: Fri, 04 Aug 2017 11:34:18 -0000 Author: mat Date: Fri Aug 4 11:34:16 2017 New Revision: 50632 URL: https://svnweb.freebsd.org/changeset/doc/50632 Log: Fix all the whitespace errors igor reports. Translators can ignore. Sponsored by: Absolight, The FreeBSD Foundation Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/new-port/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/porting-why/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -2490,9 +2490,9 @@ USE_GITHUB= yes similar to . - When fetching multiple files from GitHub, sometimes the default - distribution file is not required. To disable fetching the default - distribution, set: + When fetching multiple files from GitHub, sometimes the + default distribution file is not required. To disable + fetching the default distribution, set: USE_GITHUB= nodefault @@ -2500,8 +2500,8 @@ USE_GITHUB= yes GH_ACCOUNT, GH_PROJECT, and GH_TAGNAME. Each different value is - assigned a group. The main value can either have no group, or - the :DEFAULT group. A value can be + assigned a group. The main value can either have no group, + or the :DEFAULT group. A value can be omitted if it is the same as the default as listed in . @@ -2533,9 +2533,9 @@ USE_GITHUB= yes As this is only syntastic sugar above DISTFILES and - MASTER_SITES, the group names must adhere - to the restrictions on group names outlined in + MASTER_SITES, the group names must + adhere to the restrictions on group names outlined in + @@ -3645,7 +3645,8 @@ PATCHFILES= patch1:test - The COMMENT string should be 70 characters or less. + The COMMENT string should be 70 characters or + less. @@ -3664,7 +3665,8 @@ PATCHFILES= patch1:test - Capitalize names such as Apache, JavaScript, or Perl. + Capitalize names such as Apache, JavaScript, or + Perl. @@ -5940,8 +5942,8 @@ USE_OPENSSL= yes <varname><replaceable>OPT</replaceable>_CONFIGURE_ENABLE</varname> - When option OPT is selected, - for each entry in + When option OPT is + selected, for each entry in OPT_CONFIGURE_ENABLE then --enable-entry @@ -5951,8 +5953,8 @@ USE_OPENSSL= yes --disable-entry is appended to CONFIGURE_ARGS. An optional argument can be specified with an - = symbol. This argument is only appended - to the + = symbol. This argument is only + appended to the --enable-entry configure option. For example: @@ -5982,8 +5984,8 @@ CONFIGURE_ARGS+= --disable-test2 <varname><replaceable>OPT</replaceable>_CONFIGURE_WITH</varname> - When option OPT is selected, - for each entry in + When option OPT is + selected, for each entry in OPT_CONFIGURE_WITH then --with-entry @@ -5993,8 +5995,8 @@ CONFIGURE_ARGS+= --disable-test2 --without-entry is appended to CONFIGURE_ARGS. An optional argument can be specified with an - = symbol. This argument is only appended - to the + = symbol. This argument is only + appended to the --with-entry configure option. For example: @@ -6026,8 +6028,8 @@ CONFIGURE_ARGS+= --without-test2 and OPT_CONFIGURE_OFF - When option OPT is selected, - the value of + When option OPT is + selected, the value of OPT_CONFIGURE_ON, if defined, is appended to CONFIGURE_ARGS. @@ -6068,8 +6070,8 @@ CONFIGURE_ARGS+= --no-test and OPT_CMAKE_OFF - When option OPT is selected, - the value of + When option OPT is + selected, the value of OPT_CMAKE_ON, if defined, is appended to CMAKE_ARGS. OPT_CMAKE_OFF @@ -6093,8 +6095,8 @@ CMAKE_ARGS+= -DOPTIMIZE:BOOL=true .endif - See for a shorter - helper when the value is boolean. + See for a + shorter helper when the value is boolean. @@ -6103,8 +6105,8 @@ CMAKE_ARGS+= -DOPTIMIZE:BOOL=true and OPT_CMAKE_BOOL_OFF - When option OPT is selected, - for each entry in + When option OPT is + selected, for each entry in OPT_CMAKE_BOOL then -Dentry:BOOL=true @@ -6116,8 +6118,8 @@ CMAKE_ARGS+= -DOPTIMIZE:BOOL=true OPT_CMAKE_BOOL_OFF is the oposite, -Dentry:BOOL=false - is appended to CMAKE_ARGS when the option - is selected, and + is appended to CMAKE_ARGS when the + option is selected, and -Dentry:BOOL=true when the option is not selected. For example: @@ -6150,8 +6152,8 @@ CMAKE_ARGS+= -DTEST:BOOL=false -DDEBUG:BOOL=false \ and OPT_MESON_OFF - When option OPT is selected, - the value of + When option OPT is + selected, the value of OPT_MESON_ON, if defined, is appended to MESON_ARGS. OPT_MESON_OFF @@ -6180,8 +6182,8 @@ MESON_ARGS+= -Dopt=2 and OPT_MESON_FALSE - When option OPT is selected, - for each entry in + When option OPT is + selected, for each entry in OPT_MESON_TRUE then -Dentry=true @@ -6193,8 +6195,8 @@ MESON_ARGS+= -Dopt=2 OPT_MESON_FALSE is the oposite, -Dentry=false - is appended to CMAKE_ARGS when the option - is selected, and + is appended to CMAKE_ARGS when the + option is selected, and -Dentry=true when the option is not selected. For example: @@ -6223,8 +6225,8 @@ CMAKE_ARGS+= -Dtest=false -Ddebug=false \ and OPT_MESON_NO - When option OPT is selected, - for each entry in + When option OPT is + selected, for each entry in OPT_MESON_YES then -Dentry=yes @@ -6236,8 +6238,8 @@ CMAKE_ARGS+= -Dtest=false -Ddebug=false \ OPT_MESON_NO is the oposite, -Dentry=no - is appended to CMAKE_ARGS when the option - is selected, and + is appended to CMAKE_ARGS when the + option is selected, and -Dentry=yes when the option is not selected. For example: @@ -7047,7 +7049,8 @@ DISTVERSION= 1.0 adds files to their system. All the additional commands run in the port Makefile's *-install targets should be - echoed to the screen. Do not silence these commands with + echoed to the screen. Do not silence + these commands with @ or .SILENT. Modified: head/en_US.ISO8859-1/books/porters-handbook/new-port/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/new-port/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/new-port/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -22,8 +22,8 @@ refer to /usr/ports/Mk/bsd.port.mk, which is included by all port Makefiles. Even those not hacking Makefiles daily can gain much - knowledge from it. Additionally, specific questions can be sent to the - &a.ports;. + knowledge from it. Additionally, specific questions can be sent + to the &a.ports;. Only a fraction of the variables @@ -40,8 +40,7 @@ loaded. - - Looking for something easy to start with? Take a look at the + Looking for something easy to start with? Take a look at the list of requested ports and see if you can work on one (or more). Modified: head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -92,7 +92,8 @@ Makefile if needed. This is especially useful when sharing the same pkg-* files - among several ports or when it is necessary to write to one of these files. + among several ports or when it is necessary to write to one of + these files. See writing to places other than WRKDIR for why it is a bad idea to write directly into Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -72,24 +72,24 @@ xlink:href="http://svnweb.freebsd.org/base/head/sys/sys/param.h?view=markup">sys/param.h. If this file is not included add the code, - #include <sys/param.h> + #include <sys/param.h> - to the proper place in the .c - file. + to the proper place in the .c + file. - __FreeBSD__ is defined in all versions - of &os; as their major version number. For example, in &os; - 9.x, __FreeBSD__ is defined to be - 9. + __FreeBSD__ is defined in all versions + of &os; as their major version number. For example, in &os; + 9.x, __FreeBSD__ is defined to be + 9. - #if __FreeBSD__ >= 9 + #if __FreeBSD__ >= 9 # if __FreeBSD_version >= 901000 /* 9.1+ release specific code here */ # endif #endif - A complete list of __FreeBSD_version - values is available in . + A complete list of __FreeBSD_version + values is available in . Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-why/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/porting-why/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/porting-why/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -16,7 +16,7 @@ in mind when reading this document. In &os;, anyone may submit a new port, or volunteer to - maintain an existing unmaintained port. No special commit + maintain an existing unmaintained port. No special commit privilege is needed. Modified: head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -418,7 +418,8 @@ lib/X11/oneko/mouse.xpm Giving a good description in the summary of the problem report makes the work of port committers a lot easier. We prefer something like New port: - category/portname short description of + category/portname + short description of the port for new ports. Using this scheme makes it easier and faster to begin the work of committing the new port. Modified: head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -192,8 +192,8 @@ FTP or HTTP server (for example, a home page). - If a convenient and reliable place to put - the distfile cannot be found, we can house it ourselves on + If a convenient and reliable place to put the distfile + cannot be found, we can house it ourselves on ftp.FreeBSD.org; however, this is the least-preferred solution. The distfile must be placed into ~/public_distfiles/ of someone's @@ -209,8 +209,8 @@ distfile on a home page and listing it as the first MASTER_SITES. Try to talk the port author out of doing this; it really does help to establish - some kind of source code control. Hosting a specific version will - prevent users from getting + some kind of source code control. Hosting a specific version + will prevent users from getting checksum mismatch errors, and also reduce the workload of maintainers of our FTP site. Also, if there is only one master site for the port, it is recommended to @@ -458,9 +458,10 @@ DOS2UNIX_WRKSRC= ${WRKDIR} Include any additional customization commands in the configure script and save it in the scripts subdirectory. As mentioned above, - it is also possible do this with Makefile targets - and/or scripts with the name pre-configure - or post-configure. + it is also possible do this with Makefile + targets and/or scripts with the name + pre-configure or + post-configure. Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -395,7 +395,7 @@ binary packages and the port's DISTFILES will still be available via FTP/HTTP. - If this variable is set along with + If this variable is set along with NO_PACKAGE, then only the port's DISTFILES will be available, and only via FTP/HTTP. @@ -1459,10 +1459,9 @@ USE_XORG= x11 xpm DEVELOPER=yes - - in the environment or in /etc/make.conf. - This causes the ports framework to enable additional - checks. + in the environment or in + /etc/make.conf. This causes the ports + framework to enable additional checks. @@ -2902,7 +2901,8 @@ USE_QT4= moc_build qmake_build rcc_build uic_buildUsing LXQt Applications depending on LXQt should set - USES+= lxqt and set USE_LXQT + USES+= lxqt and set + USE_LXQT to the list of required components from the table below @@ -2973,7 +2973,8 @@ USE_LXQT= buildtools libfmqt The most current version is java/openjdk8, with java/openjdk6 and - java/openjdk7 also available. + java/openjdk7 also + available.
Variables Which May be Set by Ports That Use @@ -3530,7 +3531,7 @@ do-install: <important> <para>Use <varname>WWWOWN</varname> and - <varname>WWWGRP</varname> sparingly. Remember that every + <varname>WWWGRP</varname> sparingly. Remember that every file the web server can write to is a security risk waiting to happen.</para> </important> Modified: head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -182,7 +182,8 @@ <command>poudriere testport</command> or <command>poudriere bulk -t</command>. It is highly recommended that every ports contributor install and test their ports with it. See - <xref linkend="testing-poudriere"/> for more information.</para> + <xref linkend="testing-poudriere"/> for more + information.</para> </tip> </sect1> Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -698,8 +698,8 @@ <para>Possible arguments: (none)</para> - <para>Uses <package role="port">devel/gmake</package> as a build-time - dependency and sets up the environment to use + <para>Uses <package role="port">devel/gmake</package> as a + build-time dependency and sets up the environment to use <command>gmake</command> as the default <command>make</command> for the build.</para> </sect1> @@ -1346,8 +1346,9 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssapi</programlis <filename>KERN_DEBUGDIR</filename>/<filename>KMODDIR</filename>. By default, <varname>KERN_DEBUGDIR</varname> is copied from <varname>DEBUGDIR</varname> and set to - <filename>/usr/lib/debug</filename>. The framework will take - care of creating and removing any required directories.</para> + <filename>/usr/lib/debug</filename>. The framework will + take care of creating and removing any required + directories.</para> </listitem> </itemizedlist> </sect1> @@ -1710,7 +1711,8 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssapi</programlis <sect1 xml:id="uses-localbase"> <title><literal>localbase</literal> - Possible arguments: (none), ldflags + Possible arguments: (none), + ldflagsEnsures that libraries from dependencies in LOCALBASE are used instead of the ones from @@ -2856,7 +2858,8 @@ SHEBANG_FILES= scripts/foobar.pl scripts/*.shOPENSSLLIB - Path to the OpenSSL libraries. + Path to the OpenSSL + libraries. @@ -2864,7 +2867,8 @@ SHEBANG_FILES= scripts/foobar.pl scripts/*.shOPENSSLINC - Path to the OpenSSL includes. + Path to the OpenSSL + includes. Modified: head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Fri Aug 4 11:34:11 2017 (r50631) +++ head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Fri Aug 4 11:34:16 2017 (r50632) @@ -90,8 +90,8 @@ 1200006 305256 September 1, 2016 - 12.0-CURRENT after &man.crunchgen.1; META_MODE fix in - 305254. + 12.0-CURRENT after &man.crunchgen.1; META_MODE fix + in 305254. @@ -196,10 +196,10 @@ 309676 December 7, 2016 12.0-CURRENT after adding the - ki_moretdname member to - struct kinfo_proc and - struct kinfo_proc32 to export the whole - thread name to user-space utilities. + ki_moretdname member to + struct kinfo_proc and + struct kinfo_proc32 to export the + whole thread name to user-space utilities. @@ -223,7 +223,8 @@ 1200021 313858 February 16, 2017 - 12.0-CURRENT after removing MCA and EISA support. + 12.0-CURRENT after removing MCA and EISA + support. @@ -239,7 +240,7 @@ 314373 March 2, 2017 12.0-CURRENT after removing System V Release 4 - binary compatibility support. + binary compatibility support. @@ -247,7 +248,8 @@ 314564 March 2, 2017 12.0-CURRENT after upgrading our copies of clang, - llvm, lld, lldb, compiler-rt and libc++ to 4.0.0. + llvm, lld, lldb, compiler-rt and libc++ to + 4.0.0. @@ -263,7 +265,8 @@ 315430 March 16, 2017 12.0-CURRENT after addition of the - <dev/mmc/mmc_ioctl.h> header. + <dev/mmc/mmc_ioctl.h> + header. @@ -271,15 +274,16 @@ 315662 March 16, 2017 12.0-CURRENT after hiding - struct inpcb and struct tcpcb - from userland. + struct inpcb and struct + tcpcb from userland. 1200027 315673 March 21, 2017 - 12.0-CURRENT after making CAM SIM lock optional. + 12.0-CURRENT after making CAM SIM lock + optional. @@ -296,7 +300,8 @@ 1200029 317176 April 19, 2017 - 12.0-CURRENT after the removal of struct vmmeter from + 12.0-CURRENT after the removal of struct vmmeter + from struct pcpu from 317061. @@ -307,15 +312,18 @@ 12.0-CURRENT after removing NATM support including en(4), fatm(4), hatm(4), and patm(4). + 1200031 318736 May 23, 2017 12.0-CURRENT after types ino_t, dev_t, nlink_t - were extended to 64bit and struct dirent + were extended to 64bit and struct + dirent changed layout (also known as ino64). + 1200032 319664 @@ -323,21 +331,26 @@ 12.0-CURRENT after removal of groff. + 1200033 320043 June 17, 2017 - 12.0-CURRENT after the type of the - struct event member data - was increased to 64bit, and ext structure members added. + 12.0-CURRENT after the type of the struct + event member data was + increased to 64bit, and ext structure members + added. + 1200034 320085 June 19, 2017 - 12.0-CURRENT after the NFS client and server were changed - so that they actually use the 64bit ino_t. + 12.0-CURRENT after the NFS client and server were + changed so that they actually use the 64bit + ino_t. + 1200035 320317 @@ -345,13 +358,16 @@ 12.0-CURRENT after the MAP_GUARD mmap(2) flag was added. + 1200036 320347 June 26, 2017 - 12.0-CURRENT after changing time_t + 12.0-CURRENT after changing + time_t to 64 bits on powerpc (32-bit version). + 1200037 320545 @@ -360,6 +376,7 @@ bus_dmamap* functions (320528). + 1200038 320879 @@ -1503,10 +1520,10 @@ 310120 December 15, 2016 11.0-STABLE after adding the - ki_moretdname member to - struct kinfo_proc and - struct kinfo_proc32 to export the whole - thread name to user-space utilities. + ki_moretdname member to + struct kinfo_proc and + struct kinfo_proc32 to export the + whole thread name to user-space utilities. @@ -1560,7 +1577,7 @@ May 11, 2017 11.0-STABLE after multiple MFC of mmc, - mmcsd, and + mmcsd, and sdhci changes. @@ -1589,6 +1606,7 @@ 11-STABLE after releng/11.1 branched. + 1101501 320666