&os; Security Team

From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 05:33:34 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 2752BBFB; Sun, 7 Jul 2013 05:33:34 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id EE0E31191; Sun, 7 Jul 2013 05:33:33 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r675XXKl058778; Sun, 7 Jul 2013 05:33:33 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r675XX5J058777; Sun, 7 Jul 2013 05:33:33 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307070533.r675XX5J058777@svn.freebsd.org> From: Gabor Pali Date: Sun, 7 Jul 2013 05:33:33 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42183 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 05:33:34 -0000 Author: pgj Date: Sun Jul 7 05:33:33 2013 New Revision: 42183 URL: http://svnweb.freebsd.org/changeset/doc/42183 Log: - Add a Q2 entry for secteam Submitted by: gnn Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sat Jul 6 23:15:13 2013 (r42182) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 05:33:33 2013 (r42183) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 18 entries and we hope you enjoy reading it.

+ contains 19 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1037,4 +1037,51 @@ Fix x11-themes/gtk-xfce-engine with Gtk+ >=3.6. + + + &os; Security Team + + + + + &os; Security Team + + secteam@FreeBSD.org + + + + + + +

On April 15th Dag-Erling Smørgrav and Xin Li took over + as security officers for the &os; Project, and the team welcomed + Qing Li back in the team in June. This report briefly + summarizes the work of the Security Team from April until the + end of June.

+ +

The Security Team has released the following advisories:

+ +

FreeBSD-SA-13:05.nfsserver: Insufficient input + validation in the NFS server (nfsd(8)), reported by + Adam Nowacki.
FreeBSD-SA-13:06.mmap: Privilege escalation via + mmap(), reported by Konstantin Belousov.
FreeBSD-EN-13:02.vtnet: vtnet(4) + network interface issue on QEMU 1.4.0 and later in 8.4-RELEASE, + reported by Julian Stecklina.
FreeBSD-EN-13:01.fxp: dhclient(8) utility + issue on fxp(4) network interface in 8.4-RELEASE, + reported by Michael L. Squires.

+ +

Per request of Baptiste Daroussin, the Security Team has also + reviewed the source code of Poudriere, the port build and test + system which is planned to be used for producing pkg(8) + ("new-style") packages on the &os; cluster.

+ + From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 05:55:16 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id C137DEA; Sun, 7 Jul 2013 05:55:16 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A38CB120D; Sun, 7 Jul 2013 05:55:16 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r675tGUD064593; Sun, 7 Jul 2013 05:55:16 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r675tG2D064592; Sun, 7 Jul 2013 05:55:16 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307070555.r675tG2D064592@svn.freebsd.org> From: Gabor Pali Date: Sun, 7 Jul 2013 05:55:16 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42184 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 05:55:16 -0000 Author: pgj Date: Sun Jul 7 05:55:16 2013 New Revision: 42184 URL: http://svnweb.freebsd.org/changeset/doc/42184 Log: - Add a Q2 entry for BSD-Day 2013 Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 05:33:33 2013 (r42183) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 05:55:16 2013 (r42184) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 19 entries and we hope you enjoy reading it.

+ contains 20 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -67,6 +67,12 @@ Documentation + + event + + Events + + PC-BSD @@ -1084,4 +1090,53 @@ ("new-style") packages on the &os; cluster.

+ + + BSD-Day 2013 + + + + + Gábor + Páli + + pgj@FreeBSD.org + + + + + BSD-Day 2013 web site + YouTube playlist of talks + Event photo album + + + +

The BSD-Day is a now recurring excuse for BSD developers and + users to meet up in person, share some beers and talk about what + they are working on these days. There was a detour this year to + visit the beautiful city of Naples of Italy, the home of pizza. + Fortunately, the event has again gained support from numerous + and generous sponsors, such as the &os; Foundation, the EMC + Corporation, iXsystems, FreeBSDMall, BSD Magazine, and many + others which enabled us to cover the costs of travel and + accommodation for the speakers. We are really grateful for + this!

+ +

Similarly to the previous years, the whole event started with a + common dinner in the downtown (somewhere around the Ireland + Irish Pub) on Friday which suddenly turned into a do-it-yourself + pizza-fest. Then it was followed by the Saturday event at the + Institute of Biostructures and Bioimaging. There we had a lot + of attendees for the associated BSDA exam in the morning — + 8 persons! The event itself had many interesting topics as + well, for example moving MCLinker into the BSD world, + organization and culture of the &os; Project, the new + callout(9) framework, building and testing ports with + Poudriere and Tinderbox, &os; in the embedded space, or building + reliable VPN networks with OpenBSD. See the links in the report + for more.

+ + From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 06:07:54 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 760562B8; Sun, 7 Jul 2013 06:07:54 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 66D741250; Sun, 7 Jul 2013 06:07:54 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6767sDw068076; Sun, 7 Jul 2013 06:07:54 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6767sFL068075; Sun, 7 Jul 2013 06:07:54 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307070607.r6767sFL068075@svn.freebsd.org> From: Gabor Pali Date: Sun, 7 Jul 2013 06:07:54 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42185 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 06:07:54 -0000 Author: pgj Date: Sun Jul 7 06:07:53 2013 New Revision: 42185 URL: http://svnweb.freebsd.org/changeset/doc/42185 Log: - Add a Q2 report entry on the xorg work Submitted by: zeising Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 05:55:16 2013 (r42184) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 06:07:53 2013 (r42185) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 20 entries and we hope you enjoy reading it.

+ contains 21 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1139,4 +1139,82 @@ for more.

+ + + xorg on &os; + + + + x11@FreeBSD.org + + + + + Niclas + Zeising + + zeising@FreeBSD.org + + + + + Koop + Mast + + kwm@FreeBSD.org + + + + + + + + + +

During the beginning of this quarter, work focused on making + the xorg update as robust and stable as possible in + preparation for the merge to ports. As part of this exp-run + were made, to find and resolve regressions and other issues. + Once this was completed, xorg was updated to version + 7.7 on May 25, after more than a year of hard work.

+ +

After the update, work immediately shifted to focus on updating + and patching xorg client libraries, since numerous + security issues had been identified in those. Unfortunately, + this took a little longer than anticipated, but all fixes were + comitted eventually.

+ +

There has also been work on making the new xorg + distribution the default for &os; 9.1 and later. A patch + was sent out and tested with good results, but this is currently + postponed because switching virtual terminals is not working + with the KMS driver.

+ +

Currently, work is focusing on keeping xorg drivers + and libraries up to date. Instead of making big updates every + year or less, minor updates to some libraries, applications and + drivers happen fairly regularly. Focus is also starting to + shift towards newer versions of MESA and xorg-server, + but this is still very experimental.

+ + + + Continue the porting effort of recent versions of MESA. + This is ongoing work, but integrating this into the development + repo is hard work. Once this is completed, and KMS support for + ATI is more mature, more testing can be done. + + Port Wayland. The future of graphical environments in open + source operating system seem to be Wayland. This needs to be + ported to &os; so that a wider audience can test it, and so that + it eventually can be integrated into the ports tree, perhaps as + a replacement for the current xorg. + + Look into replacements for HAL. HAL is used for + hot-plugging of devices, but it has been long abandoned by Linux. + A replacement, perhaps build on top of devd would be nice to + have. This work should be coordinated with the &os; GNOME and + KDE teams. + + From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 09:13:20 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 0996CAEF; Sun, 7 Jul 2013 09:13:20 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id DA5A21BE8; Sun, 7 Jul 2013 09:13:19 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r679DJLJ022910; Sun, 7 Jul 2013 09:13:19 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r679DJFE022909; Sun, 7 Jul 2013 09:13:19 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201307070913.r679DJFE022909@svn.freebsd.org> From: Eitan Adler Date: Sun, 7 Jul 2013 09:13:19 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42186 - head/en_US.ISO8859-1/books/handbook/introduction X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 09:13:20 -0000 Author: eadler Date: Sun Jul 7 09:13:19 2013 New Revision: 42186 URL: http://svnweb.freebsd.org/changeset/doc/42186 Log: Remove dated paragraph. While true, it doesn't add much for the reader and might confuse them. Modified: head/en_US.ISO8859-1/books/handbook/introduction/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/introduction/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/introduction/chapter.xml Sun Jul 7 06:07:53 2013 (r42185) +++ head/en_US.ISO8859-1/books/handbook/introduction/chapter.xml Sun Jul 7 09:13:19 2013 (r42186) @@ -123,13 +123,6 @@ - &os; is a 32-bit operating - system (64-bit on the &itanium;, - AMD64, and &ultrasparc;) and was designed as such from - the ground up. - - - X Window System From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 16:10:26 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 57032EAF; Sun, 7 Jul 2013 16:10:26 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 48FFB1A0F; Sun, 7 Jul 2013 16:10:26 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r67GAQjx049020; Sun, 7 Jul 2013 16:10:26 GMT (envelope-from ryusuke@svn.freebsd.org) Received: (from ryusuke@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r67GAQtT049019; Sun, 7 Jul 2013 16:10:26 GMT (envelope-from ryusuke@svn.freebsd.org) Message-Id: <201307071610.r67GAQtT049019@svn.freebsd.org> From: Ryusuke SUZUKI Date: Sun, 7 Jul 2013 16:10:26 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42187 - head/ja_JP.eucJP/books/handbook/introduction X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 16:10:26 -0000 Author: ryusuke Date: Sun Jul 7 16:10:25 2013 New Revision: 42187 URL: http://svnweb.freebsd.org/changeset/doc/42187 Log: - Merge the following from the English version: r41760 -> r42186 head/ja_JP.eucJP/books/handbook/introduction/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/introduction/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/introduction/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/introduction/chapter.xml Sun Jul 7 09:13:19 2013 (r42186) +++ head/ja_JP.eucJP/books/handbook/introduction/chapter.xml Sun Jul 7 16:10:25 2013 (r42187) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r41760 + Original revision: r42186 $FreeBSD$ --> @@ -122,14 +122,6 @@ - &os; �� 32�ӥå� - �Υ��ڥ졼�ƥ��󥰥��ƥ� - (&itanium; �ǡ�AMD64 �Ǥ�� &ultrasparc; �Ǥ� - 64 �ӥå�) �Ǥ��ꡢ - �ǽ餫�餽�Τ褦�ˤ��Ĥ��Ĥ��߷פ��ޤ�� - - - X Window System From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 18:32:16 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 13680742; Sun, 7 Jul 2013 18:32:16 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id E991A1F43; Sun, 7 Jul 2013 18:32:15 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r67IWFqN091707; Sun, 7 Jul 2013 18:32:15 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r67IWFrO091705; Sun, 7 Jul 2013 18:32:15 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307071832.r67IWFrO091705@svn.freebsd.org> From: Warren Block Date: Sun, 7 Jul 2013 18:32:15 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42188 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 18:32:16 -0000 Author: wblock Date: Sun Jul 7 18:32:15 2013 New Revision: 42188 URL: http://svnweb.freebsd.org/changeset/doc/42188 Log: Fix whitespace-only issues found with 'igor -RZ'. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml head/en_US.ISO8859-1/books/porters-handbook/uses.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Jul 7 16:10:25 2013 (r42187) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Jul 7 18:32:15 2013 (r42188) @@ -5768,11 +5768,11 @@ CMAKE_SOURCE_PATH= ${WRKSRC}/subp Basic Usage If your port requires gettext, set - USES= gettext, and your - port will inherit a dependency on devel/gettext. Other values for - gettext usage are listed in . + USES= gettext, and your port will inherit + a dependency on + devel/gettext. Other + values for gettext usage are listed in + . A rather common case is a port using gettext and configure. @@ -15743,8 +15743,8 @@ Reference: <http://www.freebsd.org/po 901501 November 11, 2012 9.1-STABLE after LIST_PREV() added to queue.h - (rev 242893) and KBI change in USB - serial devices (rev 240659). + (rev 242893) and KBI change in USB + serial devices (rev 240659). @@ -16011,8 +16011,8 @@ Reference: <http://www.freebsd.org/po 1000028 February 13, 2013 - 10-CURRENT after USB moved to the driver structure - requiring a rebuild of all USB modules (rev + 10-CURRENT after USB moved to the driver + structure requiring a rebuild of all USB modules (rev 246759). Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses.xml Sun Jul 7 16:10:25 2013 (r42187) +++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml Sun Jul 7 18:32:15 2013 (r42188) @@ -19,8 +19,9 @@ ada (none) - Depends on an Ada-capable compiler, and - sets CC accordingly. + + Depends on an Ada-capable + compiler, and sets CC accordingly. @@ -39,12 +40,12 @@ charsetfix (none) - Prevents the port from installing charset.alias. - This should be installed only by - converters/libiconv. - CHARSETFIX_MAKEFILEIN can be set to a path relative - to WRKSRC if charset.alias is - not installed by + Prevents the port from installing + charset.alias. This should be installed only + by converters/libiconv. + CHARSETFIX_MAKEFILEIN can be set to a path + relative to WRKSRC if + charset.alias is not installed by WRKSRC/Makefile.in. @@ -64,12 +65,12 @@ Implies that the port uses the update-desktop-database from - devel/desktop-file-utils. - This uses will automatically add a post-install step in such a way - that the port itself still can specify there own post-install step - if needed. It also insert lines into the plist for package - install and removal to run - update-desktop-database. + devel/desktop-file-utils. An + extra post-install step will be run without interfering with any + post-install steps already in the port + Makefile. Lines will be inserted into the + plist to run update-desktop-database on + package install or removal. @@ -85,11 +86,12 @@ gettext (none), lib, build, run - Implies that the port uses devel/gettext in one way or another. By - default, with no arguments or with the lib - argument, implies gettext with build-time and - run-time dependencies, build implies a build-time + Implies that the port uses + devel/gettext in one way or + another. By default, with no arguments or with the + lib argument, implies + gettext with build-time and run-time + dependencies, build implies a build-time dependency, and run implies a run-time dependency. @@ -99,15 +101,16 @@ (none) Implies that the port uses converters/libiconv as build-time and - run-time dependency. - + run-time dependency. ncurses - (none), base, port - Implies that the port uses ncurses, and - causes some useful variables to be set. + (none), base, + port + Implies that the port uses + ncurses, and causes some useful + variables to be set. @@ -151,9 +154,10 @@ readline (none), port - Implies that the port uses readline as - library dependency, and sets CPPFLAGS and - LDFLAGS as necessary. + Implies that the port uses + readline as library dependency, and + sets CPPFLAGS and LDFLAGS as + necessary. @@ -174,23 +178,26 @@ shebangfix (none) - A lot of software uses incorrect locations for script interpreters, - most notably /usr/bin/perl and - /bin/bash. This fixes shebang lines in scripts - listed in SHEBANG_FILES. Currently - Perl, Python, + A lot of software uses incorrect locations for script + interpreters, most notably /usr/bin/perl and + /bin/bash. This fixes shebang lines in + scripts listed in SHEBANG_FILES. Currently + Perl, + Python, Bash, Ruby, - and PHP are supported by default. - To support another interpreter, set SHEBANG_LANG - (for example SHEBANG_LANG=lua), then - lua_OLD_CMD and lua_CMD. + and PHP are supported by default. To + support another interpreter, set SHEBANG_LANG + (for example + SHEBANG_LANG=lua), then + lua_OLD_CMD and + lua_CMD. zenoss (none) - Implies the port uses net-mgmt/zenoss in one way or another, - but largely is used for building zenoss related zenpack + Implies the port uses + net-mgmt/zenoss in one way or + another, but largely is used for building zenoss related zenpack ports. From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 18:44:18 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D3BE8DFE; Sun, 7 Jul 2013 18:44:18 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id C65431FEB; Sun, 7 Jul 2013 18:44:18 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r67IiINk094904; Sun, 7 Jul 2013 18:44:18 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r67IiIAg094903; Sun, 7 Jul 2013 18:44:18 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307071844.r67IiIAg094903@svn.freebsd.org> From: Warren Block Date: Sun, 7 Jul 2013 18:44:18 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42189 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 18:44:18 -0000 Author: wblock Date: Sun Jul 7 18:44:18 2013 New Revision: 42189 URL: http://svnweb.freebsd.org/changeset/doc/42189 Log: Fix title capitalization found with 'igor -Rz'. 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 Jul 7 18:32:15 2013 (r42188) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Jul 7 18:44:18 2013 (r42189) @@ -6297,7 +6297,7 @@ USE_XORG= x11 xpm - Updating desktop database + Updating Desktop Database If a port has a MimeType entry in its portname.desktop, From owner-svn-doc-all@FreeBSD.ORG Sun Jul 7 22:15:37 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 282749CF; Sun, 7 Jul 2013 22:15:37 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 09DC01915; Sun, 7 Jul 2013 22:15:37 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r67MFaCq057903; Sun, 7 Jul 2013 22:15:36 GMT (envelope-from rene@svn.freebsd.org) Received: (from rene@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r67MFaDO057902; Sun, 7 Jul 2013 22:15:36 GMT (envelope-from rene@svn.freebsd.org) Message-Id: <201307072215.r67MFaDO057902@svn.freebsd.org> From: Rene Ladan Date: Sun, 7 Jul 2013 22:15:36 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42191 - head/share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 22:15:37 -0000 Author: rene Date: Sun Jul 7 22:15:36 2013 New Revision: 42191 URL: http://svnweb.freebsd.org/changeset/doc/42191 Log: Resolve whitespace-only changes against projects/entities (r40263) Approved by: gjb (mentor) Modified: head/share/xml/catalog.xml Modified: head/share/xml/catalog.xml ============================================================================== --- head/share/xml/catalog.xml Sun Jul 7 19:17:56 2013 (r42190) +++ head/share/xml/catalog.xml Sun Jul 7 22:15:36 2013 (r42191) @@ -1,70 +1,69 @@ + "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"> + rewritePrefix="../../"/> + rewritePrefix="../../"/> + rewritePrefix="../../"/> + rewritePrefix="../../"/> - + publicId="-//FreeBSD//ENTITIES FreeBSD Developers Entities//EN" + uri="developers.ent" /> + publicId="-//FreeBSD//ENTITIES ISO 8879:1986 Entity Set//EN//XML" + uri="iso8859.ent" /> + publicId="-//FreeBSD//ENTITIES FreeBSD L10N Common Entities//EN" + uri="l10n-common.ent" /> + publicId="-//FreeBSD//ENTITIES FreeBSD L10N Entities//EN" + uri="l10n.ent" /> + publicId="-//FreeBSD//DOCUMENT FreeBSD Language Neutral XSLT Library//EN" + uri="libcommon.xsl" /> + publicId="-//FreeBSD//DTD FreeBSD XSLT 1.0 DTD Fragment//EN" + uri="xslt10.dtd" /> + publicId="-//FreeBSD//DTD FreeBSD XSLT 1.0 DTD//EN" + uri="xslt10-freebsd.dtd" /> + uri="cvs.dtd"/> + publicId="-//FreeBSD//DTD FreeBSD XML Database for UserGroups//EN" + uri="usergroups.dtd" /> + publicId="-//FreeBSD//DTD FreeBSD XML Database for News//EN" + uri="news.dtd" /> + publicId="-//FreeBSD//DTD FreeBSD XML Database for Multimedia//EN" + uri="multimedia.dtd"/> @@ -72,14 +71,14 @@ publicId="-//FreeBSD//DTD FreeBSD XML Database for Events//EN" uri="events.dtd" /> + publicId="-//FreeBSD//DTD FreeBSD XML Database for Status Report//EN" + uri="statusreport.dtd" /> + publicId="-//FreeBSD//DTD FreeBSD XML Database for Commercial Gallery//EN" + uri="gallery.dtd" /> + publicId="-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN" + uri="xhtml10-freebsd.dtd" /> From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 01:51:27 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 1A512AF0; Mon, 8 Jul 2013 01:51:27 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-3.mit.edu (dmz-mailsec-scanner-3.mit.edu [18.9.25.14]) by mx1.freebsd.org (Postfix) with ESMTP id 9100A1024; Mon, 8 Jul 2013 01:51:26 +0000 (UTC) X-AuditID: 1209190e-b7f988e0000009a7-5a-51da19eb0d37 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP id 55.1E.02471.BE91AD15; Sun, 7 Jul 2013 21:46:19 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id r681kIwN009230; Sun, 7 Jul 2013 21:46:18 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r681kFrS007828 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 7 Jul 2013 21:46:17 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r681kEXq027059; Sun, 7 Jul 2013 21:46:14 -0400 (EDT) Date: Sun, 7 Jul 2013 21:46:14 -0400 (EDT) From: Benjamin Kaduk To: Gabor Pali Subject: Re: svn commit: r42183 - head/en_US.ISO8859-1/htdocs/news/status In-Reply-To: <201307070533.r675XX5J058777@svn.freebsd.org> Message-ID: References: <201307070533.r675XX5J058777@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrHIsWRmVeSWpSXmKPExsUixCmqrPta8lagwZ2zbBY/Ph5ispiz+imj xY1F+5ksdvf3MjuweMz4NJ8lgDGKyyYlNSezLLVI3y6BK2PnjpksBR9FK/p6nzI3MG4Q7GLk 5JAQMJE4vXM+G4QtJnHh3nogm4tDSGAfo0TjpncsEM4GRolfu95COQeZJO50n2IFaRESqJc4 sO0iM4jNIqAlcfHrAnYQm01ARWLmm41gY0UEFCRO7+hhAbGZBaIk9ixtBOsVFvCUWLt8IVg9 p4CVxInV78FsXgFHiQXnOxgh5ltK/J7aBxYXFdCRWL1/CgtEjaDEyZlPoGZaSpz7c51tAqPg LCSpWUhSCxiZVjHKpuRW6eYmZuYUpybrFicn5uWlFuka6+VmluilppRuYgQHrSTfDsavB5UO MQpwMCrx8J44fzNQiDWxrLgy9xCjJAeTkijvLaFbgUJ8SfkplRmJxRnxRaU5qcWHGCU4mJVE eMVZgXK8KYmVValF+TApaQ4WJXHeZ0/PBgoJpCeWpGanphakFsFkZTg4lCR430kANQoWpaan VqRl5pQgpJk4OEGG8wANvwVSw1tckJhbnJkOkT/FqMsx+eyW94xCLHn5ealS4ry/QIoEQIoy SvPg5sCSzStGcaC3hHkfglTxABMV3KRXQEuYgJZ03b8GsqQkESEl1cBo8k4jmE11isHmhQIN sy02uUblzCzwTDS43ij8smLr8s6uPN/GZ5Jx5gyL/2n4/Pwx0ZFpveX+Ww90TpzdsLHq8A+z Y6WR9d5Rbua5q6okZVb9+3xe1PmxJv/yr06NW6uyPFNzVsY5P2WLOWvcfJbrw//Y0+8uTWnj 8s2T3la0v/bM1qi2jQeUWIozEg21mIuKEwHpaW9xEQMAAA== Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 01:51:27 -0000 On Sun, 7 Jul 2013, Gabor Pali wrote: > Author: pgj > Date: Sun Jul 7 05:33:33 2013 > New Revision: 42183 > URL: http://svnweb.freebsd.org/changeset/doc/42183 > > Log: > - Add a Q2 entry for secteam > > Submitted by: gnn > > Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sat Jul 6 23:15:13 2013 (r42182) > +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 05:33:33 2013 (r42183) > @@ -1037,4 +1037,51 @@ > Fix x11-themes/gtk-xfce-engine with Gtk+ >=3.6. > > > + > + > + &os; Security Team > + > + > + > + > + &os; Security Team > + > + secteam@FreeBSD.org > + > + > + > + > + > + > +

On April 15th Dag-Erling Smørgrav and Xin Li took over > + as security officers for the &os; Project, and the team welcomed > + Qing Li back in the team in June. This report briefly "back to the team" is probably better. > + summarizes the work of the Security Team from April until the > + end of June.

> + > +

The Security Team has released the following advisories:

> + > +

FreeBSD-SA-13:05.nfsserver: Insufficient input > + validation in the NFS server (nfsd(8)), reported by > + Adam Nowacki.
FreeBSD-SA-13:06.mmap: Privilege escalation via > + mmap(), reported by Konstantin Belousov.
FreeBSD-EN-13:02.vtnet: vtnet(4) > + network interface issue on QEMU 1.4.0 and later in 8.4-RELEASE, > + reported by Julian Stecklina.
FreeBSD-EN-13:01.fxp: dhclient(8) utility > + issue on fxp(4) network interface in 8.4-RELEASE, > + reported by Michael L. Squires.

"vtnet network interface issue" and "dhclient utility issue" are rather odd phrasings that convey little information about the actual issue. I don't remember the actual problems offhand, but I expect that a rewording is possible which better indicates the nature of the problem. > +

Per request of Baptiste Daroussin, the Security Team has also "Per the request"? -Ben > + reviewed the source code of Poudriere, the port build and test > + system which is planned to be used for producing pkg(8) > + ("new-style") packages on the &os; cluster.

> + > + > > From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 01:58:02 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 3C244D0; Mon, 8 Jul 2013 01:58:02 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (dmz-mailsec-scanner-4.mit.edu [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 9EFA7105E; Mon, 8 Jul 2013 01:58:01 +0000 (UTC) X-AuditID: 1209190f-b7fa58e000000953-62-51da1b767666 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 7D.55.02387.67B1AD15; Sun, 7 Jul 2013 21:52:54 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id r681qrSU009677; Sun, 7 Jul 2013 21:52:54 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r681qpnn009471 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 7 Jul 2013 21:52:52 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r681qoKd027895; Sun, 7 Jul 2013 21:52:50 -0400 (EDT) Date: Sun, 7 Jul 2013 21:52:50 -0400 (EDT) From: Benjamin Kaduk To: Gabor Pali Subject: Re: svn commit: r42185 - head/en_US.ISO8859-1/htdocs/news/status In-Reply-To: <201307070607.r6767sFL068075@svn.freebsd.org> Message-ID: References: <201307070607.r6767sFL068075@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrIIsWRmVeSWpSXmKPExsUixCmqrFsmfSvQoHmfjsWPj4eYLOasfspo cWPRfiaL3f29zA4sHjM+zWcJYIzisklJzcksSy3St0vgyli25Sp7wUGFiruTnjE1MC6X7GLk 5JAQMJE49mIzM4QtJnHh3nq2LkYuDiGBfYwST5/vYodwNjBKrNuwFso5yCSxZ+pyFpAWIYF6 idXvVoDZLAJaEm1Le9hAbDYBFYmZbzaC2SICChKnd/SA1TALREnsWdrICmILC3hKrL/2iR3E 5hSwkmiY/QionoODV8BR4s5meYjxlhL3J+8EaxUV0JFYvX8KmM0rIChxcuYTqJGWEuf+XGeb wCg4C0lqFpLUAkamVYyyKblVurmJmTnFqcm6xcmJeXmpRbomermZJXqpKaWbGMEhK8m/g/Hb QaVDjAIcjEo8vAVnbwYKsSaWFVfmHmKU5GBSEuW9JXQrUIgvKT+lMiOxOCO+qDQntfgQowQH s5IIrzgrUI43JbGyKrUoHyYlzcGiJM777OnZQCGB9MSS1OzU1ILUIpisDAeHkgTvTCmgRsGi 1PTUirTMnBKENBMHJ8hwHqDhO0FqeIsLEnOLM9Mh8qcYFaXEeWeAJARAEhmleXC9sJTyilEc 6BVh3maQKh5gOoLrfgU0mAlocNf9ayCDSxIRUlINjGU+H8rPBbZIhH7Yc8SUeVlgxuWdJt9W u70wnufPK1d/Pi6cQzNhxfk5/OL6Dr3vL/w7wPnp27Sc7KPf9587xvV5e+LEm3+cljdXKq3/ tnJu7kuXC6VTmBtmCnzee9R7lfuu3MuMt09WdM6KZtILaC7SbmGY3SIbO73llJ/anKKuB3pa 8x/vYFNiKc5INNRiLipOBAD2kEFmBAMAAA== Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 01:58:02 -0000 On Sun, 7 Jul 2013, Gabor Pali wrote: > Author: pgj > Date: Sun Jul 7 06:07:53 2013 > New Revision: 42185 > URL: http://svnweb.freebsd.org/changeset/doc/42185 > > Log: > - Add a Q2 report entry on the xorg work > > Submitted by: zeising > > Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 05:55:16 2013 (r42184) > +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sun Jul 7 06:07:53 2013 (r42185) > @@ -1139,4 +1139,82 @@ > for more.

> > > + > + > + xorg on &os; > + > + > + > + x11@FreeBSD.org > + > + > + > + > + Niclas > + Zeising > + > + zeising@FreeBSD.org > + > + > + > + > + Koop > + Mast > + > + kwm@FreeBSD.org > + > + > + > + > + > + > + > + > + > +

During the beginning of this quarter, work focused on making > + the xorg update as robust and stable as possible in > + preparation for the merge to ports. As part of this exp-run > + were made, to find and resolve regressions and other issues. "As a part of this, Ports exp-runs were performed to find and resolve regressions and other issues." > + Once this was completed, xorg was updated to version > + 7.7 on May 25, after more than a year of hard work.

> + > +

After the update, work immediately shifted to focus on updating > + and patching xorg client libraries, since numerous > + security issues had been identified in those. Unfortunately, > + this took a little longer than anticipated, but all fixes were > + comitted eventually.

> + > +

There has also been work on making the new xorg > + distribution the default for &os; 9.1 and later. A patch > + was sent out and tested with good results, but this is currently > + postponed because switching virtual terminals is not working > + with the KMS driver.

I heard a rumor that the FreeBSD Foundation had funded some work for fixing VT switching with KMS? If so, that would be good to mention. > +

Currently, work is focusing on keeping xorg drivers > + and libraries up to date. Instead of making big updates every > + year or less, minor updates to some libraries, applications and > + drivers happen fairly regularly. Focus is also starting to > + shift towards newer versions of MESA and xorg-server, > + but this is still very experimental.

> + > + > + > + Continue the porting effort of recent versions of MESA. > + This is ongoing work, but integrating this into the development > + repo is hard work. Once this is completed, and KMS support for > + ATI is more mature, more testing can be done. > + > + Port Wayland. The future of graphical environments in open > + source operating system seem to be Wayland. This needs to be "seems" > + ported to &os; so that a wider audience can test it, and so that > + it eventually can be integrated into the ports tree, perhaps as > + a replacement for the current xorg. > + > + Look into replacements for HAL. HAL is used for > + hot-plugging of devices, but it has been long abandoned by Linux. > + A replacement, perhaps build on top of devd would be nice to comma after devd (or use parens for the parenthetical remark). -Ben > + have. This work should be coordinated with the &os; GNOME and > + KDE teams. > + > + > > From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 18:09:57 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 7AD8EB6D; Mon, 8 Jul 2013 18:09:57 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 534E11FB2; Mon, 8 Jul 2013 18:09:57 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r68I9vAm063491; Mon, 8 Jul 2013 18:09:57 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r68I9vMa063490; Mon, 8 Jul 2013 18:09:57 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201307081809.r68I9vMa063490@svn.freebsd.org> From: Benedict Reuschling Date: Mon, 8 Jul 2013 18:09:57 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42193 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 18:09:57 -0000 Author: bcr Date: Mon Jul 8 18:09:56 2013 New Revision: 42193 URL: http://svnweb.freebsd.org/changeset/doc/42193 Log: Typo fixes Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Sun Jul 7 22:18:00 2013 (r42192) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Mon Jul 8 18:09:56 2013 (r42193) @@ -71,7 +71,7 @@ Report//EN" two weeks, with no QA, and monthly sets that will undergo QA and will be available for 12 months.

Stacy Son and Brooks Davis talkes about packages for less +

Stacy Son and Brooks Davis talked about packages for less common architectures. Stacy has worked to bring QEMU usermode support to &os;. This means that MIPS or ARM &os; binaries can run on an x86 &os; system. The kernel will detect the foreign @@ -205,7 +205,7 @@ Report//EN" Davis now permits building the entire base system and creating a disk image without root privileges. This makes embedded development easier, as a number of users can now share an - expensive development box, capabily of performing builds + expensive development box, capably of performing builds quickly, without having to give all of them root.

This session also discussed the bmake import, which brings in @@ -213,7 +213,7 @@ Report//EN" should allow much more accurate dependency tracking and faster parallel and incremental builds. This should have some additional benefits to the rest of the project, for example by - making our tinderbox infrastcture, which notifies developers if + making our tinderbox infrastructure, which notifies developers if the have broken the build, able to report failures much more quickly.

@@ -268,7 +268,7 @@ Report//EN" virtualization options. This working group discussed the current status and future directions of several of them.

Xen is the de-facto standard for large-scale virtualisation and +

Xen is the de-facto standard for large-scale virtualization and &os; has supported running as a guest for some time. SpectraLogic has funded recent work on improving this, with two overlapping goals. The first is to allow &os; to run as the From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 19:03:31 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 5C32CE89; Mon, 8 Jul 2013 19:03:31 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 4DA5A12B5; Mon, 8 Jul 2013 19:03:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r68J3VB5081300; Mon, 8 Jul 2013 19:03:31 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r68J3VG0081299; Mon, 8 Jul 2013 19:03:31 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307081903.r68J3VG0081299@svn.freebsd.org> From: Warren Block Date: Mon, 8 Jul 2013 19:03:31 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42194 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 19:03:31 -0000 Author: wblock Date: Mon Jul 8 19:03:30 2013 New Revision: 42194 URL: http://svnweb.freebsd.org/changeset/doc/42194 Log: Add section on location of images. Rework examples to use instead of CDATA. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 18:09:56 2013 (r42193) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 19:03:30 2013 (r42194) @@ -1742,8 +1742,8 @@ This is the file called 'foo2' Images - Image support in the documentation is currently - extremely experimental. The mechanisms described here are + Image support in the documentation is somewhat + experimental. The mechanisms described here are unlikely to change, but that is not guaranteed. Installation of the @@ -1751,11 +1751,11 @@ This is the file called 'foo2' port is required. It is used to convert between the different image formats. This port is not in the textproc/docproj meta - port, it must be installed by hand. + port, it must be installed separately. The best example of what follows in practice is the doc/en_US.ISO8859-1/articles/vm-design/ - document. If the description that follows is unclear, take a + document. If the description that follows is unclear, look at the files in that directory to see how everything hangs together. Experiment with creating different formatted versions of the document to see how the image markup appears @@ -1766,7 +1766,7 @@ This is the file called 'foo2' Image Formats Two image formats are currently supported. Which to - choose will depend on the nature of the image. + use depends on the nature of the image. Images that are primarily vector based, such as network diagrams, time lines, and similar, should be in @@ -1787,8 +1787,8 @@ This is the file called 'foo2' expected that documentation will have a mix of EPS and PNG images. The Makefiles ensure that the correct format - image is chosen depending on the output format that you use - for your documentation. Do not commit the same + image is chosen depending on the output format used. + Do not commit the same image to the repository in two different formats. @@ -1801,11 +1801,46 @@ This is the file called 'foo2' + + Image File Locations + + Image files can be stored in one of several + locations, depending on the document and image: + + + + In the same directory as the document itself, usually + done for articles and small books that keep all their + files in a single directory. + + + + In a subdirectory of the main document. Typically + done when a large book uses separate subdirectories to + organize individual chapters. + + When images are stored in a subdirectory of the + main document directory, the subdirectory name must be + included in their paths in the + Makefile and the + imagedata element. + + + + In a subdirectory of + doc/share/images. + Images that apply to multiple translations are stored in + this upper level of the documentation file tree. + Generally, these are images that do not require + translation for use in non-English documents. + + + + Image Markup - The markup for an image is relatively simple. First, - markup a mediaobject. The + Images are included as part of a mediaobject. The mediaobject can contain other, more specific objects. We are concerned with two, the imageobject and the @@ -1814,7 +1849,7 @@ This is the file called 'foo2' Include one imageobject, and two textobject elements. The imageobject will point to the name of the - image file (without the extension). The + image file without the extension. The textobject elements contain information that will be presented to the user as well as, or instead of, the image itself. @@ -1825,10 +1860,10 @@ This is the file called 'foo2' When the reader is viewing the documentation in - HTML. In this case, each image will - need associated alternate text to show the user, typically - while the image is loading, or if they hover the mouse - pointer over the image. + HTML. In this case, each image + needs associated alternate text to show the user, typically + while the image is loading, or if the mouse + pointer is hovered over the image. @@ -1843,24 +1878,23 @@ This is the file called 'foo2' An example will make things easier to understand. Suppose there is an image called fig1.png that is to be included in the document. This image is of a rectangle - with an A inside it. The markup for this would be as - follows. + with an A inside it: - <mediaobject> - <imageobject> - <imagedata fileref="fig1"> - </imageobject> + mediaobject + imageobject + imagedata fileref="fig1" + imageobject - <textobject> - <literallayout class="monospaced">+---------------+ + textobject + literallayout class="monospaced"+---------------+ | A | -+---------------+</literallayout> - </textobject> ++---------------+literallayout + textobject - <textobject> - <phrase>A picture</phrase> - </textobject> -</mediaobject> + textobject + phraseA picturephrase + textobject +mediaobject @@ -1940,7 +1974,7 @@ IMAGES+= fig3.png chapter1/chapter.xml, chapter2/chapter.xml, and chapter3/chapter.xml. If each chapter - has images associated with it, it is suggested to place + has images associated with it, place those images in each chapter's subdirectory (chapter1/, chapter2/, and @@ -1958,14 +1992,14 @@ IMAGES+= fig3.png chapter1/chapter.xml should contain: - <mediaobject> - <imageobject> - <imagedata fileref="chapter1/fig1"> - </imageobject> + mediaobject + imageobject + imagedata fileref="chapter1/fig1" + imageobject … -</mediaobject> +mediaobject @@ -2011,18 +2045,18 @@ IMAGES= chapter1/fig1.png <literal>id</literal> on Chapters and Sections - - Introduction + chapter id="introduction" + titleIntroductiontitle - This is the introduction. It contains a subsection, - which is identified as well. + paraThis is the introduction. It contains a subsection, + which is identified as well.para - - More Details + sect1 id="introduction-moredetails" + titleMore Detailstitle - This is a subsection. - -]]> + paraThis is a subsection.para + sect1 +chapter Use descriptive values for id names. @@ -2043,9 +2077,9 @@ IMAGES= chapter1/fig1.png <sgmltag>anchor</sgmltag> - This paragraph has an embedded - link target in it. It will not - show up in the document.]]> + paraThis paragraph has an embedded + anchor id="para1"link target in it. It will not + show up in the document.para @@ -2066,11 +2100,11 @@ IMAGES= chapter1/fig1.png document that includes the id example shown above: - More information can be found - in . + paraMore information can be found + in xref linkend="introduction".para -More specific information can be found - in .]]> +paraMore specific information can be found + in xref linkend="introduction-moredetails".para The link text will be generated automatically, looking like (emphasized text indicates the @@ -2129,11 +2163,12 @@ IMAGES= chapter1/fig1.png document that includes the id example. - More information can be found in the - sample introduction. + paraMore information can be found in the + link linkend="introduction"sample introductionlink.para -More specific information can be found in the - sample introduction with more details section.]]> +paraMore specific information can be found in the + link linkend="introduction-moredetails"sample introduction with + more detailslink section.para This output will be generated (emphasized text is used to show the @@ -2181,12 +2216,12 @@ IMAGES= chapter1/fig1.png Usage for book links: - Read the SVN - introduction, then pick the nearest mirror from - the list of Subversion - mirror sites.]]> + paraRead the ulink + url="&url.books.handbook;/svn.html#svn-intro"SVN + introductionulink, then pick the nearest mirror from + the list of ulink + url="&url.books.handbook;/subversion-mirrors.html"Subversion + mirror sitesulink.para Appearance: @@ -2199,9 +2234,10 @@ IMAGES= chapter1/fig1.png Usage for article links: - Read this article - about the BSD license, or just the introduction.]]> + paraRead this + ulink url="&url.articles.bsdl-gpl;"article + about the BSD licenseulink, or just the + ulink url="&url.articles.bsdl-gpl;#intro"introductionulink.para Appearance: @@ -2215,9 +2251,8 @@ IMAGES= chapter1/fig1.png Usage: - Of course, you could stop reading this document and - go to the FreeBSD - home page instead.]]> + paraOf course, you could stop reading this document and go to the + ulink url="&url.base;/index.html"FreeBSD home pageulink instead.para Appearance: @@ -2232,10 +2267,10 @@ IMAGES= chapter1/fig1.png Usage: - Wikipedia has an excellent reference on - GUID - Partition Tables.]]> + paraWikipedia has an excellent reference on + ulink + url="http://en.wikipedia.org/wiki/GUID_Partition_Table"GUID + Partition Tablesulink.para Appearance: @@ -2247,9 +2282,9 @@ IMAGES= chapter1/fig1.png The link text can be omitted to show the actual URL: - Wikipedia has an excellent reference on - GUID Partition Tables: .]]> + paraWikipedia has an excellent reference on + GUID Partition Tables: ulink + url="http://en.wikipedia.org/wiki/GUID_Partition_Table"ulink.para Appearance: From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 19:21:14 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 3EA3D3B6; Mon, 8 Jul 2013 19:21:14 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 16D371377; Mon, 8 Jul 2013 19:21:14 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r68JLDWd087174; Mon, 8 Jul 2013 19:21:13 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r68JLDlp087173; Mon, 8 Jul 2013 19:21:13 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307081921.r68JLDlp087173@svn.freebsd.org> From: Warren Block Date: Mon, 8 Jul 2013 19:21:13 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42195 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 19:21:14 -0000 Author: wblock Date: Mon Jul 8 19:21:13 2013 New Revision: 42195 URL: http://svnweb.freebsd.org/changeset/doc/42195 Log: Add explanation and an example for images stored in doc/share/images. Fix a misformed endtag attribute. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 19:03:30 2013 (r42194) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 19:21:13 2013 (r42195) @@ -1828,11 +1828,14 @@ This is the file called 'foo2' In a subdirectory of - doc/share/images. - Images that apply to multiple translations are stored in + doc/share/images + named after the document. For example, images for the + Handbook are stored in doc/share/images/books/handbook. + Images that work for multiple translations are stored in this upper level of the documentation file tree. - Generally, these are images that do not require - translation for use in non-English documents. + Generally, these are images that can be used unchanged in + non-English translations of the document. @@ -2221,7 +2224,7 @@ IMAGES= chapter1/fig1.png introductionulink, then pick the nearest mirror from the list of ulink url="&url.books.handbook;/subversion-mirrors.html"Subversion - mirror sitesulink.para + mirror sitesulink.para Appearance: From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 19:34:03 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id E5267625; Mon, 8 Jul 2013 19:34:03 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id A0C25147E; Mon, 8 Jul 2013 19:34:03 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r68JY2wc035905; Mon, 8 Jul 2013 13:34:02 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r68JY2jM035902; Mon, 8 Jul 2013 13:34:02 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 8 Jul 2013 13:34:02 -0600 (MDT) From: Warren Block To: Benedict Reuschling Subject: Re: svn commit: r42193 - head/en_US.ISO8859-1/htdocs/news/status In-Reply-To: <201307081809.r68I9vMa063490@svn.freebsd.org> Message-ID: References: <201307081809.r68I9vMa063490@svn.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Mon, 08 Jul 2013 13:34:02 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 19:34:04 -0000 On Mon, 8 Jul 2013, Benedict Reuschling wrote: > Author: bcr > Date: Mon Jul 8 18:09:56 2013 > New Revision: 42193 > URL: http://svnweb.freebsd.org/changeset/doc/42193 > > Log: > Typo fixes > > Modified: > head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml > > Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Sun Jul 7 22:18:00 2013 (r42192) > +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Mon Jul 8 18:09:56 2013 (r42193) > @@ -71,7 +71,7 @@ Report//EN" > two weeks, with no QA, and monthly sets that will undergo QA and > will be available for 12 months.

> > -

Stacy Son and Brooks Davis talkes about packages for less > +

Stacy Son and Brooks Davis talked about packages for less > common architectures. Stacy has worked to bring QEMU usermode > support to &os;. This means that MIPS or ARM &os; binaries can > run on an x86 &os; system. The kernel will detect the foreign > @@ -205,7 +205,7 @@ Report//EN" > Davis now permits building the entire base system and creating a > disk image without root privileges. This makes embedded > development easier, as a number of users can now share an > - expensive development box, capabily of performing builds > + expensive development box, capably of performing builds > quickly, without having to give all of them root.

Probably that should just be "capable". From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 21:52:48 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 896A7163; Mon, 8 Jul 2013 21:52:48 +0000 (UTC) (envelope-from flo@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 6199A1B26; Mon, 8 Jul 2013 21:52:48 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r68Lqmui031831; Mon, 8 Jul 2013 21:52:48 GMT (envelope-from flo@svn.freebsd.org) Received: (from flo@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r68Lqm5j031829; Mon, 8 Jul 2013 21:52:48 GMT (envelope-from flo@svn.freebsd.org) Message-Id: <201307082152.r68Lqm5j031829@svn.freebsd.org> From: Florian Smeets Date: Mon, 8 Jul 2013 21:52:48 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42197 - in head/en_US.ISO8859-1: books/handbook/eresources share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 21:52:48 -0000 Author: flo (ports committer) Date: Mon Jul 8 21:52:47 2013 New Revision: 42197 URL: http://svnweb.freebsd.org/changeset/doc/42197 Log: Add -fortran@ list. Approved by: gjb Modified: head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml head/en_US.ISO8859-1/share/xml/mailing-lists.ent Modified: head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml Mon Jul 8 20:46:26 2013 (r42196) +++ head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml Mon Jul 8 21:52:47 2013 (r42197) @@ -294,6 +294,11 @@ + &a.fortran.name; + Fortran on &os; + + + &a.fs.name; File systems @@ -1280,6 +1285,19 @@ + &a.fortran.name; + + + Fortran on &os; + + This is the mailing list for discussion of Fortran + related ports on &os;: compilers, libraries, scientific + and engineering applications from laptops to HPC clusters. + + + + + &a.fs.name; Modified: head/en_US.ISO8859-1/share/xml/mailing-lists.ent ============================================================================== --- head/en_US.ISO8859-1/share/xml/mailing-lists.ent Mon Jul 8 20:46:26 2013 (r42196) +++ head/en_US.ISO8859-1/share/xml/mailing-lists.ent Mon Jul 8 21:52:47 2013 (r42197) @@ -190,6 +190,10 @@ FreeBSD FireWire (IEEE 1394) discussion mailing list"> freebsd-firewire"> + +Fortran on FreeBSD mailing list"> +freebsd-fortran"> + FreeBSD file system project mailing list"> freebsd-fs"> From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 22:14:37 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 026FE847; Mon, 8 Jul 2013 22:14:35 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 3D96C1C24; Mon, 8 Jul 2013 22:14:34 +0000 (UTC) X-AuditID: 12074423-b7f168e00000095a-73-51db3897d2d6 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id F8.1A.02394.7983BD15; Mon, 8 Jul 2013 18:09:28 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r68M9R1V007710; Mon, 8 Jul 2013 18:09:27 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r68M9PuK026561 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 8 Jul 2013 18:09:26 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r68M9Oen002467; Mon, 8 Jul 2013 18:09:24 -0400 (EDT) Date: Mon, 8 Jul 2013 18:09:24 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42194 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: <201307081903.r68J3VG0081299@svn.freebsd.org> Message-ID: References: <201307081903.r68J3VG0081299@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrAIsWRmVeSWpSXmKPExsUixCmqrTvD4nagwd29zBY/Ph5isrixaD+T xe7+XmaLy+8nsjiweMz4NJ8lgDGKyyYlNSezLLVI3y6BK+P5lIssBdNFK77um8zewNgm2MXI ySEhYCJx8tlvZghbTOLCvfVsXYxcHEIC+xglFsyYzw6SEBLYwCixflopROIgk8SzvkZGiES9 xM07t8FsFgEtiT+Tp4NNYhNQkZj5ZiMbiC0ioCrxvXsVE4jNLBAlsWdpI2sXIweHsECExKYV lSBhTgEriU0fX4K18go4Sux8/4kNYrylxIHr08HGiwroSKzeP4UFokZQ4uTMJywQIy0lzv25 zjaBUXAWktQsJKkFjEyrGGVTcqt0cxMzc4pTk3WLkxPz8lKLdM30cjNL9FJTSjcxggKW3UV5 B+Ofg0qHGAU4GJV4eGdcvBUoxJpYVlyZe4hRkoNJSZR3n9ntQCG+pPyUyozE4oz4otKc1OJD jBIczEoivC9UgXK8KYmVValF+TApaQ4WJXHeZ0/PBgoJpCeWpGanphakFsFkZTg4lCR4vcyB GgWLUtNTK9Iyc0oQ0kwcnCDDeYCGZ4HU8BYXJOYWZ6ZD5E8xKkqJ84aCJARAEhmleXC9sITy ilEc6BVhiCoeYDKC634FNJgJaHBD2i2QwSWJCCmpBsawG/1+XZ+/rEj64TiPu9Ug4fvM3aZh Ivv3b9Rg5pgo+1DFcf0vefWVst+PXFDR3GTY29HyMq0sZnebWuhtTsOkPpZ2uUumb5l0JxdJ vdne+fNJEesxI58j5woO9iw0UG7w+Fl28NXql7vEHzRPmM0RdbT1Z0S3wL78W6//W4jOuBj8 h0vDPEqJpTgj0VCLuag4EQAIEJLLAwMAAA== Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 22:14:37 -0000 On Mon, 8 Jul 2013, Warren Block wrote: > Author: wblock > Date: Mon Jul 8 19:03:30 2013 > New Revision: 42194 > URL: http://svnweb.freebsd.org/changeset/doc/42194 > > Log: > Add section on location of images. Rework examples to use > instead of CDATA. > > Modified: > head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > > Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 18:09:56 2013 (r42193) > +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 19:03:30 2013 (r42194) > @@ -1751,11 +1751,11 @@ This is the file called 'foo2' > port is required. It is used to convert between the different > image formats. This port is not in > the textproc/docproj meta > - port, it must be installed by hand. > + port, it must be installed separately. > > The best example of what follows in practice is the > doc/en_US.ISO8859-1/articles/vm-design/ > - document. If the description that follows is unclear, take a > + document. If the description that follows is unclear, > look at the files in that directory to see how everything > hangs together. Experiment with creating different formatted "hangs together" seems similarly informal to "take a look" > versions of the document to see how the image markup appears > @@ -1825,10 +1860,10 @@ This is the file called 'foo2' > > > When the reader is viewing the documentation in I think the "When" is superfluous here? > - HTML. In this case, each image will > - need associated alternate text to show the user, typically > - while the image is loading, or if they hover the mouse > - pointer over the image. > + HTML. In this case, each image > + needs associated alternate text to show the user, typically I hung up a little parsing "each image needs associated alternate text to show the user", but I'm not convinced that it's actually wrong. I sondered adding "an" before "associated" and "to" after "show". > + while the image is loading, or if the mouse > + pointer is hovered over the image. > > > The programlistings (not shown) are a bit hard to read in source form due to long lines. I guess it's best to review those in rendered form, anyway. -Ben From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 00:45:50 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 6430CEC6; Tue, 9 Jul 2013 00:45:50 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 0AB88194C; Tue, 9 Jul 2013 00:45:49 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r690HC9b037930; Mon, 8 Jul 2013 18:17:12 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r690HC3u037927; Mon, 8 Jul 2013 18:17:12 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 8 Jul 2013 18:17:12 -0600 (MDT) From: Warren Block To: Benjamin Kaduk Subject: Re: svn commit: r42194 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: Message-ID: References: <201307081903.r68J3VG0081299@svn.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Mon, 08 Jul 2013 18:17:12 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 00:45:50 -0000 On Mon, 8 Jul 2013, Benjamin Kaduk wrote: > On Mon, 8 Jul 2013, Warren Block wrote: > >> Author: wblock >> Date: Mon Jul 8 19:03:30 2013 >> New Revision: 42194 >> URL: http://svnweb.freebsd.org/changeset/doc/42194 >> >> Log: >> Add section on location of images. Rework examples to use >> instead of CDATA. >> >> Modified: >> head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml >> >> Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml >> ============================================================================== >> --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon >> Jul 8 18:09:56 2013 (r42193) >> +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon >> Jul 8 19:03:30 2013 (r42194) >> @@ -1751,11 +1751,11 @@ This is the file called 'foo2' >> port is required. It is used to convert between the different >> image formats. This port is not in >> the textproc/docproj meta >> - port, it must be installed by hand. >> + port, it must be installed separately. >> >> The best example of what follows in practice is the >> doc/en_US.ISO8859-1/articles/vm-design/ >> - document. If the description that follows is unclear, take a >> + document. If the description that follows is unclear, >> look at the files in that directory to see how everything >> hangs together. Experiment with creating different formatted > > "hangs together" seems similarly informal to "take a look" Agreed. >> versions of the document to see how the image markup appears >> @@ -1825,10 +1860,10 @@ This is the file called 'foo2' >> >> >> When the reader is viewing the documentation in > > I think the "When" is superfluous here? > >> - HTML. In this case, each image will >> - need associated alternate text to show the user, typically >> - while the image is loading, or if they hover the mouse >> - pointer over the image. >> + HTML. In this case, each image >> + needs associated alternate text to show the user, typically > > I hung up a little parsing "each image needs associated alternate text to > show the user", but I'm not convinced that it's actually wrong. I sondered > adding "an" before "associated" and "to" after "show". The more I look at the section, the more it appears to be replaceable with a simple paragraph rather than an overly-complicated list. >> + while the image is loading, or if the mouse >> + pointer is hovered over the image. >> >> >> > > The programlistings (not shown) are a bit hard to read in source form due to > long lines. I guess it's best to review those in rendered form, anyway. Agreed on that also. The problem is that inside a , whitespace is significant. I'm not sure if there is a good solution. From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 00:53:37 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 41457178; Tue, 9 Jul 2013 00:53:37 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 32B40199E; Tue, 9 Jul 2013 00:53:37 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r690rbpQ078827; Tue, 9 Jul 2013 00:53:37 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r690rbuX078826; Tue, 9 Jul 2013 00:53:37 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307090053.r690rbuX078826@svn.freebsd.org> From: Warren Block Date: Tue, 9 Jul 2013 00:53:37 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42198 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 00:53:37 -0000 Author: wblock Date: Tue Jul 9 00:53:36 2013 New Revision: 42198 URL: http://svnweb.freebsd.org/changeset/doc/42198 Log: Improve clarity, get the hippo down off the stilts. Some improvements suggested by bjk@. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 21:52:47 2013 (r42197) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 00:53:36 2013 (r42198) @@ -1746,27 +1746,25 @@ This is the file called 'foo2' experimental. The mechanisms described here are unlikely to change, but that is not guaranteed. - Installation of the + To provide conversion between different image formats, the graphics/ImageMagick - port is required. It is used to convert between the different - image formats. This port is not in + port must be installed. This port is not included in the textproc/docproj meta - port, it must be installed separately. + port, and must be installed separately. - The best example of what follows in practice is the + A good example of the use of images is the doc/en_US.ISO8859-1/articles/vm-design/ - document. If the description that follows is unclear, - look at the files in that directory to see how everything - hangs together. Experiment with creating different formatted - versions of the document to see how the image markup appears - in the formatted output. + document. Examine the files in that directory to see how + these elements are used together. Build different output + formats to see how the format determines what images are shown + in the rendered document. Image Formats - Two image formats are currently supported. Which to - use depends on the nature of the image. + Two image formats are currently supported. The type of + image determines which format to use. Images that are primarily vector based, such as network diagrams, time lines, and similar, should be in @@ -1780,7 +1778,7 @@ This is the file called 'foo2' extension. These are the only formats in which - images should be committed to the Subversion + images should be committed to the documentation repository. Use the appropriate format for each image. It is to be @@ -1857,30 +1855,16 @@ This is the file called 'foo2' that will be presented to the user as well as, or instead of, the image itself. - There are two circumstances where this can - happen. + Text elements are shown to the reader in several + situations. When the document is viewed in + HTML, text elements are shown while the + image is loading, or if the mouse pointer is hovered over the + image, or if a text-only browser is being used. In formats + like plain text where graphics are not possible, the text + elements are shown instead of the graphical ones. - - - When the reader is viewing the documentation in - HTML. In this case, each image - needs associated alternate text to show the user, typically - while the image is loading, or if the mouse - pointer is hovered over the image. - - - - When the reader is viewing the documentation in - plain text. In this case, each image should have an - ASCII art equivalent to show the - user. - - - - - An example will make things easier to understand. Suppose - there is an image called fig1.png that is - to be included in the document. This image is of a rectangle + This example shows how to include an image called + fig1.png in a document. The image is a rectangle with an A inside it: mediaobject @@ -2016,8 +2000,6 @@ IMAGES+= fig3.png … IMAGES= chapter1/fig1.png … - - Then everything will work. From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 05:34:53 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 63C3ABE0; Tue, 9 Jul 2013 05:34:53 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 5621E18CA; Tue, 9 Jul 2013 05:34:53 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r695YrG8061390; Tue, 9 Jul 2013 05:34:53 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r695YrlG061389; Tue, 9 Jul 2013 05:34:53 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307090534.r695YrlG061389@svn.freebsd.org> From: Warren Block Date: Tue, 9 Jul 2013 05:34:53 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42199 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 05:34:53 -0000 Author: wblock Date: Tue Jul 9 05:34:52 2013 New Revision: 42199 URL: http://svnweb.freebsd.org/changeset/doc/42199 Log: Clarity improvements, convert the rest of examples using CDATA to . Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 00:53:36 2013 (r42198) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 05:34:52 2013 (r42199) @@ -195,33 +195,33 @@ - <book> - <bookinfo> - <title>Your Title Here</title> - - <author> - <firstname>Your first name</firstname> - <surname>Your surname</surname> - <affiliation> - <address><email>Your email address</email></address> - </affiliation> - </author> - - <copyright> - <year>1998</year> - <holder role="mailto:your email address">Your name</holder> - </copyright> - - <releaseinfo>$FreeBSD$</releaseinfo> - - <abstract> - <para>Include an abstract of the book's contents here.</para> - </abstract> - </bookinfo> + book + bookinfo + titleYour Title Heretitle + + author + firstnameYour first namefirstname + surnameYour surnamesurname + affiliation + addressemailYour email addressemailaddress + affiliation + author + + copyright + year1998year + holder role="mailto:your email address"Your nameholder + copyright + + releaseinfo$&os;$releaseinfo + + abstract + paraInclude an abstract of the book's contents here.para + abstract + bookinfo … -</book> +book @@ -245,33 +245,33 @@ - <article> - <articleinfo> - <title>Your title here</title> - - <author> - <firstname>Your first name</firstname> - <surname>Your surname</surname> - <affiliation> - <address><email>Your email address</email></address> - </affiliation> - </author> - - <copyright> - <year>1998</year> - <holder role="mailto:your email address">Your name</holder> - </copyright> - - <releaseinfo>$FreeBSD$</releaseinfo> - - <abstract> - <para>Include an abstract of the article's contents here.</para> - </abstract> - </articleinfo> + article + articleinfo + titleYour title heretitle + + author + firstnameYour first namefirstname + surnameYour surnamesurname + affiliation + addressemailYour email addressemailaddress + affiliation + author + + copyright + year1998year + holder role="mailto:your email address"Your nameholder + copyright + + releaseinfo$&os;$releaseinfo + + abstract + paraInclude an abstract of the article's contents here.para + abstract + articleinfo … -</article> +article @@ -286,11 +286,11 @@ A Simple Chapter - - The Chapter's Title + chapter + titleThe Chapter's Titletitle ... -]]> +chapter A chapter cannot be empty; it must contain elements in @@ -301,11 +301,11 @@ Empty Chapters - - This is An Empty Chapter + chapter + titleThis is An Empty Chaptertitle - -]]> + parapara +chapter @@ -330,45 +330,66 @@ Sections in Chapters - - A Sample Chapter + chapter + titleA Sample Chaptertitle - Some text in the chapter. + paraSome text in the chapter.para - - First Section (1.1) + sect1 + titleFirst Sectiontitle … - + sect1 - - Second Section (1.2) + sect1 + titleSecond Sectiontitle - - First Sub-Section (1.2.1) + sect2 + titleFirst Sub-Sectiontitle - - First Sub-Sub-Section (1.2.1.1) + sect3 + titleFirst Sub-Sub-Sectiontitle - … - - + … + sect3 + sect2 - - Second Sub-Section (1.2.2) + sect2 + titleSecond Sub-Section (1.2.2)title … - - -]]> + sect2 + sect1 +chapter - This example includes section numbers in the section - titles. You should not do this in your documents. Adding - the section numbers is carried out by the stylesheets (of - which more later), and you do not need to manage them - yourself. + Section numbers are automatically generated and + prepended to titles when the document is rendered to an + output format. The generated section numbers and titles + from the example above will be: + + + + 1.1. First Section + + + + 1.2. Second Section + + + + 1.2.1. First Sub-Section + + + + 1.2.1.1. First Sub-Sub-Section + + + + 1.2.2. Second Sub-Section + + @@ -382,27 +403,27 @@ parts. This cannot be done in an article. - - Introduction + part + titleIntroductiontitle - - Overview + chapter + titleOverviewtitle ... - + chapter - - What is FreeBSD? + chapter + titleWhat is FreeBSD?title ... - + chapter - - History + chapter + titleHistorytitle ... - -]]> + chapter +part @@ -428,8 +449,8 @@ Usage: - This is a paragraph. It can contain just about any - other element. ]]> + paraThis is a paragraph. It can contain just about any + other element.para Appearance: @@ -454,20 +475,20 @@ Usage: - A small excerpt from the US Constitution: + paraA small excerpt from the US Constitution:para -

- Preamble to the Constitution of the United States +blockquote + titlePreamble to the Constitution of the United Statestitle - Copied from a web site somewhere + attributionCopied from a web site somewhereattribution - We the People of the United States, in Order to form a more + paraWe the People of the United States, in Order to form a more perfect Union, establish Justice, insure domestic Tranquility, provide for the common defence, promote the general Welfare, and secure the Blessings of Liberty to ourselves and our Posterity, do ordain and establish this Constitution for the United States of - America. -

]]> + America.para +blockquote Appearance: @@ -537,10 +558,10 @@ Usage: - - Installing FreeBSD may make you want to delete Windows from your - hard disk. -]]> + warning + paraInstalling FreeBSD may make you want to delete Windows from your + hard disk.para +warning Appearance: @@ -588,39 +609,39 @@ Usage: - - - This is the first itemized item. - - - - This is the second itemized item. - - - - - - This is the first ordered item. - - - - This is the second ordered item. - - - - - - Do this. - - - - Then do this. - - - - And now do this. - -]]> + itemizedlist + listitem + paraThis is the first itemized item.para + listitem + + listitem + paraThis is the second itemized item.para + listitem +itemizedlist + +orderedlist + listitem + paraThis is the first ordered item.para + listitem + + listitem + paraThis is the second ordered item.para + listitem +orderedlist + +procedure + step + paraDo this.para + step + + step + paraThen do this.para + step + + step + paraAnd now do this.para + step +procedure Appearance: @@ -683,16 +704,16 @@ Usage: - When finished, the program will look like - this: + paraWhen finished, the program will look like + this:para -#include <stdio.h> +programlisting#include <stdio.h> int main(void) { printf("hello, world\n"); -}]]> +}programlisting Notice how the angle brackets in the #include line need to be referenced by @@ -715,49 +736,46 @@ main(void) Callouts - A callout is a mechanism for referring back to an - earlier piece of text or specific position within an earlier - example without linking to it within the text. - - To do this, mark areas of interest in the example - (programlisting, - literallayout, or whatever) with the + A callout is a visual marker for referring to a + piece of text or specific position within an + example. + + Callouts are marked with the co element. Each element must have a unique id assigned to it. After the - example include a calloutlist that refers - back to the example and provides additional - commentary. + example, include a calloutlist that describes + each callout. <sgmltag>co</sgmltag> and <sgmltag>calloutlist</sgmltag> - When finished, the program will look like - this: + paraWhen finished, the program will look like + this:para -#include <stdio.h> +programlisting#include <stdio.h> co id="co-ex-include" -int +int co id="co-ex-return" main(void) { - printf("hello, world\n"); -} + printf("hello, world\n"); co id="co-ex-printf" +}programlisting - - - Includes the standard IO header file. - - - - Specifies that main() returns an - int. - - - - The printf() call that writes - hello, world to standard output. - -]]> +calloutlist + callout arearefs="co-ex-include" + paraIncludes the standard IO header file.para + callout + + callout arearefs="co-ex-return" + paraSpecifies that functionmain()function returns an + int.para + callout + + callout arearefs="co-ex-printf" + paraThe functionprintf()function call that writes + literalhello, worldliteral to standard output.para + callout +calloutlist Appearance: @@ -820,28 +838,28 @@ main(void) Usage: - - - - - This is Column Head 1 - This is Column Head 2 - - - - - - Row 1, column 1 - Row 1, column 2 - - - - Row 2, column 1 - Row 2, column 2 - - - -]]> + informaltable pgwide="1" + tgroup cols="2" + thead + row + entryThis is Column Head 1entry + entryThis is Column Head 2entry + row + thead + + tbody + row + entryRow 1, column 1entry + entryRow 1, column 2entry + row + + row + entryRow 2, column 1entry + entryRow 2, column 2entry + row + tbody + tgroup +informaltable Appearance: @@ -878,7 +896,7 @@ main(void) Table borders can be suppressed by setting the frame attribute to none in the informaltable element. For example, - <informaltable frame="none">. + informaltable frame="none". Tables Where <literal>frame="none"</literal> @@ -981,16 +999,16 @@ main(void) Usage: - &prompt.user; ls -1 + screen&prompt.user; userinputls -1userinput foo1 foo2 foo3 -&prompt.user; ls -1 | grep foo2 +&prompt.user; userinputls -1 | grep foo2userinput foo2 -&prompt.user; su -Password: -&prompt.root; cat foo2 -This is the file called 'foo2']]> +&prompt.user; userinputsuuserinput +promptPassword: prompt +&prompt.root; userinputcat foo2userinput +This is the file called 'foo2'screen Appearance: @@ -1040,8 +1058,8 @@ This is the file called 'foo2' Usage: - FreeBSD is without doubt the - premiere Unix like operating system for the Intel architecture.]]> + paraFreeBSD is without doubt emphasistheemphasis + premiere Unix like operating system for the Intel architecture.para Appearance: @@ -1065,9 +1083,9 @@ This is the file called 'foo2' Usage: - However, make sure that the search does not go beyond the - boundary between local and public administration, - as RFC 1535 calls it.]]> + paraHowever, make sure that the search does not go beyond the + quoteboundary between local and public administrationquote, + as RFC 1535 calls it.para Appearance: @@ -1103,18 +1121,18 @@ This is the file called 'foo2' Usage: - To switch to the second virtual terminal, press - Alt - F1. - -To exit vi without saving changes, type - Esc: - q!. - -My window manager is configured so that - Alt - right - mouse button is used to move windows.]]> + paraTo switch to the second virtual terminal, press + keycombo action="simul"keycapAltkeycap + keycapF1keycapkeycombo.para + +paraTo exit commandvicommand without saving changes, type + keycombo action="seq"keycapEsckeycapkeycap:keycap + keycapqkeycapkeycap!keycapkeycombo.para + +paraMy window manager is configured so that + keycombo action="simul"keycapAltkeycap + mousebuttonrightmousebutton + keycombo mouse button is used to move windows.para Appearance: @@ -1215,22 +1233,22 @@ This is the file called 'foo2' Usage: - Sendmail is the most - widely used Unix mail application. + paraapplicationSendmailapplication is the most + widely used Unix mail application.para -Sendmail includes the - - sendmail - 8 - , &man.mailq.1;, and &man.newaliases.1; - programs. - -One of the command line parameters to - sendmail - 8 - , , will display the current +paraapplicationSendmailapplication includes the + citerefentry + refentrytitlesendmailrefentrytitle + manvolnum8manvolnum + citerefentry, &man.mailq.1;, and &man.newaliases.1; + programs.para + +paraOne of the command line parameters to citerefentry + refentrytitlesendmailrefentrytitle + manvolnum8manvolnum + citerefentry, option-bpoption, will display the current status of messages in the mail queue. Check this on the command - line by running sendmail -bp.]]> + line by running commandsendmail -bpcommand.para Appearance: @@ -1272,12 +1290,12 @@ This is the file called 'foo2' Usage: - The XML source for the Handbook in English is - found in /usr/doc/en_US.ISO8859-1/books/handbook/. The first - file is called book.xml in that - directory. There is also a Makefile - and a number of files with a .ent - extension.]]> + paraThe XML source for the Handbook in English is + found in filename class="directory"/usr/doc/en_US.ISO8859-1/books/handbook/filename. The first + file is called filenamebook.xmlfilename in that + directory. There is also a filenameMakefilefilename + and a number of files with a filename.entfilename + extension.para Appearance: @@ -1316,7 +1334,7 @@ This is the file called 'foo2' Usage: - Install the net/wireshark port to view network traffic.]]> + paraInstall the filename role="package"net/wiresharkfilename port to view network traffic.para Appearance: @@ -1352,17 +1370,17 @@ This is the file called 'foo2' Usage: - sio is used for serial - communication in FreeBSD. sio manifests - through a number of entries in /dev, including - /dev/ttyd0 and /dev/cuaa0. - -By contrast, network devices such as - ed0 do not appear in /dev. - -In MS-DOS, the first floppy drive is referred to as - a:. In FreeBSD it is - /dev/fd0.]]> + paradevicenamesiodevicename is used for serial + communication in FreeBSD. devicenamesiodevicename manifests + through a number of entries in filename/devfilename, including + filename/dev/ttyd0filename and filename/dev/cuaa0filename.para + +paraBy contrast, network devices such as + devicenameed0devicename do not appear in filename/devfilename.para + +paraIn MS-DOS, the first floppy drive is referred to as + devicenamea:devicename. In FreeBSD it is + filename/dev/fd0filename.para Appearance: @@ -1481,26 +1499,26 @@ This is the file called 'foo2' Usage: - The local machine can always be referred to by the - name localhost, which will have the IP - address 127.0.0.1. + paraThe local machine can always be referred to by the + name hostidlocalhosthostid, which will have the IP + address hostid role="ipaddr"127.0.0.1hostid.para -The FreeBSD.org +paraThe hostid role="domainname"FreeBSD.orghostid domain contains a number of different hosts, including - freefall.FreeBSD.org and - bento.FreeBSD.org. + hostid role="fqdn"freefall.FreeBSD.orghostid and + hostid role="fqdn"bento.FreeBSD.orghostid.para -When adding an IP alias to an - interface (using ifconfig) - always use a netmask of - 255.255.255.255 (which can +paraWhen adding an acronymIPacronym alias to an + interface (using commandifconfigcommand) + emphasisalwaysemphasis use a netmask of + hostid role="netmask"255.255.255.255hostid (which can also be expressed as - 0xffffffff). + hostid role="netmask"0xffffffffhostid).para -The MAC address uniquely identifies +paraThe acronymMACacronym address uniquely identifies every network card in existence. A typical - MAC address looks like - 08:00:20:87:ef:d0.]]> + acronymMACacronym address looks like + hostid role="mac"08:00:20:87:ef:d0hostid.para Appearance: @@ -1547,8 +1565,8 @@ This is the file called 'foo2' Usage: - To carry out most system administration functions - requires logging in as root.]]> + paraTo carry out most system administration functions + requires logging in as usernamerootusername.para Appearance: @@ -1587,19 +1605,19 @@ This is the file called 'foo2' Usage: - Two common targets in a Makefile - are all and - clean. + paraTwo common targets in a filenameMakefilefilename + are maketargetallmaketarget and + maketargetcleanmaketarget.para -Typically, invoking all will +paraTypically, invoking maketargetallmaketarget will rebuild the application, and invoking - clean will remove the temporary - files (.o for example) created by the - build process. - -clean may be controlled by a - number of variables, including CLOBBER - and RECURSE.]]> + maketargetcleanmaketarget will remove the temporary + files (filename.ofilename for example) created by the + build process.para + +paramaketargetcleanmaketarget may be controlled by a + number of variables, including makevarCLOBBERmakevar + and makevarRECURSEmakevar.para Appearance: @@ -1642,10 +1660,10 @@ This is the file called 'foo2' Usage: - The maxusers 10 line in the kernel + paraThe literalmaxusers 10literal line in the kernel configuration file determines the size of many system tables, and is a rough guide to how many simultaneous logins the system will - support.]]> + support.para Appearance: @@ -1675,7 +1693,7 @@ This is the file called 'foo2' Usage: - &prompt.user; man command]]> + screen&prompt.user; userinputman replaceablecommandreplaceableuserinputscreen Appearance: @@ -1693,13 +1711,13 @@ This is the file called 'foo2' Usage: - The maxusers n + paraThe literalmaxusers replaceablenreplaceableliteral line in the kernel configuration file determines the size of many system tables, and is a rough guide to how many simultaneous logins the system will - support. + support.para -For a desktop workstation, 32 is a good value - for n.]]> +paraFor a desktop workstation, literal32literal is a good value + for replaceablenreplaceable.para Appearance: @@ -1726,7 +1744,7 @@ This is the file called 'foo2' Usage: - Panic: cannot mount root]]> + screenerrornamePanic: cannot mount rooterrornamescreen Appearance: @@ -1781,8 +1799,8 @@ This is the file called 'foo2' images should be committed to the documentation repository. - Use the appropriate format for each image. It is to be - expected that documentation will have a mix of + Use the appropriate format for each image. Documentation + will often have a mix of EPS and PNG images. The Makefiles ensure that the correct format image is chosen depending on the output format used. @@ -1791,7 +1809,7 @@ This is the file called 'foo2' formats. - It is anticipated that the Documentation Project will + The Documentation Project may eventually switch to using the SVG (Scalable Vector Graphic) format for vector images. However, the current state of SVG capable editing tools makes From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 06:18:31 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id BB69C643; Tue, 9 Jul 2013 06:18:31 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 9DEC51A29; Tue, 9 Jul 2013 06:18:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r696IVdk073641; Tue, 9 Jul 2013 06:18:31 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r696IV2q073640; Tue, 9 Jul 2013 06:18:31 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307090618.r696IV2q073640@svn.freebsd.org> From: Warren Block Date: Tue, 9 Jul 2013 06:18:31 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42200 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 06:18:31 -0000 Author: wblock Date: Tue Jul 9 06:18:31 2013 New Revision: 42200 URL: http://svnweb.freebsd.org/changeset/doc/42200 Log: Whitespace-only changes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 05:34:52 2013 (r42199) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 06:18:31 2013 (r42200) @@ -463,8 +463,8 @@ Block Quotations A block quotation is an extended quotation from another - document that should not appear within the current - paragraph. These are rarely needed. + document that should not appear within the current paragraph. + These are rarely needed. Blockquotes can optionally contain a title and an attribution (or they can be left untitled and @@ -740,11 +740,11 @@ main(void) piece of text or specific position within an example. - Callouts are marked with the - co element. Each element must have a - unique id assigned to it. After the - example, include a calloutlist that describes - each callout. + Callouts are marked with the co + element. Each element must have a unique + id assigned to it. After the example, + include a calloutlist that describes each + callout. <sgmltag>co</sgmltag> and @@ -896,7 +896,8 @@ main(void) <para>Table borders can be suppressed by setting the <literal>frame</literal> attribute to <literal>none</literal> in the <sgmltag>informaltable</sgmltag> element. For example, - <literal><sgmltag class="starttag">informaltable frame="none"</sgmltag></literal>.</para> + <literal><sgmltag class="starttag">informaltable + frame="none"</sgmltag></literal>.</para> <example> <title>Tables Where <literal>frame="none"</literal> @@ -1225,8 +1226,7 @@ This is the file called 'foo2' HTML, appear visually better. This can be confusing, and sometimes the choice is not - always clear. Hopefully this example makes it - clearer. + always clear. Hopefully this example makes it clearer. Applications, Commands, and Options @@ -1587,9 +1587,8 @@ This is the file called 'foo2' Two elements exist to describe parts of - Makefiles, - maketarget and - makevar. + Makefiles, maketarget + and makevar. maketarget identifies a build target exported by a Makefile that can be @@ -1703,11 +1702,10 @@ This is the file called 'foo2' replaceable can be used in many different elements, including literal. - This example also shows that - replaceable should only be wrapped - around the content that the user is - meant to provide. The other content should be left - alone. + This example also shows that replaceable + should only be wrapped around the content that the user + is meant to provide. The other content + should be left alone. Usage: @@ -1746,7 +1744,6 @@ This is the file called 'foo2' screenerrornamePanic: cannot mount rooterrornamescreen - Appearance: @@ -1761,13 +1758,13 @@ This is the file called 'foo2' Image support in the documentation is somewhat - experimental. The mechanisms described here are - unlikely to change, but that is not guaranteed. + experimental. The mechanisms described here are unlikely to + change, but that is not guaranteed. To provide conversion between different image formats, the graphics/ImageMagick - port must be installed. This port is not included in - the textproc/docproj meta + port must be installed. This port is not included in the + textproc/docproj meta port, and must be installed separately. A good example of the use of images is the @@ -1800,28 +1797,27 @@ This is the file called 'foo2' repository. Use the appropriate format for each image. Documentation - will often have a mix of - EPS and PNG images. The + will often have a mix of EPS and + PNG images. The Makefiles ensure that the correct format image is chosen depending on the output format used. - Do not commit the same - image to the repository in two different - formats. + Do not commit the same image to the repository in + two different formats. - The Documentation Project may eventually - switch to using the SVG (Scalable Vector - Graphic) format for vector images. However, the current - state of SVG capable editing tools makes - this impractical. + The Documentation Project may eventually switch to using + the SVG (Scalable Vector Graphic) format + for vector images. However, the current state of + SVG capable editing tools makes this + impractical. Image File Locations - Image files can be stored in one of several - locations, depending on the document and image: + Image files can be stored in one of several locations, + depending on the document and image: @@ -1859,14 +1855,15 @@ This is the file called 'foo2' Image Markup - Images are included as part of a mediaobject. The + Images are included as part of a + mediaobject. The mediaobject can contain other, more specific objects. We are concerned with two, the imageobject and the textobject. - Include one imageobject, - and two textobject elements. The + Include one imageobject, and two + textobject elements. The imageobject will point to the name of the image file without the extension. The textobject elements contain information @@ -1882,8 +1879,8 @@ This is the file called 'foo2' elements are shown instead of the graphical ones. This example shows how to include an image called - fig1.png in a document. The image is a rectangle - with an A inside it: + fig1.png in a document. The image is a + rectangle with an A inside it: mediaobject imageobject @@ -1961,10 +1958,10 @@ IMAGES+= fig2.png IMAGES+= fig3.png … - Again, the Makefile will work out - the complete list of images it needs to build the source - document, you only need to list the image files - you provided. + Again, the Makefile will work out the + complete list of images it needs to build the source document, + you only need to list the image files you + provided. @@ -2182,7 +2179,8 @@ IMAGES= chapter1/fig1.png sample introduction. More specific information can be found in the - sample introduction with more details section. + sample introduction with more + details section. From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 06:27:56 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id C19DE949; Tue, 9 Jul 2013 06:27:56 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A4B221ABB; Tue, 9 Jul 2013 06:27:56 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r696Ru27076373; Tue, 9 Jul 2013 06:27:56 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r696RuOg076372; Tue, 9 Jul 2013 06:27:56 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307090627.r696RuOg076372@svn.freebsd.org> From: Warren Block Date: Tue, 9 Jul 2013 06:27:56 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42201 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 06:27:56 -0000 Author: wblock Date: Tue Jul 9 06:27:56 2013 New Revision: 42201 URL: http://svnweb.freebsd.org/changeset/doc/42201 Log: Remove a confusing paragraph whose net contribution is negative. Remove some from "Ports Collection", it's unnecessary. Make one example section consistent with the actual code. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 06:18:31 2013 (r42200) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Tue Jul 9 06:27:56 2013 (r42201) @@ -60,7 +60,7 @@ should be presented. The DocBook DTD is available from the - Ports Collection in the + Ports Collection in the textproc/docbook-xml-450 port. It is automatically installed as part of the textproc/docproj @@ -114,7 +114,7 @@ The &os; extensions are not (currently) in the - Ports Collection. They are stored in the &os; Subversion + Ports Collection. They are stored in the &os; Subversion tree, as head/share/xml/freebsd.dtd. @@ -1225,9 +1225,6 @@ This is the file called 'foo2' This makes the generated output, especially HTML, appear visually better. - This can be confusing, and sometimes the choice is not - always clear. Hopefully this example makes it clearer. - Applications, Commands, and Options @@ -1320,7 +1317,7 @@ This is the file called 'foo2' To include the name of a program from the &os; - Ports Collection in the document, use the + Ports Collection in the document, use the filename tag with the role attribute set to package. Since ports can be installed in @@ -2167,8 +2164,8 @@ IMAGES= chapter1/fig1.png link linkend="introduction"sample introductionlink.para paraMore specific information can be found in the - link linkend="introduction-moredetails"sample introduction with - more detailslink section.para + link linkend="introduction-moredetails"sample introduction with more + detailslink section.para This output will be generated (emphasized text is used to show the From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 06:36:51 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id B1B53B5A; Tue, 9 Jul 2013 06:36:51 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A47E41B1D; Tue, 9 Jul 2013 06:36:51 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r696ap3C079120; Tue, 9 Jul 2013 06:36:51 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r696apZ9079119; Tue, 9 Jul 2013 06:36:51 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201307090636.r696apZ9079119@svn.freebsd.org> From: Benedict Reuschling Date: Tue, 9 Jul 2013 06:36:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42202 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 06:36:51 -0000 Author: bcr Date: Tue Jul 9 06:36:51 2013 New Revision: 42202 URL: http://svnweb.freebsd.org/changeset/doc/42202 Log: Use a better word in a sentence. Suggested by: wblock Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Tue Jul 9 06:27:56 2013 (r42201) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-05-devsummit.xml Tue Jul 9 06:36:51 2013 (r42202) @@ -205,7 +205,7 @@ Report//EN" Davis now permits building the entire base system and creating a disk image without root privileges. This makes embedded development easier, as a number of users can now share an - expensive development box, capably of performing builds + expensive development box, capable of performing builds quickly, without having to give all of them root.

This session also discussed the bmake import, which brings in From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 07:05:20 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 74C40134; Tue, 9 Jul 2013 07:05:20 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 674081C22; Tue, 9 Jul 2013 07:05:20 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6975Khl087812; Tue, 9 Jul 2013 07:05:20 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6975KCf087811; Tue, 9 Jul 2013 07:05:20 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090705.r6975KCf087811@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 07:05:20 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42203 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 07:05:20 -0000 Author: pgj Date: Tue Jul 9 07:05:19 2013 New Revision: 42203 URL: http://svnweb.freebsd.org/changeset/doc/42203 Log: - Improve entries in response to bjk's and des' (private) feedback Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 06:36:51 2013 (r42202) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:05:19 2013 (r42203) @@ -1061,7 +1061,7 @@

On April 15th Dag-Erling Smørgrav and Xin Li took over as security officers for the &os; Project, and the team welcomed - Qing Li back in the team in June. This report briefly + Qing Li back to the team in June. This report briefly summarizes the work of the Security Team from April until the end of June.

@@ -1074,20 +1074,27 @@

FreeBSD-SA-13:06.mmap: Privilege escalation via mmap(), reported by Konstantin Belousov.

+ + +

The Security Team has contributed to the following errata + notices:

FreeBSD-EN-13:02.vtnet: vtnet(4) - network interface issue on QEMU 1.4.0 and later in 8.4-RELEASE, +

FreeBSD-EN-13:02.vtnet: Frames are not properly + forwarded to vtnet(4) when two or more MAC addresses + are configured on QEMU 1.4.0 and later in 8.4-RELEASE, reported by Julian Stecklina.
FreeBSD-EN-13:01.fxp: dhclient(8) utility - issue on fxp(4) network interface in 8.4-RELEASE, - reported by Michael L. Squires.
FreeBSD-EN-13:01.fxp: Initialization of + fxp(4) network interfaces results in an infinite loop + with dhclient(8) in 8.4-RELEASE, reported by Michael + L. Squires.

Per request of Baptiste Daroussin, the Security Team has also - reviewed the source code of Poudriere, the port build and test - system which is planned to be used for producing pkg(8) - ("new-style") packages on the &os; cluster.

Per the request of Baptiste Daroussin, the Security Team has + also reviewed the source code of Poudriere, the port build and + test system which is planned to be used for producing + pkg(8) ("new-style") packages on the &os; cluster.

@@ -1173,10 +1180,11 @@

During the beginning of this quarter, work focused on making the xorg update as robust and stable as possible in - preparation for the merge to ports. As part of this exp-run - were made, to find and resolve regressions and other issues. - Once this was completed, xorg was updated to version - 7.7 on May 25, after more than a year of hard work.

+ preparation for the merge to ports. As a part of this, ports + exp-runs were performed to find and resolve regressions and + other issues. Once this was completed, xorg was + updated to version 7.7 on May 25, after more than a year of hard + work.

After the update, work immediately shifted to focus on updating and patching xorg client libraries, since numerous @@ -1205,16 +1213,16 @@ ATI is more mature, more testing can be done. Port Wayland. The future of graphical environments in open - source operating system seem to be Wayland. This needs to be + source operating system seems to be Wayland. This needs to be ported to &os; so that a wider audience can test it, and so that it eventually can be integrated into the ports tree, perhaps as a replacement for the current xorg. Look into replacements for HAL. HAL is used for - hot-plugging of devices, but it has been long abandoned by Linux. - A replacement, perhaps build on top of devd would be nice to - have. This work should be coordinated with the &os; GNOME and - KDE teams. + hot-plugging of devices, but it has been long abandoned by + Linux. A replacement, perhaps build on top of devd(8), + would be nice to have. This work should be coordinated with the + &os; GNOME and KDE teams. From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 07:11:15 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 125543D2; Tue, 9 Jul 2013 07:11:15 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 034B61C61; Tue, 9 Jul 2013 07:11:15 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r697BE5k090485; Tue, 9 Jul 2013 07:11:14 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r697BE6o090484; Tue, 9 Jul 2013 07:11:14 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090711.r697BE6o090484@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 07:11:14 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42204 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 07:11:15 -0000 Author: pgj Date: Tue Jul 9 07:11:14 2013 New Revision: 42204 URL: http://svnweb.freebsd.org/changeset/doc/42204 Log: - Minor wording improvements for the ARM superpages report Submitted by: emaste, Zbyszek Bodek Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:05:19 2013 (r42203) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:11:14 2013 (r42204) @@ -658,11 +658,12 @@ -

The ARM architecture is more and more prevalent, not only in - the mobile and embedded space. Among the more interesting - industry trends emerging in the recent months, there has been - the concept of "ARM server". Some top-tier companies, e.g. - Dell and HP, have already started to develop such systems.

The ARM architecture is becoming more and more prevalent, with + increasing usage beyond the mobile and embedded space. Among + the more interesting industry trends emerging in the recent + months, there has been the concept of "ARM server". Some + top-tier companies, e.g. Dell and HP, have already started to + develop such systems.

Key to success of &os; in these new areas is dealing with the sophisticated features of the platform, for example adding @@ -696,7 +697,7 @@

This project is jointly sponsored by The &os; Foundation and - Semihalf sp.j.

+ Semihalf.

From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 07:24:27 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id D923F9A9; Tue, 9 Jul 2013 07:24:27 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id BCCEA1CF3; Tue, 9 Jul 2013 07:24:27 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r697ORQh093839; Tue, 9 Jul 2013 07:24:27 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r697ORBx093838; Tue, 9 Jul 2013 07:24:27 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090724.r697ORBx093838@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 07:24:27 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42205 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 07:24:27 -0000 Author: pgj Date: Tue Jul 9 07:24:27 2013 New Revision: 42205 URL: http://svnweb.freebsd.org/changeset/doc/42205 Log: - Further improvements and fixes, suggested by theraven Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:11:14 2013 (r42204) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:24:27 2013 (r42205) @@ -173,12 +173,15 @@ -

A VT-d driver was developed that implements the - busdma(9) interface using the DMA Remap units (DMARs) - found in current Intel chipsets. The driver provides - reliability and security improvements for the system by - facilitating restricted access to main memory from busmastering - devices.

Intel VT-d is a set of extensions that were originally designed + to allow virtualizing devices. It allows safe access to physical + devices from virtual machines and can also be used for better + isolation and performance increases. A VT-d driver was + developed that implements the busdma(9) interface using + the DMA Remap units (DMARs) found in current Intel chipsets. + The driver provides reliability and security improvements for + the system by facilitating restricted access to main memory from + busmastering devices.

It also eliminates bounce buffering (copying) by allocating remapped regions that satisfy a device's access limitations.

@@ -187,7 +190,7 @@ driver will also provide PCI pass-through functionality for hypervisors.

This project is sponsored by the &os; Foundation.

This project is sponsored by The &os; Foundation.

@@ -240,7 +243,7 @@

Testing on diverse workloads and on real multi-socket machines is required.

This project is sponsored by the &os; Foundation.

This project is sponsored by The &os; Foundation.

@@ -251,7 +254,7 @@ - HAST Module for <tt>bsnmpd(1)</tt> + <tt>bsnmpd(1)</tt> Support in <tt>hastd(8)</tt> @@ -266,9 +269,11 @@ -

HAST module for bsnmpd(1) has been committed to - -CURRENT and merged to 8.x and 9.x -STABLE branches. The module - allows to monitor and manage HAST via the SNMP protocol.

A hastd(8) module for bsnmpd(1) has been + committed to &os; head and merged to stable/8 + and stable/9 branches recently. This module makes it + possible to monitor and manage hastd(8) via the SNMP + protocol.

@@ -356,7 +361,7 @@ -

The KDE/&os; Team have continued to improve the experience of +

The KDE/&os; Team has continued to improve the experience of KDE software and Qt under &os;. During this quarter, the team has kept most of the KDE and Qt ports up-to-date, working on the following releases:

@@ -434,8 +439,8 @@

The Documentation Project has been using old versions of markup standards until recently when we switched to a real XML toolchain and DocBook 4.5. However, we still depend on obsolete - technologies — DSSSL and Jade. Besides, DocBook 5.0 - provides cleaner markup and some nice new features.

+ technologies — DSSSL and Jade. DocBook 5.0 provides + cleaner markup and some nice new features.

The objective of this project is to upgrade the documentation set to DocBook 5.0 and to find a way to properly render our @@ -787,8 +792,8 @@ user-friendly administration utilities, for example iscsictl(8) which displays SCSI device nodes for each iSCSI session. This frees the user from getting the same - information through camcontrol(8). But there are - improvements in logging and manual pages as well.

+ information through camcontrol(8). There are also + improvements in logging and manual pages.

Once the iSER support becomes stable, the work will focus on performance optimizations. The plan is to commit both the new @@ -797,7 +802,7 @@ iWARP stack (useful mostly for testing and development), SCSI passthrough and various other improvements.

This project is being sponsored by the &os; Foundation.

This project is being sponsored by The &os; Foundation.

@@ -836,14 +841,14 @@ &os;.org until the zone signatures were refreshed.

Created the freebsd-dtrace mailing list per George - Neville-Neil.

Created the freebsd-dtrace mailing list, requested + by George Neville-Neil.

Resurrected the freebsd-testing mailing list per - Garrett Cooper.

Resurrected the freebsd-testing mailing list, + requested by Garrett Cooper.

Created the freebsd-tex mailing list per Hiroki - Sato.

Created the freebsd-tex mailing list, requested by + Hiroki Sato.

In response to another comment that our message rejection message was unclear in the case that greylisting was the @@ -860,7 +865,7 @@

Initiated de-orbit for freebsd-mozilla in favor of +

Began replacing freebsd-mozilla with freebsd-gecko.

@@ -893,9 +898,9 @@ -

Capsicum (lightweight OS capability and sandbox framework) is - being actively worked on. In the last few months the following - tasks have been completed:

Capsicum, lightweight OS capability and sandboxing framework, + is being actively worked on. In the last few months the + following tasks have been completed:

Committed Capsicum overhaul to &os; head (r247602). @@ -953,7 +958,7 @@ for example. This requires deep understanding of how the tool in question works, not necessarily only Capsicum.
-
This work is being sponsored by the &os; Foundation.
+
This work is being sponsored by The &os; Foundation.
@@ -1126,25 +1131,25 @@ they are working on these days. There was a detour this year to visit the beautiful city of Naples of Italy, the home of pizza. Fortunately, the event has again gained support from numerous - and generous sponsors, such as the &os; Foundation, the EMC + and generous sponsors, such as The &os; Foundation, the EMC Corporation, iXsystems, FreeBSDMall, BSD Magazine, and many others which enabled us to cover the costs of travel and accommodation for the speakers. We are really grateful for - this!
+ this.

Similarly to the previous years, the whole event started with a - common dinner in the downtown (somewhere around the Ireland - Irish Pub) on Friday which suddenly turned into a do-it-yourself - pizza-fest. Then it was followed by the Saturday event at the - Institute of Biostructures and Bioimaging. There we had a lot - of attendees for the associated BSDA exam in the morning — - 8 persons! The event itself had many interesting topics as - well, for example moving MCLinker into the BSD world, - organization and culture of the &os; Project, the new - callout(9) framework, building and testing ports with - Poudriere and Tinderbox, &os; in the embedded space, or building - reliable VPN networks with OpenBSD. See the links in the report - for more.
+ dinner in the downtown (somewhere around the Irish Pub) on + Friday which suddenly turned into a do-it-yourself pizza-fest. + Then it was followed by the Saturday event at the Institute of + Biostructures and Bioimaging. There we had a lot of attendees + for the associated BSDA exam in the morning — 8 persons. + The event itself had many interesting topics as well, for + example moving MCLinker into the BSD world, organization and + culture of the &os; Project, the new callout(9) + framework, building and testing ports with Poudriere and + Tinderbox, &os; in the embedded space, or building reliable VPN + networks with OpenBSD. See the links in the report for + more.
From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 07:30:13 2013 Return-Path:
Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id A2F35D28; Tue, 9 Jul 2013 07:30:13 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 85CBE1D4B; Tue, 9 Jul 2013 07:30:13 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r697UDUv094669; Tue, 9 Jul 2013 07:30:13 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r697UDpH094668; Tue, 9 Jul 2013 07:30:13 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090730.r697UDpH094668@svn.freebsd.org> From: Gabor Pali
Date: Tue, 9 Jul 2013 07:30:13 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42206 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $"
List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 07:30:13 -0000 Author: pgj Date: Tue Jul 9 07:30:13 2013 New Revision: 42206 URL: http://svnweb.freebsd.org/changeset/doc/42206 Log: - Add Q2 status report entry for the FreeBSD Haskell team Submitted by: ashish Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:24:27 2013 (r42205) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:30:13 2013 (r42206) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 21 entries and we hope you enjoy reading it.
+ contains 22 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1231,4 +1231,66 @@ &os; GNOME and KDE teams. + + + &os; Haskell Ports + + + + + Gábor + Páli + + pgj@FreeBSD.org + + + + + Ashish + SHUKLA + + ashish@FreeBSD.org + + + + + &os; Haskell wiki page + &os; Haskell ports repository + Experimental pkg(8) package repositories + + + +
We are proud to announce &os; Haskell Team has updated the + Haskell Platform to 2013.2.0.0, GHC to 7.6.3, as well as updated + existing ports to their latest stable versions. In this update, + we provided experimental support for LLVM-based code generation + (disabled by default) to Haskell ports. We also added number of + new ports, which brings their count in &os; Ports Collection to + 402, and now Haskell ports play nicer with + portmaster(8)-based upgrades.
+ +
In cooperation with Konstantin Belousov and Dimitry Andric, we + have managed to unbreak build of GHC on 32-bit 10.x systems, so + we have packages for 10.x again. However, it turned out that + this bug (in thread signal delivery) can also affect the + building process for other platforms as well, which explains + some of the strange build breakages our users experienced in the + past.
+ +
We have also learned that there is an ongoing work + in GHC upstream which will allow us to provide support for + building with Clang natively once GHC 7.8 becomes part of + the Haskell Platform.
+ + + + Test experimental Clang/LLVM code generation support to + enable it by default. + + Commit pending Haskell ports to the ports tree. + + Port more (popular) Cabal packages. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 07:34:54 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id D155C1E0; Tue, 9 Jul 2013 07:34:54 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 540911DBA; Tue, 9 Jul 2013 07:34:54 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r697Yrb0096818; Tue, 9 Jul 2013 07:34:53 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r697YrkG096817; Tue, 9 Jul 2013 07:34:53 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090734.r697YrkG096817@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 07:34:53 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42207 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 07:34:55 -0000 Author: pgj Date: Tue Jul 9 07:34:53 2013 New Revision: 42207 URL: http://svnweb.freebsd.org/changeset/doc/42207 Log: - Add a Q2 report on the recent V4L2 linuxulator work Submitted by: netchild Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:30:13 2013 (r42206) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:34:53 2013 (r42207) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 22 entries and we hope you enjoy reading it.
+ contains 23 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1293,4 +1293,30 @@ Port more (popular) Cabal packages. + + + V4L2 Update in the Linuxulator + + + + + Alexander + Leidinger + + netchild@FreeBSD.org + + + + + + +
The V4L2 support in the linuxulator was updated in &os; + head. This lets Skype v4 to display video.
+ + + + Find out why audio in Skype v4 stops working after some + calls. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 07:51:24 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id C881D621; Tue, 9 Jul 2013 07:51:24 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id BB9401E66; Tue, 9 Jul 2013 07:51:24 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r697pOZU002162; Tue, 9 Jul 2013 07:51:24 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r697pOaD002161; Tue, 9 Jul 2013 07:51:24 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090751.r697pOaD002161@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 07:51:24 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42208 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 07:51:24 -0000 Author: pgj Date: Tue Jul 9 07:51:24 2013 New Revision: 42208 URL: http://svnweb.freebsd.org/changeset/doc/42208 Log: - Add a Q2 report entry on bsdconfig(8) and sysrc(8) Submitted by: dteske Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:34:53 2013 (r42207) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:51:24 2013 (r42208) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 23 entries and we hope you enjoy reading it.
+ contains 24 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1319,4 +1319,35 @@ calls. + + + <tt>bsdconfig(8)</tt> and <tt>sysrc(8)</tt> + + + + + Devin + Teske + + dteske@FreeBSD.org + + + + + + + + +
There have been new utilities introduced in &os; base system: + bsdconfig(8) and sysrc(8). The + bsdconfig(8) is a replacement for the post-install + abilities of deprecated sysinstall(8), while + sysrc(8) is a robust utility for managing + rc.conf(5) from the command line without a text + editor.
+ +
They are expected to be merged back to stable + branches shortly.
+ + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 08:00:10 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A7DFBAB8; Tue, 9 Jul 2013 08:00:10 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 80DAA1EB9; Tue, 9 Jul 2013 08:00:10 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6980APA003619; Tue, 9 Jul 2013 08:00:10 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6980Ahl003618; Tue, 9 Jul 2013 08:00:10 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090800.r6980Ahl003618@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 08:00:10 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42209 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:00:10 -0000 Author: pgj Date: Tue Jul 9 08:00:10 2013 New Revision: 42209 URL: http://svnweb.freebsd.org/changeset/doc/42209 Log: - Add a Q2 report entry on the PkgQtGtk SoC project - Add a separate category for Summer of Code projects Submitted by: Justin Edward Muniz Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 07:51:24 2013 (r42208) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:00:10 2013 (r42209) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 24 entries and we hope you enjoy reading it.
+ contains 25 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -73,6 +73,12 @@ Events + + soc + + Google Summer of Code + + PC-BSD @@ -1350,4 +1356,49 @@ branches shortly.
+ + + Qt and GTK+ Frontends for <tt>pkg(8)</tt> + + + + + Justin + Muniz + + jmuniz@FreeBSD.org + + + + + Eitan + Adler + + eadler@FreeBSD.org + + + + + + + + +
This project is part of Google Summer of Code. Work has only +just begun, and the code is in its infancy. The Subversion repository +holds experimental code that is actively being developed. Development +should be concluded before the end of September, and the project will +enter the maintenance phase of its life cycle.
+ + + + Work with Matt Windsor to create a pkg(8) backend + for PackageKit. + + Extend PackageKit's Qt frontend to offer more functionality +through pkg(8). + + Extend PackageKit's GKT+ frontend to offer more +functionality through pkg(8). + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 08:10:09 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 9FB6ED96; Tue, 9 Jul 2013 08:10:09 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 770751F18; Tue, 9 Jul 2013 08:10:09 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r698A9BW006853; Tue, 9 Jul 2013 08:10:09 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r698A9g7006852; Tue, 9 Jul 2013 08:10:09 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090810.r698A9g7006852@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 08:10:09 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42210 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:10:09 -0000 Author: pgj Date: Tue Jul 9 08:10:09 2013 New Revision: 42210 URL: http://svnweb.freebsd.org/changeset/doc/42210 Log: - Add Q2 report entry for GNOME ports Submitted by: kwm Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:00:10 2013 (r42209) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:10:09 2013 (r42210) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 25 entries and we hope you enjoy reading it.
+ contains 26 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1401,4 +1401,42 @@ through pkg(8). functionality through pkg(8). + + + GNOME/&os; + + + + + &os; GNOME Team + + gnome@FreeBSD.org + + + + + + + + +
The GNOME 3.6 work is moving along slowly but steadily. + Almost all the GNOME 3 desktop ports were updated to their + corresponding 3.6 versions.
+ +
A big challenge was taken by getting the webkit-gtk3 + port updated to 2.0.3. Currently programs using + webkit-gtk3 crash on launch. It is hard to find the + causes as the debug build of webkit-gtk either runs out of + memory or disk space on the developement system used.
+ + + + Update the &os; GNOME website with recent changes in the + ports tree, add new items in preparation for GNOME 3 and + Mate, etc. + + Merge Glib 2.36, GTK+ 3.8 and related ports back to the + Ports Collection. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 08:20:15 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 62DFC2A0; Tue, 9 Jul 2013 08:20:15 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 5590A1F89; Tue, 9 Jul 2013 08:20:15 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r698KF1D011378; Tue, 9 Jul 2013 08:20:15 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r698KFJd011377; Tue, 9 Jul 2013 08:20:15 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090820.r698KFJd011377@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 08:20:15 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42211 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:20:15 -0000 Author: pgj Date: Tue Jul 9 08:20:14 2013 New Revision: 42211 URL: http://svnweb.freebsd.org/changeset/doc/42211 Log: - Add Q2 report on recent Xen work Submitted by: Roger Pau Monné Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:10:09 2013 (r42210) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:20:14 2013 (r42211) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 26 entries and we hope you enjoy reading it.
+ contains 27 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1439,4 +1439,88 @@ functionality through pkg(8). + + + Xen Support Improvements + + + + + Justin T. + Gibbs + + gibbs@FreeBSD.org + + + + + Will + Andrews + + will@FreeBSD.org + + + + + Andre + Oppermann + + andre@FreeBSD.org + + + + + Roger + Pau Monné + + roger.pau@citrix.com + + + + + Git repository + + + +
&os; Xen HVM can be further improved by using more PV + interfaces inside a HVM guest. So far the following items have + been completed:
+ +
+
Update Xen interface files. (Merged into + head)
+
Add support for the vector callback injection mechanism. + This replaces the PCI interrupt and provides a per-cpu + callback, which was not possible when using the PCI + interrupt.
+
Rework event channel implementation and use the same code + paths for both PV and PVHVM.
+
Implement PV one-shot event timers and timecounters.
+
Implement PV IPIs.
+
Live migration support for PV timers and PV IPIs.
+
+ +
With this changes, &os; will have a complete PVHVM port, this + will also set the ground for a future PVH port (when PVH support + is merged into Xen).
+ +
Further improvements on blkfront and netfront have also been + commited:
+ +
+
Fix netfront crash when detaching an interface.
+
Enable netfront to specify a maximum TSO length limiting the + segment chain to what the Xen host side can handle after + defragmentation.
+
Add barriers and flush support to blkfront.
+
+ +
Netfront changes have been merged to stable branches, + blkfront changes are only in head.
+ + + + Merge remaining changes into head. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 08:32:43 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 38BB6A0E; Tue, 9 Jul 2013 08:32:43 +0000 (UTC) (envelope-from murray@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 2B6A7104B; Tue, 9 Jul 2013 08:32:43 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r698WhQs014855; Tue, 9 Jul 2013 08:32:43 GMT (envelope-from murray@svn.freebsd.org) Received: (from murray@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r698WhMb014854; Tue, 9 Jul 2013 08:32:43 GMT (envelope-from murray@svn.freebsd.org) Message-Id: <201307090832.r698WhMb014854@svn.freebsd.org> From: Murray Stokely Date: Tue, 9 Jul 2013 08:32:43 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42212 - head/share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:32:43 -0000 Author: murray Date: Tue Jul 9 08:32:42 2013 New Revision: 42212 URL: http://svnweb.freebsd.org/changeset/doc/42212 Log: Remove Upcoming links from our events pages. Upcoming was a Yahoo! service for events that has since been turned down and was never used much by this community in the first place so the links were not that useful even when Upcoming was available and popular (it is now long since completely turned down and the links all jus go to yahoo.com). Meetup.com is the most popular service for upcoming technology meetups in the bay area at least, and is used by the local BAFUG, but the links are probably best added manually for events instead of optimistically adding a link that tries to search on meetup.com for something matching the event. Modified: head/share/xml/templates.events.xsl Modified: head/share/xml/templates.events.xsl ============================================================================== --- head/share/xml/templates.events.xsl Tue Jul 9 08:20:14 2013 (r42211) +++ head/share/xml/templates.events.xsl Tue Jul 9 08:32:42 2013 (r42212) @@ -268,14 +268,6 @@
-
Social links: - - - - - http://upcoming.yahoo.com/search?type=Events&q=&Search=GO - - upcoming

Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 97625A81; Tue, 9 Jul 2013 08:33:27 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 7A4B61059; Tue, 9 Jul 2013 08:33:27 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r698XRfP015030; Tue, 9 Jul 2013 08:33:27 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r698XRnj015029; Tue, 9 Jul 2013 08:33:27 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090833.r698XRnj015029@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 08:33:27 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42213 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:33:27 -0000 Author: pgj Date: Tue Jul 9 08:33:27 2013 New Revision: 42213 URL: http://svnweb.freebsd.org/changeset/doc/42213 Log: - Add Q2 report on the new Capsicum features SoC project Submitted by: Mario Oshogbo Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:32:42 2013 (r42212) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:33:27 2013 (r42213) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 27 entries and we hope you enjoy reading it.

+ contains 28 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1523,4 +1523,60 @@ functionality through pkg(8).Merge remaining changes into head. + + + New Capsicum Features + + + + + Mariusz + Zaborski + + oshogbo@FreeBSD.org + + + + + Pawel Jakub + Dawidek + + pjd@FreeBSD.org + + + + + + + + +

Capsicum is a lightweight OS capability and sandboxing + framework implemented in &os;. This is still a new technology, + so there is a lot of space for improvements. Thanks to the + Google Summer of Code program and Pawel Jakub Dawidek for + volunteering as mentor, Mariusz will have the chance to work on + this project in the summer.

+ +

The work on sandboxing the rwho(1) and + rwhod(8) utilities was completed recently. There is + also a plan to implement two new modules for Casper. Casper is + a daemon to provide services for applications using Capsicum's + capability mode. Some experimentation with implementing two new + capability rights is in progress, so as porting one more program + to use the existing features of the Capsicum framework.

+ + + + system.unix — a Casper module provides + connect and listen on Unix domain socket. + + system.udp — a Casper module enabling + connect, listen, sending and receive UDP packages. + + Implementing sandboxing for fetch(1). + + Introduce new capability rights: CAP_SEND_RIGHTS + and CAP_RECV_RIGHTS. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 08:33:49 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 593EEAE9; Tue, 9 Jul 2013 08:33:49 +0000 (UTC) (envelope-from murray@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 329E01060; Tue, 9 Jul 2013 08:33:49 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r698Xn5I015099; Tue, 9 Jul 2013 08:33:49 GMT (envelope-from murray@svn.freebsd.org) Received: (from murray@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r698XnrB015098; Tue, 9 Jul 2013 08:33:49 GMT (envelope-from murray@svn.freebsd.org) Message-Id: <201307090833.r698XnrB015098@svn.freebsd.org> From: Murray Stokely Date: Tue, 9 Jul 2013 08:33:49 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42214 - head/share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:33:49 -0000 Author: murray Date: Tue Jul 9 08:33:48 2013 New Revision: 42214 URL: http://svnweb.freebsd.org/changeset/doc/42214 Log: Add link to YouTube playlist of BSDCan 2013 presentations. Modified: head/share/xml/events2013.xml Modified: head/share/xml/events2013.xml ============================================================================== --- head/share/xml/events2013.xml Tue Jul 9 08:33:27 2013 (r42213) +++ head/share/xml/events2013.xml Tue Jul 9 08:33:48 2013 (r42214) @@ -92,6 +92,10 @@ Ottawa University of Ottawa + + YouTube Playlist of Presentation Videos + https://www.youtube.com/playlist?list=PLWW0CjV-TafZN1ArKy3j6X7YJ57_FFQ5e + BSDCan is a developers conference with a strong focus on emerging technologies, research projects, and works in progress. It also features Userland infrastructure projects and From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 08:48:08 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id BF7D9486; Tue, 9 Jul 2013 08:48:08 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id B1BBC1120; Tue, 9 Jul 2013 08:48:08 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r698m8F9018590; Tue, 9 Jul 2013 08:48:08 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r698m8Uq018589; Tue, 9 Jul 2013 08:48:08 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090848.r698m8Uq018589@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 08:48:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42215 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 08:48:08 -0000 Author: pgj Date: Tue Jul 9 08:48:08 2013 New Revision: 42215 URL: http://svnweb.freebsd.org/changeset/doc/42215 Log: - Add a Q2 report on improved TCP SYN cookies Submitted by: andre Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:33:48 2013 (r42214) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:48:08 2013 (r42215) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 28 entries and we hope you enjoy reading it.

+ contains 29 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1579,4 +1579,84 @@ functionality through pkg(8).CAP_RECV_RIGHTS. + + + Improved TCP SYN Cookies + + + + + Andre + Oppermann + + andre@FreeBSD.org + + + + + Description + Patch + + + +

We have had a SYN cookie implementation for quite some time now + but it has some limitations with current realities for window + scaling and SACK encoding the in the few available bits.

+ +

This patch updates and improves SYN cookies mainly by:

+ +

Encoding of MSS, WSCALE (window scaling) and SACK into the + ISN (initial sequence number) without the use of timestamp + bits.
Switching to the very fast and cryptographically strong + SipHash-2-4 hash MAC algorithm to protect the SYN cookie + against forgery.

+ +

The common parameters used on TCP sessions have changed quite a + bit since SYN cookies very invented some 17 years ago. Today we + have a lot more bandwidth which makes the use window scaling + almost mandatory. Also SACK has become standard as it makes + recovering from packet loss much more efficient.

+ +

The original SYN cookies method only stored an indexed MSS + values in the cookie. This obviously is not sufficient anymore + and breaks in the presence of WSCALE. WSCALE information is + only exchanged during SYN and SYN-ACK. If we cannot keep track + of it then we severely underestimate the available send or + receive window, compounded with the fact that with large window + scaling the window size information on the TCP segment header + would be even lower numerically.

+ +

A number of years back SYN cookies have been extended to store + the additional state in the TCP timestamp fields, if available + on a connection. It has been adopted by Linux as well. While + timestamps are common among the BSD, Linux and other Unix + systems, Windows never enabled them by default, thus they are + not present for the vast majority of clients seen on the + Internet.

+ +

The new improvement in this patch moves all necessary + information into the ISN again removing the need for timestamps. + Both the MSS and send WSCALE are stored in 3 bit indexed form + together with a single bit for SACK. While we cannot represent + all possible MSS and WSCALE values, both are 16 bit fields in + the TCP header, in only 3 bits each this, it turns out, is not + actually necessary.

+ +

These improvements allow one to run with SYN cookies only on + Internet-facing servers. However while SYN cookies are + calculated and sent all the time, they are only used when the + syn cache overflows due to attacks or overload. In that cause + though, you can rest assured that no significant degradation in + TCP connection setup happens anymore and that even Windows + clients can make use of window scaling and SACK.

+ + + + Additional testing on busy servers. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 09:03:29 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 377E3FFF; Tue, 9 Jul 2013 09:03:29 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 2A04811F9; Tue, 9 Jul 2013 09:03:29 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6993T6O024294; Tue, 9 Jul 2013 09:03:29 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6993TYp024292; Tue, 9 Jul 2013 09:03:29 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090903.r6993TYp024292@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 09:03:29 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42216 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 09:03:29 -0000 Author: pgj Date: Tue Jul 9 09:03:28 2013 New Revision: 42216 URL: http://svnweb.freebsd.org/changeset/doc/42216 Log: - Add Q2 report for The FreeBSD Foundation Submitted by: Deb Goodkin Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:48:08 2013 (r42215) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 09:03:28 2013 (r42216) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 29 entries and we hope you enjoy reading it.

+ contains 30 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -79,6 +79,12 @@ Google Summer of Code + + misc + + Miscellaneous + + PC-BSD @@ -1659,4 +1665,83 @@ functionality through pkg(8).Additional testing on busy servers. + + + The &os; Foundation + + + + + Deb + Goodkin + + deb@FreeBSDFoundation.org + + + + + + + + +

We started the quarter with our "Raise a Million — Spend + a Million" Spring Fundraiser. This was the first of three major + fundraisers scheduled for the year. We were pleased to have + raised $365,291 by the end of the campaign — May 31. Last + year, by the same time, we had raised only $56,196. We have + started this year off with a much better fundraising strategy. + We want to send a big thank you to everyone out there that has + made a donation in 2013. Your early donations have made a + significant impact on our fundraising endeavors so far this + year.

+ +

Some things we accomplished this last quarter are:

+ +

Attended BSDCan in Ottawa, Texas LinuxFest in Austin, + SouthEast LinuxFest in Charlotte, and ICANN 46 meeting in + Beijing.
We were a Gold Sponsor for BSDCan 2013 and sponsored 7 + developers to attend the conference.
We signed up to be a Platinum Sponsor for EuroBSDCon + 2013.
We sponsored 1 developer to attend OpenHelp.
Recognized Mark Linimon, Simon L. B. Nielsen, Bjoern A. + Zeeb, and Ken Smith, at BSDCan, for their significant + contributions to &os;. We also recognized Dan Langille for + his tireless effort of putting on BSDCan for 10 years.
We sponsored the developer and vendor summits at BSDCan, + with 100 and 30 attendees respectively.
We sponsored BSD-Day 2013 that was held in Naples, Italy on + April 6.
We held our annual board meeting in Ottawa.
We sponsored the following projects: Capsicum, ARM + Superpages, iSCSI, Page Queue Locking, Input/Output Memory + Management Unit, Documentation project infrastructure, and + writing white papers.
We hired Edward Tomasz Napierała as the second member + of our technical staff to work on &os; projects + full-time.
We hired Ed Maste as Director of Project Development.
With our continued support of building out the &os; + infrastructure, we purchased high-end servers for the Sentex Lab + to be used with the latest 40 Gbps Ethernet cards from Chelsio + to do performance testing and analysis, smaller servers for + firewalls for NYI and ISC, and cables to connect our Juniper + switches together into a bigger Juniper switch we purchased + for NYI.

+ + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 09:10:24 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 59D00485; Tue, 9 Jul 2013 09:10:24 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 32FEF124F; Tue, 9 Jul 2013 09:10:24 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r699AOSI025773; Tue, 9 Jul 2013 09:10:24 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r699AObc025772; Tue, 9 Jul 2013 09:10:24 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307090910.r699AObc025772@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 09:10:24 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42217 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 09:10:24 -0000 Author: pgj Date: Tue Jul 9 09:10:23 2013 New Revision: 42217 URL: http://svnweb.freebsd.org/changeset/doc/42217 Log: - Add Q2 report for the Core Team Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 09:03:28 2013 (r42216) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 09:10:23 2013 (r42217) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 30 entries and we hope you enjoy reading it.

+ contains 31 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1744,4 +1744,41 @@ functionality through pkg(8). + + + &os; Core Team + + + + + &os; + Core Team + + core@FreeBSD.org + + + + +

In the second quarter of 2013, the Core Team approved a new + Security Officer, Dag-Erling Smørgrav and his deputy, Xin + Li, who replaced Simon Nielsen. Peter Wemm volunteered to + reorganize and take the lead on administration of the &os; + cluster and then the Core Team has approved and welcome Glen + Barber and Ryan Steinmetz as additions to his team.

+ +

Based on the recommendation and experiences of Martin Wilke, + core also supported establishing a liaison role between port + managers and release engineers in order to improve their + communication, especially for preparing releases. This liaison + became Bryan Drewery.

+ +

Following up on the request from Eitan Adler, core agreed to + remove CVS from the base system, which was soon followed by + importing a lightweight version of Subversion tools, implemented + by Peter Wemm.

+ +

There were src commit bits issued for 3 new developers and 1 + existing committer received extension in this quarter.

+ + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 12:15:57 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 27CD2B95; Tue, 9 Jul 2013 12:15:57 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id A96DC1C61; Tue, 9 Jul 2013 12:15:56 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r69CFuPG043259; Tue, 9 Jul 2013 06:15:56 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r69CFufM043256; Tue, 9 Jul 2013 06:15:56 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 9 Jul 2013 06:15:56 -0600 (MDT) From: Warren Block To: Gabor Pali Subject: Re: svn commit: r42215 - head/en_US.ISO8859-1/htdocs/news/status In-Reply-To: <201307090848.r698m8Uq018589@svn.freebsd.org> Message-ID: References: <201307090848.r698m8Uq018589@svn.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 09 Jul 2013 06:15:56 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 12:15:57 -0000 On Tue, 9 Jul 2013, Gabor Pali wrote: > Author: pgj > Date: Tue Jul 9 08:48:08 2013 > New Revision: 42215 > URL: http://svnweb.freebsd.org/changeset/doc/42215 > > Log: > - Add a Q2 report on improved TCP SYN cookies > > Submitted by: andre > > Modified: > head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml > > Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:33:48 2013 (r42214) > +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 08:48:08 2013 (r42215) > @@ -18,7 +18,7 @@ > > >

Thanks to all the reporters for the excellent work! This report > - contains 28 entries and we hope you enjoy reading it.

> + contains 29 entries and we hope you enjoy reading it.

> > >

The deadline for submissions covering between July and September 2013 > @@ -1579,4 +1579,84 @@ functionality through pkg(8). and CAP_RECV_RIGHTS. > > > + > + > + Improved TCP SYN Cookies > + > + > + > + > + Andre > + Oppermann > + > + andre@FreeBSD.org > + > + > + > + > + Description > + Patch > + > + > + > +

We have had a SYN cookie implementation for quite some time now > + but it has some limitations with current realities for window > + scaling and SACK encoding the in the few available bits.

> + > +

This patch updates and improves SYN cookies mainly by:

> + > +

Encoding of MSS, WSCALE (window scaling) and SACK into the > + ISN (initial sequence number) without the use of timestamp > + bits.
Switching to the very fast and cryptographically strong > + SipHash-2-4 hash MAC algorithm to protect the SYN cookie > + against forgery.

> + > +

The common parameters used on TCP sessions have changed quite a > + bit since SYN cookies very invented some 17 years ago. Today we s/very/were/ > + have a lot more bandwidth which makes the use window scaling s/the use/use of/ > + almost mandatory. Also SACK has become standard as it makes > + recovering from packet loss much more efficient.

> + > +

The original SYN cookies method only stored an indexed MSS > + values in the cookie. This obviously is not sufficient anymore s/values/value/ s/anymore/any more/ > + and breaks in the presence of WSCALE. WSCALE information is > + only exchanged during SYN and SYN-ACK. If we cannot keep track > + of it then we severely underestimate the available send or > + receive window, compounded with the fact that with large window > + scaling the window size information on the TCP segment header > + would be even lower numerically.

> + > +

A number of years back SYN cookies have been extended to store s/back SYN/back, SYN/ s/have been/were/ > + the additional state in the TCP timestamp fields, if available > + on a connection. It has been adopted by Linux as well. While > + timestamps are common among the BSD, Linux and other Unix > + systems, Windows never enabled them by default, thus they are > + not present for the vast majority of clients seen on the > + Internet.

> + > +

The new improvement in this patch moves all necessary > + information into the ISN again removing the need for timestamps. s/again removing/again, removing/ > + Both the MSS and send WSCALE are stored in 3 bit indexed form > + together with a single bit for SACK. While we cannot represent > + all possible MSS and WSCALE values, both are 16 bit fields in > + the TCP header, in only 3 bits each this, it turns out, is not > + actually necessary.

That last sentence is very unclear. I *think* it means "While we cannot represent all possible MSS and WSCALE values in only 3 bits each (both are 16 bit fields in the TCP header), it turns out that is not actually necessary.

" > +

These improvements allow one to run with SYN cookies only on > + Internet-facing servers. However while SYN cookies are > + calculated and sent all the time, they are only used when the > + syn cache overflows due to attacks or overload. In that cause s/cause/case/ > + though, you can rest assured that no significant degradation in > + TCP connection setup happens anymore and that even Windows s/anymore/any more/ > + clients can make use of window scaling and SACK.

> + > + > + > + Additional testing on busy servers. > + > + > > Phew, almost done. Sorry, and thanks! From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 13:22:59 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 8232472C; Tue, 9 Jul 2013 13:22:59 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 73F121F9D; Tue, 9 Jul 2013 13:22:59 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69DMxqB002401; Tue, 9 Jul 2013 13:22:59 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69DMxZV002400; Tue, 9 Jul 2013 13:22:59 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307091322.r69DMxZV002400@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 13:22:59 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42218 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 13:22:59 -0000 Author: pgj Date: Tue Jul 9 13:22:59 2013 New Revision: 42218 URL: http://svnweb.freebsd.org/changeset/doc/42218 Log: - Many minor fixes from Warren -- thanks! Submitted by: wblock Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 09:10:23 2013 (r42217) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 13:22:59 2013 (r42218) @@ -1238,7 +1238,7 @@ Look into replacements for HAL. HAL is used for hot-plugging of devices, but it has been long abandoned by - Linux. A replacement, perhaps build on top of devd(8), + Linux. A replacement, perhaps built on top of devd(8), would be nice to have. This work should be coordinated with the &os; GNOME and KDE teams. @@ -1272,26 +1272,26 @@ -

We are proud to announce &os; Haskell Team has updated the - Haskell Platform to 2013.2.0.0, GHC to 7.6.3, as well as updated - existing ports to their latest stable versions. In this update, - we provided experimental support for LLVM-based code generation - (disabled by default) to Haskell ports. We also added number of - new ports, which brings their count in &os; Ports Collection to - 402, and now Haskell ports play nicer with - portmaster(8)-based upgrades.

We are proud to announce that the &os; Haskell Team has updated + the Haskell Platform to 2013.2.0.0, GHC to 7.6.3, as well as + updated existing ports to their latest stable versions. In this + update, we provided experimental support for LLVM-based code + generation (disabled by default) to Haskell ports. We also + added a number of new ports, which brings their count in the + &os; Ports Collection to 402, and now Haskell ports play nicer + with portmaster(8)-based upgrades.

In cooperation with Konstantin Belousov and Dimitry Andric, we - have managed to unbreak build of GHC on 32-bit 10.x systems, so - we have packages for 10.x again. However, it turned out that + have managed to unbreak the build of GHC on 32-bit 10.x systems, + so we have packages for 10.x again. However, it turned out that this bug (in thread signal delivery) can also affect the building process for other platforms as well, which explains some of the strange build breakages our users experienced in the past.

We have also learned that there is an We have also learned that there is ongoing work - in GHC upstream which will allow us to provide support for + in the GHC upstream which will allow us to provide support for building with Clang natively once GHC 7.8 becomes part of the Haskell Platform.

@@ -1350,8 +1350,8 @@ -

There have been new utilities introduced in &os; base system: - bsdconfig(8) and sysrc(8). The +

New utilities have been introduced in &os; base system: + bsdconfig(8) and sysrc(8). bsdconfig(8) is a replacement for the post-install abilities of deprecated sysinstall(8), while sysrc(8) is a robust utility for managing @@ -1568,7 +1568,7 @@ functionality through pkg(8). @@ -1577,7 +1577,7 @@ functionality through pkg(8). system.udp — a Casper module enabling - connect, listen, sending and receive UDP packages. + connect, listen, send, and receive of UDP packets. Implementing sandboxing for fetch(1). @@ -1622,13 +1622,13 @@ functionality through pkg(8).

The common parameters used on TCP sessions have changed quite a - bit since SYN cookies very invented some 17 years ago. Today we - have a lot more bandwidth which makes the use window scaling + bit since SYN cookies were invented some 17 years ago. Today we + have a lot more bandwidth which makes use of window scaling almost mandatory. Also SACK has become standard as it makes recovering from packet loss much more efficient.

The original SYN cookies method only stored an indexed MSS - values in the cookie. This obviously is not sufficient anymore + value in the cookie. This obviously is not sufficient any more and breaks in the presence of WSCALE. WSCALE information is only exchanged during SYN and SYN-ACK. If we cannot keep track of it then we severely underestimate the available send or @@ -1636,28 +1636,28 @@ functionality through pkg(8). -

A number of years back SYN cookies have been extended to store - the additional state in the TCP timestamp fields, if available - on a connection. It has been adopted by Linux as well. While +

A number of years back, SYN cookies were extended to store the + additional state in the TCP timestamp fields, if available on a + connection. It has been adopted by Linux as well. While timestamps are common among the BSD, Linux and other Unix systems, Windows never enabled them by default, thus they are not present for the vast majority of clients seen on the Internet.

The new improvement in this patch moves all necessary - information into the ISN again removing the need for timestamps. - Both the MSS and send WSCALE are stored in 3 bit indexed form - together with a single bit for SACK. While we cannot represent - all possible MSS and WSCALE values, both are 16 bit fields in - the TCP header, in only 3 bits each this, it turns out, is not - actually necessary.

+ information into the ISN again, removing the need for + timestamps. Both the MSS and send WSCALE are stored in 3 bit + indexed form together with a single bit for SACK. While we + cannot represent all possible MSS and WSCALE values in only 3 + bits each (both are 16-bit fields in the TCP header), it turns + out that is not actually necessary.

These improvements allow one to run with SYN cookies only on Internet-facing servers. However while SYN cookies are calculated and sent all the time, they are only used when the - syn cache overflows due to attacks or overload. In that cause + syn cache overflows due to attacks or overload. In that case though, you can rest assured that no significant degradation in - TCP connection setup happens anymore and that even Windows + TCP connection setup happens any more and that even Windows clients can make use of window scaling and SACK.

From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 14:08:53 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D1B317A1; Tue, 9 Jul 2013 14:08:53 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id B3F0A11F8; Tue, 9 Jul 2013 14:08:53 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69E8rAS015009; Tue, 9 Jul 2013 14:08:53 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69E8rag015008; Tue, 9 Jul 2013 14:08:53 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307091408.r69E8rag015008@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 14:08:53 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42219 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 14:08:53 -0000 Author: pgj Date: Tue Jul 9 14:08:53 2013 New Revision: 42219 URL: http://svnweb.freebsd.org/changeset/doc/42219 Log: - Add a Q2 report entry for the recent Newcons work Submitted by: ray Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 13:22:59 2013 (r42218) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 14:08:53 2013 (r42219) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 31 entries and we hope you enjoy reading it.

+ contains 32 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1781,4 +1781,62 @@ functionality through pkg(8). + + + Newcons Reboot + + + + + Aleksandr + Rybalko + + ray@FreeBSD.org + + + + +

The purpose of the Newcons project is to provide a new + interface for console and video output to graphic devices. This + will allow simple drivers access the console and terminal mode + early, and framebuffer access for xorg. Drivers will + not need embedded font bitmaps, color maps, or mouse cursor + bitmaps, as the whole infrastructure will be provided by the + vt(4) Newcons driver.

+ +

As the project includes Kernel Mode Setting (KMS) integration, + one of the goals is support for modern Xorg releases, allowing + the kernel to switch back to virtual terminal mode after + graphics mode or resolution used with xorg changes.

+ +

There are a lot of changes involved in the project. Main tasks + include:

+ +

Core functionality (almost done).
Mouse support.
KMS (kernel mode setting) support.
USB keyboard support.
Splash screen support (partially working).
Driver support.
vidcontrol(1) support.

+ +

The first deliverables of the project, including + moused(8), ukbd(4), and KMS support are expected + to arrive around the middle or end of August 2013. The whole + project is expected to complete in November 2013.

+ +

This project is being sponsored by The &os; Foundation.

+ +

Many thanks to Ed Schouten who started Newcons project and did + most of the work.

+ + + + Provide different flavors of hardware for testing the + implementation. Do not hesitate to volunteer when a call for + testing is announced. + + From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 15:47:59 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id AEA4AF54; Tue, 9 Jul 2013 15:47:59 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A126E1931; Tue, 9 Jul 2013 15:47:59 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69Flx7i044544; Tue, 9 Jul 2013 15:47:59 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69Flxtg044543; Tue, 9 Jul 2013 15:47:59 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307091547.r69Flxtg044543@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 15:47:59 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42220 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 15:47:59 -0000 Author: pgj Date: Tue Jul 9 15:47:59 2013 New Revision: 42220 URL: http://svnweb.freebsd.org/changeset/doc/42220 Log: - Add some more open tasks for the GNOME entry Submitted by: kwm Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 14:08:53 2013 (r42219) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 15:47:59 2013 (r42220) @@ -1443,6 +1443,11 @@ functionality through pkg(8).Merge Glib 2.36, GTK+ 3.8 and related ports back to the Ports Collection. + + Continue work on GNOME 3.6, fix bugs and write code for + missing features. + + Complete the port of MATE. From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 15:50:56 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D7FA9C6; Tue, 9 Jul 2013 15:50:56 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id CA83F1952; Tue, 9 Jul 2013 15:50:56 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69Fou0D046526; Tue, 9 Jul 2013 15:50:56 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69FouHP046525; Tue, 9 Jul 2013 15:50:56 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307091550.r69FouHP046525@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 15:50:56 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42221 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 15:50:57 -0000 Author: pgj Date: Tue Jul 9 15:50:56 2013 New Revision: 42221 URL: http://svnweb.freebsd.org/changeset/doc/42221 Log: - Fix a grammar mistake (made by me) in the V4L2 entry Submitted by: theraven Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 15:47:59 2013 (r42220) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 15:50:56 2013 (r42221) @@ -1323,7 +1323,7 @@

The V4L2 support in the linuxulator was updated in &os; - head. This lets Skype v4 to display video.

+ head. This lets Skype v4 display video.

From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 15:59:56 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 714CE5D3; Tue, 9 Jul 2013 15:59:56 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 49F8219E1; Tue, 9 Jul 2013 15:59:56 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69Fxuha047761; Tue, 9 Jul 2013 15:59:56 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69FxumJ047760; Tue, 9 Jul 2013 15:59:56 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307091559.r69FxumJ047760@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 15:59:56 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42222 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 15:59:56 -0000 Author: pgj Date: Tue Jul 9 15:59:55 2013 New Revision: 42222 URL: http://svnweb.freebsd.org/changeset/doc/42222 Log: - Improve wording for the core report entry Submitted by: emaste Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 15:50:56 2013 (r42221) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 15:59:55 2013 (r42222) @@ -1766,21 +1766,22 @@ functionality through pkg(8).

In the second quarter of 2013, the Core Team approved a new Security Officer, Dag-Erling Smørgrav and his deputy, Xin - Li, who replaced Simon Nielsen. Peter Wemm volunteered to - reorganize and take the lead on administration of the &os; - cluster and then the Core Team has approved and welcome Glen - Barber and Ryan Steinmetz as additions to his team.

+ Li. The Core Team acknowledges Simon Nielsen, the outgoing + Security Officer, for his work in the role. Peter Wemm took the + lead on the reorganization and administration of the &os; + cluster, and with the Core Team's approval, Glen Barber and Ryan + Steinmetz were welcomed to the cluster administration team.

Based on the recommendation and experiences of Martin Wilke, - core also supported establishing a liaison role between port - managers and release engineers in order to improve their - communication, especially for preparing releases. This liaison - became Bryan Drewery.

- -

Following up on the request from Eitan Adler, core agreed to - remove CVS from the base system, which was soon followed by - importing a lightweight version of Subversion tools, implemented - by Peter Wemm.

+ the Core Team also supported establishing a liaison role between + port managers and release engineers in order to improve their + communication, especially for preparing releases. The Core Team + welcomes Bryan Drewery to this role.

+ +

Following up on the request from Eitan Adler, the Core Team + agreed to remove CVS from the base system, which was soon followed + by importing a lightweight version of Subversion tools, + implemented by Peter Wemm.

There were src commit bits issued for 3 new developers and 1 existing committer received extension in this quarter.

From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 17:02:35 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 4EC6C9B3; Tue, 9 Jul 2013 17:02:35 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 413A91D53; Tue, 9 Jul 2013 17:02:35 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69H2ZOZ067312; Tue, 9 Jul 2013 17:02:35 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69H2ZCk067309; Tue, 9 Jul 2013 17:02:35 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307091702.r69H2ZCk067309@svn.freebsd.org> From: Gabor Pali Date: Tue, 9 Jul 2013 17:02:35 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42223 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 17:02:35 -0000 Author: pgj Date: Tue Jul 9 17:02:34 2013 New Revision: 42223 URL: http://svnweb.freebsd.org/changeset/doc/42223 Log: - Trim sentences about expected merging of bsdconfig(8) and sysrc(8), because it is already done now Submitted by: dteske Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 15:59:55 2013 (r42222) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 9 17:02:34 2013 (r42223) @@ -1357,9 +1357,6 @@ sysrc(8) is a robust utility for managing rc.conf(5) from the command line without a text editor.

- -

They are expected to be merged back to stable - branches shortly.

From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 18:18:07 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A2514877; Tue, 9 Jul 2013 18:18:07 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 7ACB011E6; Tue, 9 Jul 2013 18:18: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 r69II7jU088733; Tue, 9 Jul 2013 18:18:07 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69II7RG088732; Tue, 9 Jul 2013 18:18:07 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201307091818.r69II7RG088732@svn.freebsd.org> From: Glen Barber Date: Tue, 9 Jul 2013 18:18:07 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-svnadmin@freebsd.org Subject: svn commit: r42224 - svnadmin/conf X-SVN-Group: doc-svnadmin MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 18:18:07 -0000 Author: gjb Date: Tue Jul 9 18:18:06 2013 New Revision: 42224 URL: http://svnweb.freebsd.org/changeset/doc/42224 Log: Lock down head/ in preparation of the projects/entities/ merge. Approved by: doceng (implicit) Modified: svnadmin/conf/approvers Modified: svnadmin/conf/approvers ============================================================================== --- svnadmin/conf/approvers Tue Jul 9 17:02:34 2013 (r42223) +++ svnadmin/conf/approvers Tue Jul 9 18:18:06 2013 (r42224) @@ -16,7 +16,7 @@ # # $FreeBSD$ # -#^head/ doceng +^head/ doceng #^projects/ doceng #^user/ doceng #^translations/ doceng From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 19:13:10 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 19A4ACA7; Tue, 9 Jul 2013 19:13:10 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 7D526163C; Tue, 9 Jul 2013 19:13:09 +0000 (UTC) X-AuditID: 12074423-b7f168e00000095a-3a-51dc60c43f0b Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id 03.92.02394.4C06CD15; Tue, 9 Jul 2013 15:13:08 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r69JD78T031911; Tue, 9 Jul 2013 15:13:08 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r69JD3wq015179 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 9 Jul 2013 15:13:06 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r69JD31A012453; Tue, 9 Jul 2013 15:13:03 -0400 (EDT) Date: Tue, 9 Jul 2013 15:13:02 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42201 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: <201307090627.r696RuOg076372@svn.freebsd.org> Message-ID: References: <201307090627.r696RuOg076372@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrAIsWRmVeSWpSXmKPExsUixG6nonsk4U6gwY/HyhY/Ph5isrixaD+T xe7+XmaLy+8nsjiweMz4NJ8lgDGKyyYlNSezLLVI3y6BK2PyzsiCPcwVO+6tYGtgfMjUxcjJ ISFgItHR+YQNwhaTuHBvPZDNxSEksI9R4sCX5VDOBkaJlRvvs0M4B5kkZjz/C9YuJFAvsffZ RRYQm0VAS+Jm10tGEJtNQEVi5puNYGNFBFQlvnevAqtnFoiS2LO0kRXEFhaIkPh8dg87iM0p YCVxeV47UA0HB6+Ao0Tb2wSI8ZYSPXfngbWKCuhIrN4/BWwVr4CgxMmZT1ggRlpKnPtznW0C o+AsJKlZSFILGJlWMcqm5Fbp5iZm5hSnJusWJyfm5aUW6Zrp5WaW6KWmlG5iBAesi/IOxj8H lQ4xCnAwKvHwHlC4EyjEmlhWXJl7iFGSg0lJlDc4DijEl5SfUpmRWJwRX1Sak1p8iFGCg1lJ hDeJDyjHm5JYWZValA+TkuZgURLnffb0bKCQQHpiSWp2ampBahFMVoaDQ0mCNzgeqFGwKDU9 tSItM6cEIc3EwQkynAdouBtIDW9xQWJucWY6RP4Uo6KUOO9vkIsEQBIZpXlwvbCE8opRHOgV YV4xkHYeYDKC634FNJgJaHBD2i2QwSWJCCmpBsbt7ulnWf++amENuav2IWhOmaTsBm2FwO8T srpCGI5dWLTDf2H6fluFm/wTJ/9eG5+w95rfL7Z83rQFvR5NDuLppROM+fev/vqpbidXRL3R gx/M+8//f7Al4cQvRlZHq13TD9/ZHG29NpZX4ZThXMnIKYInxJ9vvb77Z/XalhXepRMrF02V 9hVWYinOSDTUYi4qTgQAO5UlfgMDAAA= Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 19:13:10 -0000 On Tue, 9 Jul 2013, Warren Block wrote: > Author: wblock > Date: Tue Jul 9 06:27:56 2013 > New Revision: 42201 > URL: http://svnweb.freebsd.org/changeset/doc/42201 > > Log: > Remove a confusing paragraph whose net contribution is negative. Remove > some from "Ports Collection", it's unnecessary. Make one example Was this discussed anywhere? I am seeing a pretty long precedent for the non-breaking space. -Ben From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 20:58:53 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 8D7E4365; Tue, 9 Jul 2013 20:58:53 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 4B22A1C1C; Tue, 9 Jul 2013 20:58:53 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id DD90814D250A; Tue, 9 Jul 2013 22:58:45 +0200 (CEST) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id VhTtCe65ZYdU; Tue, 9 Jul 2013 22:58:45 +0200 (CEST) Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 4EFCE14D2410; Tue, 9 Jul 2013 22:58:45 +0200 (CEST) Message-ID: <51DC7984.4080106@FreeBSD.org> Date: Tue, 09 Jul 2013 22:58:44 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/20100101 Thunderbird/22.0 MIME-Version: 1.0 To: Benjamin Kaduk , Warren Block Subject: Re: svn commit: r42201 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup References: <201307090627.r696RuOg076372@svn.freebsd.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 20:58:53 -0000 Em 09-07-2013 21:13, Benjamin Kaduk escreveu: >> Remove a confusing paragraph whose net contribution is negative. >> Remove >> some from "Ports Collection", it's unnecessary. Make one example > > Was this discussed anywhere? I am seeing a pretty long precedent for > the non-breaking space. Indeed it wasn't discussed but I think that these non-breaking spaces should be reconsidered. Typography rules and conventions are language-dependent. For example, in Hungarian it is not nice to end a line with a sentence-starting single-letter article. Afaik, English does not have such rules, except widows and orphans, which are more concerned with aesthetics. It is reasonable to avoid a line break between FreeBSD and 9.X or similar cases but probably not for such long terms as Ports Collection. Actually, it may just hit back because it may make justified paragraphs very ugly in our print formats. Gabor From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 21:15:49 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 2151FF32; Tue, 9 Jul 2013 21:15:49 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 0F5CA1D0F; Tue, 9 Jul 2013 21:15:49 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69LFn5q044706; Tue, 9 Jul 2013 21:15:49 GMT (envelope-from rene@svn.freebsd.org) Received: (from rene@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69LFmQv044700; Tue, 9 Jul 2013 21:15:48 GMT (envelope-from rene@svn.freebsd.org) Message-Id: <201307092115.r69LFmQv044700@svn.freebsd.org> From: Rene Ladan Date: Tue, 9 Jul 2013 21:15:48 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42226 - in head: en_US.ISO8859-1/articles/committers-guide en_US.ISO8859-1/articles/console-server en_US.ISO8859-1/articles/contributors en_US.ISO8859-1/articles/cvs-freebsd en_US.ISO8... X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 21:15:49 -0000 Author: rene Date: Tue Jul 9 21:15:47 2013 New Revision: 42226 URL: http://svnweb.freebsd.org/changeset/doc/42226 Log: Merge the projects/entities branch into head/ The primary purposes are to clean up duplicated author definitions in both share/xml/authors.ent and share/xml/developers.ent, and as a added bonus simplify writing up author names/email addresses in web pages. Apart from merging developers.ent into authors.ent, removing the former, and updating the Committers Guide there should be little user-visible changes: - a.portmgr renamed to a.portmgr.members - a.doceng renamed to a.doceng.members - team.re renamed to a.re.members.email and moved from share/xml/freebsd.ent to share/xml/authors.ent - a.core updated and moved from share/xml/mailing-lists.ent to share/xml/teams.ent - share/pgpkeys/{addkey.sh|README} updated Translations are untouched except for build fixes. Approved by: doceng (gjb) Approved by: gjb (mentor) Deleted: head/share/xml/developers.ent Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml head/en_US.ISO8859-1/articles/console-server/article.xml head/en_US.ISO8859-1/articles/contributors/article.xml head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml head/en_US.ISO8859-1/articles/contributors/contrib.corealumni.xml head/en_US.ISO8859-1/articles/contributors/contrib.develalumni.xml head/en_US.ISO8859-1/articles/contributors/contrib.develinmemoriam.xml head/en_US.ISO8859-1/articles/contributors/contrib.portmgralumni.xml head/en_US.ISO8859-1/articles/cvs-freebsd/article.xml head/en_US.ISO8859-1/articles/freebsd-update-server/article.xml head/en_US.ISO8859-1/articles/gjournal-desktop/article.xml head/en_US.ISO8859-1/articles/hubs/article.xml head/en_US.ISO8859-1/articles/linux-emulation/article.xml head/en_US.ISO8859-1/articles/mailing-list-faq/article.xml head/en_US.ISO8859-1/articles/nanobsd/article.xml head/en_US.ISO8859-1/articles/releng-packages/article.xml head/en_US.ISO8859-1/articles/releng/article.xml head/en_US.ISO8859-1/articles/remote-install/article.xml head/en_US.ISO8859-1/articles/serial-uart/article.xml head/en_US.ISO8859-1/books/dev-model/book.xml head/en_US.ISO8859-1/books/developers-handbook/testing/chapter.xml head/en_US.ISO8859-1/books/developers-handbook/x86/chapter.xml head/en_US.ISO8859-1/books/faq/book.xml head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml head/en_US.ISO8859-1/books/handbook/disks/chapter.xml head/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml head/en_US.ISO8859-1/books/handbook/jails/chapter.xml head/en_US.ISO8859-1/htdocs/administration.xml head/en_US.ISO8859-1/htdocs/internal/doceng.xml head/en_US.ISO8859-1/htdocs/platforms/arm.xml head/en_US.ISO8859-1/htdocs/platforms/sparc.xml head/en_US.ISO8859-1/htdocs/platforms/xbox.xml head/en_US.ISO8859-1/htdocs/portmgr/index.xml head/en_US.ISO8859-1/htdocs/projects/summerofcode-2005.xml head/en_US.ISO8859-1/htdocs/projects/summerofcode-2006.xml head/en_US.ISO8859-1/htdocs/releng/index.xml head/en_US.ISO8859-1/htdocs/security/reporting.xml head/en_US.ISO8859-1/share/xml/mailing-lists.ent head/en_US.ISO8859-1/share/xml/teams.ent head/fr_FR.ISO8859-1/htdocs/releng/index.xml head/ru_RU.KOI8-R/htdocs/portmgr/index.xml head/ru_RU.KOI8-R/htdocs/releng/index.xml head/share/pgpkeys/README head/share/pgpkeys/addkey.sh head/share/pgpkeys/pgpkeys-core.xml head/share/pgpkeys/pgpkeys-developers.xml head/share/xml/authors.ent head/share/xml/catalog.xml head/share/xml/freebsd.ent head/share/xml/xhtml.xsl head/share/xml/xhtml10-freebsd.dtd head/share/xml/xslt10-freebsd.dtd head/share/xsl/freebsd-xhtml-common.xsl Directory Properties: head/bn_BD.ISO10646-1/ (props changed) head/da_DK.ISO8859-1/ (props changed) head/de_DE.ISO8859-1/ (props changed) head/el_GR.ISO8859-7/ (props changed) head/en_US.ISO8859-1/ (props changed) head/es_ES.ISO8859-1/ (props changed) head/fr_FR.ISO8859-1/ (props changed) head/hu_HU.ISO8859-2/ (props changed) head/it_IT.ISO8859-15/ (props changed) head/ja_JP.eucJP/ (props changed) head/mn_MN.UTF-8/ (props changed) head/nl_NL.ISO8859-1/ (props changed) head/nl_NL.ISO8859-1/share/xml/entities.ent (props changed) head/no_NO.ISO8859-1/ (props changed) head/pl_PL.ISO8859-2/ (props changed) head/pt_BR.ISO8859-1/ (props changed) head/release/ (props changed) head/ru_RU.KOI8-R/ (props changed) head/share/ (props changed) head/sr_YU.ISO8859-2/ (props changed) head/tr_TR.ISO8859-9/ (props changed) head/zh_CN.GB2312/ (props changed) head/zh_TW.Big5/ (props changed) Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Tue Jul 9 19:06:20 2013 (r42225) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Tue Jul 9 21:15:47 2013 (r42226) @@ -2046,11 +2046,6 @@ ControlPersist yes - Also add your author entity to - head/share/xml/developers.ent. - - - Add yourself to the Developers section of the Contributors @@ -2079,7 +2074,7 @@ ControlPersist yes head/share/pgpkeys/pgpkeys-developers.xml. Please note that entries are sorted by last name. - &a.des; has written a shell script + &a.des.email; has written a shell script (head/share/pgpkeys/addkey.sh) to make this extremely simple. See the README @@ -2268,7 +2263,7 @@ ControlPersist yes The &os; project discourages completely new licenses and variations on the standard licenses. New licenses require the - approval of core@FreeBSD.org to reside in the + approval of the &a.core; to reside in the main repository. The more different licenses that are used in the tree, the more problems that this causes to those wishing to utilize this code, typically from unintended consequences from a @@ -2308,7 +2303,7 @@ ControlPersist yes Makefile. For other parts of the repository, if you are unsure who the active maintainer might be, it may help to scan the revision history to see who has - committed changes in the past. &a.fenner; has written a nice + committed changes in the past. &a.fenner.email; has written a nice shell script that can help determine who the active maintainer might be. It lists each person who has committed to a given file along with the number of commits each person has made. It @@ -2464,7 +2459,7 @@ ControlPersist yes - &a.ru; + &a.ru.email; Ruslan is Mister &man.mdoc.7;. If you are writing a @@ -2474,7 +2469,7 @@ ControlPersist yes - &a.bde; + &a.bde.email; Bruce is the Style Police-Meister. When you do a @@ -2486,7 +2481,7 @@ ControlPersist yes - &team.re; + &a.re.members.email; These are the members of the &a.re;. This team is @@ -2507,7 +2502,7 @@ ControlPersist yes - &a.des; + &a.des.email; Dag-Erling is the @@ -2518,7 +2513,7 @@ ControlPersist yes - &a.wollman; + &a.wollman.email; If you need advice on obscure network internals or @@ -3443,9 +3438,10 @@ ControlPersist yes port Makefile. It will also add an entry to the port's category Makefile. It was written by - &a.mharo;, &a.will;, and &a.garga;. When sending + &a.mharo.email;, &a.will.email;, and &a.garga.email;. + When sending questions about this script to the &a.ports;, please - also CC &a.crees;, the current maintainer. + also CC &a.crees.email;, the current maintainer. @@ -3560,9 +3556,9 @@ ControlPersist yes Alternatively, you can use the rmport script, from ports/Tools/scripts. - This script was written by &a.vd;. When sending + This script was written by &a.vd.email;. When sending questions about this script to the &a.ports;, please - also CC &a.crees;, the current maintainer. + also CC &a.crees.email;, the current maintainer. @@ -4372,7 +4368,7 @@ bak/packages packages from last complet name or freebsd/developer/NickServ name. To request a cloak, send an email to - &a.eadler; with your requested hostmask and NickServ + &a.eadler.email; with your requested hostmask and NickServ account name. Modified: head/en_US.ISO8859-1/articles/console-server/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/console-server/article.xml Tue Jul 9 19:06:20 2013 (r42225) +++ head/en_US.ISO8859-1/articles/console-server/article.xml Tue Jul 9 21:15:47 2013 (r42226) @@ -539,7 +539,7 @@ print crypt($cleartext, $salt), "\n";

- &a.kris; has since pointed out you can get the same effect using + &a.kris.email; has since pointed out you can get the same effect using the openssl passwd command: &prompt.user; openssl passwd -1 Modified: head/en_US.ISO8859-1/articles/contributors/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/contributors/article.xml Tue Jul 9 19:06:20 2013 (r42225) +++ head/en_US.ISO8859-1/articles/contributors/article.xml Tue Jul 9 21:15:47 2013 (r42226) @@ -51,7 +51,7 @@ - &a.mbarkah; and his employer, &a.mbarkah.email; and his employer, Hemisphere Online, donated a Pentium Pro (P6) 200MHz CPU @@ -97,7 +97,7 @@ - &a.dillon; + &a.dillon.email; @@ -111,7 +111,7 @@ - &a.sef; + &a.sef.email; @@ -137,7 +137,7 @@ - &a.chuckr; + &a.chuckr.email; @@ -241,7 +241,7 @@ - Larry Altneu larry@ALR.COM, and &a.wilko;, + Larry Altneu larry@ALR.COM, and &a.wilko.email;, provided Wangtek and Archive QIC-02 tape drives in order to improve the wt driver. @@ -273,7 +273,7 @@ - Christoph Kukulies kuku@FreeBSD.org donated + &a.kuku.email; donated an FX120 12 speed Mitsumi CDROM drive for IDE CDROM driver development. @@ -309,7 +309,7 @@ The interface business GmbH, Dresden has been patiently supporting - &a.joerg; who has often preferred FreeBSD work over paid work, and + &a.joerg.email; who has often preferred FreeBSD work over paid work, and used to fall back to their (quite expensive) EUnet Internet connection whenever his private connection became too slow or flaky to work with it... Modified: head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml ============================================================================== --- head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Tue Jul 9 19:06:20 2013 (r42225) +++ head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Tue Jul 9 21:15:47 2013 (r42226) @@ -365,8 +365,7 @@ - Alexander Best - arundel@FreeBSD.org + &a.arundel.email; @@ -1747,8 +1746,7 @@ - Christoph P. Kukulies - kuku@FreeBSD.org + &a.kuku.email; @@ -2220,8 +2218,7 @@ - Dave Tweten - tweten@FreeBSD.org + &a.tweten.email; @@ -2703,7 +2700,7 @@ - &a.whiteside; + &a.whiteside.email; @@ -3346,7 +3343,7 @@ - &a.stanislav; + &a.stanislav.email; @@ -4308,8 +4305,7 @@ - Jan Koum - jkb@FreeBSD.org + &a.jkb.email; @@ -4622,8 +4618,7 @@ - Jim Babb - babb@FreeBSD.org + &a.babb.email; @@ -5263,7 +5258,7 @@ - &a.jhs; + &a.jhs.email; @@ -10839,8 +10834,7 @@ - Wolfgang Stanglmeier - wolf@FreeBSD.org + &a.wolf.email; @@ -10864,7 +10858,7 @@ - &a.wylie; + &a.wylie.email; Modified: head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml ============================================================================== --- head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Tue Jul 9 19:06:20 2013 (r42225) +++ head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Tue Jul 9 21:15:47 2013 (r42226) @@ -8,1682 +8,1682 @@ - &a.ariff; + &a.ariff.email; - &a.tabthorpe; + &a.tabthorpe.email; - &a.eadler; + &a.eadler.email; - &a.akiyama; + &a.akiyama.email; - &a.monthadar; + &a.monthadar.email; - &a.ambrisko; + &a.ambrisko.email; - &a.shaun; + &a.shaun.email; - &a.brix; + &a.brix.email; - &a.jonathan; + &a.jonathan.email; - &a.mandree; + &a.mandree.email; - &a.will; + &a.will.email; - &a.dim; + &a.dim.email; - &a.mva; + &a.mva.email; - &a.araujo; + &a.araujo.email; - &a.mat; + &a.mat.email; - &a.syuu; + &a.syuu.email; - &a.gavin; + &a.gavin.email; - &a.jsa; + &a.jsa.email; - &a.jadawin; + &a.jadawin.email; - &a.timur; + &a.timur.email; - &a.jhb; + &a.jhb.email; - &a.gjb; + &a.gjb.email; - &a.art; + &a.art.email; - &a.kib; + &a.kib.email; - &a.tobez; + &a.tobez.email; - &a.gber; + &a.gber.email; - &a.pb; + &a.pb.email; - &a.tdb; + &a.tdb.email; - &a.gblach; + &a.gblach.email; - &a.mbr; + &a.mbr.email; - &a.wblock; + &a.wblock.email; - &a.novel; + &a.novel.email; - &a.garga; + &a.garga.email; - &a.sbz; + &a.sbz.email; - &a.ebrandi; + &a.ebrandi.email; - &a.harti; + &a.harti.email; - &a.makc; + &a.makc.email; - &a.antoine; + &a.antoine.email; - &a.db; + &a.db.email; - &a.sbruno; + &a.sbruno.email; - &a.brueffer; + &a.brueffer.email; - &a.markus; + &a.markus.email; - &a.oleg; + &a.oleg.email; - &a.jchandra; + &a.jchandra.email; - &a.acm; + &a.acm.email; - &a.gahr; + &a.gahr.email; - &a.adrian; + &a.adrian.email; - &a.dchagin; + &a.dchagin.email; - &a.charnier; + &a.charnier.email; - &a.jon; + &a.jon.email; - &a.loader; + &a.loader.email; - &a.luoqi; + &a.luoqi.email; - &a.ache; + &a.ache.email; - &a.melifaro; + &a.melifaro.email; - &a.theraven; + &a.theraven.email; - &a.davidch; + &a.davidch.email; - &a.marcus; + &a.marcus.email; - &a.tijl; + &a.tijl.email; - &a.rakuco; + &a.rakuco.email; - &a.alc; + &a.alc.email; - &a.cracauer; + &a.cracauer.email; - &a.brucec; + &a.brucec.email; - &a.culot; + &a.culot.email; - &a.joel; + &a.joel.email; - &a.bapt; + &a.bapt.email; - &a.davidc; + &a.davidc.email; - &a.brd; + &a.brd.email; - &a.brooks; + &a.brooks.email; - &a.pjd; + &a.pjd.email; - &a.jwd; + &a.jwd.email; - &a.carl; + &a.carl.email; - &a.vd; + &a.vd.email; - &a.rdivacky; + &a.rdivacky.email; - &a.mdodd; + &a.mdodd.email; - &a.danfe; + &a.danfe.email; - &a.dd; + &a.dd.email; - &a.iedowse; + &a.iedowse.email; - &a.bdrewery; + &a.bdrewery.email; - &a.gad; + &a.gad.email; - &a.olivierd; + &a.olivierd.email; - &a.bruno; + &a.bruno.email; - &a.ale; + &a.ale.email; - &a.peadar; + &a.peadar.email; - &a.deischen; + &a.deischen.email; - &a.eivind; + &a.eivind.email; - &a.julian; + &a.julian.email; - &a.ae; + &a.ae.email; - &a.lme; + &a.lme.email; - &a.rse; + &a.rse.email; - &a.ru; + &a.ru.email; - &a.le; + &a.le.email; - &a.se; + &a.se.email; - &a.bde; + &a.bde.email; - &a.jasone; + &a.jasone.email; - &a.bf; + &a.bf.email; - &a.madpilot; + &a.madpilot.email; - &a.rafan; + &a.rafan.email; - &a.stefanf; + &a.stefanf.email; - &a.scf; + &a.scf.email; - &a.feld; + &a.feld.email; - &a.green; + &a.green.email; - &a.lioux; + &a.lioux.email; - &a.fanf; + &a.fanf.email; - &a.mdf; + &a.mdf.email; - &a.blackend; + &a.blackend.email; - &a.olli; + &a.olli.email; - &a.decke; + &a.decke.email; - &a.gallatin; + &a.gallatin.email; - &a.avg; + &a.avg.email; - &a.beat; + &a.beat.email; - &a.danger; + &a.danger.email; - &a.sjg; + &a.sjg.email; - &a.gibbs; + &a.gibbs.email; - &a.pfg; + &a.pfg.email; - &a.girgen; + &a.girgen.email; - &a.pgollucci; + &a.pgollucci.email; - &a.trociny; + &a.trociny.email; - &a.daichi; + &a.daichi.email; - &a.bgray; + &a.bgray.email; - &a.dg; + &a.dg.email; - &a.grehan; + &a.grehan.email; - &a.jamie; + &a.jamie.email; - &a.edwin; + &a.edwin.email; - &a.wg; + &a.wg.email; - &a.bar; + &a.bar.email; - &a.jmg; + &a.jmg.email; - &a.mjg; + &a.mjg.email; - &a.vg; + &a.vg.email; - &a.jhale; + &a.jhale.email; - &a.smh; + &a.smh.email; - &a.ehaupt; + &a.ehaupt.email; - &a.jhay; + &a.jhay.email; - &a.jh; + &a.jh.email; - &a.jgh; + &a.jgh.email; - &a.ghelmer; + &a.ghelmer.email; - &a.wen; + &a.wen.email; - &a.dhn; + &a.dhn.email; - &a.jhibbits; + &a.jhibbits.email; - &a.nhibma; + &a.nhibma.email; - &a.pho; + &a.pho.email; *** DIFF OUTPUT TRUNCATED AT 1000 LINES *** From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 21:19:58 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 928302F2; Tue, 9 Jul 2013 21:19:58 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 6BEAB1D5B; Tue, 9 Jul 2013 21:19:58 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69LJwoT045198; Tue, 9 Jul 2013 21:19:58 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69LJwuf045197; Tue, 9 Jul 2013 21:19:58 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201307092119.r69LJwuf045197@svn.freebsd.org> From: Glen Barber Date: Tue, 9 Jul 2013 21:19:58 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-svnadmin@freebsd.org Subject: svn commit: r42227 - svnadmin/conf X-SVN-Group: doc-svnadmin MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 21:19:58 -0000 Author: gjb Date: Tue Jul 9 21:19:57 2013 New Revision: 42227 URL: http://svnweb.freebsd.org/changeset/doc/42227 Log: Unlock head/ now that projects/entities/ is merged. Thanks, rene@ ! Approved by: doceng (implicit) Modified: svnadmin/conf/approvers Modified: svnadmin/conf/approvers ============================================================================== --- svnadmin/conf/approvers Tue Jul 9 21:15:47 2013 (r42226) +++ svnadmin/conf/approvers Tue Jul 9 21:19:57 2013 (r42227) @@ -16,7 +16,7 @@ # # $FreeBSD$ # -^head/ doceng +#^head/ doceng #^projects/ doceng #^user/ doceng #^translations/ doceng From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 21:42:51 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 6F9BD766; Tue, 9 Jul 2013 21:42:51 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 228471EAE; Tue, 9 Jul 2013 21:42:50 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r69LgnJ1048908; Tue, 9 Jul 2013 15:42:49 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r69LgnIv048905; Tue, 9 Jul 2013 15:42:49 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 9 Jul 2013 15:42:49 -0600 (MDT) From: Warren Block To: Gabor Kovesdan Subject: Re: svn commit: r42201 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: <51DC7984.4080106@FreeBSD.org> Message-ID: References: <201307090627.r696RuOg076372@svn.freebsd.org> <51DC7984.4080106@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 09 Jul 2013 15:42:50 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 21:42:51 -0000 On Tue, 9 Jul 2013, Gabor Kovesdan wrote: > Em 09-07-2013 21:13, Benjamin Kaduk escreveu: >>> Remove a confusing paragraph whose net contribution is negative. Remove >>> some from "Ports Collection", it's unnecessary. Make one example >> >> Was this discussed anywhere? I am seeing a pretty long precedent for the >> non-breaking space. > Indeed it wasn't discussed but I think that these non-breaking spaces should > be reconsidered. I had added the to the Ports Collection in the word list very recently, then saw that it really made no sense to force those two words to be on the same line. > Typography rules and conventions are language-dependent. For example, in > Hungarian it is not nice to end a line with a sentence-starting single-letter > article. Afaik, English does not have such rules, except widows and orphans, > which are more concerned with aesthetics. It is reasonable to avoid a line > break between FreeBSD and 9.X or similar cases but probably not for such long > terms as Ports Collection. Actually, it may just hit back because it may make > justified paragraphs very ugly in our print formats. Exactly. From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 22:56:31 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 5201934C; Tue, 9 Jul 2013 22:56:31 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 440EA1239; Tue, 9 Jul 2013 22:56:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69MuVdc077192; Tue, 9 Jul 2013 22:56:31 GMT (envelope-from rene@svn.freebsd.org) Received: (from rene@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69MuUu5077189; Tue, 9 Jul 2013 22:56:30 GMT (envelope-from rene@svn.freebsd.org) Message-Id: <201307092256.r69MuUu5077189@svn.freebsd.org> From: Rene Ladan Date: Tue, 9 Jul 2013 22:56:30 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42228 - in head/nl_NL.ISO8859-1/books/handbook: disks filesystems jails X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 22:56:31 -0000 Author: rene Date: Tue Jul 9 22:56:30 2013 New Revision: 42228 URL: http://svnweb.freebsd.org/changeset/doc/42228 Log: Merge r42226 for the Dutch articles and books. Modified: head/nl_NL.ISO8859-1/books/handbook/disks/chapter.xml head/nl_NL.ISO8859-1/books/handbook/filesystems/chapter.xml head/nl_NL.ISO8859-1/books/handbook/jails/chapter.xml Modified: head/nl_NL.ISO8859-1/books/handbook/disks/chapter.xml ============================================================================== --- head/nl_NL.ISO8859-1/books/handbook/disks/chapter.xml Tue Jul 9 21:19:57 2013 (r42227) +++ head/nl_NL.ISO8859-1/books/handbook/disks/chapter.xml Tue Jul 9 22:56:30 2013 (r42228) @@ -6,6 +6,7 @@ %SOURCE% en_US.ISO8859-1/books/handbook/disks/chapter.xml %SRCID% 40792 + (+r42226) --> @@ -4001,7 +4002,7 @@ gbde_lockdir="/etc/gbde"Een alternatieve cryptografische GEOM klassie is beschikbaar - geli. Deze wordt - op het moment ontwikkeld door &a.pjd;. geli + op het moment ontwikkeld door &a.pjd.email;. geli verschilt van gbde in de mogelijkheden en in het gebruik van een andere methode voor het versleutelen. @@ -4390,7 +4391,7 @@ Device 1K-blocks Used Av toepassingen en hoog beschikbare opslag is een sleutelonderdeel in zulke omgevingen. Hoog beschikbare opslag, of HASTHighly Available STorage, werd - ontwikkeld door &a.pjd; als een raamwerk dat transparante opslag van + ontwikkeld door &a.pjd.email; als een raamwerk dat transparante opslag van dezelfde gegevens toestaat over fysiek gescheiden machines die verbonden zijn door een TCP/IP-netwerk. HAST kan gezien worden als een netwerkgebaseerde RAID1 (spiegel) en is vergelijkbaar met het Modified: head/nl_NL.ISO8859-1/books/handbook/filesystems/chapter.xml ============================================================================== --- head/nl_NL.ISO8859-1/books/handbook/filesystems/chapter.xml Tue Jul 9 21:19:57 2013 (r42227) +++ head/nl_NL.ISO8859-1/books/handbook/filesystems/chapter.xml Tue Jul 9 22:56:30 2013 (r42228) @@ -5,6 +5,7 @@ %SOURCE% en_US.ISO8859-1/books/handbook/filesystems/chapter.xml %SRCID% 40792 + (+r42226) --> @@ -840,7 +841,7 @@ errors: No known data errors broncode is vrijgegeven onder de GNU Public License. Kijk op deze pagina voor meer details. De &os;-port werd gestart door - Russel Cattelan, &a.kan; en &a.rodrigc;. + Russel Cattelan, &a.kan.email; en &a.rodrigc.email;. Om XFS als een kernelmodule te laden: @@ -873,7 +874,7 @@ errors: No known data errors ReiserFS Het Reiser bestandssysteem, ReiserFS, was overgebracht naar &os; - door &a.dumbbell; en is vrijgegeven onder de GNU + door &a.dumbbell.email; en is vrijgegeven onder de GNU Public License. Het stuurprogramma voor ReiserFS stelt de &os;-kernel momenteel in Modified: head/nl_NL.ISO8859-1/books/handbook/jails/chapter.xml ============================================================================== --- head/nl_NL.ISO8859-1/books/handbook/jails/chapter.xml Tue Jul 9 21:19:57 2013 (r42227) +++ head/nl_NL.ISO8859-1/books/handbook/jails/chapter.xml Tue Jul 9 22:56:30 2013 (r42228) @@ -6,6 +6,7 @@ %SOURCE% en_US.ISO8859-1/books/handbook/jails/chapter.xml %SRCID% 41645 + (+r42226) --> @@ -174,7 +175,7 @@ ��n van de tools welke gebruikt kan worden om de beveiliging van een &os; systeem te verbeteren zijn jails. Jails zijn ge�ntroduceerd in - &os; 4.X door &a.phk;, maar zijn grotendeels verbeterd in + &os; 4.X door &a.phk.email;, maar zijn grotendeels verbeterd in &os; 5.X om ze nog sterker en krachtiger te maken. De ontwikkeling gaat nog steeds door met verbeteringen voor het gebruik, performance, betrouwbaarheid en beveiliging. @@ -570,7 +571,7 @@ jail_www_devf Dienst jails - Deze sectie is gebaseerd op een idee van &a.simon; + Deze sectie is gebaseerd op een idee van &a.simon.email; op , en een geupdate artikel door Ken Tom locals@gmail.com. Deze sectie illusteert hoe een From owner-svn-doc-all@FreeBSD.ORG Tue Jul 9 23:18:04 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 648F8821; Tue, 9 Jul 2013 23:18:04 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 4730B131F; Tue, 9 Jul 2013 23:18:04 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r69NI4Pw083662; Tue, 9 Jul 2013 23:18:04 GMT (envelope-from rene@svn.freebsd.org) Received: (from rene@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r69NI418083661; Tue, 9 Jul 2013 23:18:04 GMT (envelope-from rene@svn.freebsd.org) Message-Id: <201307092318.r69NI418083661@svn.freebsd.org> From: Rene Ladan Date: Tue, 9 Jul 2013 23:18:04 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42229 - head/nl_NL.ISO8859-1/htdocs X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Jul 2013 23:18:04 -0000 Author: rene Date: Tue Jul 9 23:18:03 2013 New Revision: 42229 URL: http://svnweb.freebsd.org/changeset/doc/42229 Log: Merge r42226 fo the Dutch website. Modified: head/nl_NL.ISO8859-1/htdocs/administration.xml Modified: head/nl_NL.ISO8859-1/htdocs/administration.xml ============================================================================== --- head/nl_NL.ISO8859-1/htdocs/administration.xml Tue Jul 9 22:56:30 2013 (r42228) +++ head/nl_NL.ISO8859-1/htdocs/administration.xml Tue Jul 9 23:18:03 2013 (r42229) @@ -9,7 +9,7 @@ @@ -86,14 +86,14 @@ actieve ontwikkelaars binnen het project.

&a.tabthorpe; <tabthorpe@FreeBSD.org>
&a.gavin; <gavin@FreeBSD.org>
&a.jhb; <jhb@FreeBSD.org>
&a.kib; <kib@FreeBSD.org>
&a.theraven; <theraven@FreeBSD.org>
&a.hrs; <hrs@FreeBSD.org>
&a.peter; <peter@FreeBSD.org>
&a.miwi; <miwi@FreeBSD.org>
&a.tabthorpe.email;
&a.gavin.email;
&a.jhb.email;
&a.kib.email;
&a.theraven.email;
&a.hrs.email;
&a.peter.email;
&a.miwi.email;

&os; Documentatiebeheerteam @@ -107,10 +107,10 @@ Documentatiebeheerteam in meer detail.

-
&a.gjb; <gjb@FreeBSD.org>
-
&a.blackend; <blackend@FreeBSD.org>
-
&a.gabor; <gabor@FreeBSD.org>
-
&a.hrs; <hrs@FreeBSD.org>
+
&a.gjb.email;
+
&a.blackend.email;
+
&a.gabor.email;
+
&a.hrs.email;

&os; Portbeheerteam @@ -126,15 +126,14 @@ van het Portbeheerteam.

-
&a.tabthorpe; <tabthorpe@FreeBSD.org>
-
&a.marcus; <marcus@FreeBSD.org>
-
&a.bapt; <bapt@FreeBSD.org>
-
&a.bdrewery; <bdrewery@FreeBSD.org> - (liaison voor het Uitgavebeheerteam)
-
&a.decke; <decke@FreeBSD.org>
-
&a.erwin; <erwin@FreeBSD.org> (liaison voor het Clusterbeheerteam)
-
&a.itetcu; <itetcu@FreeBSD.org>
-
&a.miwi; <miwi@FreeBSD.org>
+
&a.tabthorpe.email;
+
&a.marcus.email;
+
&a.bapt.email;
+
&a.bdrewery.email; (liaison voor het Uitgavebeheerteam)
+
&a.decke.email;
+
&a.erwin.email; (liaison voor het Clusterbeheerteam)
+
&a.itetcu.email;
+
&a.miwi.email;

@@ -151,20 +150,19 @@ verantwoordelijkheden van het Primaire Uitgavebeheerteam.

-
&a.mva; <mva@FreeBSD.org>
-
&a.gjb; <gjb@FreeBSD.org>
-
&a.kib; <kib@FreeBSD.org>
-
&a.joel; <joel@FreeBSD.org>
-
&a.blackend; <blackend@FreeBSD.org>
-
&a.skreuzer; <skreuzer@FreeBSD.org>
-
&a.delphij; <delphij@FreeBSD.org>
-
&a.jpaetzel; <jpaetzel@FreeBSD.org>
-
&a.rodrigc; <rodrigc@FreeBSD.org>
-
&a.hrs; <hrs@FreeBSD.org>
-
&a.glebius; <glebius@FreeBSD.org>
-
&a.kensmith; <kensmith@FreeBSD.org> - (Hoofd)
-
&a.marius; <marius@FreeBSD.org>
+
&a.mva.email;
+
&a.gjb.email;
+
&a.kib.email;
+
&a.joel.email;
+
&a.blackend.email;
+
&a.skreuzer.email;
+
&a.delphij.email;
+
&a.jpaetzel.email;
+
&a.rodrigc.email;
+
&a.hrs.email;
+
&a.glebius.email;
+
&a.kensmith.email; (Hoofd)
+
&a.marius.email;

Bouwers Uitgavebeheerteam @@ -174,9 +172,9 @@ verpakken van uitgaven van &os; op de ondersteunde platforms.

-
&a.marcel; <marcel@FreeBSD.org>
-
&a.nyan; <nyan@FreeBSD.org>
-
&a.nwhitehorn; <nwhitehorn@FreeBSD.org>
+
&a.marcel.email;
+
&a.nyan.email;
+
&a.nwhitehorn.email;

@@ -192,15 +190,15 @@ href="donations/">&os; Donaties Relatie pagina.

-
&a.tabthorpe; <tabthorpe@FreeBSD.org>
-
&a.gjb; <gjb@FreeBSD.org>
-
&a.gahr; <gahr@FreeBSD.org>
-
&a.pgollucci; <pgollucci@FreeBSD.org>
-
&a.skreuzer; <skreuzer@FreeBSD.org>
-
&a.obrien; <obrien@FreeBSD.org>
-
&a.trhodes; <trhodes@FreeBSD.org>
-
Daniel Seuffert <ds@FreeBSD.org>
-
&a.rwatson; <rwatson@FreeBSD.org>
+
&a.tabthorpe.email;
+
&a.gjb.email;
+
&a.gahr.email;
+
&a.pgollucci.email;
+
&a.skreuzer.email;
+
&a.obrien.email;
+
&a.trhodes.email;
+
&a.ds.email;
+
&a.rwatson.email;

Marketingteam @@ -213,17 +211,17 @@ href="mailto:steven@zna.com">steven@zna.com>
Denise Ebery <denise@ixsystems.com>
-
Deb Goodkin <deb@FreeBSD.org>
-
&a.jkoshy; <jkoshy@FreeBSD.org>
-
&a.dru; <dru@FreeBSD.org>
-
&a.mwlucas; <mwlucas@FreeBSD.org>
-
&a.imp; <imp@FreeBSD.org>
-
&a.kmoore; <kmoore@FreeBSD.org>
-
&a.murray; <murray@FreeBSD.org>
-
Matt Olander <matt@FreeBSD.org>
+
&a.deb.email;
+
&a.jkoshy.email;
+
&a.dru.email;
+
&a.mwlucas.email;
+
&a.imp.email;
+
&a.kmoore.email;
+
&a.murray.email;
+
&a.matt.email;

Jeremy C. Reed <reed@reedmedia.net>
-
&a.rwatson; <rwatson@FreeBSD.org>
+
&a.rwatson.email;

Beveiligingsteam @@ -241,22 +239,21 @@ en verantwoordelijkheden van de Beveiligingsofficier.

-
&a.benl; <benl@FreeBSD.org>
-
&a.cperciva; <cperciva@FreeBSD.org> (Emeritus Officier)
-
&a.csjp; <csjp@FreeBSD.org>
-
&a.delphij; <delphij@FreeBSD.org> (Hulpofficier)
-
&a.des; <des@FreeBSD.org> (Officier)
-
&a.gavin; <gavin@FreeBSD.org> (Liaison voor het Coreteam)
-
&a.gnn; <gnn@FreeBSD.org>
-
&a.jonathan; <jonathan@FreeBSD.org>
-
&a.philip; <philip@FreeBSD.org>
-
&a.qingli; <qingli@FreeBSD.org>
-
&a.remko; <remko@FreeBSD.org>
-
&a.rwatson; <rwatson@FreeBSD.org>
-
&a.simon; <simon@FreeBSD.org> - (Emeritus Officier)
-
&a.stas; <stas@FreeBSD.org>
-
&a.trasz; <trasz@FreeBSD.org>
+
&a.benl.email;
+
&a.cperciva.email; (Emeritus Officier)
+
&a.csjp.email;
+
&a.delphij.email; (Hulpofficier)
+
&a.des.email; (Officier)
+
&a.gavin.email; (Liaison voor het Coreteam)
+
&a.gnn.email;
+
&a.jonathan.email;
+
&a.philip.email;
+
&a.qingli.email;
+
&a.remko.email;
+
&a.rwatson.email;
+
&a.simon.email; (Emeritus Officier)
+
&a.stas.email;
+
&a.trasz.email;

Verkopersrelaties @@ -282,7 +279,7 @@ acties van core.

-
&a.pgj; <pgj@FreeBSD.org>
+
&a.pgj.email;

Portbeheerteam-secretaris @@ -298,7 +295,7 @@ recente beslissingen en acties van portmgr bevatten.

-
&a.tabthorpe; <tabthorpe@FreeBSD.org>
+
&a.tabthorpe.email;

Beveiligingsteam Secretaris @@ -312,7 +309,7 @@ Beveiligingsteam-secretaris geen zaken van het Beveiligingsofficierteam.

-
&a.gnn; <gnn@FreeBSD.org>
+
&a.gnn.email;

@@ -327,8 +324,8 @@ entiteit.

-
&a.simon; <simon@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.simon.email;
+
&a.dhw.email;

Back-upbeheerders @@ -338,8 +335,8 @@
De Back-upbeheerders behandelen alle back-ups op het &os;-cluster.

-
&a.simon; <simon@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.simon.email;
+
&a.dhw.email;

Bugmeisters & GNATS Beheerders @@ -351,9 +348,9 @@ verantwoordelijk voor de probleemrapportagegroep.

-
&a.eadler; <eadler@FreeBSD.org<
-
&a.gavin; <gavin@FreeBSD.org<
-
&a.gonzo; <gonzo@FreeBSD.org<
+
&a.eadler.email;
+
&a.gavin.email;
+
&a.gonzo.email;

Clusterbeheerders @@ -372,15 +369,15 @@

-
&a.bhaga; <bhaga@FreeBSD.org>
-
&a.brd; <brd@FreeBSD.org>
-
&a.bz; <bz@FreeBSD.org>
-
&a.gjb; <gjb@FreeBSD.org>
-
&a.kensmith; <kensmith@FreeBSD.org>
-
&a.peter; <peter@FreeBSD.org> (Hoofd)
-
&a.sbruno; <sbruno@FreeBSD.org>
-
&a.simon; <simon@FreeBSD.org>
-
&a.zi; <zi@FreeBSD.org>
+
&a.bhaga.email;
+
&a.brd.email;
+
&a.bz.email;
+
&a.gjb.email;
+
&a.kensmith.email;
+
&a.peter.email; (Hoofd)
+
&a.sbruno.email;
+
&a.simon.email;
+
&a.zi.email;

CVSup Mirror Site Co�rdinatoren @@ -393,8 +390,8 @@ voor het grote publiek om hun dichtstbijzijnde CVSup-spiegel te vinden.

-
&a.kuriyama; <kuriyama@FreeBSD.org>
-
&a.kensmith; <kensmith@FreeBSD.org>
+
&a.kuriyama.email;
+
&a.kensmith.email;

DNS Beheerders @@ -405,10 +402,10 @@ aanverwante diensten.

-
&a.brd; <brd@FreeBSD.org>
-
&a.simon; <simon@FreeBSD.org>
-
&a.peter; <peter@FreeBSD.org>
-
&a.bz; <bz@FreeBSD.org>
+
&a.brd.email;
+
&a.simon.email;
+
&a.peter.email;
+
&a.bz.email;

FTP/WWW Mirror Site Co�rdinatoren @@ -422,11 +419,11 @@ vinden.

-
&a.brd; <brd@FreeBSD.org>
-
&a.kuriyama; <kuriyama@FreeBSD.org>
-
&a.simon; <simon@FreeBSD.org>
-
&a.kensmith; <kensmith@FreeBSD.org>
-
&a.bz; <bz@FreeBSD.org>
+
&a.brd.email;
+
&a.kuriyama.email;
+
&a.simon.email;
+
&a.kensmith.email;
+
&a.bz.email;

Perforce Reservoir Beheerders @@ -438,12 +435,12 @@ niet-committers dienen aan de perforce-beheerders gericht te worden.

-
&a.gibbs; <gibbs@FreeBSD.org>
-
&a.kensmith; <kensmith@FreeBSD.org>
-
&a.gordon; <gordon@FreeBSD.org>
-
&a.rwatson; <rwatson@FreeBSD.org>
-
&a.peter; <peter@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.gibbs.email;
+
&a.kensmith.email;
+
&a.gordon.email;
+
&a.rwatson.email;
+
&a.peter.email;
+
&a.dhw.email;

Postmeesterteam @@ -456,11 +453,11 @@ trol-, spam- en virusfilters.

-
&a.jmb; <jmb@FreeBSD.org>
-
&a.brd; <brd@FreeBSD.org>
-
&a.flo; <flo@FreeBSD.org>
-
&a.sahil; <sahil@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.jmb.email;
+
&a.brd.email;
+
&a.flo.email;
+
&a.sahil.email;
+
&a.dhw.email;

Subversion Beheerders <svnadm@>

@@ -469,9 +466,9 @@ werking van de Subversion reservoirs.

&a.bz; <bz@FreeBSD.org>
&a.peter; <peter@FreeBSD.org>
&a.simon; <simon@FreeBSD.org>
&a.bz.email;
&a.peter.email;
&a.simon.email;

Webmasterteam @@ -484,12 +481,12 @@ Webmasterteam, behalve fouten in de documentatie.

-
&a.nik; <nik@FreeBSD.org>
-
&a.kuriyama; <kuriyama@FreeBSD.org>
-
&a.simon; <simon@FreeBSD.org>
-
&a.jesusr; <jesusr@FreeBSD.org>
-
&a.wosch; <wosch@FreeBSD.org>
-
&a.don; <don@FreeBSD.org>
+
&a.nik.email;
+
&a.kuriyama.email;
+
&a.simon.email;
+
&a.jesusr.email;
+
&a.wosch.email;
+
&a.don.email;

From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 00:18:49 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id DEB5F9B6; Wed, 10 Jul 2013 00:18:49 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id D1D2C187D; Wed, 10 Jul 2013 00:18:49 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6A0InLF001381; Wed, 10 Jul 2013 00:18:49 GMT (envelope-from rmacklem@svn.freebsd.org) Received: (from rmacklem@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6A0InbL001380; Wed, 10 Jul 2013 00:18:49 GMT (envelope-from rmacklem@svn.freebsd.org) Message-Id: <201307100018.r6A0InbL001380@svn.freebsd.org> From: Rick Macklem Date: Wed, 10 Jul 2013 00:18:49 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42230 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 00:18:49 -0000 Author: rmacklem (src committer) Date: Wed Jul 10 00:18:49 2013 New Revision: 42230 URL: http://svnweb.freebsd.org/changeset/doc/42230 Log: Document the __FreeBSD_version bump for r253049. 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 Tue Jul 9 23:18:03 2013 (r42229) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Wed Jul 10 00:18:49 2013 (r42230) @@ -16089,6 +16089,15 @@ Reference: <http://www.freebsd.org/po aio_mlock system call (rev 251526). + + + 1000036 + July 9, 2013 + 10-CURRENT after the addition of a new function + to the kernel GSSAPI module's function call interface (rev + 253049). + + From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 08:13:58 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id BFA37970; Wed, 10 Jul 2013 08:13:58 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 97E2F1AF2; Wed, 10 Jul 2013 08:13:58 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6A8DwIk049725; Wed, 10 Jul 2013 08:13:58 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6A8Dw7u049724; Wed, 10 Jul 2013 08:13:58 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307100813.r6A8Dw7u049724@svn.freebsd.org> From: Gabor Pali Date: Wed, 10 Jul 2013 08:13:58 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42231 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 08:13:58 -0000 Author: pgj Date: Wed Jul 10 08:13:58 2013 New Revision: 42231 URL: http://svnweb.freebsd.org/changeset/doc/42231 Log: - Add a Q2 report entry on the SDIO driver Submitted by: Ilya Bakulin Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 00:18:49 2013 (r42230) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 08:13:58 2013 (r42231) @@ -18,7 +18,7 @@
Thanks to all the reporters for the excellent work! This report - contains 32 entries and we hope you enjoy reading it.
+ contains 33 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -1842,4 +1842,49 @@ functionality through `pkg(8)`. + + + SDIO Driver + + + + + Ilya + Bakulin + + ilya@bakulin.de + + + + + SDIO project page on the &os; wiki + Source code + + + +
The driver is implemented as an extension to the existing MMC + bus, adding a lot of new SDIO-specific bus methods. Getting + information about the card works, including querying all the + supported I/O functions. Simple byte transfers and multi-byte + reads work.
+ +
A prototype of the driver for Marvell SDIO WLAN/BT module is + also being developed, using the existing Linux driver as a + reference.
+ + + + Extend MMC bus interface with more SDIO-specific bus methods + to allow child drivers to perform multi-byte in/out + transfers. + + Write firmware loading code for the prototype of the WLAN + driver. Further work on the WLAN driver should probably be done + as a separate project. + + Implement detach path. It has not been tested yet because + the DreamPlug hardware available does not have an external + SDIO-capable slot. + + From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 08:16:33 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 00F93ADC; Wed, 10 Jul 2013 08:16:32 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id E83A61B0B; Wed, 10 Jul 2013 08:16:32 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6A8GWXB050252; Wed, 10 Jul 2013 08:16:32 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6A8GWAH050251; Wed, 10 Jul 2013 08:16:32 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307100816.r6A8GWAH050251@svn.freebsd.org> From: Gabor Pali Date: Wed, 10 Jul 2013 08:16:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42232 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 08:16:33 -0000 Author: pgj Date: Wed Jul 10 08:16:32 2013 New Revision: 42232 URL: http://svnweb.freebsd.org/changeset/doc/42232 Log: - Minor nits Submitted by: bjk Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 08:13:58 2013 (r42231) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 08:16:32 2013 (r42232) @@ -282,10 +282,10 @@
A `hastd(8)` module for `bsnmpd(1)` has been - committed to &os; `head` and merged to `stable/8` - and `stable/9` branches recently. This module makes it - possible to monitor and manage `hastd(8)` via the SNMP - protocol.
+ committed to &os; `head` and merged to the + `stable/8` and `stable/9` branches recently. This + module makes it possible to monitor and manage `hastd(8)` + via the SNMP protocol.
@@ -910,7 +910,7 @@ -
Capsicum, lightweight OS capability and sandboxing framework, +
Capsicum, a lightweight OS capability and sandboxing framework, is being actively worked on. In the last few months the following tasks have been completed:
From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 10:05:39 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 43C2EBB4; Wed, 10 Jul 2013 10:05:39 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 345A610B3; Wed, 10 Jul 2013 10:05:39 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6AA5dcD082728; Wed, 10 Jul 2013 10:05:39 GMT (envelope-from ryusuke@svn.freebsd.org) Received: (from ryusuke@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6AA5brc082719; Wed, 10 Jul 2013 10:05:37 GMT (envelope-from ryusuke@svn.freebsd.org) Message-Id: <201307101005.r6AA5brc082719@svn.freebsd.org> From: Ryusuke SUZUKI Date: Wed, 10 Jul 2013 10:05:37 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42233 - in head/ja_JP.eucJP: articles/contributors books/faq books/handbook/bsdinstall htdocs/platforms htdocs/security share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 10:05:39 -0000 Author: ryusuke Date: Wed Jul 10 10:05:37 2013 New Revision: 42233 URL: http://svnweb.freebsd.org/changeset/doc/42233 Log: - Update the author entity references: head/ja_JP.eucJP/articles/contributors/article.xml head/ja_JP.eucJP/books/faq/book.xml head/ja_JP.eucJP/books/handbook/bsdinstall/chapter.xml head/ja_JP.eucJP/share/xml/mailing-lists.ent - Merge the following from the English version: r40236 -> r42226 head/ja_JP.eucJP/htdocs/platforms/arm.xml r38308 -> r42226 head/ja_JP.eucJP/htdocs/platforms/sparc.xml r41455 -> r42226 head/ja_JP.eucJP/htdocs/security/reporting.xml r37259 -> r42226 head/ja_JP.eucJP/share/xml/teams.ent Modified: head/ja_JP.eucJP/articles/contributors/article.xml head/ja_JP.eucJP/books/faq/book.xml head/ja_JP.eucJP/books/handbook/bsdinstall/chapter.xml head/ja_JP.eucJP/htdocs/platforms/arm.xml head/ja_JP.eucJP/htdocs/platforms/sparc.xml head/ja_JP.eucJP/htdocs/security/reporting.xml head/ja_JP.eucJP/share/xml/mailing-lists.ent head/ja_JP.eucJP/share/xml/teams.ent Modified: head/ja_JP.eucJP/articles/contributors/article.xml ============================================================================== --- head/ja_JP.eucJP/articles/contributors/article.xml Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/articles/contributors/article.xml Wed Jul 10 10:05:37 2013 (r42233) @@ -52,7 +52,7 @@ - &a.mbarkah; + &a.mbarkah.email; ��ν�°�� Hemisphere Online �ϡ�Pentium Pro (P6) 200MHz CPU @@ -106,7 +106,7 @@ - &a.dillon; + &a.dillon.email; @@ -120,7 +120,7 @@ - &a.sef; + &a.sef.email; @@ -146,7 +146,7 @@ - &a.chuckr; + &a.chuckr.email; @@ -264,7 +264,7 @@ Larry Altneu larry@ALR.COM �� - &a.wilko;�ϡ�wt + &a.wilko.email;�ϡ�wt �ɥ饤�Ф��ɤ��뤿�� Wangtek �� Archive �� QIC-02 �ơ��ץɥ饤�֤��󶡤��Ƥ��ޤ�� @@ -301,7 +301,7 @@ - Christoph Kukulies kuku@FreeBSD.org + &a.kuku.email; �ϡ�IDE CD-ROM �ɥ饤�г�ȯ�Ѥ� FX120 12 ��® Mitsumi CD-ROM �ɥ饤�֤��󶡤��Ƥ��ޤ�� @@ -336,7 +336,7 @@ interface - business GmbH, Dresden �ϡ�&a.joerg; + business GmbH, Dresden �ϡ�&a.joerg.email; �򺬵��褯��ݡ��Ȥ��Ƥ��ޤ��ܿ�� FreeBSD �λŻ��򹥤ߤ��Ǥ��ꡢ��Ŀͤ��³��ޤ�� ٤��ʤä��ڤ줿�ꤷ�ƻŻ��ˤʤ�ʤ��ɬ�� Modified: head/ja_JP.eucJP/books/faq/book.xml ============================================================================== --- head/ja_JP.eucJP/books/faq/book.xml Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/books/faq/book.xml Wed Jul 10 10:05:37 2013 (r42233) @@ -13832,7 +13832,7 @@ raisechar=^^ - &a.nik; �ˤ��ɵ� + &a.nik.email; �ˤ��ɵ� ��ˤ��Ф��ޤ�� Modified: head/ja_JP.eucJP/books/handbook/bsdinstall/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/bsdinstall/chapter.xml Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/books/handbook/bsdinstall/chapter.xml Wed Jul 10 10:05:37 2013 (r42233) @@ -968,12 +968,12 @@ Trying to mount root from cd9660:/dev/is <application>bsdinstall</application> �ξҲ� - bsdinstall �ϡ�&a.nwhitehorn; �ˤ��񤫤줿�� + bsdinstall �ϡ�&a.nwhitehorn.email; �ˤ��񤫤줿�� ƥ��ȥ١��Υ��󥹥ȡ��ץ��Ǥ�� 2011 ǯ�� &os; 9.0 ��Ƴ��ޤ�� - &a.kmoore; �� pc-sysinstall �ϡ� + &a.kmoore.email; �� pc-sysinstall �ϡ� PC-BSD �˴ޤޤ�Ƥ��ꡢ &os; �Υ��󥹥ȡ�� ˤ��ѤǤ��ޤ�� Modified: head/ja_JP.eucJP/htdocs/platforms/arm.xml ============================================================================== --- head/ja_JP.eucJP/htdocs/platforms/arm.xml Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/htdocs/platforms/arm.xml Wed Jul 10 10:05:37 2013 (r42233) @@ -5,7 +5,7 @@ ]> - + @@ -94,7 +94,7 @@
û��󥹥ȡ��륬��
-
&a.cognet; (cognet@FreeBSD.org) �� FreeBSD +
&a.cognet.email; �� FreeBSD ��Ѥ�û��󥹥ȡ��륬��ɤ�񤭤ޤ�� Ǥ��ޤ��
Modified: head/ja_JP.eucJP/htdocs/platforms/sparc.xml ============================================================================== --- head/ja_JP.eucJP/htdocs/platforms/sparc.xml Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/htdocs/platforms/sparc.xml Wed Jul 10 10:05:37 2013 (r42233) @@ -5,7 +5,7 @@ ]> - + @@ -159,9 +159,9 @@ �ؤΰܿ��ƻ�˾褻�뤿��˺�Ȥ��Ƥ��ޤ��

-
&a.jake;
-
&a.tmm;
-
&a.obrien;
+
&a.jake.email;
+
&a.tmm.email;
+
&a.obrien.email;

FreeBSD/sparc64 �᡼��󥰥ꥹ��
Modified: head/ja_JP.eucJP/htdocs/security/reporting.xml ============================================================================== --- head/ja_JP.eucJP/htdocs/security/reporting.xml Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/htdocs/security/reporting.xml Wed Jul 10 10:05:37 2013 (r42233) @@ -5,7 +5,7 @@ ]> - + @@ -74,28 +74,23 @@ - + - + - + - + - + Modified: head/ja_JP.eucJP/share/xml/mailing-lists.ent ============================================================================== --- head/ja_JP.eucJP/share/xml/mailing-lists.ent Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/share/xml/mailing-lists.ent Wed Jul 10 10:05:37 2013 (r42233) @@ -80,7 +80,6 @@ - Modified: head/ja_JP.eucJP/share/xml/teams.ent ============================================================================== --- head/ja_JP.eucJP/share/xml/teams.ent Wed Jul 10 08:16:32 2013 (r42232) +++ head/ja_JP.eucJP/share/xml/teams.ent Wed Jul 10 10:05:37 2013 (r42233) @@ -19,14 +19,14 @@ admins@FreeBSD.org"> +core@FreeBSD.org"> + core-secretary@FreeBSD.org"> cvsadm@FreeBSD.org"> cvsup-master@FreeBSD.org"> -dcvs@FreeBSD.org"> - doceng@FreeBSD.org"> donations@FreeBSD.org"> From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 11:35:47 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id B2B1C588; Wed, 10 Jul 2013 11:35:47 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 9486E177F; Wed, 10 Jul 2013 11:35:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ABZlTf011351; Wed, 10 Jul 2013 11:35:47 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ABZl5q011350; Wed, 10 Jul 2013 11:35:47 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307101135.r6ABZl5q011350@svn.freebsd.org> From: Warren Block Date: Wed, 10 Jul 2013 11:35:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 11:35:47 -0000 Author: wblock Date: Wed Jul 10 11:35:47 2013 New Revision: 42235 URL: http://svnweb.freebsd.org/changeset/doc/42235 Log: Add a section showing use of tags, both with and without "nolink". Move the sample inside the , the comment that noted procedures could not be inside examples is no longer correct. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 10:38:06 2013 (r42234) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 11:35:47 2013 (r42235) @@ -664,10 +664,7 @@ This is the second ordered item. - - @@ -682,6 +679,7 @@ And now do this. + @@ -1572,6 +1570,49 @@ This is the file called 'foo2' + + Email Addresses + + Email addresses are marked up with + email tags. In the HTML + output format, the wrapped text becomes a hyperlink to the + email address. Other output formats that support hyperlinks + may also make the email address into a link. + + + <sgmltag>email</sgmltag> with a Hyperlink + + Usage: + + paraQuestions about &os; may be sent to + emailquestions@&os;.orgemail.para + + Appearance: + + Questions about &os; may be sent to + questions@&os;.org. + + + A &os;-specific extension allows setting the + role attribute to nolink + to prevent the creation of the hyperlink to the email + address. + + + <sgmltag>email</sgmltag> Without a Hyperlink + + Usage: + + paraQuestions about &os; may be sent to + email role="nolink"questions@&os;.orgemail.para + + Appearance: + + Questions about &os; may be sent to + questions@&os;.org. + + + Describing <filename>Makefile</filename>s From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 11:40:36 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id DAFB68B1; Wed, 10 Jul 2013 11:40:36 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id CD66817AB; Wed, 10 Jul 2013 11:40:36 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ABeaJ2013668; Wed, 10 Jul 2013 11:40:36 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ABeatI013667; Wed, 10 Jul 2013 11:40:36 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307101140.r6ABeatI013667@svn.freebsd.org> From: Warren Block Date: Wed, 10 Jul 2013 11:40:36 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42236 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 11:40:36 -0000 Author: wblock Date: Wed Jul 10 11:40:36 2013 New Revision: 42236 URL: http://svnweb.freebsd.org/changeset/doc/42236 Log: Whitespace-only cleanup. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 11:35:47 2013 (r42235) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 11:40:36 2013 (r42236) @@ -665,20 +665,19 @@ - - - - Do this. - - - - Then do this. - - - - And now do this. - - + + + Do this. + + + + Then do this. + + + + And now do this. + + @@ -1574,7 +1573,7 @@ This is the file called 'foo2' Email Addresses Email addresses are marked up with - email tags. In the HTML + email tags. In the HTML output format, the wrapped text becomes a hyperlink to the email address. Other output formats that support hyperlinks may also make the email address into a link. From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 14:51:51 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 97EEC322; Wed, 10 Jul 2013 14:51:51 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-1.mit.edu (dmz-mailsec-scanner-1.mit.edu [18.9.25.12]) by mx1.freebsd.org (Postfix) with ESMTP id 1882B12E6; Wed, 10 Jul 2013 14:51:50 +0000 (UTC) X-AuditID: 1209190c-b7fa48e000000947-8b-51dd73d35381 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id 5B.28.02375.3D37DD15; Wed, 10 Jul 2013 10:46:43 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r6AEkgGj032511; Wed, 10 Jul 2013 10:46:42 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r6AEkeOE000459 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 10 Jul 2013 10:46:41 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r6AEkdAg012674; Wed, 10 Jul 2013 10:46:39 -0400 (EDT) Date: Wed, 10 Jul 2013 10:46:39 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: <201307101135.r6ABZl5q011350@svn.freebsd.org> Message-ID: References: <201307101135.r6ABZl5q011350@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrLIsWRmVeSWpSXmKPExsUixG6nonu5+G6gQdszeYsfHw8xWdxYtJ/J Ynd/L7PF5fcTWRxYPGZ8ms8SwBjFZZOSmpNZllqkb5fAlbHpyDn2gv8SFWt7/jA2MP4V6WLk 5JAQMJGY+e40M4QtJnHh3nq2LkYuDiGBfYwSE54tZYJwNjJKHN+6mBnCOcQksWheC5TTwCgx /9ZFVpB+FgFtifnbNrKB2GwCKhIz30DYIgKqEt+7VzGB2MwCURJ7ljaC1QsLREjcmzIRKM7B wSlgJfHkFiOIySvgKPFtgxtIhZCApcS8p3vZQWxRAR2J1funsIDYvAKCEidnPmGBmGgpce7P dbYJjIKzkKRmIUktYGRaxSibklulm5uYmVOcmqxbnJyYl5dapGuol5tZopeaUrqJERSynJI8 OxjfHFQ6xCjAwajEw9sQfzdQiDWxrLgy9xCjJAeTkihveAFQiC8pP6UyI7E4I76oNCe1+BCj BAezkgivuhVQjjclsbIqtSgfJiXNwaIkzvv06dlAIYH0xJLU7NTUgtQimKwMB4eSBO+OIqBG waLU9NSKtMycEoQ0EwcnyHAeoOH7QGp4iwsSc4sz0yHypxh1OXac2fKeUYglLz8vVUqcdzJI kQBIUUZpHtwcWKp5xSgO9JYw7zmQKh5gmoKb9ApoCRPQkj0pd0CWlCQipKQaGOuv3lI/9a2h XKRzStE57QM/T11scei6/kj3+Upf1iuvamVVXmtuTWR4+8V2+dsz3ku2qB8L7y/lT0i5W/O6 36KgrHBVobxILf+stYXNFUI6XJk7yhrfPH0fxMfPEnljRbz1vWsWWaq7JjwXuXn4bXesQt1/ P/HpKpdN0g6vVOhUXD1nWm9vtRJLcUaioRZzUXEiANJz9ZMQAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 14:51:51 -0000 On Wed, 10 Jul 2013, Warren Block wrote: > Author: wblock > Date: Wed Jul 10 11:35:47 2013 > New Revision: 42235 > URL: http://svnweb.freebsd.org/changeset/doc/42235 > > Log: > Add a section showing use of tags, both with and without > "nolink". Move the sample inside the , the > comment that noted procedures could not be inside examples is no > longer correct. > > Modified: > head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > > Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 10:38:06 2013 (r42234) > +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 11:35:47 2013 (r42235) > @@ -1572,6 +1570,49 @@ This is the file called 'foo2' > > > > + > + Email Addresses > + > + Email addresses are marked up with > + email tags. In the HTML > + output format, the wrapped text becomes a hyperlink to the > + email address. Other output formats that support hyperlinks > + may also make the email address into a link. > + > + > + <sgmltag>email</sgmltag> with a Hyperlink > + > + Usage: > + > + paraQuestions about &os; may be sent to > + emailquestions@&os;.orgemail.para Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred spelling. > + Appearance: > + > + Questions about &os; may be sent to > + questions@&os;.org. > + > + A &os;-specific extension allows setting the > + role attribute to nolink > + to prevent the creation of the hyperlink to the email > + address. > + > + > + <sgmltag>email</sgmltag> Without a Hyperlink > + > + Usage: > + > + paraQuestions about &os; may be sent to > + email role="nolink"questions@&os;.orgemail.para > + > + Appearance: > + > + Questions about &os; may be sent to > + questions@&os;.org. > + > + (all four places, of course) -Ben > > Describing <filename>Makefile</filename>s > > _______________________________________________ > svn-doc-all@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/svn-doc-all > To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org" > From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 15:03:50 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 4D899750; Wed, 10 Jul 2013 15:03:50 +0000 (UTC) (envelope-from joel@vnode.se) Received: from mail.vnode.se (mail.vnode.se [212.247.52.13]) by mx1.freebsd.org (Postfix) with ESMTP id 094AC13C5; Wed, 10 Jul 2013 15:03:49 +0000 (UTC) Received: from mail.vnode.se (localhost [127.0.0.1]) by mail.vnode.se (Postfix) with ESMTP id D874BE3F07A; Wed, 10 Jul 2013 17:03:41 +0200 (CEST) X-Virus-Scanned: amavisd-new at vnode.se Received: from mail.vnode.se ([127.0.0.1]) by mail.vnode.se (mail.vnode.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 1k6vZKYVyfP2; Wed, 10 Jul 2013 17:03:39 +0200 (CEST) Received: from [10.101.105.140] (edsfw.benders.se [212.247.52.27]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by mail.vnode.se (Postfix) with ESMTPSA id 7589CE3F079; Wed, 10 Jul 2013 17:03:39 +0200 (CEST) Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 6.5 $1508$) Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup From: Joel Dahl In-Reply-To: Date: Wed, 10 Jul 2013 17:03:41 +0200 Content-Transfer-Encoding: quoted-printable Message-Id: <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se> References: <201307101135.r6ABZl5q011350@svn.freebsd.org> To: Benjamin Kaduk X-Mailer: Apple Mail (2.1508) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 15:03:50 -0000 10 jul 2013 kl. 16:46 skrev Benjamin Kaduk : > On Wed, 10 Jul 2013, Warren Block wrote: >=20 >> Author: wblock >> Date: Wed Jul 10 11:35:47 2013 >> New Revision: 42235 >> URL: http://svnweb.freebsd.org/changeset/doc/42235 >>=20 >> Log: >> Add a section showing use of tags, both with and without >> "nolink". Move the sample inside the , the >> comment that noted procedures could not be inside examples is no >> longer correct. >>=20 >> Modified: >> head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml >>=20 >> Modified: = head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml >> = =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D >> --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml = Wed Jul 10 10:38:06 2013 (r42234) >> +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml = Wed Jul 10 11:35:47 2013 (r42235) >> @@ -1572,6 +1570,49 @@ This is the file called 'foo2' >> >> >>=20 >> + >> + Email Addresses >> + >> + Email addresses are marked up with >> + email tags. In the HTML >> + output format, the wrapped text becomes a hyperlink to the >> + email address. Other output formats that support hyperlinks >> + may also make the email address into a link. >> + >> + >> + <sgmltag>email</sgmltag> with a Hyperlink >> + >> + Usage: >> + >> + paraQuestions about &os; may be sent to >> + emailquestions@&os;.orgemail.para >=20 > Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred = spelling. It definitely is. -- Joel= From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 15:56:34 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 07CAA242; Wed, 10 Jul 2013 15:56:34 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id ACB191A21; Wed, 10 Jul 2013 15:56:33 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r6AFuWfd057046; Wed, 10 Jul 2013 09:56:32 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6AFuWs8057043; Wed, 10 Jul 2013 09:56:32 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Wed, 10 Jul 2013 09:56:32 -0600 (MDT) From: Warren Block To: Joel Dahl Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se> Message-ID: References: <201307101135.r6ABZl5q011350@svn.freebsd.org> <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Wed, 10 Jul 2013 09:56:32 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 15:56:34 -0000 On Wed, 10 Jul 2013, Joel Dahl wrote: > 10 jul 2013 kl. 16:46 skrev Benjamin Kaduk : >> On Wed, 10 Jul 2013, Warren Block wrote: >>> + >>> + paraQuestions about &os; may be sent to >>> + emailquestions@&os;.orgemail.para >> >> Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred spelling. > > It definitely is. Well, yes, but there's an alias. Looking at now, I think it's preferable to use an example.com address to avoid the &os; complication. Does a standard fake example email address exist, like notreal@example.com? From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 21:37:57 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id BB0C0C49; Wed, 10 Jul 2013 21:37:57 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id AD5101D12; Wed, 10 Jul 2013 21:37:57 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ALbvTv094314; Wed, 10 Jul 2013 21:37:57 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ALbvZW094313; Wed, 10 Jul 2013 21:37:57 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307102137.r6ALbvZW094313@svn.freebsd.org> From: Gabor Pali Date: Wed, 10 Jul 2013 21:37:57 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42238 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 21:37:57 -0000 Author: pgj Date: Wed Jul 10 21:37:57 2013 New Revision: 42238 URL: http://svnweb.freebsd.org/changeset/doc/42238 Log: - Elaborate benefits of PVHM and PVH in the Xen entry Submitted by: theraven Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 11:57:13 2013 (r42237) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 21:37:57 2013 (r42238) @@ -1512,6 +1512,22 @@ functionality through `pkg(8)`. +
PVHVM allows a virtual machine that boots as a native guest to + be able to take full advantage of paravirtualized drivers, + giving a performance improvement in most I/O related tasks. PVH + allows a guest to take advantage of hardware assistance for + memory management, but uses fully paravirtualized events and + boot procedure, which brings two significant advantages beyond + performance. The first is that domain 0 does not have to run a + QEMU instance for emulated boot for PVH guests, which is a + common reason for hosting providers to charge more for Windows + and other HVM guests. The second is that PVH domains can be + used as domain 0, without requiring different pmap (memory + management) code from the conventional kernel. This will allow + us to ship a single kernel binary supporting bare metal + hardware, running as a Xen unprivileged guest, and eventually as + Xen domain 0.
+
Further improvements on blkfront and netfront have also been commited:
From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 21:40:23 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id E12D8D71; Wed, 10 Jul 2013 21:40:23 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id D2FAE1D33; Wed, 10 Jul 2013 21:40:23 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ALeNPK096268; Wed, 10 Jul 2013 21:40:23 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ALeN78096266; Wed, 10 Jul 2013 21:40:23 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307102140.r6ALeN78096266@svn.freebsd.org> From: Gabor Pali Date: Wed, 10 Jul 2013 21:40:23 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42239 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 21:40:24 -0000 Author: pgj Date: Wed Jul 10 21:40:23 2013 New Revision: 42239 URL: http://svnweb.freebsd.org/changeset/doc/42239 Log: - Prepend an introductory sentence for the SDIO driver entry Submitted by: theraven Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 21:37:57 2013 (r42238) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 21:40:23 2013 (r42239) @@ -1878,11 +1878,15 @@ functionality through `pkg(8)`. -
The driver is implemented as an extension to the existing MMC - bus, adding a lot of new SDIO-specific bus methods. Getting - information about the card works, including querying all the - supported I/O functions. Simple byte transfers and multi-byte - reads work.
+
SDIO is an interface designed as an extension for the existing + SD card standard, to allow connecting different peripherals to the + host with the standard SD controller. Peripherals currently + sold at the general market include WLAN/BT modules, cameras, + fingerprint readers, barcode scanners. The driver is + implemented as an extension to the existing MMC bus, adding a + lot of new SDIO-specific bus methods. Getting information about + the card works, including querying all the supported I/O + functions. Simple byte transfers and multi-byte reads work.

A prototype of the driver for Marvell SDIO WLAN/BT module is also being developed, using the existing Linux driver as a From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 21:40:31 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 83CA7DAF; Wed, 10 Jul 2013 21:40:31 +0000 (UTC) (envelope-from marino@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 66BC61D34; Wed, 10 Jul 2013 21:40:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ALeVvY096327; Wed, 10 Jul 2013 21:40:31 GMT (envelope-from marino@svn.freebsd.org) Received: (from marino@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ALeU90096318; Wed, 10 Jul 2013 21:40:30 GMT (envelope-from marino@svn.freebsd.org) Message-Id: <201307102140.r6ALeU90096318@svn.freebsd.org> From: John Marino Date: Wed, 10 Jul 2013 21:40:30 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42240 - in head: en_US.ISO8859-1/articles/contributors share/pgpkeys share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 21:40:31 -0000 Author: marino (ports committer) Date: Wed Jul 10 21:40:29 2013 New Revision: 42240 URL: http://svnweb.freebsd.org/changeset/doc/42240 Log: Add John Marino to developers list Approved by: bapt (mentor) Added: head/share/pgpkeys/marino.key (contents, props changed) Modified: head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml head/share/pgpkeys/pgpkeys-developers.xml head/share/pgpkeys/pgpkeys.ent head/share/xml/authors.ent head/share/xml/news.xml Modified: head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml ============================================================================== --- head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Wed Jul 10 21:40:23 2013 (r42239) +++ head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Wed Jul 10 21:40:29 2013 (r42240) @@ -4913,11 +4913,6 @@ - John Marino - draco@marino.st - - - John McAree john@mcaree.org Modified: head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml ============================================================================== --- head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Wed Jul 10 21:40:23 2013 (r42239) +++ head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Wed Jul 10 21:40:29 2013 (r42240) @@ -932,6 +932,10 @@ + &a.marino.email; + + + &a.dmarion.email; Added: head/share/pgpkeys/marino.key ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/share/pgpkeys/marino.key Wed Jul 10 21:40:29 2013 (r42240) @@ -0,0 +1,76 @@ + + + +uid John R. Marino +uid John Marino (NetBSD) +sub 2048R/71D9FB68 2011-07-19 +]]> + Modified: head/share/pgpkeys/pgpkeys-developers.xml ============================================================================== --- head/share/pgpkeys/pgpkeys-developers.xml Wed Jul 10 21:40:23 2013 (r42239) +++ head/share/pgpkeys/pgpkeys-developers.xml Wed Jul 10 21:40:29 2013 (r42240) @@ -1151,6 +1151,11 @@ &pgpkey.amdmi3; + + &a.marino.email; + &pgpkey.marino; + + &a.kwm.email; &pgpkey.kwm; Modified: head/share/pgpkeys/pgpkeys.ent ============================================================================== --- head/share/pgpkeys/pgpkeys.ent Wed Jul 10 21:40:23 2013 (r42239) +++ head/share/pgpkeys/pgpkeys.ent Wed Jul 10 21:40:29 2013 (r42240) @@ -241,6 +241,7 @@ + Modified: head/share/xml/authors.ent ============================================================================== --- head/share/xml/authors.ent Wed Jul 10 21:40:23 2013 (r42239) +++ head/share/xml/authors.ent Wed Jul 10 21:40:29 2013 (r42240) @@ -1254,6 +1254,9 @@ maho@FreeBSD.org"> + +marino@FreeBSD.org"> + markj@FreeBSD.org"> Modified: head/share/xml/news.xml ============================================================================== --- head/share/xml/news.xml Wed Jul 10 21:40:23 2013 (r42239) +++ head/share/xml/news.xml Wed Jul 10 21:40:29 2013 (r42240) @@ -34,6 +34,13 @@ 7 + 4 + +
New committer: + John Marino (ports)
+ + + 3 From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 22:12:18 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D61926E7; Wed, 10 Jul 2013 22:12:18 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (dmz-mailsec-scanner-4.mit.edu [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 401A31E82; Wed, 10 Jul 2013 22:12:17 +0000 (UTC) X-AuditID: 1209190f-b7fa58e000000953-7a-51dddc3bb85f Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 46.BD.02387.B3CDDD15; Wed, 10 Jul 2013 18:12:11 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r6AMCAlV021123; Wed, 10 Jul 2013 18:12:10 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r6AMC7Hx008179 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 10 Jul 2013 18:12:09 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r6AMC6CH013594; Wed, 10 Jul 2013 18:12:06 -0400 (EDT) Date: Wed, 10 Jul 2013 18:12:06 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: Message-ID: References: <201307101135.r6ABZl5q011350@svn.freebsd.org> <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpnleLIzCtJLcpLzFFi42IRYrdT0bW+czfQYNk3NYsfHw8xWUzoOsRm cWPRfiaL3f29zBaX309ksfh1ysOBzWPGp/ksHv++T2HzONLxiDGAOYrLJiU1J7MstUjfLoEr Y/7XzewFX9grfs3ZzdzAuI+ti5GTQ0LARKL9+EZ2CFtM4sK99UBxLg4hgX2MEp3HNjBBOBsZ JZr3/GOFcA4xSXy4eQDKaWCU+H5gJTNIP4uAtsSM760sIDabgIrEzDcbgWZxcIgIqErsPWMN Us8ssJBR4vnHpWD7hAUiJO5NmcgEYnMK2Elc3b4EbA6vgKNE08w/jBALLjJKbFtxAywhKqAj sXr/FBaIIkGJkzOfgNnMApYS5/5cZ5vAKDgLSWoWktQCRqZVjLIpuVW6uYmZOcWpybrFyYl5 ealFuiZ6uZkleqkppZsYQeHNKcm/g/HbQaVDjAIcjEo8vA3xdwOFWBPLiitzDzFKcjApifJy XAcK8SXlp1RmJBZnxBeV5qQWH2KU4GBWEuE9OQUox5uSWFmVWpQPk5LmYFES53329GygkEB6 YklqdmpqQWoRTFaGg0NJgvfiLaBGwaLU9NSKtMycEoQ0EwcnyHAeoOFnQWp4iwsSc4sz0yHy pxgVpcR5j4MkBEASGaV5cL2w9POKURzoFWHexSBVPMDUBdf9CmgwE9DgPSl3QAaXJCKkpBoY s98dOi66XSa5YIu46IWFVU/3LMqczWb5XPPqLnftgjyrveEBP39ezp6l+un01ISa5OfBV5Ys N9yw/5AMV6fAhK8HPU+ts35jeLFMvf3gwq96yS4MU2W/xD3psmjYoyAY3f5zx6fWNfw7pjH0 bFq6SMe3nu/Cnd45hTv1A86p/UmSW3ZaWTFcRImlOCPRUIu5qDgRAKSWN+EaAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block , Joel Dahl X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 22:12:18 -0000 On Wed, 10 Jul 2013, Warren Block wrote: > On Wed, 10 Jul 2013, Joel Dahl wrote: > >> 10 jul 2013 kl. 16:46 skrev Benjamin Kaduk : >>> On Wed, 10 Jul 2013, Warren Block wrote: >>>> + >>>> + paraQuestions >>>> about &os; may be sent to >>>> + >>> class="starttag">emailquestions@&os;.org>>> class="endtag">email.>>> class="endtag">para >>> >>> Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred >>> spelling. >> >> It definitely is. > > Well, yes, but there's an alias. Looking at now, I think it's preferable to > use an example.com address to avoid the &os; complication. > > Does a standard fake example email address exist, like notreal@example.com? I don't know of one. Using @example.com would also render the "questions about FreeBSD" part unusable, and I would kind of like to keep that. -Ben From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 23:01:13 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 7F6775D0; Wed, 10 Jul 2013 23:01:13 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 375821058; Wed, 10 Jul 2013 23:01:13 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r6AN1BuX082595; Wed, 10 Jul 2013 17:01:11 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6AN1AiP082592; Wed, 10 Jul 2013 17:01:11 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Wed, 10 Jul 2013 17:01:10 -0600 (MDT) From: Warren Block To: Benjamin Kaduk Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: Message-ID: References: <201307101135.r6ABZl5q011350@svn.freebsd.org> <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Wed, 10 Jul 2013 17:01:11 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block , Joel Dahl X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 23:01:13 -0000 On Wed, 10 Jul 2013, Benjamin Kaduk wrote: > On Wed, 10 Jul 2013, Warren Block wrote: > >> On Wed, 10 Jul 2013, Joel Dahl wrote: >> >>> 10 jul 2013 kl. 16:46 skrev Benjamin Kaduk : >>>> On Wed, 10 Jul 2013, Warren Block wrote: >>>>> + >>>>> + paraQuestions >>>>> about &os; may be sent to >>>>> + >>>> class="starttag">emailquestions@&os;.org>>>> class="endtag">email.>>>> class="endtag">para >>>> >>>> Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred >>>> spelling. >>> >>> It definitely is. >> >> Well, yes, but there's an alias. Looking at now, I think it's preferable >> to use an example.com address to avoid the &os; complication. >> >> Does a standard fake example email address exist, like notreal@example.com? > > I don't know of one. Using @example.com would also render the "questions > about FreeBSD" part unusable, and I would kind of like to keep that. questions@ was just my idea of the least-damaging FreeBSD.org email address. I'll add another example to show an email address without entities in the both the username and domain. Of course this also points out that the Primer does not have a table of &os;-specific entities... From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 23:30:09 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 80384A12; Wed, 10 Jul 2013 23:30:09 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 191C2114E; Wed, 10 Jul 2013 23:30:08 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r6ANU83Z082773; Wed, 10 Jul 2013 17:30:08 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6ANU7K8082770; Wed, 10 Jul 2013 17:30:08 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Wed, 10 Jul 2013 17:30:07 -0600 (MDT) From: Warren Block To: Benjamin Kaduk Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: Message-ID: References: <201307101135.r6ABZl5q011350@svn.freebsd.org> <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Wed, 10 Jul 2013 17:30:08 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block , Joel Dahl X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 23:30:09 -0000 On Wed, 10 Jul 2013, Warren Block wrote: > On Wed, 10 Jul 2013, Benjamin Kaduk wrote: > >> On Wed, 10 Jul 2013, Warren Block wrote: >> >>> On Wed, 10 Jul 2013, Joel Dahl wrote: >>> >>>> 10 jul 2013 kl. 16:46 skrev Benjamin Kaduk : >>>>> On Wed, 10 Jul 2013, Warren Block wrote: >>>>>> + >>>>>> + paraQuestions >>>>>> about &os; may be sent to >>>>>> + >>>>> class="starttag">emailquestions@&os;.org>>>>> class="endtag">email.>>>>> class="endtag">para >>>>> >>>>> Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred >>>>> spelling. >>>> >>>> It definitely is. >>> >>> Well, yes, but there's an alias. Looking at now, I think it's preferable >>> to use an example.com address to avoid the &os; complication. >>> >>> Does a standard fake example email address exist, like >>> notreal@example.com? >> >> I don't know of one. Using @example.com would also render the "questions >> about FreeBSD" part unusable, and I would kind of like to keep that. > > questions@ was just my idea of the least-damaging FreeBSD.org email address. > I'll add another example to show an email address without entities in the > both the username and domain. > > Of course this also points out that the Primer does not have a table of > &os;-specific entities... And at least two more issues: There is an entity for questions@, &a.questions;. But creating that address without using the entity is wrong, and gives a bad example. Also, that entity shows the email address as questions@FreeBSD.org, not freebsd-questions@FreeBSD.org. Check out the bottom of each HTML Handbook page. Given all that, I'm going to remove the questions@ address and use notreal@example.com, unless someone can suggest something better. From owner-svn-doc-all@FreeBSD.ORG Wed Jul 10 23:39:24 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 918C4BDE; Wed, 10 Jul 2013 23:39:24 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 6982A118B; Wed, 10 Jul 2013 23:39:24 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ANdOsa029669; Wed, 10 Jul 2013 23:39:24 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ANdOtI029668; Wed, 10 Jul 2013 23:39:24 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307102339.r6ANdOtI029668@svn.freebsd.org> From: Gabor Pali Date: Wed, 10 Jul 2013 23:39:24 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42241 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jul 2013 23:39:24 -0000 Author: pgj Date: Wed Jul 10 23:39:23 2013 New Revision: 42241 URL: http://svnweb.freebsd.org/changeset/doc/42241 Log: - Add introduction for the Q2 report Submitted by: theraven Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 21:40:29 2013 (r42240) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Wed Jul 10 23:39:23 2013 (r42241) @@ -14,9 +14,27 @@
This report covers &os;-related projects between April and June 2013. This is the second of four reports planned for 2013.
- +
The last three months have been very active for the &os; + developer community, including events such as BSDCan and the &os; + Developer Summit collocated with it (covered in a separate report, + see the BSDCan Developer Summit Special) + and BSD-Day 2013. It has also seen improvements from the top to + the bottom of the &os; system. Desktop users will be pleased to + note work on improving the state of AMD GPUs and making the + console interaction with kernel mode setting — required for + recent `xorg` drivers — cleaner and from continued + work to make binary packages easier to use. Developers will note + continued improvements to our toolchain, with a new debugger being + prepared for integration. Server users will benefit from various + improvements to virtualization support and scalability in the + kernel. Of course, the &os; system is nothing without + applications to run atop it, and this quarter has seen some + tireless work by members of the ports team to ensure that users + have a wide choice of desktop and development environments, with + highlights from the GNOME, KDE, Xfce, and Haskell teams in this + report.
-
Thanks to all the reporters for the excellent work! This report contains 33 entries and we hope you enjoy reading it.
From owner-svn-doc-all@FreeBSD.ORG Thu Jul 11 02:16:23 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 1FFD6970; Thu, 11 Jul 2013 02:16:23 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 122CA1A2A; Thu, 11 Jul 2013 02:16:23 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6B2GMI8076540; Thu, 11 Jul 2013 02:16:22 GMT (envelope-from rmacklem@svn.freebsd.org) Received: (from rmacklem@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6B2GMni076539; Thu, 11 Jul 2013 02:16:22 GMT (envelope-from rmacklem@svn.freebsd.org) Message-Id: <201307110216.r6B2GMni076539@svn.freebsd.org> From: Rick Macklem Date: Thu, 11 Jul 2013 02:16:22 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42242 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Jul 2013 02:16:23 -0000 Author: rmacklem (src committer) Date: Thu Jul 11 02:16:22 2013 New Revision: 42242 URL: http://svnweb.freebsd.org/changeset/doc/42242 Log: Fix a line that wasn't spotted by the old version of igor I used. Requested by: Warren Block 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 Wed Jul 10 23:39:23 2013 (r42241) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Thu Jul 11 02:16:22 2013 (r42242) @@ -16094,7 +16094,8 @@ Reference: <http://www.freebsd.org/po 1000036 July 9, 2013 10-CURRENT after the addition of a new function - to the kernel GSSAPI module's function call interface (rev + to the kernel GSSAPI module's + function call interface (rev 253049). From owner-svn-doc-all@FreeBSD.ORG Thu Jul 11 08:34:25 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id AF39844F; Thu, 11 Jul 2013 08:34:25 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A08271AC2; Thu, 11 Jul 2013 08:34:25 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6B8YPvx093336; Thu, 11 Jul 2013 08:34:25 GMT (envelope-from ryusuke@svn.freebsd.org) Received: (from ryusuke@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6B8YPwR093335; Thu, 11 Jul 2013 08:34:25 GMT (envelope-from ryusuke@svn.freebsd.org) Message-Id: <201307110834.r6B8YPwR093335@svn.freebsd.org> From: Ryusuke SUZUKI Date: Thu, 11 Jul 2013 08:34:25 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42246 - head/ja_JP.eucJP/share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Jul 2013 08:34:25 -0000 Author: ryusuke Date: Thu Jul 11 08:34:25 2013 New Revision: 42246 URL: http://svnweb.freebsd.org/changeset/doc/42246 Log: - Merge the following from the English version: r42144 -> r42240 head/ja_JP.eucJP/share/xml/news.xml Modified: head/ja_JP.eucJP/share/xml/news.xml Modified: head/ja_JP.eucJP/share/xml/news.xml ============================================================================== --- head/ja_JP.eucJP/share/xml/news.xml Thu Jul 11 03:07:22 2013 (r42245) +++ head/ja_JP.eucJP/share/xml/news.xml Thu Jul 11 08:34:25 2013 (r42246) @@ -20,7 +20,7 @@ the contents of will be preferred over <p>. $FreeBSD$ - Original revision: r42144 + Original revision: r42240 --> <news> <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS"> @@ -34,6 +34,13 @@ <name>7</name> <day> + <name>4</name> + <event> + <p>��ߥå��Ǥ: + <a href="mailto:marino@FreeBSD.org">John Marino</a> (ports)</p> + </event> + </day> + <day> <name>3</name> <event> From owner-svn-doc-all@FreeBSD.ORG Thu Jul 11 17:11:30 2013 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 82DDEE52; Thu, 11 Jul 2013 17:11:30 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 71DCB1AC3; Thu, 11 Jul 2013 17:11:30 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6BHBUKo052045; Thu, 11 Jul 2013 17:11:30 GMT (envelope-from gabor@svn.freebsd.org) Received: (from gabor@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6BHBM5x051988; Thu, 11 Jul 2013 17:11:22 GMT (envelope-from gabor@svn.freebsd.org) Message-Id: <201307111711.r6BHBM5x051988@svn.freebsd.org> From: Gabor Kovesdan <gabor@FreeBSD.org> Date: Thu, 11 Jul 2013 17:11:22 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42248 - in head: de_DE.ISO8859-1/books/handbook/cutting-edge de_DE.ISO8859-1/books/handbook/install de_DE.ISO8859-1/books/handbook/mail el_GR.ISO8859-7/books/handbook/cutting-edge el_G... X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Thu, 11 Jul 2013 17:11:30 -0000 Author: gabor Date: Thu Jul 11 17:11:21 2013 New Revision: 42248 URL: http://svnweb.freebsd.org/changeset/doc/42248 Log: - Whitespace adjustments after last commit Modified: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml head/de_DE.ISO8859-1/books/handbook/install/chapter.xml head/de_DE.ISO8859-1/books/handbook/mail/chapter.xml head/el_GR.ISO8859-7/books/handbook/cutting-edge/chapter.xml head/el_GR.ISO8859-7/books/handbook/install/chapter.xml head/el_GR.ISO8859-7/books/handbook/mail/chapter.xml head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml head/en_US.ISO8859-1/books/handbook/install/chapter.xml head/en_US.ISO8859-1/books/handbook/mail/chapter.xml head/es_ES.ISO8859-1/books/handbook/mail/chapter.xml head/fr_FR.ISO8859-1/books/handbook/cutting-edge/chapter.xml head/fr_FR.ISO8859-1/books/handbook/install/chapter.xml head/fr_FR.ISO8859-1/books/handbook/mail/chapter.xml head/hu_HU.ISO8859-2/books/handbook/cutting-edge/chapter.xml head/hu_HU.ISO8859-2/books/handbook/install/chapter.xml head/hu_HU.ISO8859-2/books/handbook/mail/chapter.xml head/it_IT.ISO8859-15/books/handbook/install/chapter.xml head/it_IT.ISO8859-15/books/handbook/mail/chapter.xml head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml head/ja_JP.eucJP/books/handbook/install/chapter.xml head/ja_JP.eucJP/books/handbook/mail/chapter.xml head/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.xml head/mn_MN.UTF-8/books/handbook/install/chapter.xml head/mn_MN.UTF-8/books/handbook/mail/chapter.xml head/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.xml head/nl_NL.ISO8859-1/books/handbook/install/chapter.xml head/nl_NL.ISO8859-1/books/handbook/mail/chapter.xml head/pl_PL.ISO8859-2/books/handbook/cutting-edge/chapter.xml head/pl_PL.ISO8859-2/books/handbook/install/chapter.xml head/pl_PL.ISO8859-2/books/handbook/mail/chapter.xml head/ru_RU.KOI8-R/books/handbook/cutting-edge/chapter.xml head/ru_RU.KOI8-R/books/handbook/install/chapter.xml head/ru_RU.KOI8-R/books/handbook/mail/chapter.xml head/zh_CN.GB2312/books/handbook/cutting-edge/chapter.xml head/zh_CN.GB2312/books/handbook/install/chapter.xml head/zh_CN.GB2312/books/handbook/mail/chapter.xml head/zh_TW.Big5/books/handbook/cutting-edge/chapter.xml head/zh_TW.Big5/books/handbook/mail/chapter.xml Modified: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -3012,7 +3012,8 @@ Script done, …</screen> <qandaentry> <question> <para>Der Bau bricht mit vielen - <errorname>Signal 11</errorname>-Fehlern<indexterm><primary>Signal 11</primary></indexterm> (oder anderen + <errorname>Signal 11</errorname>-Fehlern<indexterm> + <primary>Signal 11</primary></indexterm> (oder anderen Signalnummern) ab. Was ist da passiert?</para> </question> Modified: head/de_DE.ISO8859-1/books/handbook/install/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/de_DE.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4701,8 +4701,9 @@ Please press any key to reboot.</screen> <para>Wenn ich <application>sysinstall</application> aus einen X-Terminal starte, ist die gelbe Schritt auf dem grauen Hintergrund nur schwer zu erkennen. Gibt es - eine M�glichkeit, den Kontrast<indexterm><primary>Farben</primary><secondary>Kontrast</secondary></indexterm> f�r dieses - Programm zu erh�hen?</para> + eine M�glichkeit, den Kontrast<indexterm> + <primary>Farben</primary><secondary>Kontrast</secondary> + </indexterm> f�r dieses Programm zu erh�hen?</para> </question> <answer> Modified: head/de_DE.ISO8859-1/books/handbook/mail/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/de_DE.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -999,7 +999,8 @@ purgestat /usr/local/supermailer/bin/pur Wie kann ich dieses Problem l�sen? - Sie haben durch die Benutzung eines MX-Eintrags<indexterm><primary>MX-Eintrag</primary></indexterm> eingestellt, dass + Sie haben durch die Benutzung eines MX-Eintrags<indexterm> + <primary>MX-Eintrag</primary></indexterm> eingestellt, dass Mail f�r die Dom�ne (z.B. domain.net) an einen speziellen Host (in diesem Fall relay.domain.net) weitergeleitet wird, aber der Relay-Host erkennt sich selbst nicht als @@ -1027,7 +1028,8 @@ purgestat /usr/local/supermailer/bin/pur <qandaentry> <question> <para>Wie kann ich einen E-Mail-Server auf einem - Anwahl-PPP<indexterm><primary>PPP</primary></indexterm> Rechner betreiben?</para> + Anwahl-PPP<indexterm> + <primary>PPP</primary></indexterm> Rechner betreiben?</para> </question> <answer> @@ -1040,7 +1042,8 @@ purgestat /usr/local/supermailer/bin/pur UUCP zu verwenden.</para> <para>Ein anderer Weg ist, von einem immer mit dem Internet - verbundenen Server einen sekund�ren MX-Dienst<indexterm><primary>MX-Eintrag</primary></indexterm> f�r Ihre + verbundenen Server einen sekund�ren MX-Dienst<indexterm> + <primary>MX-Eintrag</primary></indexterm> f�r Ihre Dom�ne zur Verf�gung gestellt zu bekommen. Wenn die Dom�ne Ihrer Firma <hostid role="domainname">example.com</hostid> ist, und Ihr Modified: head/el_GR.ISO8859-7/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/el_GR.ISO8859-7/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/el_GR.ISO8859-7/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -3043,7 +3043,8 @@ Script done, …</screen> <qandaentry> <question> - <para>� �� signal 11<indexterm><primary>signal 11</primary></indexterm> + <para>� �� + signal 11<indexterm><primary>signal 11</primary></indexterm> (� �� ). �� ;</para> </question> Modified: head/el_GR.ISO8859-7/books/handbook/install/chapter.xml ============================================================================== --- head/el_GR.ISO8859-7/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/el_GR.ISO8859-7/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4455,8 +4455,9 @@ Please press any key to reboot.</screen> <para>�� <application>sysinstall</application> �� X11, � �� - ��. �� <indexterm><primary>color</primary><secondary>contrast</secondary></indexterm> �� - �� ;</para> + ��. �� + <indexterm><primary>color</primary><secondary>contrast</secondary> + </indexterm> �� ;</para> </question> <answer> Modified: head/el_GR.ISO8859-7/books/handbook/mail/chapter.xml ============================================================================== --- head/el_GR.ISO8859-7/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/el_GR.ISO8859-7/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -928,7 +928,8 @@ purgestat /usr/local/supermailer/bin/pur role="fqdn">mumble.bar.edu</hostid>, �� <hostid>mumble</hostid>.</para> - <para>��, �� DNS resolvers �� BIND<indexterm><primary>BIND</primary></indexterm>. + <para>��, �� DNS resolvers �� + BIND<indexterm><primary>BIND</primary></indexterm>. ��, � �� <application>BIND</application> �� &os;, �� -�� , �� . @@ -976,7 +977,8 @@ purgestat /usr/local/supermailer/bin/pur �� mail �� (�.�. �� domain.net) �� (�� -�� relay.domain.net) �� MX<indexterm><primary>MX record</primary></indexterm>, �� +�� relay.domain.net) �� +MX<indexterm><primary>MX record</primary></indexterm>, �� (relay) �� domain.net. �� domain.net �� /etc/mail/local-host-names [�� /etc/sendmail.cw �� 8.10] @@ -994,7 +996,8 @@ domain.net. �� domain.net �� <qandaentry> <question> <para>�� mail �� - �� PPP<indexterm><primary>PPP</primary></indexterm>;</para> + �� + PPP<indexterm><primary>PPP</primary></indexterm>;</para> </question> <answer> @@ -1003,7 +1006,8 @@ domain.net. �� domain.net �� LAN. � �� PPP �� .</para> <para>�� . � �� - �� UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> + �� UUCP<indexterm><primary>UUCP</primary> + </indexterm>.</para> <para>�� Internet � �� , �� @@ -1011,7 +1015,8 @@ domain.net. �� domain.net �� <hostid role="domainname">example.com</hostid> �� Internet �� <hostid role="domainname">example.net</hostid> �� - �� MX<indexterm><primary>MX record</primary></indexterm> �� :</para> + �� MX<indexterm><primary>MX record</primary> + </indexterm> �� :</para> <programlisting>example.com. MX 10 example.com. MX 20 example.net.</programlisting> Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2817,8 +2817,9 @@ Script done, …</screen> <qandaentry> <question> - <para>My compile failed with lots of signal 11<indexterm><primary>signal 11</primary></indexterm> (or other - signal number) errors. What happened?</para> + <para>My compile failed with lots of + signal 11<indexterm><primary>signal 11</primary></indexterm> + (or other signal number) errors. What happened?</para> </question> <answer> Modified: head/en_US.ISO8859-1/books/handbook/install/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/en_US.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4279,7 +4279,9 @@ Please press any key to reboot.</screen> in an <application>&xorg;</application> terminal, the yellow font is difficult to read against the light gray background. Is there a way to - provide higher contrast<indexterm><primary>color</primary><secondary>contrast</secondary></indexterm> for this application?</para> + provide higher contrast<indexterm><primary>color</primary> + <secondary>contrast</secondary></indexterm> for + this application?</para> </question> <answer> <para>If the default Modified: head/en_US.ISO8859-1/books/handbook/mail/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -861,7 +861,8 @@ purgestat /usr/local/supermailer/bin/pur <hostid>mumble</hostid>.</para> <para>This is because the version of - <application>BIND</application><indexterm><primary>BIND</primary></indexterm> which ships with + <application>BIND</application><indexterm> + <primary>BIND</primary></indexterm> which ships with &os; no longer provides default abbreviations for non-FQDNs other than the local domain. An unqualified host such as @@ -933,7 +934,8 @@ to /etc/mail/sendmail.cf.</programlistin connection is non-dedicated.</para> <para>One way to do this is to get a full-time Internet server - to provide secondary <acronym>MX</acronym><indexterm><primary>MX record</primary></indexterm> services for the + to provide secondary <acronym>MX</acronym><indexterm> + <primary>MX record</primary></indexterm> services for the domain. In this example, the domain is <hostid role="domainname">example.com</hostid> and the ISP has configured <hostid Modified: head/es_ES.ISO8859-1/books/handbook/mail/chapter.xml ============================================================================== --- head/es_ES.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/es_ES.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -971,7 +971,8 @@ purgestat /usr/local/supermailer/bin/pur referirse a ella simplemente como <hostid>mumble</hostid>.</para> <para>Tradicionalmente, la referencia incompleta era posible - utilizando <quote>resolvers</quote> de BSD BIND<indexterm><primary>BIND</primary></indexterm>. + utilizando <quote>resolvers</quote> de BSD BIND<indexterm> + <primary>BIND</primary></indexterm>. No obstante la versi�n de <application>BIND</application> que en la actualidad se ofrece con FreeBSD ya no permite por defecto el uso de dichas abreviaturas salvo para aquellas m�quinas @@ -1026,7 +1027,8 @@ purgestat /usr/local/supermailer/bin/pur Usted ha especificado que el correo para el dominio (por ejemplo, para el dominio dominio.net) sea reenviado a una m�quina determinada (en este caso relay.dominio.net), para lo que se utiliza un registro -de DNS de tipo MX<indexterm><primary>MX record</primary></indexterm>, pero la m�quina que act�a de relay no se +de DNS de tipo MX<indexterm><primary>MX record</primary></indexterm>, +pero la m�quina que act�a de relay no se reconoce a s� misma como perteneciente al dominio dominio.net. Se debe a�adir dominio.net al fichero /etc/mail/local-host-names, que recibe el nombre de /etc/sendmail.cw en versiones de sendmail previas @@ -1055,11 +1057,13 @@ al fichero <filename>/etc/mail/sendmail. <answer> <para>Se quiere conectar una m�quina FreeBSD dentro de una LAN a Internet. La m�quina FreeBSD ser� una pasarela de - correo para dicha LAN. La conexi�n mediante PPP<indexterm><primary>PPP</primary></indexterm> no es + correo para dicha LAN. La conexi�n mediante PPP<indexterm> + <primary>PPP</primary></indexterm> no es dedicada.</para> <para>Existen al menos dos formas distintas de hacerlo. Una de ellas - consiste en utilizar UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> + consiste en utilizar UUCP<indexterm><primary>UUCP</primary> + </indexterm>.</para> <para>Otra forma consiste en hacerse con un servidor de internet a tiempo completo para proporcionar servicios de agente de transporte @@ -1090,7 +1094,8 @@ al fichero <filename>/etc/mail/sendmail. La aplicaci�n <application>sendmail</application> autom�ticamente entregar� el correo al servidor especificado como agente de transporte de correo secundario - (segundo registro MX)<indexterm><primary>MX record</primary></indexterm>, es decir, entregar� el correo a + (segundo registro MX)<indexterm><primary>MX record</primary> + </indexterm>, es decir, entregar� el correo a nuestro proveedor de servicios de internet (<hostid role="domainname">ejemplo.net</hostid>). El sitio MX secundario tratar� de conectarse con nuestra m�quina de una forma Modified: head/fr_FR.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/fr_FR.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/fr_FR.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2460,8 +2460,9 @@ Script done, …</screen> <qandaentry> <question> <para>Ma compilation �choue avec de nombreuses erreurs - “signal 11”<indexterm><primary>signal 11</primary></indexterm> (ou tout autre num�ro de - signal). Que s'est-il pass�?</para> + “signal 11”<indexterm> + <primary>signal 11</primary></indexterm> (ou tout + autre num�ro de signal). Que s'est-il pass�?</para> </question> <answer> Modified: head/fr_FR.ISO8859-1/books/handbook/install/chapter.xml ============================================================================== --- head/fr_FR.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/fr_FR.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -5008,8 +5008,9 @@ Please press any key to reboot.</screen> utilis� dans un terminal X11, la police de caract�res jaune sur fond gris-clair peut �tre difficile à lire. Existe-t-il un - moyen d'obtenir un contraste<indexterm><primary>couleur</primary><secondary>contraste</secondary></indexterm> plus �lev� - pour cette application?</para> + moyen d'obtenir un contraste<indexterm> + <primary>couleur</primary><secondary>contraste</secondary> + </indexterm> plus �lev� pour cette application?</para> </question> <answer> Modified: head/fr_FR.ISO8859-1/books/handbook/mail/chapter.xml ============================================================================== --- head/fr_FR.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/fr_FR.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -1020,7 +1020,8 @@ purgestat /usr/local/supermailer/bin/pur juste <hostid>mumble</hostid>.</para> <para>C'�tait traditionnellement autoris� par les - r�solveurs <application>BIND</application><indexterm><primary>BIND</primary></indexterm> BSD. + r�solveurs <application>BIND</application><indexterm> + <primary>BIND</primary></indexterm> BSD. N�anmoins, la version de <application>BIND</application> qui est maintenant livr�e avec FreeBSD ne sait pas compl�ter les noms de machines abr�g�s autrement @@ -1071,7 +1072,8 @@ Comment puis-je r�soudre ce probl�me? Vous avez demand� que le courrier pour un domaine (e.g., domain.net) soit transmis à une machine donn�e (dans ce cas pr�cis, relay.domain.net) -en utilisant un enregistrement MX<indexterm><primary>MX record</primary></indexterm>, mais la machine relais ne se +en utilisant un enregistrement MX<indexterm><primary>MX record</primary> +</indexterm>, mais la machine relais ne se conna�t pas elle-m�me comme domain.net. Ajoutez domain.net à /etc/mail/local-host-names [connu sous le nom /etc/sendmail.cw dans les versionsant�rieure à 8.10] (si vous utilisez FEATURE(use_cw_file)) ou ajoutez “Cw domain.net” à @@ -1089,7 +1091,8 @@ ou ajoutez “Cw domain.net” & <question> <para>Comment puis-je faire tourner un serveur de courrier �lectronique avec une connexion - t�l�phonique PPP<indexterm><primary>PPP</primary></indexterm></para> + t�l�phonique PPP<indexterm> + <primary>PPP</primary></indexterm></para> </question> <answer> @@ -1099,7 +1102,8 @@ ou ajoutez “Cw domain.net” & La connexion PPP n'est pas d�di�e.</para> <para>Il y a au moins deux fa�ons de faire. L'une d'elle - est d'utiliser UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> + est d'utiliser UUCP<indexterm> + <primary>UUCP</primary></indexterm>.</para> <para>L'autre m�thode �tant d'obtenir un serveur Internet constamment connect� pour qu'il vous fournisse les services @@ -1125,7 +1129,8 @@ ou ajoutez “Cw domain.net” & probablement par d�passement de d�lai puisque vous n'�tes pas en ligne. Le programme <application>sendmail</application> enverra automatiquement - le courrier au site MX secondaire<indexterm><primary>MX record</primary></indexterm>, i.e. votre fournisseur + le courrier au site MX secondaire<indexterm> + <primary>MX record</primary></indexterm>, i.e. votre fournisseur d'acc�s (<hostid role="domainname">exemple.net</hostid>). Le site MX secondaire essayera p�riodiquement de se connecter à votre machine pour exp�dier le Modified: head/hu_HU.ISO8859-2/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/hu_HU.ISO8859-2/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/hu_HU.ISO8859-2/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -3988,7 +3988,8 @@ Script done, …</screen> <qandaentry> <question> <para>A ford�t� rengeteg 11-es jelz�st - (signal 11)<indexterm><primary>signal 11</primary></indexterm> (vagy m�sfajta jelz�seket) dob + (signal 11)<indexterm><primary>signal 11</primary> + </indexterm> (vagy m�sfajta jelz�seket) dob hib�val. Mi t�rt�nhetett?</para> </question> Modified: head/hu_HU.ISO8859-2/books/handbook/install/chapter.xml ============================================================================== --- head/hu_HU.ISO8859-2/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/hu_HU.ISO8859-2/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -6176,7 +6176,8 @@ Please press any key to reboot.</screen> s�rga sz�n� bet�ket viszonylag neh�z olvasni a vil�gossz�rke h�tt�rrel. Esetleg lehet valahogy - n�velni a kontrasztot<indexterm><primary>sz�nek</primary><secondary>kontraszt</secondary></indexterm> az alkalmaz�s + n�velni a kontrasztot<indexterm><primary>sz�nek</primary> + <secondary>kontraszt</secondary></indexterm> az alkalmaz�s haszn�latakor?</para> </question> Modified: head/hu_HU.ISO8859-2/books/handbook/mail/chapter.xml ============================================================================== --- head/hu_HU.ISO8859-2/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/hu_HU.ISO8859-2/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -1136,7 +1136,8 @@ purgestat /usr/local/<replaceable>kedven <hostid>vagyis</hostid> n�ven.</para> <para>R�gebben egy�bk�nt ezt a - BSD-t�pus� BIND<indexterm><primary>BIND</primary></indexterm> n�vfelold�k + BSD-t�pus� BIND<indexterm><primary>BIND</primary> + </indexterm> n�vfelold�k megengedt�k. A &os; jelenlegi v�ltozatai azonban m�r olyan <application>BIND</application> verzi�t tartalmaznak, amelyek Modified: head/it_IT.ISO8859-15/books/handbook/install/chapter.xml ============================================================================== --- head/it_IT.ISO8859-15/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/it_IT.ISO8859-15/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4812,7 +4812,8 @@ Please press any key to reboot.</screen> <qandaset> <qandaentry> <question> - <para>Posso avviare dalla console ARC<indexterm><primary>ARC</primary></indexterm> o da quella del BIOS + <para>Posso avviare dalla console ARC<indexterm> + <primary>ARC</primary></indexterm> o da quella del BIOS Alpha<indexterm><primary>Alpha BIOS</primary></indexterm>?</para> </question> Modified: head/it_IT.ISO8859-15/books/handbook/mail/chapter.xml ============================================================================== --- head/it_IT.ISO8859-15/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/it_IT.ISO8859-15/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -954,7 +954,8 @@ purgestat /usr/local/supermailer/bin/p role="fqdn">mumble.bar.edu</hostid>, invece del solo <hostid>mumble</hostid>.</para> - <para>Tradizionalmente, questo era permesso dai resolver BIND<indexterm><primary>BIND</primary></indexterm> di + <para>Tradizionalmente, questo era permesso dai resolver + BIND<indexterm><primary>BIND</primary></indexterm> di BSD. Tuttavia la versione corrente di <application>BIND</application> equipaggiata con FreeBSD non prevede pi� l'abbreviazione di default per nomi di dominio @@ -1000,7 +1001,8 @@ Come posso risolvere questo problema? Hai chiesto che la posta per il dominio (es., domain.net) sia inoltrata a un host specifico (in questo caso, relay.domain.net) attraverso l'uso di -un record MX<indexterm><primary>record MX</primary></indexterm>, ma la macchina di inoltro non si riconosce appartenente a +un record MX<indexterm><primary>record MX</primary></indexterm>, +ma la macchina di inoltro non si riconosce appartenente a domain.net. Aggiungi domain.net in /etc/mail/local-host-names [chiamato /etc/sendmail.cw nelle versioni precedenti alla 8.10] (se stai usando FEATURE(use_cw_file)) oppure aggiungi <quote>Cw domain.net</quote> @@ -1016,7 +1018,8 @@ in /etc/mail/sendmail.cf.</programlistin <qandaentry> <question> <para>Come posso eseguire un server di posta su un host connesso in - dial-up tramite PPP<indexterm><primary>PPP</primary></indexterm>?</para> + dial-up tramite PPP<indexterm><primary>PPP</primary> + </indexterm>?</para> </question> <answer> @@ -1029,7 +1032,8 @@ in /etc/mail/sendmail.cf.</programlistin usare UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> <para>L'altro � trovare un server Internet a tempo pieno - che fornisca un servizio MX<indexterm><primary>record MX</primary></indexterm> secondario per il tuo dominio. + che fornisca un servizio MX<indexterm><primary>record MX</primary> + </indexterm> secondario per il tuo dominio. Per esempio, se il dominio della tua societ� � <hostid role="domainname">example.com</hostid> e il tuo fornitore di servizi Internet ha attivato <hostid Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2885,7 +2885,8 @@ Script done, …</screen> <qandaentry> <question> - <para>signal 11<indexterm><primary>signal 11</primary></indexterm> (�⤷��¾�Υ��ʥ��ֹ�) �Υ��顼��Ф� + <para>signal 11<indexterm><primary>signal 11</primary></indexterm> + (�⤷��¾�Υ��ʥ��ֹ�) �Υ��顼��Ф� ��ѥ��뤬��Ԥ��ޤ��äƤ��Ǥ��礦��?</para> </question> Modified: head/ja_JP.eucJP/books/handbook/install/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/ja_JP.eucJP/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4343,7 +4343,9 @@ Please press any key to reboot.</screen> <question> <para>X11 ü�� <application>sysinstall</application> ��Ȥ��ȡ� �饤�ȥ��졼��طʤ˥ե��Ȥ��ɽ��졢�ɤߤ��餤�Ǥ�� - ��Υ��ץꥱ��Υ��ȥ饹�Ȥ�⤯��뤳�ȤϤǤ��ޤ��<indexterm><primary>color</primary><secondary>contrast</secondary></indexterm>?</para> + ��Υ��ץꥱ��Υ��ȥ饹�Ȥ�⤯��뤳�ȤϤǤ��ޤ�� + <indexterm><primary>color</primary><secondary>contrast</secondary> + </indexterm>?</para> </question> <answer> <para>��Ǥ� X11 �򥤥󥹥ȡ��뤷�Ƥ��ơ�&man.xterm.1; �� &man.rxvt.1; Modified: head/ja_JP.eucJP/books/handbook/mail/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/ja_JP.eucJP/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -745,7 +745,8 @@ purgestat /usr/local/supermailer/bin/p ��λ��ñ�� <hostid>mumble</hostid> �ǤϤʤ� <hostid role="fqdn">mumble.bar.edu</hostid> �� FQDN �ǻ��Ȥ��ʤ��Фʤ�ޤ��</para> - <para>��⤽�⡢BSD BIND<indexterm><primary>BIND</primary></indexterm> �Υ꥾��С� (resolver) �ǤϤ��Τ褦�ʤ��Ȥ��ǽ�Ǥ�� + <para>��⤽�⡢BSD BIND<indexterm><primary>BIND</primary></indexterm> + �Υ꥾��С� (resolver) �ǤϤ��Τ褦�ʤ��Ȥ��ǽ�Ǥ�� FreeBSD ��äƤ��ǿ��Ǥ� <application>BIND</application> �Ǥϼ�ʬ�Υɥᥤ��ʳ��Ф�� FQDN �Ǥʤ��ά��ϵ��ޤ�� äƥۥ��Ȥ� <hostid>mumble</hostid> ��ۣ��˻��ꤷ�� @@ -811,7 +812,8 @@ FEATURE(use_cw_file) ��ꤷ�Ƥ�� <qandaentry> <question> - <para>��륢�å� PPP<indexterm><primary>PPP</primary></indexterm> �ۥ��Ȥǥ᡼�륵��Ф�¹Ԥ��ˤϤɤ��餤��?</para> + <para>��륢�å� PPP<indexterm><primary>PPP</primary></indexterm> + �ۥ��Ȥǥ᡼�륵��Ф�¹Ԥ��ˤϤɤ��餤��?</para> </question> <answer> @@ -821,7 +823,8 @@ FEATURE(use_cw_file) ��ꤷ�Ƥ�� ޥ��³�ǤϤ��ޤ�� (��: ��륢�å��³�ʤ�)��</para> <para>��ˤϡ��ʤ��Ȥ��Ĥ��ˡ��ޤ�� - ��Ĥ� UUCP<indexterm><primary>UUCP</primary></indexterm> ��Ȥ��ȤǤ��</para> + ��Ĥ� UUCP<indexterm><primary>UUCP</primary></indexterm> + ��Ȥ��ȤǤ��</para> <para>�⤦��Ĥ��ˡ�ϡ��ʤ��Υɥᥤ��Ф��륻�� MX ��ӥ��󶡤��Ư�Υ��󥿡��ͥåȥ��Ф��Ѱդ��뤳�ȤǤ�� Modified: head/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2608,7 +2608,8 @@ Script done, …</screen> <qandaentry> <question> - <para>Миний эмхэтгэл маш олон дохио 11<indexterm><primary>дохио 11</primary></indexterm> (эсвэл бусад дохионы дугаар) + <para>Миний эмхэтгэл маш олон дохио 11<indexterm> + <primary>дохио 11</primary></indexterm> (эсвэл бусад дохионы дугаар) алдаагаар амжилтгүй болсон. Юу болсон юм бол?</para> </question> Modified: head/mn_MN.UTF-8/books/handbook/install/chapter.xml ============================================================================== --- head/mn_MN.UTF-8/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/mn_MN.UTF-8/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -3998,8 +3998,9 @@ Please press any key to reboot.</screen> <question> <para><application>sysinstall</application>-ийг X11 терминал дээр ашигласан тохиолдолд цайвар саарал дээр шар фонтыг уншихад - хэцүү байдаг<indexterm><primary>color</primary><secondary>contrast</secondary></indexterm>. Энэ програмын хувьд илүү өндөр нягтралтай - үзүүлэх боломж бий юу?</para> + хэцүү байдаг<indexterm><primary>color</primary> + <secondary>contrast</secondary></indexterm>. Энэ програмын + хувьд илүү өндөр нягтралтай үзүүлэх боломж бий юу?</para> </question> <answer> <para>Хэрэв та X11-ийг суулгасан бөгөөд Modified: head/mn_MN.UTF-8/books/handbook/mail/chapter.xml ============================================================================== --- head/mn_MN.UTF-8/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/mn_MN.UTF-8/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -821,7 +821,8 @@ role="domainname">bar.edu</hostid> до� <hostid role="fqdn">mumble.bar.edu</hostid> гэсэн fully-qualified domain name буюу бүрэн-баталгаажсан домэйн нэрээр нь заах хэрэгтэй.</para> - <para>Урьд нь, BSD BIND<indexterm><primary>BIND</primary></indexterm> тайлагчийн хувьд дээрх шиг хэрэглэж болдог байсан. + <para>Урьд нь, BSD BIND<indexterm><primary>BIND</primary></indexterm> +тайлагчийн хувьд дээрх шиг хэрэглэж болдог байсан. Гэвч FreeBSD-тэй хамт ирдэг <application>BIND</application>-н одоогийн хувилбар дээр өөрийн оршин байгаа домэйноос бусад бүрэн баталгаажаагүй домэйн нэрийн хувьд анхдагч товчилсон нэрүүдийг хэрэглэж болохгүй болсон. Тиймээс баталгаажаагүй @@ -889,10 +890,12 @@ to /etc/mail/sendmail.cf.</programlistin Энэ FreeBSD машин тухайн LAN-ий хувьд захидлын гарц байх болно. PPP холболт бол тусгайлан бий болгосон зориулагдсан холболт биш юм.</para> - <para>Үүний тулд хоёр арга байна. Нэг арга нь UUCP<indexterm><primary>UUCP</primary></indexterm> ашиглах юм.</para> + <para>Үүний тулд хоёр арга байна. Нэг арга нь UUCP<indexterm> + <primary>UUCP</primary></indexterm> ашиглах юм.</para> <para>Нөгөө арга нь таны домэйны хувьд хоёрдогч -MX<indexterm><primary>MX бичлэг</primary></indexterm> үйлчилгээг үзүүлэх байнгын холболттой Интернэт сервертэй болох явдал юм. +MX<indexterm><primary>MX бичлэг</primary></indexterm> үйлчилгээг +үзүүлэх байнгын холболттой Интернэт сервертэй болох явдал юм. Жишээлбэл, хэрэв танай байгууллагын домэйн нэр <hostid role="domainname">example.com</hostid> бөгөөд танай Интернэтийн үйлчилгээ үзүүлэгч танай домэйны хувьд хоёрдогч MX үйлчилгээг үзүүлэхээр Modified: head/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2890,8 +2890,8 @@ Script done, …</screen> <qandaentry> <question> <para>Het compileren gaat fout met veel meldingen van - signal 11<indexterm><primary>signal 11</primary></indexterm> (of andere signalnummers). Wat is er aan de - hand?</para> + signal 11<indexterm><primary>signal 11</primary></indexterm> + (of andere signalnummers). Wat is er aan de hand?</para> </question> <answer> Modified: head/nl_NL.ISO8859-1/books/handbook/install/chapter.xml ============================================================================== --- head/nl_NL.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/nl_NL.ISO8859-1/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4486,8 +4486,9 @@ Please press any key to reboot.</screen> <para>Wanneer <application>sysinstall</application> in een X11-terminal wordt gebruikt, is het moeilijk om het gele font op de lichtgrijze achtergrond te lezen. Is er een - manier om het contrast<indexterm><primary>kleur</primary><secondary>contrast</secondary></indexterm> van deze applicatie te - verhogen?</para> + manier om het contrast<indexterm> + <primary>kleur</primary><secondary>contrast</secondary> + </indexterm> van deze applicatie te verhogen?</para> </question> <answer> Modified: head/nl_NL.ISO8859-1/books/handbook/mail/chapter.xml ============================================================================== --- head/nl_NL.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/nl_NL.ISO8859-1/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -875,7 +875,8 @@ purgestat /usr/local/supermailer/bin/pur verwijzen, <hostid role="fqdn">mompel.bar.edu</hostid>, in plaats van slechts <hostid>mompel</hostid>.</para> - <para>Traditioneel werd dit door BSD BIND<indexterm><primary>BIND</primary></indexterm> resolvers toegestaan. De + <para>Traditioneel werd dit door BSD BIND<indexterm> + <primary>BIND</primary></indexterm> resolvers toegestaan. De huidige versie van <application>BIND</application> die met &os; wordt geleverd levert niet langer standaard afkortingen voor onvolledig gekwalificeerde domeinnamen @@ -949,10 +950,12 @@ eerder dan 8.10] (als FEATURE(use_cw_fil voor het LAN zijn. De PPP-verbinding is niet toegewijd.</para> <para>Er zijn minstens twee manieren om dit te doen. - E�n manier is om UUCP<indexterm><primary>UUCP</primary></indexterm> te gebruiken.</para> + E�n manier is om UUCP<indexterm> + <primary>UUCP</primary></indexterm> te gebruiken.</para> <para>Een andere manier is ervoor te zorgen dat een server die - altijd met het Internet verbonden is secundaire MX-diensten<indexterm><primary>MX-regel</primary></indexterm> + altijd met het Internet verbonden is secundaire + MX-diensten<indexterm><primary>MX-regel</primary></indexterm> voor het domein biedt. Als het domein bijvoorbeeld <hostid role="domainname">example.com</hostid> is en de internetprovider <hostid role="domainname">example.net Modified: head/pl_PL.ISO8859-2/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/pl_PL.ISO8859-2/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/pl_PL.ISO8859-2/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -1389,7 +1389,8 @@ Script done, …</screen> <qandaentry> <question> - <para>My compile failed with lots of signal 11<indexterm><primary>signal 11</primary></indexterm> (or other signal + <para>My compile failed with lots of signal 11<indexterm> + <primary>signal 11</primary></indexterm> (or other signal number) errors. What has happened?</para> </question> Modified: head/pl_PL.ISO8859-2/books/handbook/install/chapter.xml ============================================================================== --- head/pl_PL.ISO8859-2/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/pl_PL.ISO8859-2/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4693,12 +4693,15 @@ Please press any key to reboot.</screen> <qandaset> <qandaentry> <question> - <para>Czy mog� �adowa� system z konsoli ARC<indexterm><primary>ARC</primary></indexterm> lub Alpha BIOS<indexterm><primary>Alpha BIOS</primary></indexterm>?</para> + <para>Czy mog� �adowa� system z konsoli ARC<indexterm> + <primary>ARC</primary></indexterm> lub Alpha BIOS<indexterm> + <primary>Alpha BIOS</primary></indexterm>?</para> </question> <answer> <para>Nie. &os;, podobnie jak Compaq Tru64 i VMS, mo�e by� - �adowany tylko z konsoli SRM<indexterm><primary>SRM</primary></indexterm>.</para> + �adowany tylko z konsoli SRM<indexterm> + <primary>SRM</primary></indexterm>.</para> </answer> </qandaentry> Modified: head/pl_PL.ISO8859-2/books/handbook/mail/chapter.xml ============================================================================== --- head/pl_PL.ISO8859-2/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/pl_PL.ISO8859-2/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -929,7 +929,8 @@ purgestat /usr/local/supermailer/bin/pur role="fqdn">mumble.bar.edu</hostid>, instead of just <hostid>mumble</hostid>.</para> - <para>Traditionally, this was allowed by BSD BIND<indexterm><primary>BIND</primary></indexterm> resolvers. + <para>Traditionally, this was allowed by BSD BIND<indexterm> + <primary>BIND</primary></indexterm> resolvers. However the current version of <application>BIND</application> that ships with FreeBSD no longer provides default abbreviations for non-fully qualified domain names other than the domain you @@ -980,7 +981,8 @@ How can I solve this problem? You have asked mail to the domain (e.g., domain.net) to be forwarded to a specific host (in this case, relay.domain.net) -by using an MX<indexterm><primary>MX record</primary></indexterm> record, but the relay machine does not recognize +by using an MX<indexterm><primary>MX record</primary></indexterm> +record, but the relay machine does not recognize itself as domain.net. Add domain.net to /etc/mail/local-host-names [known as /etc/sendmail.cw prior to version 8.10] (if you are using FEATURE(use_cw_file)) or add <quote>Cw domain.net</quote> @@ -996,7 +998,8 @@ to /etc/mail/sendmail.cf.</programlistin <qandaentry> <question> - <para>How can I run a mail server on a dial-up PPP<indexterm><primary>PPP</primary></indexterm> host?</para> + <para>How can I run a mail server on a dial-up PPP<indexterm> + <primary>PPP</primary></indexterm> host?</para> </question> <answer> @@ -1007,7 +1010,8 @@ to /etc/mail/sendmail.cf.</programlistin <para>There are at least two ways to do this. One way is to use UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> - <para>Another way is to get a full-time Internet server to provide secondary MX<indexterm><primary>MX record</primary></indexterm> + <para>Another way is to get a full-time Internet server to provide secondary + MX<indexterm><primary>MX record</primary></indexterm> services for your domain. For example, if your company's domain is <hostid role="domainname">example.com</hostid> and your Internet service provider has set <hostid role="domainname">example.net</hostid> up to provide secondary MX services Modified: head/ru_RU.KOI8-R/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/ru_RU.KOI8-R/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/ru_RU.KOI8-R/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2006,7 +2006,8 @@ Script done, … <qandaentry> <question> <para>�� - �� 11<indexterm><primary>�� 11</primary></indexterm> (�� ). �� + �� 11<indexterm><primary>�� 11</primary></indexterm> + (�� ). �� ?</para> </question> Modified: head/ru_RU.KOI8-R/books/handbook/install/chapter.xml ============================================================================== --- head/ru_RU.KOI8-R/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/ru_RU.KOI8-R/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -4255,8 +4255,9 @@ Please press any key to reboot.</screen> <question> <para>�� <application>sysinstall</application> �� X11, �� - �� . �� <indexterm><primary>color</primary><secondary>contrast</secondary></indexterm> �� - �� ?</para> + �� . �� <indexterm> + <primary>color</primary><secondary>contrast</secondary> + </indexterm> �� ?</para> </question> <answer> Modified: head/ru_RU.KOI8-R/books/handbook/mail/chapter.xml ============================================================================== --- head/ru_RU.KOI8-R/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/ru_RU.KOI8-R/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -929,7 +929,8 @@ purgestat /usr/local/supermailer/bin/pur �� , <hostid role="fqdn">mumble.bar.edu</hostid>, � �� <hostid>mumble</hostid>.</para> - <para>��, �� BSD BIND<indexterm><primary>BIND</primary></indexterm> �� + <para>��, �� BSD BIND<indexterm> + <primary>BIND</primary></indexterm> �� . ��, �� <application>BIND</application>, �� FreeBSD, �� , �� , � �� , �� @@ -1006,10 +1007,12 @@ FETURE(use_cw_file)) �� <quote �� . PPP �� .</para> <para>�� , �� . �� - �� UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> + �� UUCP<indexterm> + <primary>UUCP</primary></indexterm>.</para> <para>�� - �� MX<indexterm><primary>MX record</primary></indexterm> �� . + �� MX<indexterm> + <primary>MX record</primary></indexterm> �� . ��, �� <hostid role="domainname">example.com</hostid>, � �� <hostid role="domainname">example.net</hostid> Modified: head/zh_CN.GB2312/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/zh_CN.GB2312/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/zh_CN.GB2312/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -2388,7 +2388,8 @@ Script done, …</screen> <qandaentry> <question> - <para>�ҵı��ʧ�ܣ�� 11<indexterm><primary>�ź� 11</primary></indexterm> + <para>�ҵı��ʧ�ܣ�� + 11<indexterm><primary>�ź� 11</primary></indexterm> (��Ϣ) �Ŵ��ô��ѽ��</para> </question> Modified: head/zh_CN.GB2312/books/handbook/install/chapter.xml ============================================================================== --- head/zh_CN.GB2312/books/handbook/install/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/zh_CN.GB2312/books/handbook/install/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -3858,7 +3858,9 @@ Please press any key to reboot.</screen> <question> <para>�� X11 �ն�� <application>sysinstall</application> ��ʱ�� ɫ��ǳ��ɫ�ı��Ķ�� - ��û��ʲô��Ӧ�ó��ṩ�߶Աȶȵķ��<indexterm><primary>color</primary><secondary>contrast</secondary></indexterm></para> + ��û��ʲô��Ӧ�ó��ṩ�߶Աȶȵķ��<indexterm> + <primary>color</primary><secondary>contrast</secondary> + </indexterm></para> </question> <answer> <para>��Ѿ��װ�� X11 �� <application>sysinstall</application> Modified: head/zh_CN.GB2312/books/handbook/mail/chapter.xml ============================================================================== --- head/zh_CN.GB2312/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/zh_CN.GB2312/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -765,7 +765,8 @@ purgestat /usr/local/supermailer/bin/pur <hostid role="fqdn">mumble.bar.edu</hostid>�� <hostid>mumble</hostid>��</para> - <para>��ͳ�ϣ�� BSD BIND<indexterm><primary>BIND</primary></indexterm> resolvers ��ǿ��еġ� + <para>��ͳ�ϣ�� BSD BIND<indexterm> + <primary>BIND</primary></indexterm> resolvers ��ǿ��еġ� Ȼ��Ŀǰ�� FreeBSD �� <application>BIND</application> �Ѳ�Ϊͬһ��ṩ��д��ԣ�� <hostid>mumble</hostid> �� <hostid @@ -816,7 +817,8 @@ purgestat /usr/local/supermailer/bin/pur ��̨��Ϊ��Լ�� domain.net�� domain.net ��ӵ� /etc/mail/local-host-names �ļ�� [�� 8.10 ��֮ǰ�� /etc/sendmail.cw] (��ʹ�� FEATURE(use_cw_file) �Ļ�) �� /etc/mail/sendmail.cf -��<quote>Cw domain.net</quote>��<indexterm><primary>MX record</primary></indexterm></programlisting> +��<quote>Cw domain.net</quote>��<indexterm> +<primary>MX record</primary></indexterm></programlisting> <para><application>sendmail</application> �� FAQ �� <ulink url="http://www.sendmail.org/faq/"></ulink> �ҵ�� @@ -828,7 +830,8 @@ purgestat /usr/local/supermailer/bin/pur <qandaentry> <question> - <para>��һ��һ��ʼ��<indexterm><primary>PPP</primary></indexterm></para> + <para>��һ��һ��ʼ��<indexterm> + <primary>PPP</primary></indexterm></para> </question> <answer> @@ -836,7 +839,8 @@ purgestat /usr/local/supermailer/bin/pur FreeBSD ��Ϊ��ʼ��أ� ��Ӳ��һֱ��״̬��</para> - <para>��ַ��Ҫ��һ�ַ��ʹ�� UUCP<indexterm><primary>UUCP</primary></indexterm>��</para> + <para>��ַ��Ҫ��һ�ַ��ʹ�� UUCP<indexterm> + <primary>UUCP</primary></indexterm>��</para> <para>��һ�ַ��ҵ�һ��רְ�ķ��Ϊ��ṩ�� MX �� 磬��˾�� @@ -855,7 +859,8 @@ purgestat /usr/local/supermailer/bin/pur ��᳢��ͨ�� modem ��ӵ�� (<hostid role="domainname">example.com</hostid>)�� Ϊ��ߣ��ǻ�õ�һ��ʱ�Ĵ�� <application>sendmail</application> ��ʼ��͵�� - MX<indexterm><primary>MX record</primary></indexterm> ��Ҳ��˵��Ļ��ṩ�� + MX<indexterm><primary>MX record</primary> + </indexterm> ��Ҳ��˵��Ļ��ṩ�� (<hostid role="domainname">example.net</hostid>)�� MX ��Եĳ��Ӳ��ʼ�� (<hostid role="domainname">example.com</hostid>)��</para> Modified: head/zh_TW.Big5/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/zh_TW.Big5/books/handbook/cutting-edge/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/zh_TW.Big5/books/handbook/cutting-edge/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -1282,7 +1282,8 @@ Script done, …</screen> <qandaentry> <question> - <para>My compile failed with lots of signal 11<indexterm><primary>signal 11</primary></indexterm> (or other signal + <para>My compile failed with lots of signal 11<indexterm> + <primary>signal 11</primary></indexterm> (or other signal number) errors. What has happened?</para> </question> Modified: head/zh_TW.Big5/books/handbook/mail/chapter.xml ============================================================================== --- head/zh_TW.Big5/books/handbook/mail/chapter.xml Thu Jul 11 16:34:54 2013 (r42247) +++ head/zh_TW.Big5/books/handbook/mail/chapter.xml Thu Jul 11 17:11:21 2013 (r42248) @@ -923,7 +923,8 @@ purgestat /usr/local/supermailer/bin/pur role="fqdn">mumble.bar.edu</hostid>, instead of just <hostid>mumble</hostid>.</para> - <para>Traditionally, this was allowed by BSD BIND<indexterm><primary>BIND</primary></indexterm> resolvers. + <para>Traditionally, this was allowed by BSD BIND<indexterm> + <primary>BIND</primary></indexterm> resolvers. However the current version of <application>BIND</application> that ships with FreeBSD no longer provides default abbreviations for non-fully qualified domain names other than the domain you @@ -974,7 +975,8 @@ How can I solve this problem? You have asked mail to the domain (e.g., domain.net) to be forwarded to a specific host (in this case, relay.domain.net) -by using an MX<indexterm><primary>MX record</primary></indexterm> record, but the relay machine does not recognize +by using an MX<indexterm><primary>MX record</primary></indexterm> +record, but the relay machine does not recognize itself as domain.net. Add domain.net to /etc/mail/local-host-names [known as /etc/sendmail.cw prior to version 8.10] (if you are using FEATURE(use_cw_file)) or add <quote>Cw domain.net</quote> @@ -989,7 +991,8 @@ to /etc/mail/sendmail.cf.</programlistin <qandaentry> <question> - <para>How can I run a mail server on a dial-up PPP<indexterm><primary>PPP</primary></indexterm> host?</para> + <para>How can I run a mail server on a dial-up PPP<indexterm> + <primary>PPP</primary></indexterm> host?</para> </question> <answer> @@ -1000,7 +1003,8 @@ to /etc/mail/sendmail.cf.</programlistin <para>There are at least two ways to do this. One way is to use UUCP<indexterm><primary>UUCP</primary></indexterm>.</para> - <para>Another way is to get a full-time Internet server to provide secondary MX<indexterm><primary>MX record</primary></indexterm> + <para>Another way is to get a full-time Internet server to provide secondary + MX<indexterm><primary>MX record</primary></indexterm> services for your domain. For example, if your company's domain is <hostid role="domainname">example.com</hostid> and your Internet service provider has set <hostid role="domainname">example.net</hostid> up to provide secondary MX services From owner-svn-doc-all@FreeBSD.ORG Thu Jul 11 17:13:40 2013 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id BCB7FEBF; Thu, 11 Jul 2013 17:13:40 +0000 (UTC) (envelope-from pluknet@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id AF84B1ACE; Thu, 11 Jul 2013 17:13:40 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6BHDeZ9052468; Thu, 11 Jul 2013 17:13:40 GMT (envelope-from pluknet@svn.freebsd.org) Received: (from pluknet@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6BHDeYn052467; Thu, 11 Jul 2013 17:13:40 GMT (envelope-from pluknet@svn.freebsd.org) Message-Id: <201307111713.r6BHDeYn052467@svn.freebsd.org> From: Sergey Kandaurov <pluknet@FreeBSD.org> Date: Thu, 11 Jul 2013 17:13:40 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42249 - head/en_US.ISO8859-1/htdocs/releng X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Thu, 11 Jul 2013 17:13:40 -0000 Author: pluknet Date: Thu Jul 11 17:13:40 2013 New Revision: 42249 URL: http://svnweb.freebsd.org/changeset/doc/42249 Log: Link to the 9.2 Release Schedule, expected to be done in August. Modified: head/en_US.ISO8859-1/htdocs/releng/index.xml Modified: head/en_US.ISO8859-1/htdocs/releng/index.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/releng/index.xml Thu Jul 11 17:11:21 2013 (r42248) +++ head/en_US.ISO8859-1/htdocs/releng/index.xml Thu Jul 11 17:13:40 2013 (r42249) @@ -50,15 +50,9 @@ </tr> <tr> - <td>June 7 2013</td> - <td>&os; 8.4</td> - <td>Released</td> - </tr> - - <tr> - <td>TBD</td> + <td>August 2013</td> <td>&os; 9.2</td> - <td></td> + <td><a href="&base;/releases/9.2R/schedule.html">Target Schedule</a></td> </tr> </table> From owner-svn-doc-all@FreeBSD.ORG Thu Jul 11 17:56:20 2013 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id B8211F3A; Thu, 11 Jul 2013 17:56:20 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id AB14A1CE6; Thu, 11 Jul 2013 17:56:20 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6BHuKRs064336; Thu, 11 Jul 2013 17:56:20 GMT (envelope-from gabor@svn.freebsd.org) Received: (from gabor@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6BHuKmu064335; Thu, 11 Jul 2013 17:56:20 GMT (envelope-from gabor@svn.freebsd.org) Message-Id: <201307111756.r6BHuKmu064335@svn.freebsd.org> From: Gabor Kovesdan <gabor@FreeBSD.org> Date: Thu, 11 Jul 2013 17:56:20 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42251 - head/share/xsl X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Thu, 11 Jul 2013 17:56:20 -0000 Author: gabor Date: Thu Jul 11 17:56:20 2013 New Revision: 42251 URL: http://svnweb.freebsd.org/changeset/doc/42251 Log: - userinput should also be bold so that it can be distinguished from the rest of the screen content Reported by: wblock Modified: head/share/xsl/freebsd-common.xsl Modified: head/share/xsl/freebsd-common.xsl ============================================================================== --- head/share/xsl/freebsd-common.xsl Thu Jul 11 17:27:09 2013 (r42250) +++ head/share/xsl/freebsd-common.xsl Thu Jul 11 17:56:20 2013 (r42251) @@ -8,7 +8,7 @@   - <xsl:template match="hostid|username|groupname|devicename|maketarget|makevar|userinput|command"> + <xsl:template match="hostid|username|groupname|devicename|maketarget|makevar|command"> <xsl:call-template name="inline.monoseq"/> </xsl:template> From owner-svn-doc-all@FreeBSD.ORG Thu Jul 11 20:19:05 2013 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 9DB959A2; Thu, 11 Jul 2013 20:19:05 +0000 (UTC) (envelope-from taras@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 8FEA4128A; Thu, 11 Jul 2013 20:19:05 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6BKJ5t8006810; Thu, 11 Jul 2013 20:19:05 GMT (envelope-from taras@svn.freebsd.org) Received: (from taras@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6BKJ5Zv006809; Thu, 11 Jul 2013 20:19:05 GMT (envelope-from taras@svn.freebsd.org) Message-Id: <201307112019.r6BKJ5Zv006809@svn.freebsd.org> From: Taras Korenko <taras@FreeBSD.org> Date: Thu, 11 Jul 2013 20:19:05 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42255 - head/share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Thu, 11 Jul 2013 20:19:05 -0000 Author: taras Date: Thu Jul 11 20:19:05 2013 New Revision: 42255 URL: http://svnweb.freebsd.org/changeset/doc/42255 Log: + remove duplicate entities (lines 1263,1264 vs. 1287,1288 of head/share/xml/authors.ent@42254) Modified: head/share/xml/authors.ent Modified: head/share/xml/authors.ent ============================================================================== --- head/share/xml/authors.ent Thu Jul 11 19:27:42 2013 (r42254) +++ head/share/xml/authors.ent Thu Jul 11 20:19:05 2013 (r42255) @@ -1260,9 +1260,6 @@ <!ENTITY a.markj "Mark Johnston"> <!ENTITY a.markj.email "&a.markj; <email xmlns=''>markj@FreeBSD.org</email>"> -<!ENTITY a.markm "Mark Murray"> -<!ENTITY a.markm.email "&a.markm; <email xmlns=''>markm@FreeBSD.org</email>"> - <!ENTITY a.makc "Max Brazhnikov"> <!ENTITY a.makc.email "&a.makc; <email xmlns=''>makc@FreeBSD.org</email>"> From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 02:59:51 2013 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 45268AD9; Fri, 12 Jul 2013 02:59:51 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 37A41132D; Fri, 12 Jul 2013 02:59:51 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C2xpMa025084; Fri, 12 Jul 2013 02:59:51 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C2xpoo025083; Fri, 12 Jul 2013 02:59:51 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201307120259.r6C2xpoo025083@svn.freebsd.org> From: Glen Barber <gjb@FreeBSD.org> Date: Fri, 12 Jul 2013 02:59:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42256 - head/en_US.ISO8859-1/htdocs/releases/9.2R X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Fri, 12 Jul 2013 02:59:51 -0000 Author: gjb Date: Fri Jul 12 02:59:50 2013 New Revision: 42256 URL: http://svnweb.freebsd.org/changeset/doc/42256 Log: Update the 9.2-RELEASE schedule page. While here, add the code slush reminder section that was mistakenly left out. Approved by: re (implicit) Modified: head/en_US.ISO8859-1/htdocs/releases/9.2R/schedule.xml Modified: head/en_US.ISO8859-1/htdocs/releases/9.2R/schedule.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/releases/9.2R/schedule.xml Thu Jul 11 20:19:05 2013 (r42255) +++ head/en_US.ISO8859-1/htdocs/releases/9.2R/schedule.xml Fri Jul 12 02:59:50 2013 (r42256) @@ -52,15 +52,24 @@ <tr> <td>Release schedule reminder</td> <td>1 July 2013</td> - <td>-</td> + <td>4 July 2013</td> <td>Release Engineers send reminder announcement e-mail to developers with updated schedule.</td> </tr> <tr> - <td>Code freeze begins</td> + <td>Code slush begins</td> <td>6 July 2013</td> - <td>-</td> + <td>6 July 2013</td> + <td>Release Engineers announce that all further commits to the + &local.branch.stable; branch will not require explicit approval, + however new features should be avoided.</td> + </tr> + + <tr> + <td>Code freeze begins</td> + <td>12 July 2013</td> + <td>12 July 2013</td> <td>Release Engineers announce that all further commits to the &local.branch.stable; branch will require explicit approval. Certain blanket approvals will be granted for narrow areas of From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 03:21:55 2013 Return-Path: <owner-svn-doc-all@FreeBSD.ORG> Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id CA30D330; Fri, 12 Jul 2013 03:21:55 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id BA22D1692; Fri, 12 Jul 2013 03:21:55 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C3Ltjm034633; Fri, 12 Jul 2013 03:21:55 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C3Ltph034632; Fri, 12 Jul 2013 03:21:55 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307120321.r6C3Ltph034632@svn.freebsd.org> From: Warren Block <wblock@FreeBSD.org> Date: Fri, 12 Jul 2013 03:21:55 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42257 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" <svn-doc-all.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all> List-Post: <mailto:svn-doc-all@freebsd.org> List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>, <mailto:svn-doc-all-request@freebsd.org?subject=subscribe> X-List-Received-Date: Fri, 12 Jul 2013 03:21:55 -0000 Author: wblock Date: Fri Jul 12 03:21:55 2013 New Revision: 42257 URL: http://svnweb.freebsd.org/changeset/doc/42257 Log: Edit for clarity and style. Try to persuade the hippo and the pogo stick that they are not good for each other. Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 02:59:50 2013 (r42256) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 03:21:55 2013 (r42257) @@ -34,10 +34,10 @@ <chapter id="xml-primer"> <title>XML Primer - The majority of FDP documentation is written in applications - of XML. This chapter explains exactly what that means, how to - read and understand the source to the documentation, and the sort - of XML tricks you will see used in the documentation. + Most FDP documentation is written with markup languages based + on XML. This chapter explains what that means, how to + read and understand the documentation source, and the + XML techniques used. Portions of this section were inspired by Mark Galassi's Overview - Way back when, electronic text was simple to deal with. - Admittedly, you had to know which character set your document - was written in (ASCII, EBCDIC, or one of a number of others) but + In the original days of computers, electronic text was simple. + + There were a few character sets like ASCII or EBCDIC, but that was about it. Text was text, and what you saw really was what you got. No frills, no formatting, no intelligence. - Inevitably, this was not enough. Once you have text in a - machine-usable format, you expect machines to be able to use it - and manipulate it intelligently. You would like to indicate + Inevitably, this was not enough. When text is in a + machine-usable format, machines are expected to be able to use + and manipulate it intelligently. Authors want to indicate that certain phrases should be emphasized, or added to a - glossary, or be hyperlinks. You might want filenames to be + glossary, or made into hyperlinks. Filenames could be shown in a typewriter style font for viewing on screen, but as italics when printed, or any of a myriad of other options for presentation. It was once hoped that Artificial Intelligence (AI) would - make this easy. Your computer would read in the document and + make this easy. The computer would read the document and automatically identify key phrases, filenames, text that the reader should type in, examples, and more. Unfortunately, real - life has not happened quite like that, and our computers require - some assistance before they can meaningfully process our + life has not happened quite like that, and computers still require + assistance before they can meaningfully process text. More precisely, they need help identifying what is what. - Let's look at this text: + Consider this text:
To remove /tmp/foo use @@ -100,42 +100,40 @@ document must typically be done by a person—after all, if computers could recognize the text sufficiently well to add the markup then there would be no need to add it in the first place. - This increases the cost (i.e., the effort + This increases the cost (the effort required) to create the document. The previous example is actually represented in this document like this: - To remove /tmp/foo use &man.rm.1;. + paraTo remove filename/tmp/foofilename use &man.rm.1;.para -&prompt.user; rm /tmp/foo]]> +screen&prompt.user; userinputrm /tmp/foouserinputscreen - As you can see, the markup is clearly separate from the + The markup is clearly separate from the content. - Obviously, if you are going to use markup you need to define - what your markup means, and how it should be interpreted. You - will need a markup language that you can follow when marking up - your documents. + Markup languages define what + what the markup means and how it should be interpreted. Of course, one markup language might not be enough. A markup language for technical documentation has very different - requirements than a markup language that was to be used for + requirements than a markup language that is intended for cookery recipes. This, in turn, would be very different from a - markup language used to describe poetry. What you really need - is a first language that you use to write these other markup + markup language used to describe poetry. What is really needed + is a first language used to write these other markup languages. A meta markup language. This is exactly what the eXtensible Markup - Language (XML) is. Many markup languages have been written in - XML, including the two most used by the FDP, XHTML and + Language (XML) is. Many markup languages have been written in + XML, including the two most used by the FDP, XHTML and DocBook. Each language definition is more properly called a grammar, - vocabulary, schema or Document Type Definition (DTD). There - are various languages to specify an XML grammar, for example, - DTD (yes, it also means the specification language itself), - XML Schema (XSD) or RELANG NG. The schema specifies the name + vocabulary, schema or Document Type Definition (DTD). There + are various languages to specify an XML grammar, for example, + DTD (yes, it also means the specification language itself), + XML Schema (XSD) or RELANG NG. The schema specifies the name of the elements that can be used, what order they appear in (and whether some markup can be used inside other markup) and related information. @@ -144,7 +142,7 @@ complete specification of all the elements that are allowed to appear, the order in which they should appear, which elements are mandatory, which are optional, and so - forth. This makes it possible to write an XML + forth. This makes it possible to write an XML parser which reads in both the schema and a document which claims to conform to the schema. The parser can then confirm whether or not all the elements required by the vocabulary @@ -155,34 +153,34 @@ This processing simply confirms that the choice of elements, their ordering, and so on, conforms to that listed - in the grammar. It does not check that you - have used appropriate markup for the - content. If you tried to mark up all the filenames in your - document as function names, the parser would not flag this as - an error (assuming, of course, that your schema defines elements + in the grammar. It does not check whether + appropriate markup has been used for the + content. If all the filenames in a + document were marked up as function names, the parser would not flag this as + an error (assuming, of course, that the schema defines elements for filenames and functions, and that they are allowed to appear in the same place). - It is likely that most of your contributions to the - Documentation Project will consist of content marked up in - either XHTML or DocBook, rather than alterations to the schemas. - For this reason this book will not touch on how to write a + It is likely that most contributions to the + Documentation Project will be content marked up in + either XHTML or DocBook, rather than alterations to the schemas. + For this reason, this book will not touch on how to write a vocabulary. Elements, Tags, and Attributes - All the vocabularies written in XML share certain characteristics. - This is hardly surprising, as the philosophy behind XML will + All the vocabularies written in XML share certain characteristics. + This is hardly surprising, as the philosophy behind XML will inevitably show through. One of the most obvious manifestations of this philosophy is that of content and elements. - Your documentation (whether it is a single web page, or a - lengthy book) is considered to consist of content. This content - is then divided (and further subdivided) into elements. The + Documentation, whether it is a single web page, or a + lengthy book, is considered to consist of content. This content + is then divided and further subdivided into elements. The purpose of adding markup is to name and identify the boundaries of these elements for further processing. @@ -195,21 +193,21 @@ that was direct speech, or the name of a character in the story. - You might like to think of this as chunking - content. At the very top level you have one chunk, the book. - Look a little deeper, and you have more chunks, the individual + It may be helpful to think of this as chunking + content. At the very top level is one chunk, the book. + Look a little deeper, and there are more chunks, the individual chapters. These are chunked further into paragraphs, footnotes, character names, and so on. - Notice how you can make this differentiation between - different elements of the content without resorting to any XML - terms. It really is surprisingly straightforward. You could do - this with a highlighter pen and a printout of the book, using + Notice how this differentiation between + different elements of the content can be made without resorting to any XML + terms. It really is surprisingly straightforward. This could be done + with a highlighter pen and a printout of the book, using different colors to indicate different chunks of content. Of course, we do not have an electronic highlighter pen, so we need some other way of indicating which element each piece of - content belongs to. In languages written in XML (XHTML, + content belongs to. In languages written in XML (XHTML, DocBook, et al) this is done by means of tags. @@ -223,59 +221,54 @@ For an element called element-name the start tag will normally look like - element-name. The + element-name. The corresponding closing tag for this element is - /element-name. + element-name. Using an Element (Start and End Tags) - XHTML has an element for indicating that the content + XHTML has an element for indicating that the content enclosed by the element is a paragraph, called p. - This is a paragraph. It starts with the start tag for + pThis is a paragraph. It starts with the start tag for the 'p' element, and it will end with the end tag for the 'p' - element.
+ element.p -
This is another paragraph. But this one is much shorter.
]]> +pThis is another paragraph. But this one is much shorter.p Some elements have no - content. For example, in XHTML you can indicate that you want a - horizontal line to appear in the document. - - For such elements, that have no content at all, XML introduced - a shorthand form, which is ccompletely equivalent to the above - form: - - ]]> + content. For example, in XHTML, a + horizontal line can be included in the document. + For these empty elements, XML introduced + a shorthand form that is completely equivalent to the two-tag + version: - Using an Element (Without Content) + Using an Element Without Content - XHTML has an element for indicating a horizontal rule, + XHTML has an element for indicating a horizontal rule, called hr. This element does not wrap - content, so it looks like this. + content, so it looks like this: - One paragraph.
-
+ pOne paragraph.p +hrhr -
This is another paragraph. A horizontal rule separates this - from the previous paragraph.
]]> +pThis is another paragraph. A horizontal rule separates this + from the previous paragraph.p - For such elements, that have no content at all, XML introduced - a shorthand form, which is ccompletely equivalent to the above - form: + The shorthand version consists of a single tag: - One paragraph.
-
+ pOne paragraph.p +hr -
This is another paragraph. A horizontal rule separates this - from the previous paragraph.
]]> +pThis is another paragraph. A horizontal rule separates this + from the previous paragraph.p - If it is not obvious by now, elements can contain other + As shown above, elements can contain other elements. In the book example earlier, the book element contained all the chapter elements, which in turn contained all the paragraph elements, and so on. @@ -283,11 +276,11 @@ Elements within Elements; <sgmltag>em</sgmltag> - This is a simple paragraph where some - of the words have been emphasized.
]]> + pThis is a simple emparagraphem where some + of the emwordsem have been ememphasizedem.p - The grammar will specify the rules detailing which elements can + The grammar consists of rules that describe which elements can contain other elements, and exactly what they can contain. @@ -298,10 +291,10 @@ An element is a conceptual part of your document. An element has a defined start and end. The tags mark where the - element starts and end. + element starts and ends. When this document (or anyone else knowledgeable about - XML) refers to the p tag + XML) refers to the p tag they mean the literal text consisting of the three characters <, p, and >. But the phrase the @@ -323,13 +316,13 @@ take the form attribute-name="attribute-value". - In XHTML, the + In XHTML, the p element has an attribute called - align, which suggests an alignment + align, which suggests an alignment (justification) for the paragraph to the program displaying the - XHTML. + XHTML. - The align attribute can take one of four + The align attribute can take one of four defined values, left, center, right and justify. If the attribute is not specified @@ -338,59 +331,57 @@ Using An Element with An Attribute - The inclusion of the align attribute - on this paragraph was superfluous, since the default is left.
+ p align="left"The inclusion of the align attribute + on this paragraph was superfluous, since the default is left.p -
This may appear in the center.
]]> +p align="center"This may appear in the center.p - Some attributes will only take specific values, such as + Some attributes only take specific values, such as left or justify. Others - will allow you to enter anything you want. + allow any value. Single Quotes Around Attributes - I am on the right!
]]> + p align='right'I am on the right!p - XML requires you to quote each attribute value with either - single or double quotes. It is more habitual to use double quotes - but you may use single quotes, as well. Using single quotes is - practical if you want to include double quotes in the attribute - value. - - The information on attributes, elements, and tags is stored - in XML catalogs. The various Documentation Project tools use - these catalog files to validate your work. The tools in - textproc/docproj include a - variety of XML catalog files. The FreeBSD Documentation - Project includes its own set of catalog files. Your tools need - to know about both sorts of catalog files. + Attribute values in XML must be enclosed + in either single or double quotes. Double quotes are + traditional. Single quotes are useful when the attribute + value contains double quotes. + + Information about attributes, elements, and tags is stored + in catalog files. The Documentation Project uses standard + DocBook catalogs and includes additional catalogs for + &os;-specific features. Paths to the catalog files are defined + in an environment variable so they can be found by the document + build tools. - For You to Do… + To Do… - In order to run the examples in this document you will - need to install some software on your system and ensure that - an environment variable is set correctly. + Before running the examples in this document, + application software must be installed and the catalog + environment variable configured. - Download and install + Install textproc/docproj from - the FreeBSD ports system. This is a - meta-port that should download and - install all of the programs and supporting files that are - used by the Documentation Project. + the &os; Ports Collection. This is a + meta-port that downloads and + installs the standard programs and supporting files needed + by the Documentation Project. - Add lines to your shell startup files to set - SGML_CATALOG_FILES. (If you are not working - on the English version of the documentation, you will want - to substitute the correct directory for your - language.) + Add lines to the shell startup files to set + SGML_CATALOG_FILES. When working on non-English + versions of the documentation, replace + en_US.ISO8859-1 with the appropriate directory for the + target language. <filename>.profile</filename>, for &man.sh.1; and @@ -402,7 +393,7 @@ SGML_CATALOG_FILES=${SGML_ROOT}/docbook/ SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES SGML_CATALOG_FILES=/usr/doc/share/xml/catalog:$SGML_CATALOG_FILES -SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES +SGML_CATALOG_FILES=/usr/doc/<replaceable>en_US.ISO8859-1</replaceable>/share/xml/catalog:$SGML_CATALOG_FILES export SGML_CATALOG_FILES</programlisting> </example> @@ -416,11 +407,11 @@ setenv SGML_CATALOG_FILES ${SGML_ROOT}/d setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES setenv SGML_CATALOG_FILES /usr/doc/share/xml/catalog:$SGML_CATALOG_FILES -setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES</programlisting> +setenv SGML_CATALOG_FILES /usr/doc/<replaceable>en_US.ISO8859-1</replaceable>/share/xml/catalog:$SGML_CATALOG_FILES</programlisting> </example> - <para>Then either log out, and log back in again, or run - those commands from the command line to set the variable + <para>After making these changes, either log out and log back in again, or run + the commands from the command line to set the variable values.</para> </step> </procedure> @@ -428,67 +419,65 @@ setenv SGML_CATALOG_FILES /usr/doc/en_US <procedure> <step> <para>Create <filename>example.xml</filename>, and enter - the following text:</para> + this text:</para> - <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + <programlisting><sgmltag class="starttag">!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"</sgmltag> -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <title>An Example XHTML File - +html xmlns="http://www.w3.org/1999/xhtml" + head + titleAn Example XHTML Filetitle + head - -
This is a paragraph containing some text.
+ body + pThis is a paragraph containing some text.p -
This paragraph contains some more text.
+ pThis paragraph contains some more text.p -
This paragraph might be right-justified.
- -]]> + p align="right"This paragraph might be right-justified.p + body +html - Try to validate this file using an XML parser. + Try to validate this file using an XML parser. - Part of - textproc/docproj is + textproc/docproj includes the xmllint validating parser. - Use xmllint in the following way to - check that your document is valid: + Use xmllint to + validate the document: &prompt.user; xmllint --valid --noout example.xml - As you will see, xmllint returns - without displaying any output. This means that your + xmllint returns + without displaying any output, showing that the document validated successfully. See what happens when required elements are omitted. - Try removing the title and - /title tags, and re-run the + Delete the line with the title and + /title tags, and re-run the validation. &prompt.user; xmllint --valid --noout example.xml example.xml:5: element head: validity error : Element head content does not follow the DTD, expecting ((script | style | meta | link | object | isindex)* , ((title , (script | style | meta | link | object | isindex)* , (base , (script | style | meta | link | object | isindex))?) | (base , (script | style | meta | link | object | isindex) , title , (script | style | meta | link | object | isindex)))), got () - This line tells you that the validation error comes from + This shows that the validation error comes from the fifth line of the example.xml file and that the - content of the head is the part, which - does not follow the rules described by the XHTML grammar. + content of the head is the part which + does not follow the rules of the XHTML grammar. - Below this line xmllint will show you - the line where the error has been found and will also mark the - exact character position with a ^ sign. + Then xmllint shows + the line where the error was found and marks the + exact character position with a ^ sign. - Put the title element back - in. + Replace the title element. @@ -497,17 +486,15 @@ example.xml:5: element head: validity er The DOCTYPE Declaration - The beginning of each document that you write may specify - the name of the DTD that the document conforms to in case you use - the DTD specification language. Other specification languages, like - XML Schema and RELAX NG are not referred in the source document. - This DOCTYPE declaration serves the XML parsers so that they can - determine the DTD and ensure that the document does conform to it. + The beginning of each document can specify + the name of the DTD to which the document conforms. + This DOCTYPE declaration is used by XML parsers to + identify the DTD and ensure that the document does conform to it. A typical declaration for a document written to conform with - version 1.0 of the XHTML DTD looks like this: + version 1.0 of the XHTML DTD looks like this: - ]]> + !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" That line contains a number of different components. @@ -516,9 +503,8 @@ example.xml:5: element head: validity er <! - Is the indicator that indicates - that this is an XML declaration. This line is declaring - the document type. + The indicator shows + this is an XML declaration. @@ -526,7 +512,7 @@ example.xml:5: element head: validity er DOCTYPE - Shows that this is an XML declaration for the + Shows that this is an XML declaration of the document type. @@ -545,18 +531,18 @@ example.xml:5: element head: validity er PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" - Lists the Formal Public Identifier (FPI) + Lists the Formal Public Identifier (FPI) Formal Public Identifier - for the DTD that this document conforms to. Your XML - parser will use this to find the correct DTD when + for the DTD to which this document conforms. The XML + parser uses this to find the correct DTD when processing this document. - PUBLIC is not a part of the FPI, - but indicates to the XML processor how to find the DTD - referenced in the FPI. Other ways of telling the XML - parser how to find the DTD are shown PUBLIC is not a part of the FPI, + but indicates to the XML processor how to find the DTD + referenced in the FPI. Other ways of telling the XML + parser how to find the DTD are shown later. @@ -565,7 +551,7 @@ example.xml:5: element head: validity er "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" - A local filename or an URL to find the DTD. + A local filename or a URL to find the DTD. @@ -573,25 +559,24 @@ example.xml:5: element head: validity er > - Returns to the document. + Ends the declaration and returns to the document. - Formal Public Identifiers (FPIs) + <title>Formal Public Identifiers (<acronym>FPI</acronym>s) <indexterm significance="preferred"> <primary>Formal Public Identifier</primary> </indexterm> - You do not need to know this, but it is useful - background, and might help you debug problems when your XML - processor can not locate the DTD you are using. + It is not necessary to know this, but it is useful + background, and might help debug problems when the XML + processor can not locate the DTD. - FPIs must follow a specific syntax. This syntax is as - follows: + FPIs must follow a specific syntax: "Owner//Keyword Description//Language" @@ -600,16 +585,16 @@ example.xml:5: element head: validity er Owner - This indicates the owner of the FPI. + The owner of the FPI. - If this string starts with ISO then - this is an ISO owned FPI. For example, the FPI + The beginning of the string identifies the owner + of the FPI. For example, the FPI "ISO 8879:1986//ENTITIES Greek Symbols//EN" lists ISO 8879:1986 as being the owner for - the set of entities for Greek symbols. ISO 8879:1986 is - the ISO number for the SGML standard, the predecessor - (and a superset) of XML. + the set of entities for Greek symbols. ISO 8879:1986 is + the International Organization for Standardization (ISO) number for the SGML standard, the predecessor + (and a superset) of XML. Otherwise, this string will either look like -//Owner @@ -620,21 +605,21 @@ example.xml:5: element head: validity er If the string starts with - then the owner information is unregistered, with a - + it identifies it as being + + identifying it as registered. - ISO 9070:1991 defines how registered names are - generated; it might be derived from the number of an ISO - publication, an ISBN code, or an organization code - assigned according to ISO 6523. In addition, a + ISO 9070:1991 defines how registered names are + generated. It might be derived from the number of an ISO + publication, an ISBN code, or an organization code + assigned according to ISO 6523. Additionally, a registration authority could be created in order to - assign registered names. The ISO council delegated this + assign registered names. The ISO council delegated this to the American National Standards Institute - (ANSI). + (ANSI). - Because the FreeBSD Project has not been registered - the owner string is -//FreeBSD. And - as you can see, the W3C are not a registered owner + Because the &os; Project has not been registered, + the owner string is -//&os;. As + seen in the example, the W3C are not a registered owner either. @@ -648,10 +633,10 @@ example.xml:5: element head: validity er keywords are DTD, ELEMENT, ENTITIES, and TEXT. DTD is - used only for DTD files, ELEMENT is - usually used for DTD fragments that contain only entity + used only for DTD files, ELEMENT is + usually used for DTD fragments that contain only entity or element declarations. TEXT is - used for XML content (text and tags). + used for XML content (text and tags). @@ -659,10 +644,10 @@ example.xml:5: element head: validity er Description - Any description you want to supply for the contents + Any description can be given for the contents of this file. This may include version numbers or any - short text that is meaningful to you and unique for the - XML system. + short text that is meaningful and unique for the + XML system. @@ -670,7 +655,7 @@ example.xml:5: element head: validity er Language - This is an ISO two-character code that identifies + An ISO two-character code that identifies the native language for the file. EN is used for English. @@ -680,48 +665,45 @@ example.xml:5: element head: validity er <filename>catalog</filename> Files - If you use the syntax above and process this document - using an XML processor, the processor will need to have - some way of turning the FPI into the name of the file on - your computer that contains the DTD. - - In order to do this it can use a catalog file. A + With the syntax above, + an XML processor needs to have + some way of turning the FPI into the name of the file + containing the DTD. A catalog file (typically called catalog) - contains lines that map FPIs to filenames. For example, if + contains lines that map FPIs to filenames. For example, if the catalog file contained the line: PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "1.0/transitional.dtd" - The XML processor would know to look up the DTD from - transitional.dtd in the - 1.0 subdirectory of whichever directory - held the catalog file that contained - that line. + The XML processor knows that the DTD is + called transitional.dtd in the + 1.0 subdirectory of the directory that + held the catalog file. - Look at the contents of + Examine the contents of /usr/local/share/xml/dtd/xhtml/catalog.xml. - This is the catalog file for the XHTML DTDs that will have - been installed as part of the XHTML DTDs that was + installed as part of the textproc/docproj port. <envar>SGML_CATALOG_FILES</envar> - In order to locate a catalog file, - your XML processor will need to know where to look. Many - of them feature command line parameters for specifying the + To locate a catalog file, + the XML processor must know where to look. Many + feature command line parameters for specifying the path to one or more catalogs. - In addition, you can set - SGML_CATALOG_FILES to point to the files. - This environment variable should consist of a + In addition, + SGML_CATALOG_FILES can be set to point to the files. + This environment variable consists of a colon-separated list of catalog files (including their full path). - Typically, you will want to include the following + Typically, the list includes these files: @@ -742,33 +724,30 @@ example.xml:5: element head: validity er - You should already - have done this. + This was done earlier. - Alternatives to FPIs + Alternatives to <acronym>FPI</acronym>s - Instead of using an FPI to indicate the DTD that the - document conforms to (and therefore, which file on the system - contains the DTD) you can explicitly specify the name of the - file. + Instead of using an FPI to indicate the DTD to which + the document conforms (and therefore, which file on the system + contains the DTD), the filename can be explicitly specified. - The syntax for this is slightly different: + The syntax is slightly different: - ]]> + !DOCTYPE html SYSTEM "/path/to/file.dtd" The SYSTEM keyword indicates that the - XML processor should locate the DTD in a system specific - fashion. This typically (but not always) means the DTD will + XML processor should locate the DTD in a system specific + fashion. This typically (but not always) means the DTD will be provided as a filename. - Using FPIs is preferred for reasons of portability. You - do not want to have to ship a copy of the DTD around with your - document, and if you used the SYSTEM - identifier then everyone would need to keep their DTDs in the - same place. + Using FPIs is preferred for reasons of portability. + If the SYSTEM + identifier is used, then the DTD must be provided and kept in the same location + for everyone. From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 03:52:31 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id E82C2BC0; Fri, 12 Jul 2013 03:52:31 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id DA6301780; Fri, 12 Jul 2013 03:52:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C3qVPU043375; Fri, 12 Jul 2013 03:52:31 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C3qVKu043374; Fri, 12 Jul 2013 03:52:31 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307120352.r6C3qVKu043374@svn.freebsd.org> From: Warren Block Date: Fri, 12 Jul 2013 03:52:31 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42258 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 03:52:32 -0000 Author: wblock Date: Fri Jul 12 03:52:31 2013 New Revision: 42258 URL: http://svnweb.freebsd.org/changeset/doc/42258 Log: Improve the clarity of the email examples and add a guibutton example. Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Fri Jul 12 03:21:55 2013 (r42257) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Fri Jul 12 03:52:31 2013 (r42258) @@ -1572,8 +1572,8 @@ This is the file called 'foo2' Email Addresses - Email addresses are marked up with - email tags. In the HTML + Email addresses are marked up as + email elements. In the HTML output format, the wrapped text becomes a hyperlink to the email address. Other output formats that support hyperlinks may also make the email address into a link. @@ -1583,13 +1583,15 @@ This is the file called 'foo2' Usage: - paraQuestions about &os; may be sent to - emailquestions@&os;.orgemail.para + paraAn email address that does not actually exist, like + emailnotreal@example.comemail, can be used as an + example.para Appearance: - Questions about &os; may be sent to - questions@&os;.org. + An email address that does not actually exist, like + notreal@example.com, can be used as an + example. A &os;-specific extension allows setting the @@ -1602,13 +1604,15 @@ This is the file called 'foo2' Usage: - paraQuestions about &os; may be sent to - email role="nolink"questions@&os;.orgemail.para + paraSometimes a link to an email address like + email role="nolink"notreal@example.comemail is not + desired.para Appearance: - Questions about &os; may be sent to - questions@&os;.org. + Sometimes a link to an email address like + notreal@example.com is not + desired. @@ -1767,6 +1771,31 @@ This is the file called 'foo2' + + Showing <acronym>GUI</acronym> Buttons + + Buttons presented by a graphical user interface are marked + with guibutton. To make the text look more + like a graphical button, brackets and non-breaking spaces are + added surrounding the text. + + + <sgmltag>guibutton</sgmltag> + + Usage: + + paraEdit the file, then click + guibutton[ Save ]guibutton to save the + changes.para + + Appearance: + + Edit the file, then click + [ Save ] to save the + changes. + + + Quoting System Errors From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 04:05:39 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A1F0CD5; Fri, 12 Jul 2013 04:05:39 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 846B41853; Fri, 12 Jul 2013 04:05:39 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C45dX4047082; Fri, 12 Jul 2013 04:05:39 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C45d4B047081; Fri, 12 Jul 2013 04:05:39 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307120405.r6C45d4B047081@svn.freebsd.org> From: Warren Block Date: Fri, 12 Jul 2013 04:05:39 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42259 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 04:05:39 -0000 Author: wblock Date: Fri Jul 12 04:05:39 2013 New Revision: 42259 URL: http://svnweb.freebsd.org/changeset/doc/42259 Log: Fix title capitalization and indexterm. Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 03:52:31 2013 (r42258) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 04:05:39 2013 (r42259) @@ -113,7 +113,7 @@ The markup is clearly separate from the content. - Markup languages define what + Markup languages define what the markup means and how it should be interpreted. Of course, one markup language might not be enough. A @@ -274,7 +274,7 @@ the paragraph elements, and so on. - Elements within Elements; <sgmltag>em</sgmltag> + Elements Within Elements; <sgmltag>em</sgmltag> pThis is a simple emparagraphem where some of the emwordsem have been ememphasizedem.p @@ -329,7 +329,7 @@ then the default is left. - Using An Element with An Attribute + Using an Element with an Attribute p align="left"The inclusion of the align attribute on this paragraph was superfluous, since the default is left.p @@ -565,10 +565,10 @@ example.xml:5: element head: validity er - Formal Public Identifiers (<acronym>FPI</acronym>s) - <indexterm significance="preferred"> - <primary>Formal Public Identifier</primary> - </indexterm> + Formal Public Identifiers (<acronym>FPI</acronym>s) + + Formal Public Identifier + It is not necessary to know this, but it is useful @@ -1305,7 +1305,7 @@ example.xml:5: element head: validity er termed marked sections. - Structure of A Marked Section + Structure of a Marked Section <![KEYWORD[ Contents of marked section @@ -1456,7 +1456,7 @@ example.xml:5: element head: validity er ignored and the second one will take effect. - Using A Parameter Entity to Control a Marked + <title>Using a Parameter Entity to Control a Marked Section From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 04:33:44 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 5C73F4A9; Fri, 12 Jul 2013 04:33:44 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 4DD4018F8; Fri, 12 Jul 2013 04:33:44 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C4XixV055698; Fri, 12 Jul 2013 04:33:44 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C4XilV055697; Fri, 12 Jul 2013 04:33:44 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307120433.r6C4XilV055697@svn.freebsd.org> From: Warren Block Date: Fri, 12 Jul 2013 04:33:44 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42260 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 04:33:44 -0000 Author: wblock Date: Fri Jul 12 04:33:43 2013 New Revision: 42260 URL: http://svnweb.freebsd.org/changeset/doc/42260 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 04:05:39 2013 (r42259) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 04:33:43 2013 (r42260) @@ -35,8 +35,8 @@ XML Primer Most FDP documentation is written with markup languages based - on XML. This chapter explains what that means, how to - read and understand the documentation source, and the + on XML. This chapter explains what that means, + how to read and understand the documentation source, and the XML techniques used. Portions of this section were inspired by Mark Galassi's @@ -47,27 +47,27 @@ Overview - In the original days of computers, electronic text was simple. - - There were a few character sets like ASCII or EBCDIC, but - that was about it. Text was text, and what you saw really was - what you got. No frills, no formatting, no intelligence. + In the original days of computers, electronic text was + simple. There were a few character sets like + ASCII or EBCDIC, but that + was about it. Text was text, and what you saw really was what + you got. No frills, no formatting, no intelligence. Inevitably, this was not enough. When text is in a machine-usable format, machines are expected to be able to use - and manipulate it intelligently. Authors want to indicate - that certain phrases should be emphasized, or added to a - glossary, or made into hyperlinks. Filenames could be - shown in a typewriter style font for viewing on - screen, but as italics when printed, or any of a - myriad of other options for presentation. + and manipulate it intelligently. Authors want to indicate that + certain phrases should be emphasized, or added to a glossary, or + made into hyperlinks. Filenames could be shown in a + typewriter style font for viewing on screen, but + as italics when printed, or any of a myriad of + other options for presentation. It was once hoped that Artificial Intelligence (AI) would make this easy. The computer would read the document and automatically identify key phrases, filenames, text that the reader should type in, examples, and more. Unfortunately, real - life has not happened quite like that, and computers still require - assistance before they can meaningfully process + life has not happened quite like that, and computers still + require assistance before they can meaningfully process text. More precisely, they need help identifying what is what. @@ -95,13 +95,14 @@ the markup from the user, so the user is not distracted by it. - The extra information stored in the markup adds - value to the document. Adding the markup to the - document must typically be done by a person—after all, if - computers could recognize the text sufficiently well to add the - markup then there would be no need to add it in the first place. - This increases the cost (the effort - required) to create the document. + The extra information stored in the markup + adds value to the document. Adding the + markup to the document must typically be done by a + person—after all, if computers could recognize the text + sufficiently well to add the markup then there would be no need + to add it in the first place. This + increases the cost (the effort required) to + create the document. The previous example is actually represented in this document like this: @@ -110,79 +111,83 @@ screen&prompt.user; userinputrm /tmp/foouserinputscreen - The markup is clearly separate from the - content. + The markup is clearly separate from the content. - Markup languages define - what the markup means and how it should be interpreted. + Markup languages define what the markup means and how it + should be interpreted. Of course, one markup language might not be enough. A markup language for technical documentation has very different - requirements than a markup language that is intended for - cookery recipes. This, in turn, would be very different from a - markup language used to describe poetry. What is really needed - is a first language used to write these other markup - languages. A meta markup language. + requirements than a markup language that is intended for cookery + recipes. This, in turn, would be very different from a markup + language used to describe poetry. What is really needed is a + first language used to write these other markup languages. A + meta markup language. This is exactly what the eXtensible Markup - Language (XML) is. Many markup languages have been written in - XML, including the two most used by the FDP, XHTML and - DocBook. + Language (XML) is. Many markup languages + have been written in XML, including the two + most used by the FDP, + XHTML and DocBook. Each language definition is more properly called a grammar, - vocabulary, schema or Document Type Definition (DTD). There - are various languages to specify an XML grammar, for example, - DTD (yes, it also means the specification language itself), - XML Schema (XSD) or RELANG NG. The schema specifies the name - of the elements that can be used, what order they appear in (and - whether some markup can be used inside other markup) and related - information. + vocabulary, schema or Document Type Definition + (DTD). There are various languages to + specify an XML grammar, for example, + DTD (yes, it also means the specification + language itself), XML Schema + (XSD) or RELANG NG. The + schema specifies the name of the elements that can be used, what + order they appear in (and whether some markup can be used inside + other markup) and related information. A schema is a complete specification of all the elements that are allowed to appear, the order in which they should appear, which elements are mandatory, which are optional, and so - forth. This makes it possible to write an XML - parser which reads in both the schema and a - document which claims to conform to the schema. The parser can - then confirm whether or not all the elements required by the vocabulary - are in the document in the right order, and whether there are - any errors in the markup. This is normally referred to as + forth. This makes it possible to write an + XML parser which reads + in both the schema and a document which claims to conform to the + schema. The parser can then confirm whether or not all the + elements required by the vocabulary are in the document in the + right order, and whether there are any errors in the markup. + This is normally referred to as validating the document. This processing simply confirms that the choice of elements, their ordering, and so on, conforms to that listed - in the grammar. It does not check whether - appropriate markup has been used for the - content. If all the filenames in a - document were marked up as function names, the parser would not flag this as - an error (assuming, of course, that the schema defines elements - for filenames and functions, and that they are allowed to - appear in the same place). + in the grammar. It does not check + whether appropriate markup has been used + for the content. If all the filenames in a document were + marked up as function names, the parser would not flag this as + an error (assuming, of course, that the schema defines + elements for filenames and functions, and that they are + allowed to appear in the same place). - It is likely that most contributions to the - Documentation Project will be content marked up in - either XHTML or DocBook, rather than alterations to the schemas. - For this reason, this book will not touch on how to write a - vocabulary. + It is likely that most contributions to the Documentation + Project will be content marked up in either + XHTML or DocBook, rather than alterations to + the schemas. For this reason, this book will not touch on how + to write a vocabulary. Elements, Tags, and Attributes - All the vocabularies written in XML share certain characteristics. - This is hardly surprising, as the philosophy behind XML will - inevitably show through. One of the most obvious manifestations - of this philosophy is that of content and + All the vocabularies written in XML share + certain characteristics. This is hardly surprising, as the + philosophy behind XML will inevitably show + through. One of the most obvious manifestations of this + philosophy is that of content and elements. - Documentation, whether it is a single web page, or a - lengthy book, is considered to consist of content. This content - is then divided and further subdivided into elements. The - purpose of adding markup is to name and identify the boundaries - of these elements for further processing. + Documentation, whether it is a single web page, or a lengthy + book, is considered to consist of content. This content is then + divided and further subdivided into elements. The purpose of + adding markup is to name and identify the boundaries of these + elements for further processing. For example, consider a typical book. At the very top level, the book is itself an element. This book @@ -193,44 +198,45 @@ that was direct speech, or the name of a character in the story. - It may be helpful to think of this as chunking - content. At the very top level is one chunk, the book. - Look a little deeper, and there are more chunks, the individual - chapters. These are chunked further into paragraphs, footnotes, - character names, and so on. - - Notice how this differentiation between - different elements of the content can be made without resorting to any XML - terms. It really is surprisingly straightforward. This could be done - with a highlighter pen and a printout of the book, using - different colors to indicate different chunks of content. + It may be helpful to think of this as + chunking content. At the very top level is one + chunk, the book. Look a little deeper, and there are more + chunks, the individual chapters. These are chunked further into + paragraphs, footnotes, character names, and so on. + + Notice how this differentiation between different elements + of the content can be made without resorting to any + XML terms. It really is surprisingly + straightforward. This could be done with a highlighter pen and + a printout of the book, using different colors to indicate + different chunks of content. Of course, we do not have an electronic highlighter pen, so we need some other way of indicating which element each piece of - content belongs to. In languages written in XML (XHTML, - DocBook, et al) this is done by means of - tags. + content belongs to. In languages written in + XML (XHTML, DocBook, et + al) this is done by means of tags. A tag is used to identify where a particular element starts, and where the element ends. The tag is not part of - the element itself. Because each grammar was normally - written to mark up specific types of information, each one will - recognize different elements, and will therefore have different - names for the tags. + the element itself. Because each grammar was + normally written to mark up specific types of information, each + one will recognize different elements, and will therefore have + different names for the tags. For an element called element-name the start tag will - normally look like - element-name. The - corresponding closing tag for this element is - element-name. + normally look like element-name. + The corresponding closing tag for this element is element-name. Using an Element (Start and End Tags) - XHTML has an element for indicating that the content - enclosed by the element is a paragraph, called - p. + XHTML has an element for indicating + that the content enclosed by the element is a paragraph, + called p. pThis is a paragraph. It starts with the start tag for the 'p' element, and it will end with the end tag for the 'p' @@ -239,19 +245,18 @@ pThis is another paragraph. But this one is much shorter.p - Some elements have no - content. For example, in XHTML, a - horizontal line can be included in the document. - For these empty elements, XML introduced - a shorthand form that is completely equivalent to the two-tag - version: + Some elements have no content. For example, in + XHTML, a horizontal line can be included in + the document. For these empty elements, + XML introduced a shorthand form that is + completely equivalent to the two-tag version: Using an Element Without Content - XHTML has an element for indicating a horizontal rule, - called hr. This element does not wrap - content, so it looks like this: + XHTML has an element for indicating a + horizontal rule, called hr. This element + does not wrap content, so it looks like this: pOne paragraph.p hrhr @@ -268,10 +273,10 @@ from the previous paragraph.p - As shown above, elements can contain other - elements. In the book example earlier, the book element - contained all the chapter elements, which in turn contained all - the paragraph elements, and so on. + As shown above, elements can contain other elements. In the + book example earlier, the book element contained all the chapter + elements, which in turn contained all the paragraph elements, + and so on. Elements Within Elements; <sgmltag>em</sgmltag> @@ -280,8 +285,8 @@ of the emwordsem have been ememphasizedem.p - The grammar consists of rules that describe which elements can - contain other elements, and exactly what they can + The grammar consists of rules that describe which elements + can contain other elements, and exactly what they can contain. @@ -294,12 +299,13 @@ element starts and ends. When this document (or anyone else knowledgeable about - XML) refers to the p tag + XML) refers to + the p tag they mean the literal text consisting of the three characters <, p, and - >. But the phrase the - p element refers to the whole - element. + >. But the phrase + the p element refers to the + whole element. This distinction is very subtle. But keep it in mind. @@ -316,14 +322,14 @@ take the form attribute-name="attribute-value". - In XHTML, the - p element has an attribute called - align, which suggests an alignment - (justification) for the paragraph to the program displaying the - XHTML. + In XHTML, the p + element has an attribute called + align, which suggests an + alignment (justification) for the paragraph to the program + displaying the XHTML. - The align attribute can take one of four - defined values, left, + The align attribute can + take one of four defined values, left, center, right and justify. If the attribute is not specified then the default is left. @@ -349,8 +355,8 @@ Attribute values in XML must be enclosed in either single or double quotes. Double quotes are - traditional. Single quotes are useful when the attribute - value contains double quotes. + traditional. Single quotes are useful when the attribute value + contains double quotes. Information about attributes, elements, and tags is stored in catalog files. The Documentation Project uses standard @@ -371,17 +377,17 @@ Install textproc/docproj from the &os; Ports Collection. This is a - meta-port that downloads and - installs the standard programs and supporting files needed - by the Documentation Project. + meta-port that downloads and installs + the standard programs and supporting files needed by the + Documentation Project. Add lines to the shell startup files to set - SGML_CATALOG_FILES. When working on non-English - versions of the documentation, replace - en_US.ISO8859-1 with the appropriate directory for the - target language. + SGML_CATALOG_FILES. When working on + non-English versions of the documentation, replace + en_US.ISO8859-1 with the + appropriate directory for the target language. <filename>.profile</filename>, for &man.sh.1; and @@ -410,9 +416,9 @@ setenv SGML_CATALOG_FILES /usr/doc/share setenv SGML_CATALOG_FILES /usr/doc/<replaceable>en_US.ISO8859-1</replaceable>/share/xml/catalog:$SGML_CATALOG_FILES</programlisting> </example> - <para>After making these changes, either log out and log back in again, or run - the commands from the command line to set the variable - values.</para> + <para>After making these changes, either log out and log + back in again, or run the commands from the command line + to set the variable values.</para> </step> </procedure> @@ -439,41 +445,44 @@ setenv SGML_CATALOG_FILES /usr/doc/<repl </step> <step> - <para>Try to validate this file using an <acronym>XML</acronym> parser.</para> + <para>Try to validate this file using an + <acronym>XML</acronym> parser.</para> - <para><filename role="package">textproc/docproj</filename> includes - the <command>xmllint</command> + <para><filename role="package">textproc/docproj</filename> + includes the <command>xmllint</command> <link linkend="xml-primer-validating">validating parser</link>.</para> - <para>Use <command>xmllint</command> to - validate the document:</para> + <para>Use <command>xmllint</command> to validate the + document:</para> <screen>&prompt.user; <userinput>xmllint --valid --noout example.xml</userinput></screen> - <para><command>xmllint</command> returns - without displaying any output, showing that the - document validated successfully.</para> + <para><command>xmllint</command> returns without displaying + any output, showing that the document validated + successfully.</para> </step> <step> <para>See what happens when required elements are omitted. - Delete the line with the <sgmltag class="starttag">title</sgmltag> and - <sgmltag class="endtag">/title</sgmltag> tags, and re-run the - validation.</para> + Delete the line with the + <sgmltag class="starttag">title</sgmltag> and + <sgmltag class="endtag">/title</sgmltag> tags, and re-run + the validation.</para> <screen>&prompt.user; <userinput>xmllint --valid --noout example.xml</userinput> example.xml:5: element head: validity error : Element head content does not follow the DTD, expecting ((script | style | meta | link | object | isindex) , ((title , (script | style | meta | link | object | isindex)* , (base , (script | style | meta | link | object | isindex))?) | (base , (script | style | meta | link | object | isindex) , title , (script | style | meta | link | object | isindex)))), got ()</screen> - <para>This shows that the validation error comes from - the <replaceable>fifth</replaceable> line of the + <para>This shows that the validation error comes from the + <replaceable>fifth</replaceable> line of the <replaceable>example.xml</replaceable> file and that the - content of the <sgmltag class="starttag">head</sgmltag> is the part which - does not follow the rules of the <acronym>XHTML</acronym> grammar.</para> - - <para>Then <command>xmllint</command> shows - the line where the error was found and marks the - exact character position with a <literal>^</literal> sign.</para> + content of the <sgmltag class="starttag">head</sgmltag> is + the part which does not follow the rules of the + <acronym>XHTML</acronym> grammar.</para> + + <para>Then <command>xmllint</command> shows the line where + the error was found and marks the exact character position + with a <literal>^</literal> sign.</para> </step> <step> @@ -486,13 +495,15 @@ example.xml:5: element head: validity er <sect1 id="xml-primer-doctype-declaration"> <title>The DOCTYPE Declaration - The beginning of each document can specify - the name of the DTD to which the document conforms. - This DOCTYPE declaration is used by XML parsers to - identify the DTD and ensure that the document does conform to it. + The beginning of each document can specify the name of the + DTD to which the document conforms. This + DOCTYPE declaration is used by XML parsers to + identify the DTD and ensure that the document + does conform to it. A typical declaration for a document written to conform with - version 1.0 of the XHTML DTD looks like this: + version 1.0 of the XHTML + DTD looks like this: !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" @@ -512,8 +523,8 @@ example.xml:5: element head: validity er DOCTYPE - Shows that this is an XML declaration of the - document type. + Shows that this is an XML + declaration of the document type. @@ -528,21 +539,27 @@ example.xml:5: element head: validity er - PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" + PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" - Lists the Formal Public Identifier (FPI) + Lists the Formal Public Identifier + (FPI) Formal Public Identifier - for the DTD to which this document conforms. The XML - parser uses this to find the correct DTD when - processing this document. - - PUBLIC is not a part of the FPI, - but indicates to the XML processor how to find the DTD - referenced in the FPI. Other ways of telling the XML - parser how to find the DTD are shown DTD to which this document + conforms. The XML parser uses this to + find the correct DTD when processing + this document. + + PUBLIC is not a part of the + FPI, but indicates to the + XML processor how to find the + DTD referenced in the + FPI. Other ways of telling the + XML parser how to find the + DTD are shown later. @@ -551,7 +568,8 @@ example.xml:5: element head: validity er "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" - A local filename or a URL to find the DTD. + A local filename or a URL to find + the DTD. @@ -559,24 +577,29 @@ example.xml:5: element head: validity er > - Ends the declaration and returns to the document. + Ends the declaration and returns to the + document. - Formal Public Identifiers (<acronym>FPI</acronym>s) + Formal Public Identifiers + (<acronym>FPI</acronym>s) + Formal Public Identifier It is not necessary to know this, but it is useful - background, and might help debug problems when the XML - processor can not locate the DTD. + background, and might help debug problems when the + XML processor can not locate the + DTD. - FPIs must follow a specific syntax: + FPIs must follow a specific + syntax: "Owner//Keyword Description//Language" @@ -587,14 +610,18 @@ example.xml:5: element head: validity er The owner of the FPI. - The beginning of the string identifies the owner - of the FPI. For example, the FPI + The beginning of the string identifies the owner of + the FPI. For example, the + FPI "ISO 8879:1986//ENTITIES Greek Symbols//EN" lists ISO 8879:1986 as being the owner for - the set of entities for Greek symbols. ISO 8879:1986 is - the International Organization for Standardization (ISO) number for the SGML standard, the predecessor - (and a superset) of XML. + the set of entities for Greek symbols. + ISO 8879:1986 is the International + Organization for Standardization + (ISO) number for the + SGML standard, the predecessor (and a + superset) of XML. Otherwise, this string will either look like -//Owner @@ -608,19 +635,21 @@ example.xml:5: element head: validity er + identifying it as registered. - ISO 9070:1991 defines how registered names are - generated. It might be derived from the number of an ISO - publication, an ISBN code, or an organization code - assigned according to ISO 6523. Additionally, a + ISO 9070:1991 defines how + registered names are generated. It might be derived + from the number of an ISO + publication, an ISBN code, or an + organization code assigned according to + ISO 6523. Additionally, a registration authority could be created in order to - assign registered names. The ISO council delegated this - to the American National Standards Institute - (ANSI). + assign registered names. The ISO + council delegated this to the American National + Standards Institute (ANSI). Because the &os; Project has not been registered, - the owner string is -//&os;. As - seen in the example, the W3C are not a registered owner - either. + the owner string is -//&os;. As seen + in the example, the W3C are not a + registered owner either. @@ -632,11 +661,13 @@ example.xml:5: element head: validity er information in the file. Some of the most common keywords are DTD, ELEMENT, ENTITIES, - and TEXT. DTD is - used only for DTD files, ELEMENT is - usually used for DTD fragments that contain only entity - or element declarations. TEXT is - used for XML content (text and tags). + and TEXT. DTD is + used only for DTD files, + ELEMENT is usually used for + DTD fragments that contain only + entity or element declarations. TEXT + is used for XML content (text and + tags). @@ -655,9 +686,9 @@ example.xml:5: element head: validity er Language - An ISO two-character code that identifies - the native language for the file. EN - is used for English. + An ISO two-character code that + identifies the native language for the file. + EN is used for English. @@ -665,46 +696,46 @@ example.xml:5: element head: validity er <filename>catalog</filename> Files - With the syntax above, - an XML processor needs to have - some way of turning the FPI into the name of the file - containing the DTD. A - catalog file (typically called catalog) - contains lines that map FPIs to filenames. For example, if - the catalog file contained the line: + With the syntax above, an XML + processor needs to have some way of turning the + FPI into the name of the file containing + the DTD. A catalog file (typically + called catalog) contains lines that map + FPIs to filenames. For example, if the + catalog file contained the line: PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "1.0/transitional.dtd" - The XML processor knows that the DTD is - called transitional.dtd in the + The XML processor knows that the + DTD is called + transitional.dtd in the 1.0 subdirectory of the directory that held the catalog file. Examine the contents of /usr/local/share/xml/dtd/xhtml/catalog.xml. - This is the catalog file for the XHTML DTDs that was - installed as part of the XHTML + DTDs that was installed as part of the + textproc/docproj port. <envar>SGML_CATALOG_FILES</envar> - To locate a catalog file, - the XML processor must know where to look. Many - feature command line parameters for specifying the - path to one or more catalogs. - - In addition, - SGML_CATALOG_FILES can be set to point to the files. - This environment variable consists of a - colon-separated list of catalog files (including their full - path). + To locate a catalog file, the + XML processor must know where to look. + Many feature command line parameters for specifying the path + to one or more catalogs. + + In addition, SGML_CATALOG_FILES can be + set to point to the files. This environment variable + consists of a colon-separated list of catalog files + (including their full path). - Typically, the list includes these - files: + Typically, the list includes these files: @@ -724,30 +755,34 @@ example.xml:5: element head: validity er - This was done earlier. + This was done + earlier. Alternatives to <acronym>FPI</acronym>s - Instead of using an FPI to indicate the DTD to which - the document conforms (and therefore, which file on the system - contains the DTD), the filename can be explicitly specified. + Instead of using an FPI to indicate the + DTD to which the document conforms (and + therefore, which file on the system contains the + DTD), the filename can be explicitly + specified. The syntax is slightly different: !DOCTYPE html SYSTEM "/path/to/file.dtd" The SYSTEM keyword indicates that the - XML processor should locate the DTD in a system specific - fashion. This typically (but not always) means the DTD will - be provided as a filename. - - Using FPIs is preferred for reasons of portability. - If the SYSTEM - identifier is used, then the DTD must be provided and kept in the same location - for everyone. + XML processor should locate the + DTD in a system specific fashion. This + typically (but not always) means the DTD + will be provided as a filename. + + Using FPIs is preferred for reasons of + portability. If the SYSTEM identifier is + used, then the DTD must be provided and + kept in the same location for everyone. @@ -1031,9 +1066,11 @@ example.xml:5: element head: validity er the entity reference &version; replaced with the version number. Most web browsers have very simplistic parsers which do not handle XML DTD - constructs. Furthermore, the closing ]< - of the XML context are not recognized properly by browser and - will probably be rendered. + constructs. Furthermore, the closing + ]< of the XML context are not + recognized properly by browser and will probably be + rendered. + @@ -1349,20 +1386,19 @@ example.xml:5: element head: validity er The content model you will probably find most useful is CDATA. - CDATA is for Character - Data. If the parser is in this content model then - it is expecting to see characters, and characters only. In - this model the < and - & symbols lose their special status, - and will be treated as ordinary characters. + CDATA is for + Character Data. If the parser is in this + content model then it is expecting to see characters, and + characters only. In this model the < + and & symbols lose their special + status, and will be treated as ordinary characters. - When you use CDATA - in examples of text marked up in - XML, keep in mind that the content of + When you use CDATA in examples of + text marked up in XML, keep in mind that the content of CDATA is not validated. You have to - check the included XML text using other means. You - could, for example, write the example in another document, + check the included XML text using other means. You could, + for example, write the example in another document, validate the example code, and then paste it to your CDATA content. @@ -1482,8 +1518,8 @@ example.xml:5: element head: validity er - Modify the entities.ent file to contain - the following: + Modify the entities.ent file to + contain the following: <!ENTITY version "1.1"> <!ENTITY % conditional.text "IGNORE"> @@ -1499,13 +1535,15 @@ example.xml:5: element head: validity er - Normalize the example.xml file and notice - that the conditional text is not present on the output document. - Now if you set the parameter entity guard to INCLUDE - and regenerate the normalized document, it will appear there again. - Of course, this method makes more sense if you have more conditional - chunks that depend on the same condition, for example, whether you are - generating printed or online text. + Normalize the example.xml file + and notice that the conditional text is not present on the + output document. Now if you set the parameter entity + guard to INCLUDE and regenerate the + normalized document, it will appear there again. Of + course, this method makes more sense if you have more + conditional chunks that depend on the same condition, for + example, whether you are generating printed or online + text. From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 04:35:37 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D1267522; Fri, 12 Jul 2013 04:35:37 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id C2F5C1907; Fri, 12 Jul 2013 04:35:37 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C4ZbRG055946; Fri, 12 Jul 2013 04:35:37 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C4ZbDG055945; Fri, 12 Jul 2013 04:35:37 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307120435.r6C4ZbDG055945@svn.freebsd.org> From: Warren Block Date: Fri, 12 Jul 2013 04:35:37 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42261 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 04:35:37 -0000 Author: wblock Date: Fri Jul 12 04:35:37 2013 New Revision: 42261 URL: http://svnweb.freebsd.org/changeset/doc/42261 Log: Fix a couple of tags. Translators, this is a content change. Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 04:33:43 2013 (r42260) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 04:35:37 2013 (r42261) @@ -1495,15 +1495,13 @@ example.xml:5: element head: validity er Using a Parameter Entity to Control a Marked Section - -<!ENTITY % electronic.copy "INCLUDE"> + <!ENTITY % electronic.copy "INCLUDE"> <![%electronic.copy;[ <!ENTITY chap.preface SYSTEM "preface.xml"> ]]> -<!ENTITY chap.preface ""> - +<!ENTITY chap.preface ""> When producing the hard-copy version, change the parameter entity's definition to: From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 08:02:47 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 103827E8; Fri, 12 Jul 2013 08:02:47 +0000 (UTC) (envelope-from pluknet@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 01BE2130B; Fri, 12 Jul 2013 08:02:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6C82kJ1016419; Fri, 12 Jul 2013 08:02:46 GMT (envelope-from pluknet@svn.freebsd.org) Received: (from pluknet@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6C82kqs016418; Fri, 12 Jul 2013 08:02:46 GMT (envelope-from pluknet@svn.freebsd.org) Message-Id: <201307120802.r6C82kqs016418@svn.freebsd.org> From: Sergey Kandaurov Date: Fri, 12 Jul 2013 08:02:46 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42262 - head/en_US.ISO8859-1/htdocs/releng X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 08:02:47 -0000 Author: pluknet Date: Fri Jul 12 08:02:46 2013 New Revision: 42262 URL: http://svnweb.freebsd.org/changeset/doc/42262 Log: The stable/9 branch is frozen for the 9.2-RELEASE cycle. Modified: head/en_US.ISO8859-1/htdocs/releng/index.xml Modified: head/en_US.ISO8859-1/htdocs/releng/index.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/releng/index.xml Fri Jul 12 04:35:37 2013 (r42261) +++ head/en_US.ISO8859-1/htdocs/releng/index.xml Fri Jul 12 08:02:46 2013 (r42262) @@ -82,8 +82,8 @@
- - + + From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 18:59:00 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id F1248D4B; Fri, 12 Jul 2013 18:58:59 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-5.mit.edu (dmz-mailsec-scanner-5.mit.edu [18.7.68.34]) by mx1.freebsd.org (Postfix) with ESMTP id 724B21912; Fri, 12 Jul 2013 18:58:58 +0000 (UTC) X-AuditID: 12074422-b7ef78e000000935-bc-51e050c029ed Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP id F7.D7.02357.0C050E15; Fri, 12 Jul 2013 14:53:52 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r6CIrpxu022964; Fri, 12 Jul 2013 14:53:51 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r6CIrmx9021767 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 12 Jul 2013 14:53:50 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r6CIrlwI027070; Fri, 12 Jul 2013 14:53:47 -0400 (EDT) Date: Fri, 12 Jul 2013 14:53:47 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42257 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer In-Reply-To: <201307120321.r6C3Ltph034632@svn.freebsd.org> Message-ID: References: <201307120321.r6C3Ltph034632@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrIIsWRmVeSWpSXmKPExsUixG6nonsg4EGgQXeTuMWPj4eYLG4s2s9k sbu/l9ni8vuJLA4sHjM+zWcJYIzisklJzcksSy3St0vgyji8eC1rwRHeim1Pz7E2MP7k6mLk 5JAQMJE4fugCI4QtJnHh3no2EFtIYB+jxITvol2MXED2RkaJ280TWCCcQ0wS0x4ugnIaGCUm vpjPBNLCIqAtMX3WLBYQm01ARWLmm41go0QEVCW+d68Cq2EWiJLYs7SRFcQWFgiRWLdzHpDN wcEpYCWx7kUkSJhXwFGi/90RJogrLCWurHsEVi4qoCOxev8UFogaQYmTM5+wQIy0lPi39hfr BEbBWUhSs5CkFjAyrWKUTcmt0s1NzMwpTk3WLU5OzMtLLdI11cvNLNFLTSndxAgOWRelHYw/ DyodYhTgYFTi4X0h9CBQiDWxrLgy9xCjJAeTkiivnD9QiC8pP6UyI7E4I76oNCe1+BCjBAez kgjvPkegHG9KYmVValE+TEqag0VJnPfZ07OBQgLpiSWp2ampBalFMFkZDg4lCd4PIEMFi1LT UyvSMnNKENJMHJwgw3mAhi8AqeEtLkjMLc5Mh8ifYlSUEudV8gNKCIAkMkrz4HphKeUVozjQ K8K8msAEI8QDTEdw3a+ABjMBDb696j7I4JJEhJRUA+OswGWBy/yYs4oCnvDee3J5+yp/jaB9 Ys9ni677ssVvp531t86LrJVpPj0xqo+2b9sjczOza+XNkC1bswweWV7rV0nSXDJHk8tg9t1z d+cueNNfEVBq/OqE0IkWwQXHvqd5iHV4ObywO1j7xpdH3qmtcHbZ4dvZkRyH7gQkGnAZfnnO GuWQUK7EUpyRaKjFXFScCACsTsdFBAMAAA== Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 18:59:00 -0000 On Fri, 12 Jul 2013, Warren Block wrote: > Author: wblock > Date: Fri Jul 12 03:21:55 2013 > New Revision: 42257 > URL: http://svnweb.freebsd.org/changeset/doc/42257 > > Log: > Edit for clarity and style. Try to persuade the hippo and the pogo stick > that they are not good for each other. > > Modified: > head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml > > Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 02:59:50 2013 (r42256) > +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 03:21:55 2013 (r42257) > @@ -100,42 +100,40 @@ > - Obviously, if you are going to use markup you need to define > - what your markup means, and how it should be interpreted. You > - will need a markup language that you can follow when marking up > - your documents. > + Markup languages define what > + what the markup means and how it should be interpreted. What what?! > @@ -680,48 +665,45 @@ example.xml:5: element head: validity er > - Look at the contents of > + Examine the contents of > /usr/local/share/xml/dtd/xhtml/catalog.xml. > - This is the catalog file for the XHTML DTDs that will have > - been installed as part of the + This is the catalog file for the XHTML DTDs that was s/was/were/ -Ben > + installed as part of the role="package">textproc/docproj port. > > From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 22:03:03 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 6BBEDFDD; Fri, 12 Jul 2013 22:03:03 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 1406511A9; Fri, 12 Jul 2013 22:03:02 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r6CM2tvh003295; Fri, 12 Jul 2013 16:02:55 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6CM2tIH003292; Fri, 12 Jul 2013 16:02:55 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Fri, 12 Jul 2013 16:02:55 -0600 (MDT) From: Warren Block To: Benjamin Kaduk Subject: Re: svn commit: r42257 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer In-Reply-To: Message-ID: References: <201307120321.r6C3Ltph034632@svn.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Fri, 12 Jul 2013 16:02:56 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 22:03:03 -0000 On Fri, 12 Jul 2013, Benjamin Kaduk wrote: > On Fri, 12 Jul 2013, Warren Block wrote: > >> Author: wblock >> Date: Fri Jul 12 03:21:55 2013 >> New Revision: 42257 >> URL: http://svnweb.freebsd.org/changeset/doc/42257 >> >> Log: >> Edit for clarity and style. Try to persuade the hippo and the pogo stick >> that they are not good for each other. >> >> Modified: >> head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml >> >> Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml >> ============================================================================== >> --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri >> Jul 12 02:59:50 2013 (r42256) >> +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri >> Jul 12 03:21:55 2013 (r42257) >> @@ -100,42 +100,40 @@ >> - Obviously, if you are going to use markup you need to define >> - what your markup means, and how it should be interpreted. You >> - will need a markup language that you can follow when marking up >> - your documents. >> + Markup languages define what >> + what the markup means and how it should be interpreted. > > What what?! Fixed in a later commit. If only there were a program that could be run to detect problems like that. >> @@ -680,48 +665,45 @@ example.xml:5: element head: validity er >> - Look at the contents of >> + Examine the contents of >> /usr/local/share/xml/dtd/xhtml/catalog.xml. >> - This is the catalog file for the XHTML DTDs that will have >> - been installed as part of the > + This is the catalog file for the XHTML >> DTDs that was > > s/was/were/ Oops, fixed. Thanks! From owner-svn-doc-all@FreeBSD.ORG Fri Jul 12 22:03:40 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 624DF102; Fri, 12 Jul 2013 22:03:40 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 541EB11BC; Fri, 12 Jul 2013 22:03:40 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6CM3em1065343; Fri, 12 Jul 2013 22:03:40 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6CM3epW065342; Fri, 12 Jul 2013 22:03:40 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307122203.r6CM3epW065342@svn.freebsd.org> From: Warren Block Date: Fri, 12 Jul 2013 22:03:40 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42263 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Jul 2013 22:03:40 -0000 Author: wblock Date: Fri Jul 12 22:03:39 2013 New Revision: 42263 URL: http://svnweb.freebsd.org/changeset/doc/42263 Log: Fix s/was/were/. Submitted by: bjk Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 08:02:46 2013 (r42262) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 22:03:39 2013 (r42263) @@ -717,7 +717,7 @@ example.xml:5: element head: validity er Examine the contents of /usr/local/share/xml/dtd/xhtml/catalog.xml. This is the catalog file for the XHTML - DTDs that was installed as part of the + DTDs that were installed as part of the textproc/docproj port. From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 01:34:36 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 01EEA4DF; Sat, 13 Jul 2013 01:34:35 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id E5A221B79; Sat, 13 Jul 2013 01:34:35 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6D1YZEj028128; Sat, 13 Jul 2013 01:34:35 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6D1YZBI028127; Sat, 13 Jul 2013 01:34:35 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307130134.r6D1YZBI028127@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 01:34:35 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42264 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 01:34:36 -0000 Author: wblock Date: Sat Jul 13 01:34:35 2013 New Revision: 42264 URL: http://svnweb.freebsd.org/changeset/doc/42264 Log: Continue editing the XML primer for clarity and to conform with modern usage of the FDP tools. The hippo did not want to give up the stilts and pogo stick, but eventually agreed that it was best for everyone. Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Fri Jul 12 22:03:39 2013 (r42263) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Sat Jul 13 01:34:35 2013 (r42264) @@ -34,7 +34,7 @@ XML Primer - Most FDP documentation is written with markup languages based + Most FDP documentation is written with markup languages based on XML. This chapter explains what that means, how to read and understand the documentation source, and the XML techniques used. @@ -133,13 +133,7 @@ Each language definition is more properly called a grammar, vocabulary, schema or Document Type Definition (DTD). There are various languages to - specify an XML grammar, for example, - DTD (yes, it also means the specification - language itself), XML Schema - (XSD) or RELANG NG. The - schema specifies the name of the elements that can be used, what - order they appear in (and whether some markup can be used inside - other markup) and related information. + specify an XML grammar, or schema. A schema is a complete specification of all the elements @@ -155,7 +149,7 @@ validating the document. - This processing simply confirms that the choice of + Validation confirms that the choice of elements, their ordering, and so on, conforms to that listed in the grammar. It does not check whether appropriate markup has been used @@ -166,7 +160,7 @@ allowed to appear in the same place). - It is likely that most contributions to the Documentation + Most contributions to the Documentation Project will be content marked up in either XHTML or DocBook, rather than alterations to the schemas. For this reason, this book will not touch on how @@ -585,7 +579,7 @@ example.xml:5: element head: validity er Formal Public Identifiers - (<acronym>FPI</acronym>s) + (FPI) Formal Public Identifier @@ -712,7 +706,7 @@ example.xml:5: element head: validity er DTD is called transitional.dtd in the 1.0 subdirectory of the directory that - held the catalog file. + held catalog. Examine the contents of /usr/local/share/xml/dtd/xhtml/catalog.xml. @@ -725,7 +719,7 @@ example.xml:5: element head: validity er <envar>SGML_CATALOG_FILES</envar> - To locate a catalog file, the + To locate a catalog, the XML processor must know where to look. Many feature command line parameters for specifying the path to one or more catalogs. @@ -787,102 +781,80 @@ example.xml:5: element head: validity er - Escaping Back to SGML + Escaping Back to <acronym>XML</acronym> - As mentioned earlier, XML is only used when writing a DTD. - This is not strictly true. There is certain XML syntax that - you will want to be able to use within your documents. For - example, comments can be included in your document, and will be - ignored by the parser. Comments are entered using XML syntax. - Other uses for XML syntax in your document will be shown later - too. - - Obviously, you need some way of indicating to the XML - processor that the following content is not elements within the - document, but is XML that the parser should act upon. - - These sections are marked by - <! ... > in your document. Everything - between these delimiters is XML syntax as you might find within - a DTD. - - As you may just have realized, the + Some of the underlying XML syntax can be + useful within documents. For + example, comments can be included in the document, and will be + ignored by the parser. Comments are entered using XML syntax. + Other uses for XML syntax will be shown later. + + XML sections begin with a + <! tag and end with a + >. These sections contain instructions + for the parser rather than elements of the document. Everything + between these tags is XML syntax. The DOCTYPE - declaration is an example of XML syntax that you need - to include in your document… + declaration shown earlier is an example of XML syntax included in the document. Comments - Comments are an XML construction, and are normally only - valid inside a DTD. However, as + Comments are an XML construct, and are normally only + valid inside a DTD. However, as shows, it is possible - to use XML syntax within your document. + to use XML syntax within the document. The delimiter for XML comments is the string --. The first occurrence of this string opens a comment, and the second closes it. - XML Generic Comment - -  + <acronym>XML</acronym> Generic Comment - +  - + - + -]]> + - If you have used XHTML before you may have been shown - different rules for comments. In particular, you may think that + XHTML user may be familiar with + different rules for comments. In particular, it is often believed that the string . - This is not the case. A lot of web - browsers have broken XHTML parsers, and will accept that as - valid. However, the XML parsers used by the Documentation - Project are much stricter, and will reject documents that make + This is not correct. Many web + browsers have broken XHTML parsers, and will accept incorrect input as + valid. However, the XML parsers used by the Documentation + Project are more strict, and will reject documents with that error. - Erroneous XML Comments + Erroneous <acronym>XML</acronym> Comments - ]]> + -- back inside the comment --> - The XML parser will treat this as though it were + The XML parser will treat this as though it were actually: <!THIS IS OUTSIDE THE COMMENT> - This is not valid XML, and may give confusing error + That is not valid XML, and may give confusing error messages. - - ]]> - - As the example suggests, do not write - comments like that. - - ]]> - - That is a (slightly) better approach, but it still - potentially confusing to people new to XML. - For You to Do… + To Do… @@ -905,150 +877,144 @@ example.xml:5: element head: validity er Entities Entities are a mechanism for assigning names to chunks of - content. As an XML parser processes your document, any + content. As an XML parser processes a document, any entities it finds are replaced by the content of the entity. This is a good way to have re-usable, easily changeable - chunks of content in your XML documents. It is also the only + chunks of content in XML documents. It is also the only way to include one marked up file inside another using - XML. + XML. - There are two types of entities which can be used in two - different situations; general entities and + There are two types of entities for two + different situations: general entities and parameter entities. General Entities - You cannot use general entities in an XML context - (although you define them in one). They can only be used in - your document. Contrast this with parameter - entities. - - Each general entity has a name. When you want to - reference a general entity (and therefore include whatever - text it represents in your document), you write - &entity-name;. - For example, suppose you had an entity called - current.version which expanded to the - current version number of your product. You could + General entities are used to assign names to reusable + chunks of text. These entities can only be used in the + document. They cannot be used in an + XML context. + + To include the text of a general entity in the document, include + &entity-name; in the text. + For example, consider a general entity called + current.version which expands to the + current version number of a product. To use it in the document, write: - The current version of our product is - ¤t.version;.]]> + paraThe current version of our product is + &current.version;.para - When the version number changes you can simply change the - definition of the value of the general entity and reprocess - your document. + When the version number changes, edit the + definition of the general entity, replacing the value. Then reprocess + the document. - You can also use general entities to enter characters that - you could not otherwise include in an XML document. For + General entities can also be used to enter characters that + could not otherwise be included in an XML document. For example, < and & - cannot normally appear in an XML document. When the XML - parser sees the < symbol it assumes that - a tag (either a start tag or an end tag) is about to appear, - and when it sees the & symbol it - assumes the next text will be the name of an entity. - - Fortunately, you can use the two general entities - < and & - whenever you need to include one or other of these. + cannot normally appear in an XML document. The XML + parser sees the < symbol as the start of + a tag. Likewise, when the + & symbol is seen, the next text is expected to + be an entity name. + + These symbols can be included by using two predefined general entities: + < and &. - A general entity can only be defined within an XML - context. Typically, this is done immediately after the + General entities can only be defined within an XML + context. Such definitions are usually done immediately after the DOCTYPE declaration. Defining General Entities - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - - -]>]]> +<!ENTITY current.version "3.0-RELEASE"> +<!ENTITY last.version "2.2.7-RELEASE"> +]> - Notice how the DOCTYPE declaration has been extended by + The DOCTYPE declaration has been extended by adding a square bracket at the end of the first line. The two entities are then defined over the next two lines, - before the square bracket is closed, and then the DOCTYPE + the square bracket is closed, and then the DOCTYPE declaration is closed. - The square brackets are necessary to indicate that we - are extending the DTD indicated by the DOCTYPE - declaration. + The square brackets are necessary to indicate that + the DTD indicated by the DOCTYPE + declaration is being extended. Parameter Entities - Like general - entities, parameter entities are used to assign names - to reusable chunks of text. However, whereas general entities - can only be used within your document, parameter entities can + Parameter entities, like general + entities, are used to assign names + to reusable chunks of text. But + parameter entities can only be used within an XML context. - Parameter entities are defined in a similar way to general - entities. However, instead of using - &entity-name; - to refer to them, use - %entity-name; - Parameter entities use - the Percent - symbol.. The definition also includes + Parameter entity definitons are similar to those for general + entities. However, parameter entries are included with + %entity-name;. + The definition also includes the % between the ENTITY keyword and the name of the entity. + For a mnemonic, think Parameter entities use + the Percent + symbol. + Defining Parameter Entities - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - - - +<!ENTITY % param.some "some"> +<!ENTITY % param.text "text"> +<!ENTITY % param.new "%param.some more %param.text"> - -]>]]> + +]> - - This may not seem particularly useful. It will be. - For You to Do… + To Do… Add a general entity to example.xml. - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - -]> +<!ENTITY version "1.1"> +]> - - - An Example XHTML File - +html xmlns="http://www.w3.org/1999/xhtml" + head + titleAn Example XHTML Filetitle + head - +  - -
This is a paragraph containing some text.
+ body + pThis is a paragraph containing some text.p -
This paragraph contains some more text.
+ pThis paragraph contains some more text.p -
This paragraph might be right-justified.
+ p align="right"This paragraph might be right-justified.p -
The current version of this document is: &version;
- -]]> + pThe current version of this document is: &version;p + body +html @@ -1057,41 +1023,38 @@ example.xml:5: element head: validity er - Load example.xml into your web - browser (you may need to copy it to - example.html before your browser - recognizes it as an XHTML document). - - Unless your browser is very advanced, you will not see - the entity reference &version; - replaced with the version number. Most web browsers have - very simplistic parsers which do not handle XML DTD - constructs. Furthermore, the closing - ]< of the XML context are not - recognized properly by browser and will probably be - rendered. + Load example.xml into a web + browser. It may have to be copied to + example.html before the browser + recognizes it as an XHTML document. + + Older browsers with simple parsers may not render + this file as expected. The entity reference &version; may not be replaced by + the version number, or the XML context closing + ]< may not be + recognized and instead shown in the output. - The solution is to normalize your - document using an XML normalizer. The normalizer reads - in valid XML and outputs equally valid XML which has - been transformed in some way. One of the ways in which - the normalizer transforms the XML is to expand all the + The solution is to normalize the + document with an XML normalizer. The normalizer reads + valid XML and writes equally valid XML which has + been transformed in some way. One way + the normalizer transforms the input is by expanding all the entity references in the document, replacing the entities with the text that they represent. - You can use xmllint to do + xmllint can be used for this. It also has an option to drop the initial - DTD section so that the closing ]< + DTD section so that the closing ]< does not confuse browsers: &prompt.user; xmllint --noent --dropdtd example.xml > example.html - You should find a normalized (i.e., entity references - expanded) copy of your document in - example.html, ready to load into your + A normalized copy of the document with entities expanded + is produced in + example.html, ready to load into a web browser. @@ -1101,46 +1064,46 @@ example.xml:5: element head: validity er Using Entities to Include Files - Entities (both + Both general and - parameter) - are particularly useful when used to include one file inside + parameter entities + are particularly useful for including one file inside another. Using General Entities to Include Files - Suppose you have some content for an XML book organized + Consider some content for an XML book organized into files, one file per chapter, called chapter1.xml, chapter2.xml, and so forth, with a - book.xml file that will contain these + book.xml that will contain these chapters. In order to use the contents of these files as the values - for your entities, you declare them with the - SYSTEM keyword. This directs the XML - parser to use the contents of the named file as the value of + for entities, they are declared with the + SYSTEM keyword. This directs the XML + parser to include the contents of the named file as the value of the entity. Using General Entities to Include Files - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - - - - -]> - - - - - &chapter.1; - &chapter.2; - &chapter.3; -]]> +<!ENTITY chapter.1 SYSTEM "chapter1.xml"> +<!ENTITY chapter.2 SYSTEM "chapter2.xml"> +<!ENTITY chapter.3 SYSTEM "chapter3.xml"> + +]> + +html xmlns="http://www.w3.org/1999/xhtml" +  + + &chapter.1; + &chapter.2; + &chapter.3; +html @@ -1158,60 +1121,59 @@ example.xml:5: element head: validity er Using Parameter Entities to Include Files - Recall that parameter entities can only be used inside an - XML context. Why then would you want to include a file - within an XML context? + Parameter entities can only be used inside an + XML context. Including a file in an + XML context can be used + to ensure that general + entities are reusable. - You can use this to ensure that you can reuse your general - entities. - - Suppose that you had many chapters in your document, and - you reused these chapters in two different books, each book + Suppose that there are many chapters in the document, and + these chapters were reused in two different books, each book organizing the chapters in a different fashion. - You could list the entities at the top of each book, but - this quickly becomes cumbersome to manage. + The entities could be listed at the top of each book, but + that quickly becomes cumbersome to manage. Instead, place the general entity definitions inside one file, and use a parameter entity to include that file within - your document. + the document. Using Parameter Entities to Include Files - First, place your entity definitions in a separate file, - called chapters.ent. This file - contains the following: - - - -]]> + Place the entity definitions in a separate file + called chapters.ent and + containing this text: + + <!ENTITY chapter.1 SYSTEM "chapter1.xml"> +<!ENTITY chapter.2 SYSTEM "chapter2.xml"> +<!ENTITY chapter.3 SYSTEM "chapter3.xml"> - Now create a parameter entity to refer to the contents + Create a parameter entity to refer to the contents of the file. Then use the parameter entity to load the file into the document, which will then make all the general entities available for use. Then use the general entities as before: - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - - + +<!ENTITY % chapters SYSTEM "chapters.ent"> - + %chapters; -]> +]> - - &chapter.1; - &chapter.2; - &chapter.3; -]]> +html xmlns="http://www.w3.org/1999/xhtml" + &chapter.1; + &chapter.2; + &chapter.3; +html - For You to Do… + To Do… Use General Entities to Include Files @@ -1222,37 +1184,37 @@ example.xml:5: element head: validity er para2.xml, and para3.xml. - Put content similar to the following in each + Put content like this in each file: - This is the first paragraph.
]]> + pThis is the first paragraph.p Edit example.xml so that it looks like this: - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - - - - -]> - - - - An Example XHTML File - - - -
The current version of this document is: &version;
- - ¶1; - ¶2; - ¶3; - -]]> +<!ENTITY version "1.1"> +<!ENTITY para1 SYSTEM "para1.xml"> +<!ENTITY para2 SYSTEM "para2.xml"> +<!ENTITY para3 SYSTEM "para3.xml"> +]> + +html xmlns="http://www.w3.org/1999/xhtml" + head + titleAn Example XHTML Filetitle + head + + body + pThe current version of this document is: &version;p + + &para1; + &para2; + &para3; + body +html @@ -1263,8 +1225,8 @@ example.xml:5: element head: validity er - Load example.html into your web - browser, and confirm that the + Load example.html into the web + browser and confirm that the paran.xml files have been included in example.html. @@ -1276,7 +1238,7 @@ example.xml:5: element head: validity er Use Parameter Entities to Include Files - You must have taken the previous steps first. + The previous steps must have completed before this step. @@ -1284,35 +1246,35 @@ example.xml:5: element head: validity er Edit example.xml so that it looks like this: - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [ - %entities; -]> +<!ENTITY % entities SYSTEM "entities.ent"> %entities; +]> - - - An Example XHTML File - - - -
The current version of this document is: &version;
- - ¶1; - ¶2; - ¶3; - -]]> +html xmlns="http://www.w3.org/1999/xhtml" + head + titleAn Example XHTML Filetitle + head + + body + pThe current version of this document is: &version;p + + &para1; + &para2; + &para3; + body +html - Create a new file, - entities.ent, with this + Create a new file called + entities.ent with this content: - - - -]]> + <!ENTITY version "1.1"> +<!ENTITY para1 SYSTEM "para1.xml"> +<!ENTITY para2 SYSTEM "para2.xml"> +<!ENTITY para3 SYSTEM "para3.xml"> @@ -1323,8 +1285,8 @@ example.xml:5: element head: validity er - Load example.html into your web - browser, and confirm that the + Load example.html into the web + browser and confirm that the paran.xml files have been included in example.html. @@ -1337,9 +1299,9 @@ example.xml:5: element head: validity er Marked Sections - XML provides a mechanism to indicate that particular pieces + XML provides a mechanism to indicate that particular pieces of the document should be processed in a special way. These are - termed marked sections. + called marked sections. Structure of a Marked Section @@ -1349,101 +1311,93 @@ example.xml:5: element head: validity er ]]> - As you would expect, being an XML construct, a marked + As expected of an XML construct, a marked section starts with <!. - The first square bracket begins to delimit the marked + The first square bracket begins the marked section. KEYWORD describes how this marked - section should be processed by the parser. + section is to be processed by the parser. - The second square bracket indicates that the content of the - marked section starts here. + The second square bracket indicates the start of the + marked section's content. The marked section is finished by closing the two square brackets, and then returning to the document context from the - XGML context with >. + XML context with >. - + Marked Section Keywords - + <literal>CDATA</literal> These keywords denote the marked sections content model, and allow you to change it from the default. - When an XML parser is processing a document it keeps - track of what is called the content + When an XML parser is processing a document, it keeps + track of the content model. - Briefly, the content model describes what sort of - content the parser is expecting to see, and what it will do - with it when it finds it. + The content model describes the + content the parser is expecting to see and what it will do + with that content. - The content model you will probably find most - useful is CDATA. + The + CDATA content model is one of the most useful. CDATA is for - Character Data. If the parser is in this - content model then it is expecting to see characters, and - characters only. In this model the < + Character Data. When the parser is in this + content model, it expects to see only characters. + In this model the < and & symbols lose their special status, and will be treated as ordinary characters. - When you use CDATA in examples of - text marked up in XML, keep in mind that the content of - CDATA is not validated. You have to - check the included XML text using other means. You could, - for example, write the example in another document, - validate the example code, and then paste it to your - CDATA content. + When using CDATA in examples of + text marked up in XML, remember that the content of + CDATA is not validated. The + included text must be check with other means. + For example, the content could be written in another document, + validated, and then pasted into the + CDATA section. - Using a <literal>CDATA</literal> Marked Section - <para>Here is an example of how you would include some text - that contained many <literal><</literal> - and <literal>&</literal> symbols. The sample - text is a fragment of XHTML. The surrounding text (<para> and - <programlisting>) are from DocBook.</para> - -<programlisting> - <![CDATA[This is a sample that shows you some of the elements within - XHTML. Since the angle brackets are used so many times, it is - simpler to say the whole example is a CDATA marked section - than to use the entity names for the left and right angle - brackets throughout.
- -
-
This is a listitem
-
This is a second listitem
-
This is a third listitem
-
- -
This is the end of the example.
]]> - ]]> -</programlisting> + paraHere is an example of how to include some text that contains + many literal<literal and literal&literal + symbols. The sample text is a fragment of + acronymXHTMLacronym. The surrounding text (para and + programlisting) are from DocBook.para + +programlisting<![CDATA[pThis is a sample that shows some of the + elements within acronymXHTMLacronym. Since the angle + brackets are used so many times, it is simpler to say the whole + example is a CDATA marked section than to use the entity names for + the left and right angle brackets throughout.p + + ul + liThis is a listitemli + liThis is a second listitemli + liThis is a third listitemli + ul - If you look at the source for this document you will - see this technique used throughout. + pThis is the end of the example.p]]>programlisting - + <literal>INCLUDE</literal> and <literal>IGNORE</literal> - If the keyword is INCLUDE then the - contents of the marked section will be processed. If the - keyword is IGNORE then the marked section + When the keyword is INCLUDE, then the + contents of the marked section will be processed. When the + keyword is IGNORE, the marked section is ignored and will not be processed. It will not appear in the output. @@ -1460,18 +1414,18 @@ example.xml:5: element head: validity er ]]> - By itself, this is not too useful. If you wanted to - remove text from your document you could cut it out, or wrap - it in comments. + By itself, this is not too useful. Text to be + removed from the document could be cut out, or wrapped + in comments. - It becomes more useful when you realize you can use + It becomes more useful when controlled by parameter - entities to control this, yet this usage is limited + entities, yet this usage is limited to entity files. - For example, suppose that you produced a hard-copy - version of some documentation and an electronic version. In - the electronic version you wanted to include some extra + For example, suppose that documentation was produced in a hard-copy + version and an electronic version. Some extra text is desired in + the electronic version content that was not to appear in the hard-copy. Create an entity file that defines general entities @@ -1482,12 +1436,12 @@ example.xml:5: element head: validity er conditional general entity definitions, place one more definition for each general entity to set them to an empty value. This technique makes use of the fact that - entity definitions cannot be overridden but always the - first definition takes effect. So you can control the - inclusion of your chapter with the corrsponding parameter DIFF OUTPUT TRUNCATED AT 1000 LINES * From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 01:50:56 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id EF5305FC; Sat, 13 Jul 2013 01:50:56 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id E01201BBE; Sat, 13 Jul 2013 01:50:56 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6D1ouMH033318; Sat, 13 Jul 2013 01:50:56 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6D1oulf033317; Sat, 13 Jul 2013 01:50:56 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307130150.r6D1oulf033317@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 01:50:56 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42265 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 01:50:57 -0000 Author: wblock Date: Sat Jul 13 01:50:56 2013 New Revision: 42265 URL: http://svnweb.freebsd.org/changeset/doc/42265 Log: Whitespace-only cleanups. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Sat Jul 13 01:34:35 2013 (r42264) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Sat Jul 13 01:50:56 2013 (r42265) @@ -34,10 +34,11 @@ XML Primer - Most FDP documentation is written with markup languages based - on XML. This chapter explains what that means, - how to read and understand the documentation source, and the - XML techniques used. + Most FDP documentation is written with + markup languages based on XML. This chapter + explains what that means, how to read and understand the + documentation source, and the XML techniques + used. Portions of this section were inspired by Mark Galassi's Each language definition is more properly called a grammar, vocabulary, schema or Document Type Definition (DTD). There are various languages to - specify an XML grammar, or schema. + specify an XML grammar, or + schema. A schema is a complete specification of all the elements @@ -784,10 +786,10 @@ example.xml:5: element head: validity er Escaping Back to <acronym>XML</acronym> Some of the underlying XML syntax can be - useful within documents. For - example, comments can be included in the document, and will be - ignored by the parser. Comments are entered using XML syntax. - Other uses for XML syntax will be shown later. + useful within documents. For example, comments can be included + in the document, and will be ignored by the parser. Comments + are entered using XML syntax. Other uses for + XML syntax will be shown later. XML sections begin with a <! tag and end with a @@ -795,15 +797,17 @@ example.xml:5: element head: validity er for the parser rather than elements of the document. Everything between these tags is XML syntax. The DOCTYPE - declaration shown earlier is an example of XML syntax included in the document. + declaration shown earlier is an example of + XML syntax included in the document. + Comments - Comments are an XML construct, and are normally only - valid inside a DTD. However, as - shows, it is possible + Comments are an XML construct, and are + normally only valid inside a DTD. However, + as shows, it is possible to use XML syntax within the document. The delimiter for XML comments is the string @@ -824,16 +828,16 @@ example.xml:5: element head: validity er -- doing multiline comments --> - XHTML user may be familiar with - different rules for comments. In particular, it is often believed that + XHTML user may be familiar with different + rules for comments. In particular, it is often believed that the string . - This is not correct. Many web - browsers have broken XHTML parsers, and will accept incorrect input as - valid. However, the XML parsers used by the Documentation - Project are more strict, and will reject documents with - that error. + This is not correct. Many web browsers + have broken XHTML parsers, and will accept + incorrect input as valid. However, the XML + parsers used by the Documentation Project are more strict, and + will reject documents with that error. Erroneous <acronym>XML</acronym> Comments @@ -844,13 +848,13 @@ example.xml:5: element head: validity er -- back inside the comment --> - The XML parser will treat this as though it were - actually: + The XML parser will treat this as + though it were actually: <!THIS IS OUTSIDE THE COMMENT> - That is not valid XML, and may give confusing error - messages. + That is not valid XML, and may give + confusing error messages. @@ -877,17 +881,17 @@ example.xml:5: element head: validity er Entities Entities are a mechanism for assigning names to chunks of - content. As an XML parser processes a document, any - entities it finds are replaced by the content of the - entity. + content. As an XML parser processes a + document, any entities it finds are replaced by the content of + the entity. This is a good way to have re-usable, easily changeable - chunks of content in XML documents. It is also the only - way to include one marked up file inside another using - XML. + chunks of content in XML documents. It is + also the only way to include one marked up file inside another + using XML. - There are two types of entities for two - different situations: general entities and + There are two types of entities for two different + situations: general entities and parameter entities. @@ -898,35 +902,37 @@ example.xml:5: element head: validity er document. They cannot be used in an XML context. - To include the text of a general entity in the document, include - &entity-name; in the text. - For example, consider a general entity called + To include the text of a general entity in the document, + include + &entity-name; + in the text. For example, consider a general entity called current.version which expands to the - current version number of a product. To use it in the document, - write: + current version number of a product. To use it in the + document, write: paraThe current version of our product is &current.version;.para - When the version number changes, edit the - definition of the general entity, replacing the value. Then reprocess - the document. + When the version number changes, edit the definition of + the general entity, replacing the value. Then reprocess the + document. General entities can also be used to enter characters that - could not otherwise be included in an XML document. For - example, < and & - cannot normally appear in an XML document. The XML + could not otherwise be included in an XML + document. For example, < and + & cannot normally appear in an + XML document. The XML parser sees the < symbol as the start of - a tag. Likewise, when the - & symbol is seen, the next text is expected to - be an entity name. - - These symbols can be included by using two predefined general entities: - < and &. - - General entities can only be defined within an XML - context. Such definitions are usually done immediately after the - DOCTYPE declaration. + a tag. Likewise, when the & symbol is + seen, the next text is expected to be an entity name. + + These symbols can be included by using two predefined + general entities: < and + &. + + General entities can only be defined within an + XML context. Such definitions are usually + done immediately after the DOCTYPE declaration. Defining General Entities @@ -937,39 +943,39 @@ example.xml:5: element head: validity er <!ENTITY last.version "2.2.7-RELEASE"> ]> - The DOCTYPE declaration has been extended by - adding a square bracket at the end of the first line. The - two entities are then defined over the next two lines, - the square bracket is closed, and then the DOCTYPE - declaration is closed. - - The square brackets are necessary to indicate that - the DTD indicated by the DOCTYPE - declaration is being extended. + The DOCTYPE declaration has been extended by adding a + square bracket at the end of the first line. The two + entities are then defined over the next two lines, the + square bracket is closed, and then the DOCTYPE declaration + is closed. + + The square brackets are necessary to indicate that the + DTD indicated by the DOCTYPE declaration is being + extended. Parameter Entities - Parameter entities, like general - entities, are used to assign names - to reusable chunks of text. But - parameter entities can - only be used within an XML + Parameter entities, like + general + entities, are used to assign names to reusable chunks + of text. But parameter entities can only be used within an + XML context. - Parameter entity definitons are similar to those for general - entities. However, parameter entries are included with + Parameter entity definitons are similar to those for + general entities. However, parameter entries are included + with %entity-name;. - The definition also includes - the % between the ENTITY - keyword and the name of the entity. - - For a mnemonic, think Parameter entities use - the Percent - symbol. + The definition also includes the % between + the ENTITY keyword and the name of the + entity. + + For a mnemonic, think + Parameter entities use the + Percent symbol. Defining Parameter Entities @@ -1026,36 +1032,37 @@ example.xml:5: element head: validity er Load example.xml into a web browser. It may have to be copied to example.html before the browser - recognizes it as an XHTML document. - - Older browsers with simple parsers may not render - this file as expected. The entity reference &version; may not be replaced by - the version number, or the XML context closing - ]< may not be - recognized and instead shown in the output. + recognizes it as an XHTML + document. + Older browsers with simple parsers may not render this + file as expected. The entity reference + &version; may not be replaced by + the version number, or the XML context + closing ]< may not be recognized and + instead shown in the output. The solution is to normalize the - document with an XML normalizer. The normalizer reads - valid XML and writes equally valid XML which has - been transformed in some way. One way - the normalizer transforms the input is by expanding all the - entity references in the document, replacing the entities - with the text that they represent. - - xmllint can be used for - this. It also has an option to drop the initial - DTD section so that the closing ]< - does not confuse browsers: + document with an XML normalizer. The + normalizer reads valid XML and writes + equally valid XML which has been + transformed in some way. One way the normalizer + transforms the input is by expanding all the entity + references in the document, replacing the entities with + the text that they represent. + + xmllint can be used for this. It + also has an option to drop the initial + DTD section so that the closing + ]< does not confuse browsers: &prompt.user; xmllint --noent --dropdtd example.xml > example.html - A normalized copy of the document with entities expanded - is produced in - example.html, ready to load into a - web browser. + A normalized copy of the document with entities + expanded is produced in example.html, + ready to load into a web browser. @@ -1066,15 +1073,15 @@ example.xml:5: element head: validity er Both general and - parameter entities - are particularly useful for including one file inside + parameter + entities are particularly useful for including one file inside another. Using General Entities to Include Files - Consider some content for an XML book organized - into files, one file per chapter, called + Consider some content for an XML book + organized into files, one file per chapter, called chapter1.xml, chapter2.xml, and so forth, with a book.xml that will contain these @@ -1082,9 +1089,9 @@ example.xml:5: element head: validity er In order to use the contents of these files as the values for entities, they are declared with the - SYSTEM keyword. This directs the XML - parser to include the contents of the named file as the value of - the entity. + SYSTEM keyword. This directs the + XML parser to include the contents of the + named file as the value of the entity. Using General Entities to Include Files @@ -1112,9 +1119,9 @@ example.xml:5: element head: validity er (chapter1.xml, chapter2.xml, and so on) must not start with a DOCTYPE - declaration. This is a syntax error because entities - are low-level constructs and they are resolved before - any parsing happens. + declaration. This is a syntax error because entities are + low-level constructs and they are resolved before any + parsing happens. @@ -1124,8 +1131,7 @@ example.xml:5: element head: validity er Parameter entities can only be used inside an XML context. Including a file in an XML context can be used - to ensure that general - entities are reusable. + to ensure that general entities are reusable. Suppose that there are many chapters in the document, and these chapters were reused in two different books, each book @@ -1184,8 +1190,7 @@ example.xml:5: element head: validity er para2.xml, and para3.xml. - Put content like this in each - file: + Put content like this in each file: pThis is the first paragraph.p @@ -1238,7 +1243,8 @@ example.xml:5: element head: validity er Use Parameter Entities to Include Files - The previous steps must have completed before this step. + The previous steps must have completed before this + step. @@ -1299,9 +1305,10 @@ example.xml:5: element head: validity er Marked Sections - XML provides a mechanism to indicate that particular pieces - of the document should be processed in a special way. These are - called marked sections. + XML provides a mechanism to indicate that + particular pieces of the document should be processed in a + special way. These are called + marked sections. Structure of a Marked Section @@ -1314,8 +1321,7 @@ example.xml:5: element head: validity er As expected of an XML construct, a marked section starts with <!. - The first square bracket begins the marked - section. + The first square bracket begins the marked section. KEYWORD describes how this marked section is to be processed by the parser. @@ -1325,7 +1331,8 @@ example.xml:5: element head: validity er The marked section is finished by closing the two square brackets, and then returning to the document context from the - XML context with >. + XML context with + >. Marked Section Keywords @@ -1337,30 +1344,30 @@ example.xml:5: element head: validity er content model, and allow you to change it from the default. - When an XML parser is processing a document, it keeps - track of the content - model. + When an XML parser is processing a + document, it keeps track of the + content model. The content model describes the content the parser is expecting to see and what it will do with that content. - The - CDATA content model is one of the most useful. + The CDATA content model is one of the + most useful. CDATA is for Character Data. When the parser is in this - content model, it expects to see only characters. - In this model the < - and & symbols lose their special - status, and will be treated as ordinary characters. + content model, it expects to see only characters. In this + model the < and + & symbols lose their special status, + and will be treated as ordinary characters. When using CDATA in examples of - text marked up in XML, remember that the content of - CDATA is not validated. The - included text must be check with other means. - For example, the content could be written in another document, + text marked up in XML, remember that + the content of CDATA is not validated. + The included text must be check with other means. For + example, the content could be written in another document, validated, and then pasted into the CDATA section. @@ -1423,27 +1430,26 @@ example.xml:5: element head: validity er entities, yet this usage is limited to entity files. - For example, suppose that documentation was produced in a hard-copy - version and an electronic version. Some extra text is desired in - the electronic version - content that was not to appear in the hard-copy. - - Create an entity file that defines general entities - to include each chapter and guard these definitions with - a parameter entity that can be set to either - INCLUDE or IGNORE - to control whether the entity is defined. After these + For example, suppose that documentation was produced in + a hard-copy version and an electronic version. Some extra + text is desired in the electronic version content that was + not to appear in the hard-copy. + + Create an entity file that defines general entities to + include each chapter and guard these definitions with a + parameter entity that can be set to either + INCLUDE or IGNORE to + control whether the entity is defined. After these conditional general entity definitions, place one more - definition for each general entity to set them to an - empty value. This technique makes use of the fact that - entity definitions cannot be overridden but the - first definition always takes effect. So the - inclusion of the chapter is controlled with the corresponding parameter - entity. Set to INCLUDE, the - first general entity definition will be read and the - second one will be ignored. Set to - IGNORE, the first definition will be - ignored and the second one will take effect. + definition for each general entity to set them to an empty + value. This technique makes use of the fact that entity + definitions cannot be overridden but the first definition + always takes effect. So the inclusion of the chapter is + controlled with the corresponding parameter entity. Set to + INCLUDE, the first general entity + definition will be read and the second one will be ignored. + Set to IGNORE, the first definition will + be ignored and the second one will take effect. Using a Parameter Entity to Control a Marked @@ -1504,10 +1510,11 @@ example.xml:5: element head: validity er <sect1 id="xml-primer-conclusion"> <title>Conclusion - That is the conclusion of this XML primer. For reasons of - space and complexity, several things have not been covered in - depth (or at all). However, the previous sections cover enough - XML to introduce the organization of the FDP + That is the conclusion of this XML + primer. For reasons of space and complexity, several things + have not been covered in depth (or at all). However, the + previous sections cover enough XML to + introduce the organization of the FDP documentation. From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 03:33:21 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 70363E8C; Sat, 13 Jul 2013 03:33:21 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 628C21E9D; Sat, 13 Jul 2013 03:33:21 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6D3XLoZ063886; Sat, 13 Jul 2013 03:33:21 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6D3XLuD063885; Sat, 13 Jul 2013 03:33:21 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307130333.r6D3XLuD063885@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 03:33:21 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42266 - head/en_US.ISO8859-1/books/handbook/security X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 03:33:21 -0000 Author: wblock Date: Sat Jul 13 03:33:20 2013 New Revision: 42266 URL: http://svnweb.freebsd.org/changeset/doc/42266 Log: Fix a wording bug: action to resource. Also fix some title capitalization and redundancy issues. Submitted by: MNIHKLOM (forum user, action/resource issue) Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 01:50:56 2013 (r42265) +++ head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 03:33:20 2013 (r42266) @@ -2783,7 +2783,7 @@ racoon_enable="yes" - Enabling The SSH Server + Enabling the SSH Server OpenSSH @@ -2918,8 +2918,8 @@ bb:48:db:f2:93:57:80:b6:aa:bc:f5:d5:ba:8 is stored in ~/.ssh/id_dsa.pub or ~/.ssh/id_rsa.pub, respectively for the DSA and RSA key types. - The public key must be placed in the - ~/.ssh/authorized_keys file of the + The public key must be placed in + ~/.ssh/authorized_keys on the remote machine for both RSA or DSA keys in order for the setup to work. @@ -2960,7 +2960,7 @@ bb:48:db:f2:93:57:80:b6:aa:bc:f5:d5:ba:8 - Using SSH Agent To Cache Keys + Using SSH Agent to Cache Keys To load SSH keys into memory for use, without needing to type the passphrase each time, use @@ -2990,7 +2990,7 @@ Identity added: /home/user/.ssh/id_dsa ( needs to be placed in ~/.xinitrc. This provides the &man.ssh-agent.1; services to all programs launched in &xorg;. An example - ~/.xinitrc file might look like + ~/.xinitrc might look like this: exec ssh-agent startxfce4 @@ -3217,7 +3217,7 @@ user@unfirewalled-system.example.org's p Filesystem Access Control Lists - (<acronym>ACL</acronym>s) + (ACL)s ACL @@ -3744,7 +3744,7 @@ VII. References cap_mkdb, edits made to - the /etc/master.passwd file. In + /etc/master.passwd. In addition, the password database must be rebuilt using pwd_mkdb. This multi-step process could be very time consuming depending on how many users must be @@ -3782,7 +3782,7 @@ options RCTL This rule shows a basic premise of a rule, here the subject is user and the subject-id is trhodes. The maxproc is, of course, - max number of processes, which is considered the action. + max number of processes, which is considered the resource. The action here is set to deny, which blocks any new processes from being created. In the previous example, the user, trhodes will be constrained @@ -3808,7 +3808,7 @@ eval: Cannot fork: Resource temporarily &prompt.root; rctl -a jail:httpd:memoryuse:deny=2G/jail Rules may also persist across reboots if they have been - added to /etc/rctl.conf file. The + added to /etc/rctl.conf. The format is a rule, without the preceding command. For example, the previous rule could be added like the following: From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 03:51:23 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 3B1ABF62; Sat, 13 Jul 2013 03:51:23 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 1C8A81EE7; Sat, 13 Jul 2013 03:51:23 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6D3pNOT069094; Sat, 13 Jul 2013 03:51:23 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6D3pNSR069093; Sat, 13 Jul 2013 03:51:23 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307130351.r6D3pNSR069093@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 03:51:23 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42267 - head/en_US.ISO8859-1/books/handbook/security X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 03:51:23 -0000 Author: wblock Date: Sat Jul 13 03:51:22 2013 New Revision: 42267 URL: http://svnweb.freebsd.org/changeset/doc/42267 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 03:33:20 2013 (r42266) +++ head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 03:51:22 2013 (r42267) @@ -2444,57 +2444,57 @@ device crypto - - - - - Tom - Rhodes - -
trhodes@FreeBSD.org
- - Written by - - - - - Configuring IPsec on &os; - - To begin, - security/ipsec-tools - must be installed from the Ports Collection. This software - provides a number of applications which support the - configuration. - - The next requirement is to create two &man.gif.4; - pseudo-devices which will be used to tunnel packets and - allow both networks to communicate properly. As - root, run the following commands, - replacing internal and - external with the real IP - addresses of the internal and external interfaces of the two - gateways: - - &prompt.root; ifconfig gif0 create - - &prompt.root; ifconfig gif0 internal1 internal2 - - &prompt.root; ifconfig gif0 tunnel external1 external2 - - In this example, the corporate LAN's - external IP address is 172.16.5.4 and its internal - IP address is 10.246.38.1. The home - LAN's external IP - address is 192.168.1.12 and its - internal private IP address is 10.0.0.5. + + + + + Tom + Rhodes + +
trhodes@FreeBSD.org
+ + Written by + + + + + Configuring IPsec on &os; + + To begin, + security/ipsec-tools + must be installed from the Ports Collection. This software + provides a number of applications which support the + configuration. + + The next requirement is to create two &man.gif.4; + pseudo-devices which will be used to tunnel packets and + allow both networks to communicate properly. As + root, run the following commands, + replacing internal and + external with the real IP + addresses of the internal and external interfaces of the two + gateways: + + &prompt.root; ifconfig gif0 create + + &prompt.root; ifconfig gif0 internal1 internal2 + + &prompt.root; ifconfig gif0 tunnel external1 external2 + + In this example, the corporate LAN's + external IP address is + 172.16.5.4 and its internal + IP address is + 10.246.38.1. The home + LAN's external IP + address is 192.168.1.12 and + its internal private IP address is + 10.0.0.5. - If this is confusing, review the following example output - from &man.ifconfig.8;: + If this is confusing, review the following example + output from &man.ifconfig.8;: - Gateway 1: + Gateway 1: gif0: flags=8051 mtu 1280 tunnel inet 172.16.5.4 --> 192.168.1.12 @@ -2508,10 +2508,10 @@ tunnel inet 192.168.1.12 --> 172.16.5 inet 10.0.0.5 --> 10.246.38.1 netmask 0xffffff00 inet6 fe80::250:bfff:fe3a:c1f%gif0 prefixlen 64 scopeid 0x4 - Once complete, both internal IP - addresses should be reachable using &man.ping.8;: + Once complete, both internal IP + addresses should be reachable using &man.ping.8;: - priv-net# ping 10.0.0.5 + priv-net# ping 10.0.0.5 PING 10.0.0.5 (10.0.0.5): 56 data bytes 64 bytes from 10.0.0.5: icmp_seq=0 ttl=64 time=42.786 ms 64 bytes from 10.0.0.5: icmp_seq=1 ttl=64 time=19.255 ms @@ -2532,26 +2532,26 @@ PING 10.246.38.1 (10.246.38.1): 56 data 5 packets transmitted, 5 packets received, 0% packet loss round-trip min/avg/max/stddev = 28.106/94.594/154.524/49.814 ms - As expected, both sides have the ability to send and - receive ICMP packets from the privately - configured addresses. Next, both gateways must be told how - to route packets in order to correctly send traffic from - either network. The following command will achieve this - goal: + As expected, both sides have the ability to send and + receive ICMP packets from the privately + configured addresses. Next, both gateways must be told how + to route packets in order to correctly send traffic from + either network. The following command will achieve this + goal: - &prompt.root; corp-net# route add 10.0.0.0 10.0.0.5 255.255.255.0 + &prompt.root; corp-net# route add 10.0.0.0 10.0.0.5 255.255.255.0 - &prompt.root; corp-net# route add net 10.0.0.0: gateway 10.0.0.5 + &prompt.root; corp-net# route add net 10.0.0.0: gateway 10.0.0.5 - &prompt.root; priv-net# route add 10.246.38.0 10.246.38.1 255.255.255.0 + &prompt.root; priv-net# route add 10.246.38.0 10.246.38.1 255.255.255.0 - &prompt.root; priv-net# route add host 10.246.38.0: gateway 10.246.38.1 + &prompt.root; priv-net# route add host 10.246.38.0: gateway 10.246.38.1 - At this point, internal machines should be reachable - from each gateway as well as from machines behind the - gateways. Again, use &man.ping.8; to confirm: + At this point, internal machines should be reachable + from each gateway as well as from machines behind the + gateways. Again, use &man.ping.8; to confirm: - corp-net# ping 10.0.0.8 + corp-net# ping 10.0.0.8 PING 10.0.0.8 (10.0.0.8): 56 data bytes 64 bytes from 10.0.0.8: icmp_seq=0 ttl=63 time=92.391 ms 64 bytes from 10.0.0.8: icmp_seq=1 ttl=63 time=21.870 ms @@ -2573,15 +2573,15 @@ PING 10.246.38.1 (10.246.38.107): 56 dat 5 packets transmitted, 5 packets received, 0% packet loss round-trip min/avg/max/stddev = 21.145/31.721/53.491/12.179 ms - Setting up the tunnels is the easy part. Configuring a - secure link is a more in depth process. The following - configuration uses pre-shared (PSK) - RSA keys. Other than the - IP addresses, the - /usr/local/etc/racoon/racoon.conf on - both gateways will be identical and look similar to: + Setting up the tunnels is the easy part. Configuring a + secure link is a more in depth process. The following + configuration uses pre-shared (PSK) + RSA keys. Other than the + IP addresses, the + /usr/local/etc/racoon/racoon.conf on + both gateways will be identical and look similar to: - path pre_shared_key "/usr/local/etc/racoon/psk.txt"; #location of pre-shared key file + path pre_shared_key "/usr/local/etc/racoon/psk.txt"; #location of pre-shared key file log debug; #log verbosity setting: set to 'notify' when testing and debugging is complete padding # options are not to be changed @@ -2639,33 +2639,33 @@ sainfo (address 10.246.38.0/24 any addr compression_algorithm deflate; } - For descriptions of each available option, refer to the - manual page for racoon.conf. + For descriptions of each available option, refer to the + manual page for racoon.conf. - The Security Policy Database (SPD) - needs to be configured so that &os; and - racoon are able to encrypt and - decrypt network traffic between the hosts. - - This can be achieved with a shell script, similar to the - following, on the corporate gateway. This file will be used - during system initialization and should be saved as - /usr/local/etc/racoon/setkey.conf. + The Security Policy Database (SPD) + needs to be configured so that &os; and + racoon are able to encrypt and + decrypt network traffic between the hosts. + + This can be achieved with a shell script, similar to the + following, on the corporate gateway. This file will be used + during system initialization and should be saved as + /usr/local/etc/racoon/setkey.conf. - flush; + flush; spdflush; # To the home network spdadd 10.246.38.0/24 10.0.0.0/24 any -P out ipsec esp/tunnel/172.16.5.4-192.168.1.12/use; spdadd 10.0.0.0/24 10.246.38.0/24 any -P in ipsec esp/tunnel/192.168.1.12-172.16.5.4/use; - Once in place, racoon may be - started on both gateways using the following command: + Once in place, racoon may be + started on both gateways using the following command: - &prompt.root; /usr/local/sbin/racoon -F -f /usr/local/etc/racoon/racoon.conf -l /var/log/racoon.log + &prompt.root; /usr/local/sbin/racoon -F -f /usr/local/etc/racoon/racoon.conf -l /var/log/racoon.log - The output should be similar to the following: + The output should be similar to the following: - corp-net# /usr/local/sbin/racoon -F -f /usr/local/etc/racoon/racoon.conf + corp-net# /usr/local/sbin/racoon -F -f /usr/local/etc/racoon/racoon.conf Foreground mode. 2006-01-30 01:35:47: INFO: begin Identity Protection mode. 2006-01-30 01:35:48: INFO: received Vendor ID: KAME/racoon @@ -2678,43 +2678,43 @@ Foreground mode. 2006-01-30 01:36:18: INFO: IPsec-SA established: ESP/Tunnel 192.168.1.12[0]->172.16.5.4[0] spi=124397467(0x76a279b) 2006-01-30 01:36:18: INFO: IPsec-SA established: ESP/Tunnel 172.16.5.4[0]->192.168.1.12[0] spi=175852902(0xa7b4d66) - To ensure the tunnel is working properly, switch to - another console and use &man.tcpdump.1; to view network - traffic using the following command. Replace - em0 with the network interface card as - required: - - &prompt.root; tcpdump -i em0 host 172.16.5.4 and dst 192.168.1.12 - - Data similar to the following should appear on the - console. If not, there is an issue and debugging the - returned data will be required. + To ensure the tunnel is working properly, switch to + another console and use &man.tcpdump.1; to view network + traffic using the following command. Replace + em0 with the network interface card as + required: + + &prompt.root; tcpdump -i em0 host 172.16.5.4 and dst 192.168.1.12 + + Data similar to the following should appear on the + console. If not, there is an issue and debugging the + returned data will be required. - 01:47:32.021683 IP corporatenetwork.com > 192.168.1.12.privatenetwork.com: ESP(spi=0x02acbf9f,seq=0xa) + 01:47:32.021683 IP corporatenetwork.com > 192.168.1.12.privatenetwork.com: ESP(spi=0x02acbf9f,seq=0xa) 01:47:33.022442 IP corporatenetwork.com > 192.168.1.12.privatenetwork.com: ESP(spi=0x02acbf9f,seq=0xb) 01:47:34.024218 IP corporatenetwork.com > 192.168.1.12.privatenetwork.com: ESP(spi=0x02acbf9f,seq=0xc) - At this point, both networks should be available and - seem to be part of the same network. Most likely both - networks are protected by a firewall. To allow traffic to - flow between them, rules need to be added to pass packets. - For the &man.ipfw.8; firewall, add the following lines to the - firewall configuration file: + At this point, both networks should be available and + seem to be part of the same network. Most likely both + networks are protected by a firewall. To allow traffic to + flow between them, rules need to be added to pass packets. + For the &man.ipfw.8; firewall, add the following lines to + the firewall configuration file: - ipfw add 00201 allow log esp from any to any + ipfw add 00201 allow log esp from any to any ipfw add 00202 allow log ah from any to any ipfw add 00203 allow log ipencap from any to any ipfw add 00204 allow log udp from any 500 to any - - The rule numbers may need to be altered depending on - the current host configuration. - + + The rule numbers may need to be altered depending on + the current host configuration. + - For users of &man.pf.4; or &man.ipf.8;, the following - rules should do the trick: + For users of &man.pf.4; or &man.ipf.8;, the following + rules should do the trick: - pass in quick proto esp from any to any + pass in quick proto esp from any to any pass in quick proto ah from any to any pass in quick proto ipencap from any to any pass in quick proto udp from any port = 500 to any port = 500 @@ -2725,16 +2725,16 @@ pass out quick proto ipencap from any to pass out quick proto udp from any port = 500 to any port = 500 pass out quick on gif0 from any to any - Finally, to allow the machine to start support for the - VPN during system initialization, add the - following lines to /etc/rc.conf: + Finally, to allow the machine to start support for the + VPN during system initialization, add the + following lines to /etc/rc.conf: - ipsec_enable="YES" + ipsec_enable="YES" ipsec_program="/usr/local/sbin/setkey" ipsec_file="/usr/local/etc/racoon/setkey.conf" # allows setting up spd policies on boot racoon_enable="yes" - - + + @@ -3719,11 +3719,11 @@ VII. References - - Tom - Rhodes - Contributed by - + + Tom + Rhodes + Contributed by + @@ -3767,35 +3767,37 @@ VII. References options RACCT options RCTL - The entire system will need rebuilt. See , which will provide instructions for - the process. Once this is complete, the rctl - may be used to set rules for the system. + The entire system will need rebuilt. See + , which will provide instructions + for the process. Once this is complete, the + rctl may be used to set rules for the + system. Rule syntax is simple, controlled through the use of - a subject, a subject-id, - resource, and action. - Take the following example rule: + a subject, a + subject-id, resource, + and action. Take the following example + rule: user:trhodes:maxproc:deny=10/user - This rule shows a basic premise of a rule, here the - subject is user and the subject-id - is trhodes. The maxproc is, of course, - max number of processes, which is considered the resource. - The action here is set to deny, which blocks - any new processes from being created. In the previous example, - the user, trhodes will be constrained - to 10 (ten) processes and no greater. - Other actions are available and could be log to the console, - pass a notification to &man.devd.8;, or - send a sigterm to the process. + This rule shows a basic premise of a rule, here the subject + is user and the subject-id is + trhodes. The maxproc is, of course, max + number of processes, which is considered the resource. The + action here is set to deny, which blocks any + new processes from being created. In the previous example, the + user, trhodes will be constrained to + 10 (ten) processes and no greater. Other + actions are available and could be log to the console, pass a + notification to &man.devd.8;, or send a sigterm to the + process. Some care must be taken while adding rules. The one above - will unfortunately block my user from doing the most simple tasks - after I have logged in and executed a screen - session. When a resource limit has been hit, an error will - be printed, as in this example: + will unfortunately block my user from doing the most simple + tasks after I have logged in and executed a + screen session. When a resource limit has + been hit, an error will be printed, as in this example: &prompt.user; man test /usr/bin/man: Cannot fork: Resource temporarily unavailable @@ -3808,9 +3810,9 @@ eval: Cannot fork: Resource temporarily &prompt.root; rctl -a jail:httpd:memoryuse:deny=2G/jail Rules may also persist across reboots if they have been - added to /etc/rctl.conf. The - format is a rule, without the preceding command. For example, - the previous rule could be added like the following: + added to /etc/rctl.conf. The format is a + rule, without the preceding command. For example, the previous + rule could be added like the following: # Block jail from using more than 2G memory: jail:httpd:memoryuse:deny=2G/jail @@ -3826,7 +3828,7 @@ jail:httpd:memoryuse:deny=2G/jail&prompt.root; rctl -r user:trhodes - Many other resources exist which can be used to excert + Many other resources exist which can be used to exert additional control over various subjects. See &man.rctl.8; to learn about them. From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 09:29:01 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 554E7BA5; Sat, 13 Jul 2013 09:29:01 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 47C4C1874; Sat, 13 Jul 2013 09:29:01 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6D9T1FZ066481; Sat, 13 Jul 2013 09:29:01 GMT (envelope-from ryusuke@svn.freebsd.org) Received: (from ryusuke@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6D9T17M066479; Sat, 13 Jul 2013 09:29:01 GMT (envelope-from ryusuke@svn.freebsd.org) Message-Id: <201307130929.r6D9T17M066479@svn.freebsd.org> From: Ryusuke SUZUKI Date: Sat, 13 Jul 2013 09:29:01 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42270 - head/ja_JP.eucJP/articles X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 09:29:01 -0000 Author: ryusuke Date: Sat Jul 13 09:29:00 2013 New Revision: 42270 URL: http://svnweb.freebsd.org/changeset/doc/42270 Log: - Merge the following from the English version: r26047 -> r41535 head/ja_JP.eucJP/articles/Makefile Modified: head/ja_JP.eucJP/articles/Makefile Modified: head/ja_JP.eucJP/articles/Makefile ============================================================================== --- head/ja_JP.eucJP/articles/Makefile Sat Jul 13 07:39:52 2013 (r42269) +++ head/ja_JP.eucJP/articles/Makefile Sat Jul 13 09:29:00 2013 (r42270) @@ -1,42 +1,51 @@ # $FreeBSD$ -# Original revision: 1.47 +# Original revision: r41535 SUBDIR = #SUBDIR+= bsdl-gpl +#SUBDIR+= building-products #SUBDIR+= casestudy-argentina.com #SUBDIR+= committers-guide +#SUBDIR+= compiz-fusion #SUBDIR+= console-server SUBDIR+= contributing #SUBDIR+= contributing-ports SUBDIR+= contributors +#SUBDIR+= cups +#SUBDIR+= custom-gcc #SUBDIR+= cvs-freebsd -#SUBDIR+= cvsup-advanced #SUBDIR+= explaining-bsd SUBDIR+= fbsd-from-scratch #SUBDIR+= filtering-bridges SUBDIR+= fonts #SUBDIR+= freebsd-questions +#SUBDIR+= freebsd-update-server #SUBDIR+= geom-class -#SUBDIR+= hats +#SUBDIR+= gjournal-desktop #SUBDIR+= hubs SUBDIR+= ipsec-must -#SUBDIR+= java-tomcat #SUBDIR+= laptop +#SUBDIR+= ldap-auth #SUBDIR+= linux-comparison +#SUBDIR+= linux-emulation +#SUBDIR+= linux-users #SUBDIR+= mailing-list-faq #SUBDIR+= mh +#SUBDIR+= nanobsd #SUBDIR+= new-users +#SUBDIR+= p4-primer #SUBDIR+= pam +#SUBDIR+= port-mentor-guidelines #SUBDIR+= portbuild #SUBDIR+= pr-guidelines SUBDIR+= problem-reports -#SUBDIR+= pxe +#SUBDIR+= rc-scripting #SUBDIR+= relaydelay #SUBDIR+= releng #SUBDIR+= releng-packages +#SUBDIR+= remote-install #SUBDIR+= serial-uart #SUBDIR+= solid-state -#SUBDIR+= vinum #SUBDIR+= vm-design # ROOT_SYMLINKS+= new-users From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 14:48:41 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 14912160; Sat, 13 Jul 2013 14:48:41 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 0778F1397; Sat, 13 Jul 2013 14:48:41 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6DEmeIe059703; Sat, 13 Jul 2013 14:48:40 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6DEme1S059702; Sat, 13 Jul 2013 14:48:40 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307131448.r6DEme1S059702@svn.freebsd.org> From: Gabor Pali Date: Sat, 13 Jul 2013 14:48:40 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42271 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 14:48:41 -0000 Author: pgj Date: Sat Jul 13 14:48:40 2013 New Revision: 42271 URL: http://svnweb.freebsd.org/changeset/doc/42271 Log: - Add date for the next deadline (in October) Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sat Jul 13 09:29:00 2013 (r42270) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Sat Jul 13 14:48:40 2013 (r42271) @@ -38,9 +38,8 @@
Thanks to all the reporters for the excellent work! This report contains 33 entries and we hope you enjoy reading it.
- -
The deadline for submissions covering between July and September 2013 - is not yet decided.
+
The deadline for submissions covering between July and September + 2013 is October 7th, 2013.
From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 18:20:08 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 8D5D59C2; Sat, 13 Jul 2013 18:20:08 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 7FA181BD4; Sat, 13 Jul 2013 18:20:08 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6DIK82q029615; Sat, 13 Jul 2013 18:20:08 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6DIK8E2029610; Sat, 13 Jul 2013 18:20:08 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307131820.r6DIK8E2029610@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 18:20:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42273 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 18:20:08 -0000 Author: wblock Date: Sat Jul 13 18:20:08 2013 New Revision: 42273 URL: http://svnweb.freebsd.org/changeset/doc/42273 Log: Correctly use the plural "users". Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Sat Jul 13 16:20:18 2013 (r42272) +++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml Sat Jul 13 18:20:08 2013 (r42273) @@ -828,7 +828,7 @@ example.xml:5: element head: validity er -- doing multiline comments --> - XHTML user may be familiar with different + XHTML users may be familiar with different rules for comments. In particular, it is often believed that the string . From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 21:12:09 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id F12E2F78; Sat, 13 Jul 2013 21:12:08 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id D2DEB1039; Sat, 13 Jul 2013 21:12:08 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6DLC8SJ070188; Sat, 13 Jul 2013 21:12:08 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6DLC8fl070186; Sat, 13 Jul 2013 21:12:08 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307132112.r6DLC8fl070186@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 21:12:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42274 - head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 21:12:09 -0000 Author: wblock Date: Sat Jul 13 21:12:08 2013 New Revision: 42274 URL: http://svnweb.freebsd.org/changeset/doc/42274 Log: Revise and edit the XHTML chapter. Improve clarity, voice, and examples. Replace CDATA with longer but technically correct ("the best kind of correct") sgmltag usage. Modified: head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Sat Jul 13 18:20:08 2013 (r42273) +++ head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Sat Jul 13 21:12:08 2013 (r42274) @@ -60,9 +60,9 @@ transitional variants. The XHTML DTDs are - available from the Ports Collection in + available from the Ports Collection in textproc/xhtml. They are - automatically installed as part of the textproc/docproj port. @@ -91,7 +91,7 @@ There are a number of XHTML FPIs, depending upon the version, or level of XHTML to which - a document conforms. Most XHTML documents on the FreeBSD web + a document conforms. Most XHTML documents on the FreeBSD web site comply with the transitional version of XHTML 1.0. @@ -106,7 +106,7 @@ head, contains meta-information about the document, such as its title, the name of the author, the parent document, and so on. The second section, the - body, contains the content that will be + body, contains content that will be displayed to the user. These sections are indicated with head @@ -118,17 +118,17 @@ Normal <acronym>XHTML</acronym> Document Structure - <html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <title>The Document's Title</title> - </head> + html xmlns="http://www.w3.org/1999/xhtml" + head + titleThe Document's Titletitle + head - <body> + body … - </body> -</html> + body +html @@ -153,47 +153,28 @@ Usage: - First section + h1First sectionh1 - + -
This is the heading for the first section
+h2This is the heading for the first sectionh2 - + -
This is the heading for the first sub-section
+h3This is the heading for the first sub-sectionh3 - + -
This is the heading for the second section
+h2This is the heading for the second sectionh2 -]]> + Generally, an XHTML page should have one first level heading (h1). This can contain many second level headings (h2), - which can in turn contain many third level headings. Each - hn element - should have the same element, but one further up the - hierarchy, preceding it. Leaving gaps in the numbering is to - be avoided. - - - Bad Ordering of - <sgmltag>h<replaceable>n</replaceable></sgmltag> - Elements - - Usage: - - First section - - - -
Sub-section
- -]]> - + which can in turn contain many third level headings. + Do not leave gaps in the numbering. @@ -207,8 +188,8 @@ Usage: - This is a paragraph. It can contain just about any - other element.
]]> + pThis is a paragraph. It can contain just about any + other element.p @@ -216,7 +197,7 @@ Block Quotations A block quotation is an extended quotation from another - document that should not appear within the current + document that will appear in a separate paragraph. @@ -224,14 +205,14 @@ Usage: - A small excerpt from the US Constitution:
+ pA small excerpt from the US Constitution:p -
We the People of the United States, in Order to form +blockquoteWe the People of the United States, in Order to form a more perfect Union, establish Justice, insure domestic Tranquility, provide for the common defence, promote the general Welfare, and secure the Blessings of Liberty to ourselves and our Posterity, do ordain and establish this Constitution for the - United States of America.
]]> + United States of America.blockquote @@ -241,12 +222,11 @@ XHTML can present the user with three types of lists: ordered, unordered, and definition. - Typically, each entry in an ordered list will be - numbered, while each entry in an unordered list will be - preceded by a bullet point. Definition lists are composed of + Entries in an ordered list will be + numbered, while entries in an unordered list will be + preceded by bullet points. Definition lists have two sections for each entry. The first section is the term - being defined, and the second section is the definition of the - term. + being defined, and the second section is the definition. Ordered lists are indicated by the ol element, unordered lists by the ul @@ -270,31 +250,31 @@ Usage: - An unordered list. Listitems will probably be - preceded by bullets.
+ pAn unordered list. Listitems will probably be + preceded by bullets.p -
-
First item
+ul + liFirst itemli -
Second item
+ liSecond itemli -
Third item
-
+ liThird itemli +ul -
An ordered list, with list items consisting of multiple +pAn ordered list, with list items consisting of multiple paragraphs. Each item (note: not each paragraph) will be - numbered.
+ numbered.p -
-
This is the first item. It only has one paragraph.
+ol + lipThis is the first item. It only has one paragraph.pli -
This is the first paragraph of the second item.
+ lipThis is the first paragraph of the second item.p -
This is the second paragraph of the second item.
+ pThis is the second paragraph of the second item.pli -
This is the first and only paragraph of the third - item.
-
]]> + lipThis is the first and only paragraph of the third + item.pli +ol @@ -302,33 +282,33 @@ Usage: - -
Term 1
+ dl + dtTerm 1dt -
Paragraph 1 of definition 1.
+ ddpParagraph 1 of definition 1.p -
Paragraph 2 of definition 1.
+ pParagraph 2 of definition 1.pdd -
Term 2
+ dtTerm 2dt -
Paragraph 1 of definition 2.
+ ddpParagraph 1 of definition 2.pdd -
Term 3
+ dtTerm 3dt -
Paragraph 1 of definition 3.
-]]> + ddpParagraph 1 of definition 3.pdd +dl Pre-formatted Text - Pre-formatted text can be shown to the user exactly as it - is in the file. Typically, this means that the text is shown - in a fixed font, multiple spaces are not merged into one, and - line breaks in the text are significant. + Pre-formatted text is shown to the user exactly as it + is in the file. Text is shown in a fixed font. + Multiple spaces and line breaks are shown exactly as they are + in the file. - In order to do this, wrap the content in the + Wrap pre-formatted text in the pre element. @@ -337,18 +317,18 @@ For example, the pre tags could be used to mark up an email message: - From: nik@FreeBSD.org + pre From: nik@FreeBSD.org To: freebsd-doc@FreeBSD.org Subject: New documentation available There is a new copy of my primer for contributors to the FreeBSD Documentation Project available at - <URL:http://people.FreeBSD.org/~nik/primer/index.html> + <URL:http://people.FreeBSD.org/~nik/primer/index.html> Comments appreciated. - N]]> + Npre Keep in mind that < and & still are recognized as special @@ -379,101 +359,101 @@ Usage: - This is a simple 2x2 table.
+ pThis is a simple 2x2 table.p -

&a.des; <des@FreeBSD.org> &a.des.email; ��ƥ��ե��

&a.delphij; <delphij@FreeBSD.org> &a.delphij.email; ��ƥ��ե��亴

&a.simon; <simon@FreeBSD.org> &a.simon.email; ̾��ƥ��ե��

&a.cperciva; <cperciva@FreeBSD.org> &a.cperciva.email; ̾��ƥ��ե��

&a.rwatson; <rwatson@FreeBSD.org> &a.rwatson.email; ��꡼��󥸥˥��󥰾ĳ��
TrustedBSD �ץ��Ⱦĳ��ƥॻ��ƥ��ƥ��

`stable/9` Open committers Frozen &contact.re; Development branch for FreeBSD 9-STABLE.
- - +table + tr + tdTop left celltd - - + tdTop right celltd + tr - - + tr + tdBottom left celltd - - -
Top left cell Top right cell
Bottom left cell Bottom right cell
]]> + tdBottom right celltd + tr +table - A cell can span multiple rows and columns. To indicate - this, add the rowspan and/or - colspan attributes, with values indicating - the number of rows or columns that should be spanned. + A cell can span multiple rows and columns by adding + the rowspan or + colspan attributes with values for + the number of rows or columns to be spanned. - Using <literal>rowspan</literal> + Using <sgmltag class="attribute">rowspan</sgmltag> Usage: - One tall thin cell on the left, two short cells next to - it on the right.
+ pOne tall thin cell on the left, two short cells next to + it on the right.p - - - - +table + tr + td rowspan="2"Long and thintd + tr - - + tr + tdTop celltd - - -
Long and thin
Top cell Bottom cell
]]> + tdBottom celltd + tr +table - Using <literal>colspan</literal> + Using <sgmltag class="attribute">colspan</sgmltag> Usage: - One long cell on top, two short cells below it.
+ pOne long cell on top, two short cells below it.p - - - - +table + tr + td colspan="2"Top celltd + tr - - + tr + tdBottom left celltd - - -
Top cell
Bottom left cell Bottom right cell
]]> + tdBottom right celltd + tr +table - Using <literal>rowspan</literal> and - <literal>colspan</literal> Together + Using <sgmltag class="attribute">rowspan</sgmltag> and + <sgmltag class="attribute">colspan</sgmltag> Together Usage: - On a 3x3 grid, the top left block is a 2x2 set of - cells merged into one. The other cells are normal.
+ pOn a 3x3 grid, the top left block is a 2x2 set of + cells merged into one. The other cells are normal.p - - - +table + tr + td colspan="2" rowspan="2"Top left large celltd - - + tdTop right celltd + tr - - + tr +  - - + tdMiddle right celltd + tr - - + tr + tdBottom left celltd - + tdBottom middle celltd - - -
Top left large cell Top right cell
Middle right cell
Bottom left cell Bottom middle cell Bottom right cell
]]> + tdBottom right celltd + tr +table @@ -490,11 +470,11 @@ normal level of emphasis and strong indicates stronger emphasis. - Typically, em is rendered in italic + em is typically rendered in italic and strong is rendered in bold. This is - not always the case, however, and should not be relied upon. - According to best practices, webpages only hold structural and - semantical information and stylesheets are later applied to + not always the case, and should not be relied upon. + According to best practices, web pages only hold structural and + semantical information, and stylesheets are later applied to them. Think of semantics, not formatting, when using these tags. @@ -504,8 +484,8 @@ Usage: - This has been emphasized, while - this has been strongly emphasized.
]]> + pemThisem has been emphasized, while + strongthisstrong has been strongly emphasized.p @@ -521,9 +501,8 @@ Usage: - This document was originally written by - Nik Clayton, who can be reached by email as - `nik@FreeBSD.org`.
]]> + pMany system settings are stored in + tt/etctt.p @@ -537,75 +516,76 @@ Linking to Other Documents on the Web - A link points to the URL of another + A link points to the URL of a document on the web. The link is indicated with - a, and the href + a, and the href attribute contains the URL of the target - document. The content of the element becomes the link, and - is normally indicated to the user in some way, - typically by a different color or underlining. + document. The content of the element becomes the link, + indicated to the user by showing it in + a different color or with an underline. - Using <literal><a href="..."></literal> + Using <sgmltag class="starttag">a href="..."</sgmltag> Usage: - More information is available at the - FreeBSD web site.
]]> + pMore information is available at the + a href="http://www.&os;.org/"&os; web sitea.p - These links will take the user to the top of the chosen + This link always takes the user to the top of the linked document. - - Linking to Other Parts of Documents + + Linking to Specific Parts of Documents - Linking to a point within another document, or within - the same document, requires that the document author include - anchors. Anchors are indicated with - a and the id attribute - instead of href. + To link to a specific point within a document, that + document must include an + anchor at the desired point. Anchors are included by setting the + id attribute of an element to a name. + This example creates an anchor by setting the id attribute + of a p element. - Using <literal><a id="..."></literal> + Creating an Anchor Usage: - This paragraph can be referenced - in other links with the name `para1`.
]]> + p id="samplepara"This paragraph can be referenced + in other links with the name ttsampleparatt.p - To link to a named part of a document, write a normal - link to that document, but include the ID - of the anchor after a # symbol. + Links to anchors are similar to plain links, + but include a # symbol and the anchor's ID + at the end of the URL. - Linking to a Named Part of Another Document + Linking to a Named Part of a Different Document - Assume that the para1 example - resides in a document called - foo.html. - - More information can be found in the - first paragraph of - `foo.html`.
]]> + The samplepara example + is part of a document called + foo.html. A link to that specific + paragraph in the document is constructed in this example. + + pMore information can be found in the + a href="foo.html#samplepara"sample paragrapha of + ttfoo.htmltt.p - If you are linking to a named anchor within the same - document then you can omit the document's URL, and just - include the name of the anchor (with the preceding - #). + To link to a named anchor within the same + document, omit the document's URL, and just + use the # symbol followed by the name of the anchor. Linking to a Named Part of the Same Document - Assume that the para1 example - resides in this document: + The samplepara example + resides in this document. To link to it: - More information can be found in the - first paragraph of this - document.
]]> + pMore information can be found in the + a href="#samplepara"sample paragrapha of this + document.p From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 21:25:15 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id B30F134E; Sat, 13 Jul 2013 21:25:15 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A44A5108C; Sat, 13 Jul 2013 21:25:15 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6DLPFHt073430; Sat, 13 Jul 2013 21:25:15 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6DLPFeJ073429; Sat, 13 Jul 2013 21:25:15 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307132125.r6DLPFeJ073429@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 21:25:15 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42275 - head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 21:25:15 -0000 Author: wblock Date: Sat Jul 13 21:25:15 2013 New Revision: 42275 URL: http://svnweb.freebsd.org/changeset/doc/42275 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Sat Jul 13 21:12:08 2013 (r42274) +++ head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Sat Jul 13 21:25:15 2013 (r42275) @@ -91,8 +91,8 @@ There are a number of XHTML FPIs, depending upon the version, or level of XHTML to which - a document conforms. Most XHTML documents on the FreeBSD web - site comply with the transitional version of + a document conforms. Most XHTML documents on + the FreeBSD web site comply with the transitional version of XHTML 1.0. PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" @@ -173,8 +173,8 @@ Generally, an XHTML page should have one first level heading (h1). This can contain many second level headings (h2), - which can in turn contain many third level headings. - Do not leave gaps in the numbering. + which can in turn contain many third level headings. Do not + leave gaps in the numbering. @@ -197,8 +197,7 @@ Block Quotations A block quotation is an extended quotation from another - document that will appear in a separate - paragraph. + document that will appear in a separate paragraph. <sgmltag>blockquote</sgmltag> @@ -222,11 +221,11 @@ XHTML can present the user with three types of lists: ordered, unordered, and definition. - Entries in an ordered list will be - numbered, while entries in an unordered list will be - preceded by bullet points. Definition lists have - two sections for each entry. The first section is the term - being defined, and the second section is the definition. + Entries in an ordered list will be numbered, while entries + in an unordered list will be preceded by bullet points. + Definition lists have two sections for each entry. The first + section is the term being defined, and the second section is + the definition. Ordered lists are indicated by the ol element, unordered lists by the ul @@ -303,13 +302,13 @@ Pre-formatted Text - Pre-formatted text is shown to the user exactly as it - is in the file. Text is shown in a fixed font. - Multiple spaces and line breaks are shown exactly as they are - in the file. + Pre-formatted text is shown to the user exactly as it is + in the file. Text is shown in a fixed font. Multiple spaces + and line breaks are shown exactly as they are in the + file. - Wrap pre-formatted text in the - pre element. + Wrap pre-formatted text in the pre + element. <sgmltag>pre</sgmltag> @@ -376,13 +375,14 @@ table - A cell can span multiple rows and columns by adding - the rowspan or - colspan attributes with values for - the number of rows or columns to be spanned. + A cell can span multiple rows and columns by adding the + rowspan or + colspan attributes with + values for the number of rows or columns to be spanned. - Using <sgmltag class="attribute">rowspan</sgmltag> + Using + <sgmltag class="attribute">rowspan</sgmltag> Usage: @@ -403,7 +403,8 @@ - Using <sgmltag class="attribute">colspan</sgmltag> + Using + <sgmltag class="attribute">colspan</sgmltag> Usage: @@ -424,7 +425,8 @@ Using <sgmltag class="attribute">rowspan</sgmltag> and - <sgmltag class="attribute">colspan</sgmltag> Together + colspan + Together Usage: @@ -466,14 +468,14 @@ Two levels of emphasis are available in XHTML, em and - strong. em is for a + strong. em is for a normal level of emphasis and strong indicates stronger emphasis. em is typically rendered in italic and strong is rendered in bold. This is - not always the case, and should not be relied upon. - According to best practices, web pages only hold structural and + not always the case, and should not be relied upon. According + to best practices, web pages only hold structural and semantical information, and stylesheets are later applied to them. Think of semantics, not formatting, when using these tags. @@ -518,14 +520,16 @@ A link points to the URL of a document on the web. The link is indicated with - a, and the href - attribute contains the URL of the target - document. The content of the element becomes the link, - indicated to the user by showing it in - a different color or with an underline. + a, and the + href attribute contains + the URL of the target document. The + content of the element becomes the link, indicated to the + user by showing it in a different color or with an + underline. - Using <sgmltag class="starttag">a href="..."</sgmltag> + Using + <sgmltag class="starttag">a href="..."</sgmltag> Usage: @@ -541,11 +545,13 @@ Linking to Specific Parts of Documents To link to a specific point within a document, that - document must include an - anchor at the desired point. Anchors are included by setting the - id attribute of an element to a name. - This example creates an anchor by setting the id attribute - of a p element. + document must include an anchor at the + desired point. Anchors are included by setting the + id attribute of an + element to a name. This example creates an anchor by + setting the id + attribute of a p + element. Creating an Anchor @@ -556,26 +562,29 @@ in other links with the name ttsampleparatt.p - Links to anchors are similar to plain links, - but include a # symbol and the anchor's ID - at the end of the URL. + Links to anchors are similar to plain links, but include + a # symbol and the anchor's + ID at the end of the + URL. - Linking to a Named Part of a Different Document + Linking to a Named Part of a Different + Document - The samplepara example - is part of a document called - foo.html. A link to that specific - paragraph in the document is constructed in this example. + The samplepara example is part of a + document called foo.html. A link to + that specific paragraph in the document is constructed in + this example. pMore information can be found in the a href="foo.html#samplepara"sample paragrapha of ttfoo.htmltt.p - To link to a named anchor within the same - document, omit the document's URL, and just - use the # symbol followed by the name of the anchor. + To link to a named anchor within the same document, omit + the document's URL, and just use the + # symbol followed by the name of the + anchor. Linking to a Named Part of the Same Document From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 21:28:23 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 7C4753B7; Sat, 13 Jul 2013 21:28:23 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 6CBA81092; Sat, 13 Jul 2013 21:28:23 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6DLSNWO075960; Sat, 13 Jul 2013 21:28:23 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6DLSNP3075959; Sat, 13 Jul 2013 21:28:23 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307132128.r6DLSNP3075959@svn.freebsd.org> From: Warren Block Date: Sat, 13 Jul 2013 21:28:23 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42276 - head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 21:28:23 -0000 Author: wblock Date: Sat Jul 13 21:28:22 2013 New Revision: 42276 URL: http://svnweb.freebsd.org/changeset/doc/42276 Log: Unfix a singular that really should have been plural, and replace another "FreeBSD" with &os;. Modified: head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Sat Jul 13 21:25:15 2013 (r42275) +++ head/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml Sat Jul 13 21:28:22 2013 (r42276) @@ -86,13 +86,13 @@ - Formal Public Identifier (<acronym>FPI</acronym>) + Formal Public Identifier (<acronym>FPI</acronym>)s There are a number of XHTML FPIs, depending upon the version, or level of XHTML to which a document conforms. Most XHTML documents on - the FreeBSD web site comply with the transitional version of + the &os; web site comply with the transitional version of XHTML 1.0. PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 21:37:21 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A9531542; Sat, 13 Jul 2013 21:37:21 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 18E9E10BD; Sat, 13 Jul 2013 21:37:20 +0000 (UTC) X-AuditID: 12074423-b7f168e00000095a-e2-51e1c88a8b0b Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id AA.AE.02394.A88C1E15; Sat, 13 Jul 2013 17:37:14 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r6DLbDKB028337; Sat, 13 Jul 2013 17:37:13 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r6DLbBtX029841 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 13 Jul 2013 17:37:12 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r6DLbASW008317; Sat, 13 Jul 2013 17:37:10 -0400 (EDT) Date: Sat, 13 Jul 2013 17:37:10 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42266 - head/en_US.ISO8859-1/books/handbook/security In-Reply-To: <201307130333.r6D3XLuD063885@svn.freebsd.org> Message-ID: References: <201307130333.r6D3XLuD063885@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrDIsWRmVeSWpSXmKPExsUixCmqrdt14mGgQf9HOYsfHw8xWdxYtJ/J Ynd/L7PF5fcTWRxYPGZ8ms8SwBjFZZOSmpNZllqkb5fAlfFu5Xumgq/cFdu+n2dvYLzP2cXI ySEhYCKxbfdbJghbTOLCvfVsXYxcHEIC+xglri/pY4JwNjJK/J7QyQ7hHGKSOHp1HpDDAeQ0 MEqctQLpZhHQllh4/zTYJDYBFYmZbzaygdgiAqoS37tXgcWZBaIk9ixtZAVpFRYIkPg+JRwk zClgJbFm5zRGEJtXwFHi0o5PYK1CApYSZ7e2g8VFBXQkVu+fwgJRIyhxcuYTFoiRlhL/1v5i ncAoOAtJahaS1AJGplWMsim5Vbq5iZk5xanJusXJiXl5qUW6Znq5mSV6qSmlmxhBAcvuoryD 8c9BpUOMAhyMSjy8moceBgqxJpYVV+YeYpTkYFIS5c3dCRTiS8pPqcxILM6ILyrNSS0+xCjB wawkwpv990GgEG9KYmVValE+TEqag0VJnPfZ07OBQgLpiSWp2ampBalFMFkZDg4lCd6w40BD BYtS01Mr0jJzShDSTBycIMN5gIYHgNTwFhck5hZnpkPkTzHqckw+u+U9oxBLXn5eqpQ4rwVI kQBIUUZpHtwcWKJ5xSgO9JYwbzRIFQ8wScFNegW0hAloye1V90GWlCQipKQaGE3PCj55GWL0 b1fyGvaauG+yvqWruy+8/mfCzlp+XvFDzaVajVL7zuX1C5tU7C9z9uYadLxl2tjzZr7Wh1s+ 50XKjsnxFvf8DX6dMG3PTb3Ir0n8RslpHpd2cX1KcvH7vfTn15/3XoolbVeuWcaezHp010/X AxotPvlpLdOFHt7tnr+AQ6XisxJLcUaioRZzUXEiAMk9Wu4PAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 21:37:21 -0000 On Sat, 13 Jul 2013, Warren Block wrote: > Author: wblock > Date: Sat Jul 13 03:33:20 2013 > New Revision: 42266 > URL: http://svnweb.freebsd.org/changeset/doc/42266 > > Log: > Fix a wording bug: action to resource. Also fix some title > capitalization and redundancy issues. > > Submitted by: MNIHKLOM (forum user, action/resource issue) > > Modified: > head/en_US.ISO8859-1/books/handbook/security/chapter.xml > > Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 01:50:56 2013 (r42265) > +++ head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 03:33:20 2013 (r42266) > @@ -3744,7 +3744,7 @@ VII. References Potentially a single, more constrained user would require > an additional label added, the resource database needs to be > built using cap_mkdb, edits made to > - the /etc/master.passwd file. In > + /etc/master.passwd. In This sentence seems rather confused. My best guess is that there used to be a list of three things, and the last one was removed sloppily. -Ben > addition, the password database must be rebuilt using > pwd_mkdb. This multi-step process could be > very time consuming depending on how many users must be From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 22:45:47 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id C7E8D225; Sat, 13 Jul 2013 22:45:47 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 7192B1276; Sat, 13 Jul 2013 22:45:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6DMjl33001165; Sat, 13 Jul 2013 22:45:47 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6DMjlqj001164; Sat, 13 Jul 2013 22:45:47 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201307132245.r6DMjlqj001164@svn.freebsd.org> From: Eitan Adler Date: Sat, 13 Jul 2013 22:45:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42277 - head/share/xml X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 22:45:48 -0000 Author: eadler Date: Sat Jul 13 22:45:46 2013 New Revision: 42277 URL: http://svnweb.freebsd.org/changeset/doc/42277 Log: Sort author entity list. Submitted by: Christoph Mallon Modified: head/share/xml/authors.ent Modified: head/share/xml/authors.ent ============================================================================== --- head/share/xml/authors.ent Sat Jul 13 21:28:22 2013 (r42276) +++ head/share/xml/authors.ent Sat Jul 13 22:45:46 2013 (r42277) @@ -165,12 +165,12 @@ asmodai@FreeBSD.org"> - -assar@FreeBSD.org"> - asomers@FreeBSD.org"> + +assar@FreeBSD.org"> + ats@FreeBSD.org"> @@ -498,9 +498,6 @@ dds@FreeBSD.org"> - -ds@FreeBSD.org"> - deb@FreeBSD.org"> @@ -576,6 +573,9 @@ dryice@FreeBSD.org"> + +ds@FreeBSD.org"> + dt@FreeBSD.org"> @@ -813,12 +813,12 @@ helbig@FreeBSD.org"> - -hm@FreeBSD.org"> - hiren@FreeBSD.org"> + +hm@FreeBSD.org"> + hmp@FreeBSD.org"> @@ -1254,12 +1254,6 @@ maho@FreeBSD.org"> - -marino@FreeBSD.org"> - - -markj@FreeBSD.org"> - makc@FreeBSD.org"> @@ -1278,9 +1272,15 @@ marcus@FreeBSD.org"> + +marino@FreeBSD.org"> + marius@FreeBSD.org"> + +markj@FreeBSD.org"> + markm@FreeBSD.org"> @@ -1941,9 +1941,6 @@ steve@FreeBSD.org"> - -syuu@FreeBSD.org"> - sumikawa@FreeBSD.org"> @@ -1965,6 +1962,9 @@ syrinx@FreeBSD.org"> + +syuu@FreeBSD.org"> + tabthorpe@FreeBSD.org"> From owner-svn-doc-all@FreeBSD.ORG Sat Jul 13 23:13:23 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id F3DDF652; Sat, 13 Jul 2013 23:13:22 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id B6CF01302; Sat, 13 Jul 2013 23:13:22 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r6DNDG2F064078; Sat, 13 Jul 2013 17:13:16 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6DNDFbg064075; Sat, 13 Jul 2013 17:13:15 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sat, 13 Jul 2013 17:13:15 -0600 (MDT) From: Warren Block To: Benjamin Kaduk Subject: Re: svn commit: r42266 - head/en_US.ISO8859-1/books/handbook/security In-Reply-To: Message-ID: References: <201307130333.r6D3XLuD063885@svn.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Sat, 13 Jul 2013 17:13:16 -0600 (MDT) Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees $except for " user" , " projects" , and " translations" $" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 Jul 2013 23:13:23 -0000 On Sat, 13 Jul 2013, Benjamin Kaduk wrote: > On Sat, 13 Jul 2013, Warren Block wrote: > >> Author: wblock >> Date: Sat Jul 13 03:33:20 2013 >> New Revision: 42266 >> URL: http://svnweb.freebsd.org/changeset/doc/42266 >> >> Log: >> Fix a wording bug: action to resource. Also fix some title >> capitalization and redundancy issues. >> >> Submitted by: MNIHKLOM (forum user, action/resource issue) >> >> Modified: >> head/en_US.ISO8859-1/books/handbook/security/chapter.xml >> >> Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml >> ============================================================================== >> --- head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 >> 01:50:56 2013 (r42265) >> +++ head/en_US.ISO8859-1/books/handbook/security/chapter.xml Sat Jul 13 >> 03:33:20 2013 (r42266) >> @@ -3744,7 +3744,7 @@ VII. References > Potentially a single, more constrained user would require >> an additional label added, the resource database needs to be >> built using cap_mkdb, edits made to >> - the /etc/master.passwd file. In >> + /etc/master.passwd. In > > This sentence seems rather confused. My best guess is that there used to be > a list of three things, and the last one was removed sloppily. How about this: Potentially a single, more constrained user would require an additional label to be added, the resource database rebuilt using cap_mkdb, and edits made to /etc/master.passwd.

&a.des; <des@FreeBSD.org>	&a.des.email;	��ƥ��ե��
&a.delphij; <delphij@FreeBSD.org>	&a.delphij.email;	��ƥ��ե��亴
&a.simon; <simon@FreeBSD.org>	&a.simon.email;	̾��ƥ��ե��
&a.cperciva; <cperciva@FreeBSD.org>	&a.cperciva.email;	̾��ƥ��ե��
&a.rwatson; <rwatson@FreeBSD.org>	&a.rwatson.email;	��꡼��󥸥˥��󥰾ĳ�� TrustedBSD �ץ��Ⱦĳ��ƥॻ��ƥ��ƥ��
`stable/9`	Open	committers	Frozen	&contact.re;	Development branch for FreeBSD 9-STABLE.

Top left cell	Top right cell
Bottom left cell	Bottom right cell

Top left large cell		Top right cell
Top left large cell		Middle right cell
Bottom left cell	Bottom middle cell	Bottom right cell

&os; Documentatiebeheerteam @@ -107,10 +107,10 @@ Documentatiebeheerteam in meer detail. - &a.gjb; <gjb@FreeBSD.org> - &a.blackend; <blackend@FreeBSD.org> - &a.gabor; <gabor@FreeBSD.org> - &a.hrs; <hrs@FreeBSD.org> + &a.gjb.email; + &a.blackend.email; + &a.gabor.email; + &a.hrs.email;

Verkopersrelaties @@ -282,7 +279,7 @@ acties van core. - &a.pgj; <pgj@FreeBSD.org> + &a.pgj.email;

Portbeheerteam-secretaris @@ -298,7 +295,7 @@ recente beslissingen en acties van portmgr bevatten. - &a.tabthorpe; <tabthorpe@FreeBSD.org> + &a.tabthorpe.email;

Beveiligingsteam Secretaris @@ -312,7 +309,7 @@ Beveiligingsteam-secretaris geen zaken van het Beveiligingsofficierteam. - &a.gnn; <gnn@FreeBSD.org> + &a.gnn.email; @@ -327,8 +324,8 @@ entiteit. - &a.simon; <simon@FreeBSD.org> - &a.dhw; <dhw@FreeBSD.org> + &a.simon.email; + &a.dhw.email;

Back-upbeheerders @@ -338,8 +335,8 @@ De Back-upbeheerders behandelen alle back-ups op het &os;-cluster. - &a.simon; <simon@FreeBSD.org> - &a.dhw; <dhw@FreeBSD.org> + &a.simon.email; + &a.dhw.email;

Bugmeisters & GNATS Beheerders @@ -351,9 +348,9 @@ verantwoordelijk voor de probleemrapportagegroep. - &a.eadler; <eadler@FreeBSD.org< - &a.gavin; <gavin@FreeBSD.org< - &a.gonzo; <gonzo@FreeBSD.org< + &a.eadler.email; + &a.gavin.email; + &a.gonzo.email;

CVSup Mirror Site Co�rdinatoren @@ -393,8 +390,8 @@ voor het grote publiek om hun dichtstbijzijnde CVSup-spiegel te vinden. - &a.kuriyama; <kuriyama@FreeBSD.org> - &a.kensmith; <kensmith@FreeBSD.org> + &a.kuriyama.email; + &a.kensmith.email;

DNS Beheerders @@ -405,10 +402,10 @@ aanverwante diensten. - &a.brd; <brd@FreeBSD.org> - &a.simon; <simon@FreeBSD.org> - &a.peter; <peter@FreeBSD.org> - &a.bz; <bz@FreeBSD.org> + &a.brd.email; + &a.simon.email; + &a.peter.email; + &a.bz.email;

Postmeesterteam @@ -456,11 +453,11 @@ trol-, spam- en virusfilters. - &a.jmb; <jmb@FreeBSD.org> - &a.brd; <brd@FreeBSD.org> - &a.flo; <flo@FreeBSD.org> - &a.sahil; <sahil@FreeBSD.org> - &a.dhw; <dhw@FreeBSD.org> + &a.jmb.email; + &a.brd.email; + &a.flo.email; + &a.sahil.email; + &a.dhw.email;

Subversion Beheerders <svnadm@>

û�����󥹥ȡ��륬����

FreeBSD/sparc64 �᡼��󥰥ꥹ��

This is the heading for the first section

This is the heading for the first sub-section

This is the heading for the second section

Sub-section

&os; Documentatiebeheerteam @@ -107,10 +107,10 @@ Documentatiebeheerteam in meer detail.

-
&a.gjb; <gjb@FreeBSD.org>
-
&a.blackend; <blackend@FreeBSD.org>
-
&a.gabor; <gabor@FreeBSD.org>
-
&a.hrs; <hrs@FreeBSD.org>
+
&a.gjb.email;
+
&a.blackend.email;
+
&a.gabor.email;
+
&a.hrs.email;

Verkopersrelaties @@ -282,7 +279,7 @@ acties van core.

-
&a.pgj; <pgj@FreeBSD.org>
+
&a.pgj.email;

Portbeheerteam-secretaris @@ -298,7 +295,7 @@ recente beslissingen en acties van portmgr bevatten.

-
&a.tabthorpe; <tabthorpe@FreeBSD.org>
+
&a.tabthorpe.email;

Beveiligingsteam Secretaris @@ -312,7 +309,7 @@ Beveiligingsteam-secretaris geen zaken van het Beveiligingsofficierteam.

-
&a.gnn; <gnn@FreeBSD.org>
+
&a.gnn.email;

@@ -327,8 +324,8 @@ entiteit.

-
&a.simon; <simon@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.simon.email;
+
&a.dhw.email;

Back-upbeheerders @@ -338,8 +335,8 @@
De Back-upbeheerders behandelen alle back-ups op het &os;-cluster.

-
&a.simon; <simon@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.simon.email;
+
&a.dhw.email;

Bugmeisters & GNATS Beheerders @@ -351,9 +348,9 @@ verantwoordelijk voor de probleemrapportagegroep.

-
&a.eadler; <eadler@FreeBSD.org<
-
&a.gavin; <gavin@FreeBSD.org<
-
&a.gonzo; <gonzo@FreeBSD.org<
+
&a.eadler.email;
+
&a.gavin.email;
+
&a.gonzo.email;

CVSup Mirror Site Co�rdinatoren @@ -393,8 +390,8 @@ voor het grote publiek om hun dichtstbijzijnde CVSup-spiegel te vinden.

-
&a.kuriyama; <kuriyama@FreeBSD.org>
-
&a.kensmith; <kensmith@FreeBSD.org>
+
&a.kuriyama.email;
+
&a.kensmith.email;

DNS Beheerders @@ -405,10 +402,10 @@ aanverwante diensten.

-
&a.brd; <brd@FreeBSD.org>
-
&a.simon; <simon@FreeBSD.org>
-
&a.peter; <peter@FreeBSD.org>
-
&a.bz; <bz@FreeBSD.org>
+
&a.brd.email;
+
&a.simon.email;
+
&a.peter.email;
+
&a.bz.email;

Postmeesterteam @@ -456,11 +453,11 @@ trol-, spam- en virusfilters.

-
&a.jmb; <jmb@FreeBSD.org>
-
&a.brd; <brd@FreeBSD.org>
-
&a.flo; <flo@FreeBSD.org>
-
&a.sahil; <sahil@FreeBSD.org>
-
&a.dhw; <dhw@FreeBSD.org>
+
&a.jmb.email;
+
&a.brd.email;
+
&a.flo.email;
+
&a.sahil.email;
+
&a.dhw.email;

û��󥹥ȡ��륬��