From nobody@FreeBSD.org  Thu Feb 13 17:37:58 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id 87F8B26E
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 13 Feb 2014 17:37:58 +0000 (UTC)
Received: from newred.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 70CBA1C80
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 13 Feb 2014 17:37:58 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by newred.freebsd.org (8.14.7/8.14.7) with ESMTP id s1DHbwea063899
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 13 Feb 2014 17:37:58 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.7/8.14.7/Submit) id s1DHbwQL063889;
	Thu, 13 Feb 2014 17:37:58 GMT
	(envelope-from nobody)
Message-Id: <201402131737.s1DHbwQL063889@cgiserv.freebsd.org>
Date: Thu, 13 Feb 2014 17:37:58 GMT
From: Allan Jude <freebsd@allanjude.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook section on journals and magazines is out of date
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         186731
>Category:       docs
>Synopsis:       Handbook section on journals and magazines is out of date
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jgh
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 13 17:40:00 UTC 2014
>Closed-Date:    Wed Mar 12 19:37:08 UTC 2014
>Last-Modified:  Wed Mar 12 19:40:00 UTC 2014
>Originator:     Allan Jude
>Release:        9.2-RELEASE
>Organization:
ScaleEngine Inc.
>Environment:
FreeBSD Trooper.HML3.ScaleEngine.net 9.2-RELEASE FreeBSD 9.2-RELEASE #0 r255898: Thu Sep 26 22:50:31 UTC 2013     root@bake.isc.freebsd.org:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography-journals.html is out of date

Sys Admin magazine ceased publishing in 2007: http://www.techrepublic.com/blog/data-center/sysadmin-magazine-ceases-publication/

