staging-specs: Better preserve authorship/copyright info of each part

From: Mauro Carvalho Chehab <mchehab@redhat.com>

By using partinfo, it is possible to have separate authorships for each
part of the compendium. This makes easier to preserve copyright info.

Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

1 files changed, 39 insertions, 106 deletions

diff --git a/staging-specs/media.xml b/staging-specs/media.xml
index e8f260e1c..ec734edb7 100644
--- a/staging-specs/media.xml
+++ b/staging-specs/media.xml
@@ -26,114 +26,21 @@
 <book id="media_api">
 <bookinfo>
 <title>LINUX MEDIA INFRASTRUCTURE API</title>
-<subtitle>Version 1.0</subtitle>
 
 <authorgroup>
-	<author>
-		<firstname>Michael</firstname>
-		<surname>Schimek</surname>
-		<othername role="mi">H</othername>
-		<affiliation>
-			<address>
-				<email>mschimek@gmx.at</email>
-			</address>
-		</affiliation>
-	</author>
-
-	<author>
-		<firstname>Bill</firstname>
-		<surname>Dirks</surname>
-		<!-- Commented until Bill opts in to be spammed.
-		     <affiliation>
-			     <address>
-				     <email>bill@thedirks.org</email>
-			     </address>
-		     </affiliation> -->
-		     <contrib>Original author of the V4L2 API and
-			     documentation.</contrib>
-	     </author>
-
-	     <author>
-		     <firstname>Hans</firstname>
-		     <surname>Verkuil</surname>
-		     <contrib>Designed and documented the VIDIOC_LOG_STATUS ioctl,
-			     the extended control ioctls and major parts of the sliced VBI
-			     API.</contrib>
-		     <affiliation>
-			     <address>
-				     <email>hverkuil@xs4all.nl</email>
-			     </address>
-		     </affiliation>
-	     </author>
-
-	     <author>
-		     <firstname>Martin</firstname>
-		     <surname>Rubli</surname>
-		     <!--
-			 <affiliation>
-				 <address>
-					 <email>martin_rubli@logitech.com</email>
-				 </address>
-			 </affiliation> -->
-			 <contrib>Designed and documented the VIDIOC_ENUM_FRAMESIZES
-				 and VIDIOC_ENUM_FRAMEINTERVALS ioctls.</contrib>
-		 </author>
-
-		 <author>
-			 <firstname>Andy</firstname>
-			 <surname>Walls</surname>
-			 <contrib>Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV
-				 MPEG stream embedded, sliced VBI data format in this specification.
-			 </contrib>
-			 <affiliation>
-				 <address>
-					 <email>awalls@radix.net</email>
-				 </address>
-			 </affiliation>
-		 </author>
-
-		 <author>
-			 <firstname>Mauro</firstname>
-			 <surname>Carvalho Chehab</surname>
-			 <contrib>Documented libv4l, designed and added v4l2grab example,
-				 Remote Controller chapter
-			 </contrib>
-			 <affiliation>
-				 <address>
-					 <email>mchehab@redhat.com</email>
-				 </address>
-			 </affiliation>
-		 </author>
-		 <author>
-			 <!-- FIXME: Add the V4L authors -->
-			 <firstname>Ralph</firstname>
-			 <surname>Metzler</surname>
-			 <othername role="mi">J. K.</othername>
-			 <affiliation><address><email>rjkm@metzlerbros.de</email></address></affiliation>
-		 </author>
-		 <author>
-			 <firstname>Marcus</firstname>
-			 <surname>Metzler</surname>
-			 <othername role="mi">O. C.</othername>
-			 <affiliation><address><email>rjkm@metzlerbros.de</email></address></affiliation>
-		 </author>
-	 </authorgroup>
-
-	 <copyright>
-		 <year>1999</year>
-		 <year>2000</year>
-		 <year>2001</year>
-		 <year>2002</year>
-		 <year>2003</year>
-		 <year>2004</year>
-		 <year>2005</year>
-		 <year>2006</year>
-		 <year>2007</year>
-		 <year>2008</year>
-		 <year>2009</year>
-		 <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
-			 Rubli, Andy Walls, Mauro Carvalho Chehab, Ralph Metzler, Marcus Metzler</holder>
-	 </copyright>
+<author>
+<firstname>Mauro</firstname>
+<surname>Carvalho Chehab</surname>
+<contrib>Grouped V4L and DVB API on this compendium</contrib>
+<affiliation>
+<address><email>mchehab@redhat.com</email></address>
+</affiliation>
+</author>
+</authorgroup>
+<copyright>
+	<year>2009</year>
+	<holder>Mauro Carvalho Chehab</holder>
+</copyright>
 
 <legalnotice>
 
@@ -149,6 +56,32 @@ Foundation. A copy of the license is included in the chapter entitled
 </bookinfo>
 
 <toc></toc> <!-- autogenerated -->
+
+<preface>
+	<title>Introduction</title>
+
+	<para>This document covers the Linux Kernel to Userspace API's used by
+		video and radio straming devices, including video cameras,
+		analog and digital TV receiver cards, AM/FM receiver cards,
+		streaming capture devices.</para>
+	<para>It is divided into two parts. The first part covers radio, capture,
+		cameras and analog TV devices, while the second part covers the
+		API used for digital TV and Internet reception via one of the
+		several digital tv standards. While it is called as DVB API,
+		in fact it covers several different video standards including
+		DVB-T, DVB-S, DVB-C and ATSC. The API is currently being updated
+		to documment support also for DVB-S2, ISDB-T and ISDB-S.</para>
+
+	<para>For additional information and for the latest development code,
+		see: <ulink url="http://linuxtv.org">http://linuxtv.org</ulink>.</para>
+	<para>For discussing improvements, reporting troubles, sending new drivers, etc, please mail to: <ulink url="http://vger.kernel.org/vger-lists.html#linux-media">Linux Media Mailing List (LMML).</ulink>.</para>
+
+</preface>
+
+<part id="v4l2spec">
 &sub-v4l2;
+</part>
+<part id="dvbapi">
 &sub-dvbapi;
+</part>
 </book>