Bug 186731

Summary: Handbook section on journals and magazines is out of date
Product: Documentation Reporter: Allan Jude <freebsd>
Component: Books & ArticlesAssignee: Jason Helfman <jgh>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff
none
docs.advanced-networking.whitespace_round2.diff
none
docs.bibliography_v3.diff none

Description Allan Jude 2014-02-13 17:40:00 UTC 
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.

Fix: Patch attached with submission follows:
Comment 1 Jason Helfman freebsd_committer freebsd_triage 2014-02-13 20:00:47 UTC 
Responsible Changed
From-To: freebsd-doc->jgh

I'll take it.
Comment 2 Allan Jude 2014-02-14 21:08:19 UTC 
Updated patch for missing ISSN/ISBN numbers, and add BSD Talk podcast.

-- 
Allan Jude
Comment 3 Allan Jude 2014-02-14 21:58:46 UTC 
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
Comment 4 dfilter service freebsd_committer freebsd_triage 2014-03-12 19:36:52 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"
Comment 5 Jason Helfman freebsd_committer freebsd_triage 2014-03-12 19:37:06 UTC 
State Changed
From-To: open->closed

Committed, with minor changes. Thanks!