C/C++ Users Journal (Formerly BDS C Users' Group) was discontinued in 2006: http://en.wikipedia.org/wiki/C/C%2B%2B_Users_Journal

FreeX was discontinued in 2012 and became part of Admin-magazin.de: http://translate.google.com/translate?hl=en&sl=de&u=http://www.cul.de/freex.html


Move all of the magazines to the magazines section and change the headings, since it mentions magazines in two places

add the FreeBSD Journal and BSD Now podcast to the magazines list.


>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml	(revision 43884)
+++ head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml	(working copy)
@@ -18,10 +18,9 @@
     a good users' manual.</para>
 
   <sect1 xml:id="bibliography-freebsd">
-    <title>Books &amp; Magazines Specific to FreeBSD</title>
+    <title>Books Specific to FreeBSD</title>
 
-    <para><emphasis>International books &amp;
-	Magazines:</emphasis></para>
+    <para><emphasis>International books:</emphasis></para>
 
     <itemizedlist>
       <listitem>
@@ -142,8 +141,7 @@
       </listitem>
     </itemizedlist>
 
-    <para><emphasis>English language books &amp;
-	Magazines:</emphasis></para>
+    <para><emphasis>English language books:</emphasis></para>
 
     <itemizedlist>
       <listitem>
@@ -197,12 +195,6 @@
 	    xlink:href="http://books.mcgraw-hill.com">McGrawHill</link>,
 	  2003.  ISBN: 0072224096 </para>
       </listitem>
-
-      <listitem>
-	<para><link xlink:href="http://www.bsdmag.org">BSD
-	    Magazine</link>, published by Software Press Sp. z o.o.
-	  SK. ISSN 1898-9144</para>
-      </listitem>
     </itemizedlist>
   </sect1>
 
@@ -566,21 +558,31 @@
 
     <itemizedlist>
       <listitem>
-	<para><emphasis>The C/C++ Users Journal</emphasis>.  R&amp;D
-	  Publications Inc.  ISSN 1075-2838</para>
+	<para><link
+	  xlink:href="http://www.admin-magazin.de/"><emphasis>Admin
+	    Magazin</emphasis></link> (in German), published by
+	  Medialinx AG</para>
       </listitem>
 
       <listitem>
-	<para><emphasis>Sys Admin &mdash; The Journal for UNIX System
-	    Administrators</emphasis> Miller Freeman, Inc., ISSN
-	  1061-2688</para>
+	<para><link xlink:href="http://www.bsdmag.org/">BSD
+	    Magazine</link>, published by Software Press Sp. z o.o.
+	  SK. ISSN 1898-9144</para>
       </listitem>
 
       <listitem>
-	<para><emphasis>freeX &mdash; Das Magazin f&uuml;r Linux - BSD
-	    - UNIX</emphasis> (in German) Computer- und
-	  Literaturverlag GmbH, ISSN 1436-7033</para>
+	<para><link
+	  xlink:href="http://www.bsdnow.tv/"><emphasis>BSD Now
+	    &mdash; Video Podcast</emphasis></link>, published by
+	  Jupiter Broadcasting LLC</para>
       </listitem>
+
+      <listitem>
+	<para><link
+	  xlink:href="http://freebsdjournal.com/"><emphasis>FreeBSD
+	    Journal</emphasis></link>, published by S&amp;W
+	  Publishing, sponsored by The FreeBSD Foundation</para>
+      </listitem>
     </itemizedlist>
   </sect1>
 </appendix>


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jgh 
Responsible-Changed-By: jgh 
Responsible-Changed-When: Thu Feb 13 20:00:47 UTC 2014 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=186731 

From: Allan Jude <freebsd@allanjude.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/186731: Handbook section on journals and magazines is out
 of date
Date: Fri, 14 Feb 2014 16:08:19 -0500

 This is a multi-part message in MIME format.
 --------------090808040706080401020600
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 Updated patch for missing ISSN/ISBN numbers, and add BSD Talk podcast.
 
 -- 
 Allan Jude
 
 --------------090808040706080401020600
 Content-Type: text/plain; charset=windows-1252;
  name="docs.advanced-networking.whitespace_round2.diff"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="docs.advanced-networking.whitespace_round2.diff"
 
 Index: advanced-networking/chapter.xml
 ===================================================================
 --- advanced-networking/chapter.xml	(revision 43921)
 +++ advanced-networking/chapter.xml	(working copy)
 @@ -103,9 +103,15 @@
        </authorgroup>
      </info>
  
 -    <indexterm><primary>routing</primary></indexterm>
 -    <indexterm><primary>gateway</primary></indexterm>
 -    <indexterm><primary>subnet</primary></indexterm>
 +    <indexterm>
 +      <primary>routing</primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary>gateway</primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary>subnet</primary>
 +    </indexterm>
  
      <para>For one machine to be able to find another over a network,
        there must be a mechanism in place to describe how to get from
 @@ -143,12 +149,18 @@
  host2.example.com link#1             UC          0        0
  224              link#1             UC          0        0</screen>
  
 -      <indexterm><primary>default route</primary></indexterm>
 +      <indexterm>
 +	<primary>default route</primary>
 +      </indexterm>
 +
        <para>The first two lines specify the default route, described
  	in more detail in <xref linkend="network-routing-default"/>,
  	and the <systemitem>localhost</systemitem> route.</para>
  
 -      <indexterm><primary>loopback device</primary></indexterm>
 +      <indexterm>
 +	<primary>loopback device</primary>
 +      </indexterm>
 +
        <para>The interface (<literal>Netif</literal> column) that this
  	routing table specifies to use for
  	<literal>localhost</literal> is <filename>lo0</filename>,
 @@ -160,6 +172,7 @@
  	<primary>Ethernet</primary>
  	<secondary>MAC address</secondary>
        </indexterm>
 +
        <para>The addresses beginning with <systemitem
  	  class="etheraddress">0:e0:</systemitem> are Ethernet
  	hardware addresses, also known as <acronym>MAC</acronym>
 @@ -175,7 +188,9 @@
  	calculates routes to local hosts based upon a shortest path
  	determination.</para>
  
 -      <indexterm><primary>subnet</primary></indexterm>
 +      <indexterm>
 +	<primary>subnet</primary>
 +      </indexterm>
  
        <para>&os; will add subnet routes for the local subnet.
  	<systemitem class="ipaddress">10.20.30.255</systemitem> is the
 @@ -271,7 +286,9 @@
      <sect2 xml:id="network-routing-default">
        <title>Default Routes</title>
  
 -      <indexterm><primary>default route</primary></indexterm>
 +      <indexterm>
 +	<primary>default route</primary>
 +      </indexterm>
  
        <para>When the local system needs to make a connection to a
  	remote host, it checks the routing table to determine if a
 @@ -408,7 +425,9 @@
      <sect2 xml:id="network-dual-homed-hosts">
        <title>Dual Homed Hosts</title>
  
 -      <indexterm><primary>dual homed hosts</primary></indexterm>
 +      <indexterm>
 +	<primary>dual homed hosts</primary>
 +      </indexterm>
  
        <para>A dual-homed system is a host which resides on two
  	different networks.</para>
 @@ -436,7 +455,9 @@
      <sect2 xml:id="network-dedicated-router">
        <title>Building a Router</title>
  
 -      <indexterm><primary>router</primary></indexterm>
 +      <indexterm>
 +	<primary>router</primary>
 +      </indexterm>
  
        <para>A network router is a system that forwards packets from
  	one interface to another.  Internet standards and good
 @@ -452,9 +473,16 @@
  	<literal>1</literal>.  To stop routing, reset this to
  	<literal>0</literal>.</para>
  
 -      <indexterm><primary>BGP</primary></indexterm>
 -      <indexterm><primary>RIP</primary></indexterm>
 -      <indexterm><primary>OSPF</primary></indexterm>
 +      <indexterm>
 +	<primary>BGP</primary>
 +      </indexterm>
 +      <indexterm>
 +	<primary>RIP</primary>
 +      </indexterm>
 +      <indexterm>
 +	<primary>OSPF</primary>
 +      </indexterm>
 +
        <para>The new router will need routes to know where to send the
  	traffic.  If the network is simple enough, static routes can
  	be used.  &os; comes with the standard BSD routing daemon
 @@ -471,8 +499,13 @@
  	<title>Setting Up Static Routes</title>
  
  	<authorgroup>
 -	  <author><personname><firstname>Al</firstname><surname>Hoang</surname></personname><contrib>Contributed
 -	    by </contrib></author>
 +	  <author>
 +	    <personname>
 +	      <firstname>Al</firstname>
 +	      <surname>Hoang</surname>
 +	    </personname>
 +	    <contrib>Contributed by </contrib>
 +	  </author>
  	</authorgroup>
        </info>
        <!-- Feb 2004 -->
 @@ -649,6 +682,7 @@
  	<primary>kernel options</primary>
  	<secondary>MROUTING</secondary>
        </indexterm>
 +
        <para>&os; natively supports both multicast applications and
  	multicast routing.  Multicast applications do not require any
  	special configuration of &os;; as applications will generally
 @@ -680,16 +714,30 @@
        <title>Wireless Networking</title>
  
        <authorgroup>
 -	<author><personname><othername>Loader</othername></personname></author>
 -
 -	<author><personname><firstname>Marc</firstname><surname>Fonvieille</surname></personname></author>
 -
 -	<author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname></author>
 +	<author>
 +	  <personname>
 +	    <othername>Loader</othername>
 +	  </personname>
 +	</author>
 +	<author>
 +	  <personname>
 +	    <firstname>Marc</firstname>
 +	    <surname>Fonvieille</surname>
 +	  </personname>
 +	</author>
 +	<author>
 +	  <personname>
 +	    <firstname>Murray</firstname>
 +	    <surname>Stokely</surname>
 +	  </personname>
 +	</author>
        </authorgroup>
      </info>
  
 -    <indexterm><primary>wireless networking</primary></indexterm>
      <indexterm>
 +      <primary>wireless networking</primary>
 +    </indexterm>
 +    <indexterm>
        <primary>802.11</primary>
        <see>wireless networking</see>
      </indexterm>
 @@ -2247,7 +2295,9 @@
        <title>USB Tethering</title>
      </info>
  
 -    <indexterm><primary>tether</primary></indexterm>
 +    <indexterm>
 +      <primary>tether</primary>
 +    </indexterm>
  
      <para>Many cellphones provide the option to share their data
        connection over USB (often called "tethering").  This feature
 @@ -2278,16 +2328,15 @@
  	    <surname>Lucistnik</surname>
  	  </personname>
  	  <contrib>Written by </contrib>
 -	  <affiliation>
 -	    <address>
 -	      <email>pav@FreeBSD.org</email>
 -	    </address>
 -	  </affiliation>
 +	  <email>pav@FreeBSD.org</email>
  	</author>
        </authorgroup>
      </info>
  
 -    <indexterm><primary>Bluetooth</primary></indexterm>
 +    <indexterm>
 +      <primary>Bluetooth</primary>
 +    </indexterm>
 +
      <sect2>
        <title>Introduction</title>
  
 @@ -2359,7 +2408,9 @@
        <title>Host Controller Interface
  	(<acronym>HCI</acronym>)</title>
  
 -      <indexterm><primary>HCI</primary></indexterm>
 +      <indexterm>
 +	<primary>HCI</primary>
 +      </indexterm>
  
        <para>The Host Controller Interface (<acronym>HCI</acronym>)
  	provides a command interface to the baseband controller and
 @@ -2453,7 +2504,9 @@
        <title>Logical Link Control and Adaptation Protocol
  	(<acronym>L2CAP</acronym>)</title>
  
 -      <indexterm><primary>L2CAP</primary></indexterm>
 +      <indexterm>
 +	<primary>L2CAP</primary>
 +      </indexterm>
  
        <para>The Logical Link Control and Adaptation Protocol
  	(<acronym>L2CAP</acronym>) provides connection-oriented and
 @@ -2627,7 +2680,9 @@
        <title>Service Discovery Protocol
  	(<acronym>SDP</acronym>)</title>
  
 -      <indexterm><primary>SDP</primary></indexterm>
 +      <indexterm>
 +	<primary>SDP</primary>
 +      </indexterm>
  
        <para>The Service Discovery Protocol (<acronym>SDP</acronym>)
  	provides the means for client applications to discover the
 @@ -2811,7 +2866,10 @@
        <title><acronym>OBEX</acronym> Object Push
  	(<acronym>OPUSH</acronym>) Profile</title>
  
 -      <indexterm><primary>OBEX</primary></indexterm>
 +      <indexterm>
 +	<primary>OBEX</primary>
 +      </indexterm>
 +
        <para><acronym>OBEX</acronym> is a widely used protocol for
  	simple file transfers between mobile devices.  Its main use
  	is in infrared communication, where it is used for generic
 @@ -2931,8 +2989,13 @@
        <title>Bridging</title>
  
        <authorgroup>
 -	<author><personname><firstname>Andrew</firstname><surname>Thompson</surname></personname><contrib>Written
 -	  by </contrib></author>
 +	<author>
 +	  <personname>
 +	    <firstname>Andrew</firstname>
 +	    <surname>Thompson</surname>
 +	  </personname>
 +	  <contrib>Written by </contrib>
 +	</author>
        </authorgroup>
      </info>
  
 @@ -2939,9 +3002,13 @@
      <sect2>
        <title>Introduction</title>
  
 -      <indexterm><primary><acronym>IP</acronym>
 -	  subnet</primary></indexterm>
 -      <indexterm><primary>bridge</primary></indexterm>
 +      <indexterm>
 +	<primary><acronym>IP</acronym> subnet</primary>
 +      </indexterm>
 +      <indexterm>
 +	<primary>bridge</primary>
 +      </indexterm>
 +
        <para>It is sometimes useful to divide one physical network,
  	such as an Ethernet segment, into two separate network
  	segments without having to create <acronym>IP</acronym>
 @@ -2981,8 +3048,12 @@
        <sect3>
  	<title>Filtering/Traffic Shaping Firewall</title>
  
 -	<indexterm><primary>firewall</primary></indexterm>
 -	<indexterm><primary>NAT</primary></indexterm>
 +	<indexterm>
 +	  <primary>firewall</primary>
 +	</indexterm>
 +	<indexterm>
 +	  <primary>NAT</primary>
 +	</indexterm>
  
  	<para>A common situation is where firewall functionality is
  	  needed without routing or Network Address Translation
 @@ -2996,9 +3067,16 @@
  	  on the network.  In this situation, using a router-based
  	  firewall is difficult because of subnetting issues.</para>
  
 -	<indexterm><primary>router</primary></indexterm>
 -	<indexterm><primary><acronym>DSL</acronym></primary></indexterm>
 -	<indexterm><primary><acronym>ISDN</acronym></primary></indexterm>
 +	<indexterm>
 +	  <primary>router</primary>
 +	</indexterm>
 +	<indexterm>
 +	  <primary><acronym>DSL</acronym></primary>
 +	</indexterm>
 +	<indexterm>
 +	  <primary><acronym>ISDN</acronym></primary>
 +	</indexterm>
 +
  	<para>A bridge-based firewall can be configured and dropped
  	  into the path just downstream of the <acronym>DSL</acronym>
  	  or <acronym>ISDN</acronym> router without any
 @@ -3119,7 +3197,9 @@
      <sect2>
        <title>Firewalling</title>
  
 -      <indexterm><primary>firewall</primary></indexterm>
 +      <indexterm>
 +	<primary>firewall</primary>
 +      </indexterm>
  
        <para>When packet filtering is enabled, bridged packets will
  	pass through the filter inbound on the originating interface
 @@ -3401,17 +3481,34 @@
        <title>Link Aggregation and Failover</title>
  
        <authorgroup>
 -	<author><personname><firstname>Andrew</firstname><surname>Thompson</surname></personname><contrib>Written
 -	  by </contrib></author>
 +	<author>
 +	  <personname>
 +	    <firstname>Andrew</firstname>
 +	    <surname>Thompson</surname>
 +	  </personname>
 +	  <contrib>Written by </contrib>
 +	</author>
        </authorgroup>
      </info>
  
 -    <indexterm><primary>lagg</primary></indexterm>
 -    <indexterm><primary>failover</primary></indexterm>
 -    <indexterm><primary><acronym>FEC</acronym></primary></indexterm>
 -    <indexterm><primary><acronym>LACP</acronym></primary></indexterm>
 -    <indexterm><primary>loadbalance</primary></indexterm>
 -    <indexterm><primary>roundrobin</primary></indexterm>
 +    <indexterm>
 +      <primary>lagg</primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary>failover</primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary><acronym>FEC</acronym></primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary><acronym>LACP</acronym></primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary>loadbalance</primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary>roundrobin</primary>
 +    </indexterm>
  
      <para>&os; provides the &man.lagg.4; interface which can be used
        to aggregate multiple network interfaces into one virtual
 @@ -3743,17 +3840,31 @@
        <title>Diskless Operation</title>
  
        <authorgroup>
 -	<author><personname><firstname>Jean-Fran&ccedil;ois</firstname><surname>Dock&egrave;s</surname></personname><contrib>Updated
 -	  by </contrib></author>
 +	<author>
 +	  <personname>
 +	    <firstname>Jean-Fran&ccedil;ois</firstname>
 +	    <surname>Dock&egrave;s</surname>
 +	  </personname>
 +	  <contrib>Updated by </contrib>
 +	</author>
        </authorgroup>
        <authorgroup>
 -	<author><personname><firstname>Alex</firstname><surname>Dupre</surname></personname><contrib>Reorganized
 -	  and enhanced by </contrib></author>
 +	<author>
 +	  <personname>
 +	    <firstname>Alex</firstname>
 +	    <surname>Dupre</surname>
 +	  </personname>
 +	  <contrib>Reorganized and enhanced by </contrib>
 +	</author>
        </authorgroup>
      </info>
  
 -    <indexterm><primary>diskless workstation</primary></indexterm>
 -    <indexterm><primary>diskless operation</primary></indexterm>
 +    <indexterm>
 +      <primary>diskless workstation</primary>
 +    </indexterm>
 +    <indexterm>
 +      <primary>diskless operation</primary>
 +    </indexterm>
  
      <para>A &os; machine can boot over the network and operate
        without a local disk, using file systems mounted from an
 @@ -4634,8 +4745,13 @@
        <title>Network Address Translation</title>
  
        <authorgroup>
 -	<author><personname><firstname>Chern</firstname><surname>Lee</surname></personname><contrib>Contributed
 -	  by </contrib></author>
 +	<author>
 +	  <personname>
 +	    <firstname>Chern</firstname>
 +	    <surname>Lee</surname>
 +	  </personname>
 +	  <contrib>Contributed by </contrib>
 +	</author>
        </authorgroup>
      </info>
  
 @@ -4645,6 +4761,7 @@
        <indexterm>
  	<primary>&man.natd.8;</primary>
        </indexterm>
 +
        <para>&os;'s Network Address Translation
  	(<acronym>NAT</acronym>) daemon, &man.natd.8;, accepts
  	incoming raw <acronym>IP</acronym> packets, changes the
 @@ -4661,6 +4778,7 @@
        <indexterm>
  	<primary><acronym>NAT</acronym></primary>
        </indexterm>
 +
        <para>The most common use of <acronym>NAT</acronym> is to
  	perform what is commonly known as Internet Connection
  	Sharing.</para>
 @@ -4766,6 +4884,7 @@
  	<primary>kernel</primary>
  	<secondary>configuration</secondary>
        </indexterm>
 +
        <para>When modules are not an option or if it is preferable to
  	build all the required features into a custom kernel, the
  	following options must be in the custom kernel configuration
 @@ -4931,7 +5050,10 @@
      <sect2 xml:id="network-natdaddress-redirection">
        <title>Address Redirection</title>
  
 -      <indexterm><primary>address redirection</primary></indexterm>
 +      <indexterm>
 +	<primary>address redirection</primary>
 +      </indexterm>
 +
        <para>Address redirection is useful if more than one
  	<acronym>IP</acronym> address is available.  Each
  	<acronym>LAN</acronym> client can be assigned its own
 @@ -5531,7 +5653,13 @@
    <sect1 xml:id="network-atm">
      <info><title>Asynchronous Transfer Mode (<acronym>ATM</acronym>)</title>
        <authorgroup>
 -	<author><personname><firstname>Harti</firstname><surname>Brandt</surname></personname><contrib>Contributed by </contrib></author>
 +	<author>
 +	  <personname>
 +	    <firstname>Harti</firstname>
 +	    <surname>Brandt</surname>
 +	  </personname>
 +	  <contrib>Contributed by </contrib>
 +	</author>
        </authorgroup>
      </info>
  
 @@ -5730,7 +5858,8 @@
  	  </personname>
  	  <contrib>Contributed by </contrib>
  	</author>
 -
 +      </authorgroup>
 +      <authorgroup>
  	<author>
  	  <personname>
  	    <firstname>Allan</firstname>
 
 --------------090808040706080401020600--

From: Allan Jude <freebsd@allanjude.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/186731: Handbook section on journals and magazines is out
 of date
Date: Fri, 14 Feb 2014 16:58:46 -0500

 This is a multi-part message in MIME format.
 --------------070409080604070806010109
 Content-Type: text/plain; charset=windows-1252
 Content-Transfer-Encoding: 7bit
 
 On 2014-02-14 16:08, Allan Jude wrote:
 > Updated patch for missing ISSN/ISBN numbers, and add BSD Talk podcast.
 > 
 
 Sorry, sent the wrong patch
 
 -- 
 Allan Jude
 
 --------------070409080604070806010109
 Content-Type: text/plain; charset=windows-1252;
  name="docs.bibliography_v3.diff"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="docs.bibliography_v3.diff"
 
 Index: bibliography/chapter.xml
 ===================================================================
 --- bibliography/chapter.xml	(revision 43929)
 +++ bibliography/chapter.xml	(working copy)
 @@ -18,10 +18,9 @@
      a good users' manual.</para>
  
    <sect1 xml:id="bibliography-freebsd">
 -    <title>Books &amp; Magazines Specific to FreeBSD</title>
 +    <title>Books Specific to FreeBSD</title>
  
 -    <para><emphasis>International books &amp;
 -	Magazines:</emphasis></para>
 +    <para><emphasis>International books:</emphasis></para>
  
      <itemizedlist>
        <listitem>
 @@ -142,8 +141,7 @@
        </listitem>
      </itemizedlist>
  
 -    <para><emphasis>English language books &amp;
 -	Magazines:</emphasis></para>
 +    <para><emphasis>English language books:</emphasis></para>
  
      <itemizedlist>
        <listitem>
 @@ -197,12 +195,6 @@
  	    xlink:href="http://books.mcgraw-hill.com">McGrawHill</link>,
  	  2003.  ISBN: 0072224096 </para>
        </listitem>
 -
 -      <listitem>
 -	<para><link xlink:href="http://www.bsdmag.org">BSD
 -	    Magazine</link>, published by Software Press Sp. z o.o.
 -	  SK. ISSN 1898-9144</para>
 -      </listitem>
      </itemizedlist>
    </sect1>
  
 @@ -562,25 +554,42 @@
    </sect1>
  
    <sect1 xml:id="bibliography-journals">
 -    <title>Magazines and Journals</title>
 +    <title>Periodicals, Journals, and Magazines</title>
  
      <itemizedlist>
        <listitem>
 -	<para><emphasis>The C/C++ Users Journal</emphasis>.  R&amp;D
 -	  Publications Inc.  ISSN 1075-2838</para>
 +	<para><link
 +	  xlink:href="http://www.admin-magazin.de/"><emphasis>Admin
 +	    Magazin</emphasis></link> (in German), published by
 +	  Medialinx AG. ISSN: 2190-1066</para>
        </listitem>
  
        <listitem>
 -	<para><emphasis>Sys Admin &mdash; The Journal for UNIX System
 -	    Administrators</emphasis> Miller Freeman, Inc., ISSN
 -	  1061-2688</para>
 +	<para><link xlink:href="http://www.bsdmag.org/">BSD
 +	    Magazine</link>, published by Software Press Sp. z o.o.
 +	  SK. ISSN: 1898-9144</para>
        </listitem>
  
        <listitem>
 -	<para><emphasis>freeX &mdash; Das Magazin f&uuml;r Linux - BSD
 -	    - UNIX</emphasis> (in German) Computer- und
 -	  Literaturverlag GmbH, ISSN 1436-7033</para>
 +	<para><link
 +	  xlink:href="http://www.bsdnow.tv/"><emphasis>BSD Now
 +	    &mdash; Video Podcast</emphasis></link>, published by
 +	  Jupiter Broadcasting LLC</para>
        </listitem>
 +
 +      <listitem>
 +	<para><link
 +	  xlink:href="http://bsdtalk.blogspot.com/"><emphasis>BSD Talk
 +	    Podcast</emphasis></link>, by Will Backman</para>
 +      </listitem>
 +
 +      <listitem>
 +	<para><link
 +	  xlink:href="http://freebsdjournal.com/"><emphasis>FreeBSD
 +	    Journal</emphasis></link>, published by S&amp;W
 +	  Publishing, sponsored by The FreeBSD Foundation. ISBN:
 +	  978-0-615-88479-0</para>
 +      </listitem>
      </itemizedlist>
    </sect1>
  </appendix>
 
 --------------070409080604070806010109--
State-Changed-From-To: open->closed 
State-Changed-By: jgh 
State-Changed-When: Wed Mar 12 19:37:06 UTC 2014 
State-Changed-Why:  
Committed, with minor changes. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=186731 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/186731: commit references a PR
Date: Wed, 12 Mar 2014 19:36:52 +0000 (UTC)

 Author: jgh
 Date: Wed Mar 12 19:36:45 2014
 New Revision: 44220
 URL: http://svnweb.freebsd.org/changeset/doc/44220
 
 Log:
   - update publications within journal space [1]
   - add FreeBSD Journal and BSD Now podcast to magazine section [1]
   - while here update verbage on introduction
   
   PR:		186731 (based on) [1]
   Submitted by:	freebsd@allanjude.com
   Reviewed by:	remko, bcr (mentors)
   Approved by:	wblock (mentor)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml	Wed Mar 12 10:12:42 2014	(r44219)
 +++ head/en_US.ISO8859-1/books/handbook/bibliography/chapter.xml	Wed Mar 12 19:36:45 2014	(r44220)
 @@ -10,18 +10,17 @@
  
    <title>Bibliography</title>
  
 -  <para>While the manual pages provide the definitive reference for
 -    individual pieces of the FreeBSD operating system, they are
 -    notorious for not illustrating how to put the pieces together to
 +  <para>While manual pages provide a definitive reference for
 +    individual pieces of the &os; operating system, they seldom
 +    illustrate how to put the pieces together to
      make the whole operating system run smoothly.  For this, there is
 -    no substitute for a good book on &unix; system administration and
 -    a good users' manual.</para>
 +    no substitute for a good book or users' manual on &unix; system
 +    administration.</para>
  
    <sect1 xml:id="bibliography-freebsd">
 -    <title>Books &amp; Magazines Specific to FreeBSD</title>
 +    <title>Books Specific to &os;</title>
  
 -    <para><emphasis>International books &amp;
 -	Magazines:</emphasis></para>
 +    <para>International books:</para>
  
      <itemizedlist>
        <listitem>
 @@ -142,8 +141,7 @@
        </listitem>
      </itemizedlist>
  
 -    <para><emphasis>English language books &amp;
 -	Magazines:</emphasis></para>
 +    <para>English language books:</para>
  
      <itemizedlist>
        <listitem>
 @@ -197,12 +195,6 @@
  	    xlink:href="http://books.mcgraw-hill.com">McGrawHill</link>,
  	  2003.  ISBN: 0072224096 </para>
        </listitem>
 -
 -      <listitem>
 -	<para><link xlink:href="http://www.bsdmag.org">BSD
 -	    Magazine</link>, published by Software Press Sp. z o.o.
 -	  SK. ISSN 1898-9144</para>
 -      </listitem>
      </itemizedlist>
    </sect1>
  
 @@ -562,24 +554,41 @@
    </sect1>
  
    <sect1 xml:id="bibliography-journals">
 -    <title>Magazines and Journals</title>
 +    <title>Periodicals, Journals, and Magazines</title>
  
      <itemizedlist>
        <listitem>
 -	<para><emphasis>The C/C++ Users Journal</emphasis>.  R&amp;D
 -	  Publications Inc.  ISSN 1075-2838</para>
 +	<para><link
 +	    xlink:href="http://www.admin-magazin.de/">Admin
 +	    Magazin</link> (in German), published by
 +	  Medialinx AG. ISSN: 2190-1066</para>
        </listitem>
  
        <listitem>
 -	<para><emphasis>Sys Admin &mdash; The Journal for UNIX System
 -	    Administrators</emphasis> Miller Freeman, Inc., ISSN
 -	  1061-2688</para>
 +	<para><link xlink:href="http://www.bsdmag.org/">BSD
 +	    Magazine</link>, published by Software Press Sp. z o.o.
 +	  SK. ISSN: 1898-9144</para>
        </listitem>
  
        <listitem>
 -	<para><emphasis>freeX &mdash; Das Magazin f&uuml;r Linux - BSD
 -	    - UNIX</emphasis> (in German) Computer- und
 -	  Literaturverlag GmbH, ISSN 1436-7033</para>
 +	<para><link
 +	    xlink:href="http://www.bsdnow.tv/">BSD Now
 +	    &mdash; Video Podcast</link>, published by
 +	  Jupiter Broadcasting LLC</para>
 +      </listitem>
 +
 +      <listitem>
 +	<para><link
 +	    xlink:href="http://bsdtalk.blogspot.com/">BSD
 +	    Talk Podcast</link>, by Will Backman</para>
 +      </listitem>
 +
 +      <listitem>
 +	<para><link
 +	    xlink:href="http://freebsdjournal.com/">FreeBSD
 +	    Journal</link>, published by S&amp;W
 +	  Publishing, sponsored by The FreeBSD Foundation.
 +	  ISBN: 978-0-615-88479-0</para>
        </listitem>
      </itemizedlist>
    </sect1>
 _______________________________________________
 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"
 
>Unformatted:
