From beat@FreeBSD.org  Wed Nov 30 07:26:40 2011
Return-Path: <beat@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 95B08106566B
	for <FreeBSD-gnats-submit@FreeBSD.org>; Wed, 30 Nov 2011 07:26:40 +0000 (UTC)
	(envelope-from beat@FreeBSD.org)
Received: from marvin.chruetertee.ch (marvin.chruetertee.ch [217.150.245.55])
	by mx1.freebsd.org (Postfix) with ESMTP id 3718C8FC08
	for <FreeBSD-gnats-submit@FreeBSD.org>; Wed, 30 Nov 2011 07:26:39 +0000 (UTC)
Received: from _HOSTNAME_ (107-3.3-85.cust.bluewin.ch [85.3.3.107])
	(authenticated bits=0)
	by marvin.chruetertee.ch (8.14.4/8.14.3) with ESMTP id pAU70sRR093467
	(version=TLSv1/SSLv3 cipher=DHE-DSS-AES256-SHA bits=256 verify=NO)
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 30 Nov 2011 07:00:54 GMT
	(envelope-from beat@FreeBSD.org)
Received: by _HOSTNAME_ (sSMTP sendmail emulation); Wed, 30 Nov 2011 08:00:38 +0100
Message-Id: <201111300700.pAU70sRR093467@marvin.chruetertee.ch>
Date: Wed, 30 Nov 2011 08:00:38 +0100
From: Beat Gtzi <beat@FreeBSD.org>
Reply-To: Beat Gtzi <beat@FreeBSD.org>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:
Subject: [PATCH] Update VirtualBox section in handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         162961
>Category:       docs
>Synopsis:       [handbook] [patch] Update VirtualBox section in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    manolis
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Wed Nov 30 07:30:11 UTC 2011
>Closed-Date:    Fri Dec 02 17:38:03 UTC 2011
>Last-Modified:  Fri Dec 02 17:38:03 UTC 2011
>Originator:     Beat Gtzi
>Release:        FreeBSD 9.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD daedalus.network.local 9.0-CURRENT FreeBSD 9.0-CURRENT #5 r217615M: Thu Jan 20 01:02:35 CET 2011 root@daedalus.network.local:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	- Attached patch updates the VirtualBox section of the virtualisation
	  chapter in the handbook. This work was done by Eric Newberry during
	  the Google Code-In contest so please give him the credit for this
	  update:
	  https://google-melange.appspot.com/gci/task/view/google/gci2011/7137268
	
>How-To-Repeat:
	
>Fix:

	

--- virtualization-virtualbox-chapter.patch begins here ---
--- chapter.old.sgml	2011-11-26 11:38:34.000000000 -0700
+++ chapter.sgml	2011-11-26 18:06:03.000000000 -0700
@@ -969,6 +969,103 @@
 
       </sect3>
     </sect2>
+
+    <sect2 id="virtualization-guest-virtualbox-guest-additions">
+      <title>&virtualbox; Guest Additions on &os; Guest</title>
+      
+      <para>The <application>&virtualbox;</application> guest additions provide support for:</para>
+      
+        <itemizedlist>
+          <listitem>
+	    <para>Clipboard sharing</para>
+	  </listitem>
+	  <listitem>
+	    <para>Mouse pointer integration</para>
+	  </listitem>
+	  <listitem>
+	    <para>Host time synchronization</para>
+	  </listitem>
+	  <listitem>
+	    <para>Window scaling</para>
+	  </listitem>
+	  <listitem>
+	    <para>Seamless mode</para>
+	  </listitem>
+        </itemizedlist>
+
+      <note>
+        <para>The following commands are run in the &os; guest.</para>
+      </note>
+
+      <para>First, install the virtualbox-ose-additions package in the &os; guest.</para>
+
+      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose-additions && make install clean</userinput></screen>
+
+      <para>Then, add this to <filename>/etc/rc.conf</filename>:</para>
+
+      <programlisting>vboxguest_enable="YES"
+vboxservice_enable="YES"</programlisting>
+
+      <para>If you want to use ntpd(8) or ntpdate(8) for some reason, then you should disable host time synchronization:</para>
+
+      <programlisting>vboxservice_flags="--disable-timesync"</programlisting>
+
+      <para>The <command>vboxvideo_drv</command> should be recognized by <command>Xorg -configure</command>. If not, use something like this in your <filename>xorg.conf</filename> file for the <application>&virtualbox;</application> video card:</para>
+
+      <programlisting>Section "Device"
+	### Available Driver options are:-
+	### Values: &lt;i&gt;: integer, &lt;f&gt;: float, &lt;bool&gt;: "True"/"False",
+	### &lt;string&gt;: "String", &lt;freq&gt;: "&lt;f&gt; Hz/kHz/MHz"
+	### [arg]: arg optional
+	Identifier "Card0"
+	Driver "vboxvideo"
+	VendorName "InnoTek Systemberatung GmbH"
+	BoardName "VirtualBox Graphics Adapter"
+	BusID "PCI:0:2:0"
+EndSection</programlisting>
+
+      <para>To use <command>vboxmouse_drv</command> please adjust the mouse section in your <filename>xorg.conf</filename> like this:</para>
+
+      <programlisting>Section "InputDevice"
+	Identifier "Mouse0"
+	Driver "vboxmouse"
+EndSection</programlisting>
+
+      <para>HAL users should create this file at <filename>/usr/local/etc/hal/fdi/policy/90-vboxguest.fdi</filename> or copy it from <filename>/usr/local/share/hal/fdi/policy/10osvendor/90-vboxguest.fdi</filename>:</para>
+
+      <programlisting>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;!--
+# Sun VirtualBox
+# Hal driver description for the vboxmouse driver
+# $Id: 90-vboxguest.fdi 21412 2009-07-08 21:18:57z vboxsync $
+
+	Copyright (C) 2008-2009 Sun Microsystems, Inc.
+	
+	This file is part of VirtualBox Open Source Edition (OSE, as
+	available from http://www.virtualbox.org. This file is free software;
+	you can redistribute it and/or modify it under the terms of the GNU
+	General Public License (GPL) as published by the Free Software
+	Foundation, in version 2 as it comes in the "COPYING" file of the
+	VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+	hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+	
+	Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
+	Clara, CA 95054 USA or visit http://www.sun.com if you need
+	additional information or have any questions.
+--&gt;
+&lt;deviceinfo version="0.2"&gt;
+  &lt;device&gt;
+    &lt;match key="info.subsystem" string="pci"&gt;
+      &lt;match key="info.product" string="VirtualBox guest Service"&gt;
+        &lt;append key="info.capabilities" type="strlist"&gt;input&lt;/append&gt;
+	&lt;append key="info.capabilities" type="strlist"&gt;input.mouse&lt;/append&gt;
+        &lt;merge key="input.x11_driver" type="string"&gt;vboxmouse&lt;/merge&gt;
+	&lt;merge key="input.device" type="string"&gt;/dev/vboxguest&lt;/merge&gt;
+      &lt;/match&gt;
+    &lt;/match&gt;
+  &lt;/device&gt;
+&lt;/deviceinfo&gt;</programlisting>
+    </sect2>
   </sect1>
 
   <sect1 id="virtualization-host">
@@ -1003,7 +1100,8 @@
 	in <filename role="package">emulators/virtualbox-ose</filename>, and
 	may be installed using the following commands:</para>
 
-      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
+	<screen>&prompt.root; <userinput>portsnap fetch update</userinput>
+&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
       <para>One useful option in the configuration dialog is the
@@ -1028,34 +1126,10 @@
 
       <programlisting>vboxdrv_load="YES"</programlisting>
 
-      <para>Versions of <application>&virtualbox;</application> prior to 3.1.2
-	require the <filename class="directory">proc</filename> file system
-	to be mounted.  This is not needed in recent versions, which utilize
-	the functions provided by the &man.sysctl.3; library.</para>
+      <para>If you wish to use the kernel modules that allow bridged or host-only networking,
+	add the following to <filename>/etc/rc.conf</filename> and reboot your computer:</para>
 
-      <para>When using an older version of the port, follow the instructions
-	below to make sure <filename class="directory">proc</filename> is
-	mounted properly:</para>
-
-      <screen>&prompt.root; <userinput>mount -t procfs proc /proc</userinput></screen>
-
-      <para>To allow this setting to persist reboots, the following line
-	is needed in <filename>/etc/fstab</filename>:</para>
-
-      <programlisting>proc	/proc	procfs	rw	0	0</programlisting>
-
-      <note>
-	<para>If an error message similar to the following is observed
-	  when <application>&virtualbox;</application> is run from
-	  the terminal:</para>
-
-	<screen>VirtualBox: supR3HardenedExecDir: couldn't read "", errno=2 cchLink=-1</screen>
-
-	<para>The most likely culprit will be the <filename
-	  class="directory">proc</filename> file system.  Please use the
-	  <command>mount</command> command to check whether it is mounted
-	  properly.</para>
-      </note>
+      <programlisting>vboxnet_enable="YES"</programlisting>
 
       <para>The <groupname>vboxusers</groupname> group is created during
 	the installation of <application>&virtualbox;</application>.
@@ -1066,6 +1140,18 @@
 
       <screen>&prompt.root; <userinput>pw groupmod vboxusers -m <replaceable>yourusername</replaceable></userinput></screen>
 
+      <para>The default permissions for /dev/vboxnetctl are restrictive. You will need to change them for bridged networking.</para>
+
+      <para>To test it temporarily:</para>
+
+      <screen>&prompt.root; <userinput>chown root:vboxusers /dev/vboxnetctl</userinput>
+&prompt.root; <userinput>chmod 0660 /dev/vboxnetctl</userinput></screen>
+
+      <para>To To make the permissions change permanent, add the following lines to <filename>/etc/devfs.conf</filename>:
+
+      <programlisting>own     vboxnetctl root:vboxusers
+perm     vboxnetctl 0660</programlisting>
+
       <para>To launch <application>&virtualbox;</application>, either select
 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from your
 	graphic environment's menu, or type the following in a
@@ -1081,6 +1167,55 @@
 	visit the relevant page in the &os; wiki, at <ulink
 	  url="http://wiki.FreeBSD.org/VirtualBox"></ulink>.</para>
     </sect2>
+
+    <sect2 id="virtualization-virtualbox-usb-support">
+      <title>&virtualbox; USB Support</title>
+
+      <note>
+	<para>These steps require VirtualBox 4.0.0 or later.</para>
+      </note>
+
+      <para>In order to be able to read and write to USB devices, users need to be a member of the operator group.</para>
+
+      <screen>&prompt.root; <userinput>pw groupmod operator -m <replaceable>jerry</replaceable></userinput></screen>
+
+      <para>Then, add the following to <filename>/etc/devfs.rules</filename> (create it if it doesn't exist yet):</para>
+
+      <programlisting>[system=10]
+add path 'usb/*' mode 0660 group operator</programlisting>
+
+      <para>To load these new rules, add the following to <filename>/etc/rc.conf</filename>:</para>
+
+      <programlisting>devfs_system_ruleset="system"</programlisting>
+
+      <para>Then, restart devfs:</para>
+
+      <screen>&prompt.root; <userinput>/etc/rc.d/devfs restart</userinput></screen>
+
+      <para>Now, you can enable USB in the guest operating system. You should be able to see the USB devices in the &virtualbox; preferences.</para>
+
+    </sect2>
+
+    <sect2 id="virtualization-virtualbox-host-dvd-cd-access">
+      <title>&virtualbox; Host DVD/CD Access</title>
+
+      <para>The <command>atapicam</command> kernel module needs to be loaded by adding this to <filename>/boot/loader.conf</filename>:</para>
+
+      <programlisting>atapicam_load="YES"</programlisting>
+
+      <para>HAL needs to run for <application>&virtualbox;</application> DVD/CD functions to work, so enable it in <filename>/etc/rc.conf</filename> and start it (if it is not already running):</para>
+
+      <programlisting>hald_enable="YES"</programlisting>
+
+      <screen>&prompt.root; <userinput>/usr/local/etc/rc.d/hald start</userinput></screen>
+
+      <para>In order for users to be able to use <application>&virtualbox;</application> DVD/CD functions, they need access to <filename>/dev/xpt0</filename>, <filename>/dev/cdN</filename>, and <filename>/dev/passN</filename>. Add this to <filename>/etc/devfs.conf</filename>:
+
+      <programlisting>perm cd0 0600
+perm xpt0 0660
+perm pass0 0660</programlisting>
+    </sect2>
+
 <!--
   Note:  There is no working/end-user ready Xen support for FreeBSD as of 07-2010.
          Hide all information regarding Xen under FreeBSD.
--- virtualization-virtualbox-chapter.patch ends here ---


>Release-Note:
>Audit-Trail:

From: Manolis Kiagias <sonic2000gr@gmail.com>
To: =?ISO-8859-7?Q?Beat_G=E4tzi?= <beat@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/162961: [PATCH] Update VirtualBox section in handbook
Date: Thu, 01 Dec 2011 00:16:14 +0200

 Hi,
 
 Nice work!
 
 I made some fixes to this and uploaded a revised patch here:
 
 http://people.freebsd.org/~manolis/patches/virtualization-virtualbox-chapter-patch-new.txt 
 <http://people.freebsd.org/%7Emanolis/patches/virtualization-virtualbox-chapter-patch-new.txt>
 
 and a build (without images) here:
 
 http://people.freebsd.org/~manolis/patches/virtualization-guest.html 
 <http://people.freebsd.org/%7Emanolis/patches/virtualization-guest.html>
 
 Main changes are:
 - Use passive voice in some places to avoid "you" references
 - Improve markup in several places (filenames, devices, man pages etc). 
 There maybe also a few other places (i.e. vboxvideo_drv should probably 
 not be tagged using <command>)
 - Some minor language fixes to match the Handbook style in general
 
 This also needs a complete whitespace patch on top, but this can wait 
 until any remaining  issues are fixed. Please post followups to this if 
 you have any comments.
Responsible-Changed-From-To: freebsd-doc->manolis 
Responsible-Changed-By: manolis 
Responsible-Changed-When: Thu Dec 1 16:50:10 UTC 2011 
Responsible-Changed-Why:  
Over to me 

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

From: Manolis Kiagias <sonic2000gr@gmail.com>
To: freebsd-doc@FreeBSD.org
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/162961: [PATCH] Update VirtualBox section in handbook
Date: Thu, 01 Dec 2011 19:52:14 +0200

 Here is the latest version of the patch, with few more minor fixes and a 
 complete whitespace overhaul:
 
 http://people.freebsd.org/~manolis/patches/virtualization-virtualbox-chapter-patch-new.txt
 
 A test build is here:
 
 http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/virtualization-guest.html
 
 If there are no objections / fixes, this goes in tomorrow :)

From: Beat Gaetzi <beat@FreeBSD.org>
To: bug-followup@FreeBSD.org, beat@FreeBSD.org
Cc:  
Subject: Re: docs/162961: [handbook] [patch] Update VirtualBox section in handbook
Date: Thu, 1 Dec 2011 19:05:42 +0100

 Thanks for your work. Looks good to me.
 
 Beat

From: Warren Block <wblock@wonkity.com>
To: Manolis Kiagias <sonic2000gr@gmail.com>
Cc: freebsd-doc@freebsd.org, bug-followup@freebsd.org
Subject: Re: docs/162961: [PATCH] Update VirtualBox section in handbook
Date: Thu, 1 Dec 2011 12:53:57 -0700 (MST)

   This message is in MIME format.  The first part should be readable text,
   while the remaining parts are likely unreadable without MIME-aware tools.
 
 ---902635197-1461172185-1322769237=:12893
 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
 
 On Thu, 1 Dec 2011, Manolis Kiagias wrote:
 
 > Here is the latest version of the patch, with few more minor fixes and a 
 > complete whitespace overhaul:
 >
 > http://people.freebsd.org/~manolis/patches/virtualization-virtualbox-chapter-patch-new.txt
 >
 > A test build is here:
 >
 > http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/virtualization-guest.html
 >
 > If there are no objections / fixes, this goes in tomorrow :)
 
 A few quick suggestions:
 
 --- virtualization-virtualbox-chapter-patch-new.txt.orig	2011-12-01 12:41:46.000000000 -0700
 +++ virtualization-virtualbox-chapter-patch-new.txt	2011-12-01 12:52:28.000000000 -0700
 @@ -7,7 +7,7 @@
        </sect2>
   +
   +    <sect2 id="virtualization-guest-virtualbox-guest-additions">
 -+      <title>&virtualbox; Guest Additions on &os; Guest</title>
 ++      <title>&virtualbox; Guest Additions on a &os; Guest</title>
   +
   +      <para>The <application>&virtualbox;</application> guest additions
   +	provide support for:</para>
 @@ -44,7 +44,7 @@
   +
   +      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose-additions && make install clean</userinput></screen>
   +
 -+      <para>Add the following lines to <filename>/etc/rc.conf</filename>:</para>
 ++      <para>Add these lines to <filename>/etc/rc.conf</filename>:</para>
   +
   +      <programlisting>vboxguest_enable="YES"
   +vboxservice_enable="YES"</programlisting>
 @@ -55,8 +55,8 @@
   +      <programlisting>vboxservice_flags="--disable-timesync"</programlisting>
   +
   +      <para>The <literal>vboxvideo_drv</literal> should be recognized by
 -+	<command>Xorg -configure</command>.  If not, use something like this
 -+	in your <filename>xorg.conf</filename> file for the
 ++	<command>Xorg -configure</command>.  If not, modify
 ++	<filename>xorg.conf</filename> for the
   +	<application>&virtualbox;</application> video card:</para>
   +
   +      <programlisting>Section "Device"
 @@ -71,8 +71,8 @@
   +	BusID "PCI:0:2:0"
   +EndSection</programlisting>
   +
 -+      <para>To use <literal>vboxmouse_drv</literal> please adjust the mouse
 -+	section in your <filename>xorg.conf</filename> like this:</para>
 ++      <para>To use <literal>vboxmouse_drv</literal>, adjust the mouse
 ++	section in <filename>xorg.conf</filename>:</para>
   +
   +      <programlisting>Section "InputDevice"
   +	Identifier "Mouse0"
 @@ -127,7 +127,7 @@
   -	may be installed using the following commands:</para>
   +	in <filename role="package">emulators/virtualbox-ose</filename>.
   +	As &virtualbox; is very actively developed, make sure your ports
 -+	tree is up to date before installing.  Install using the following
 ++	tree is up to date before installing.  Install using these
   +	commands:</para>
 
          <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
 @@ -142,7 +142,7 @@
   -	the functions provided by the &man.sysctl.3; library.</para>
   +      <para>To use the kernel modules that allow bridged or host-only
   +	networking, add the following to <filename>/etc/rc.conf</filename>
 -+	and reboot your computer:</para>
 ++	and reboot the computer:</para>
 
   -      <para>When using an older version of the port, follow the instructions
   -	below to make sure <filename class="directory">proc</filename> is
 @@ -170,28 +170,28 @@
   +      <programlisting>vboxnet_enable="YES"</programlisting>
 
          <para>The <groupname>vboxusers</groupname> group is created during
 - 	the installation of <application>&virtualbox;</application>.
 + 	installation of <application>&virtualbox;</application>.
   @@ -1066,6 +1156,21 @@
 
          <screen>&prompt.root; <userinput>pw groupmod vboxusers -m <replaceable>yourusername</replaceable></userinput></screen>
 
   +      <para>The default permissions for <filename
   +	  class="devicefile">/dev/vboxnetctl</filename> are restrictive and
 -+	will need to be changed for bridged networking.</para>
 ++	need to be changed for bridged networking.</para>
   +
   +      <para>To test it temporarily:</para>
   +
   +      <screen>&prompt.root; <userinput>chown root:vboxusers /dev/vboxnetctl</userinput>
   +&prompt.root; <userinput>chmod 0660 /dev/vboxnetctl</userinput></screen>
   +
 -+      <para>To make the permissions change permanent, add the following
 ++      <para>To make the permissions change permanent, add these
   +	lines to <filename>/etc/devfs.conf</filename>:
   +
   +      <programlisting>own     vboxnetctl root:vboxusers
   +perm    vboxnetctl 0660</programlisting>
   +
          <para>To launch <application>&virtualbox;</application>, either select
 - 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from your
 + 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from the
    	graphic environment's menu, or type the following in a
   @@ -1081,6 +1186,71 @@
    	visit the relevant page in the &os; wiki, at <ulink
 ---902635197-1461172185-1322769237=:12893
 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=patch-vb-chapter.diff.txt
 Content-Transfer-Encoding: BASE64
 Content-ID: <alpine.BSF.2.00.1112011253570.12893@wonkity.com>
 Content-Description: 
 Content-Disposition: attachment; filename=patch-vb-chapter.diff.txt
 
 LS0tIHZpcnR1YWxpemF0aW9uLXZpcnR1YWxib3gtY2hhcHRlci1wYXRjaC1u
 ZXcudHh0Lm9yaWcJMjAxMS0xMi0wMSAxMjo0MTo0Ni4wMDAwMDAwMDAgLTA3
 MDANCisrKyB2aXJ0dWFsaXphdGlvbi12aXJ0dWFsYm94LWNoYXB0ZXItcGF0
 Y2gtbmV3LnR4dAkyMDExLTEyLTAxIDEyOjUyOjI4LjAwMDAwMDAwMCAtMDcw
 MA0KQEAgLTcsNyArNyw3IEBADQogICAgICA8L3NlY3QyPg0KICsNCiArICAg
 IDxzZWN0MiBpZD0idmlydHVhbGl6YXRpb24tZ3Vlc3QtdmlydHVhbGJveC1n
 dWVzdC1hZGRpdGlvbnMiPg0KLSsgICAgICA8dGl0bGU+JnZpcnR1YWxib3g7
 IEd1ZXN0IEFkZGl0aW9ucyBvbiAmb3M7IEd1ZXN0PC90aXRsZT4NCisrICAg
 ICAgPHRpdGxlPiZ2aXJ0dWFsYm94OyBHdWVzdCBBZGRpdGlvbnMgb24gYSAm
 b3M7IEd1ZXN0PC90aXRsZT4NCiArDQogKyAgICAgIDxwYXJhPlRoZSA8YXBw
 bGljYXRpb24+JnZpcnR1YWxib3g7PC9hcHBsaWNhdGlvbj4gZ3Vlc3QgYWRk
 aXRpb25zDQogKwlwcm92aWRlIHN1cHBvcnQgZm9yOjwvcGFyYT4NCkBAIC00
 NCw3ICs0NCw3IEBADQogKw0KICsgICAgICA8c2NyZWVuPiZwcm9tcHQucm9v
 dDsgPHVzZXJpbnB1dD5jZCAvdXNyL3BvcnRzL2VtdWxhdG9ycy92aXJ0dWFs
 Ym94LW9zZS1hZGRpdGlvbnMgJiYgbWFrZSBpbnN0YWxsIGNsZWFuPC91c2Vy
 aW5wdXQ+PC9zY3JlZW4+DQogKw0KLSsgICAgICA8cGFyYT5BZGQgdGhlIGZv
 bGxvd2luZyBsaW5lcyB0byA8ZmlsZW5hbWU+L2V0Yy9yYy5jb25mPC9maWxl
 bmFtZT46PC9wYXJhPg0KKysgICAgICA8cGFyYT5BZGQgdGhlc2UgbGluZXMg
 dG8gPGZpbGVuYW1lPi9ldGMvcmMuY29uZjwvZmlsZW5hbWU+OjwvcGFyYT4N
 CiArDQogKyAgICAgIDxwcm9ncmFtbGlzdGluZz52Ym94Z3Vlc3RfZW5hYmxl
 PSJZRVMiDQogK3Zib3hzZXJ2aWNlX2VuYWJsZT0iWUVTIjwvcHJvZ3JhbWxp
 c3Rpbmc+DQpAQCAtNTUsOCArNTUsOCBAQA0KICsgICAgICA8cHJvZ3JhbWxp
 c3Rpbmc+dmJveHNlcnZpY2VfZmxhZ3M9Ii0tZGlzYWJsZS10aW1lc3luYyI8
 L3Byb2dyYW1saXN0aW5nPg0KICsNCiArICAgICAgPHBhcmE+VGhlIDxsaXRl
 cmFsPnZib3h2aWRlb19kcnY8L2xpdGVyYWw+IHNob3VsZCBiZSByZWNvZ25p
 emVkIGJ5DQotKwk8Y29tbWFuZD5Yb3JnIC1jb25maWd1cmU8L2NvbW1hbmQ+
 LiAgSWYgbm90LCB1c2Ugc29tZXRoaW5nIGxpa2UgdGhpcw0KLSsJaW4geW91
 ciA8ZmlsZW5hbWU+eG9yZy5jb25mPC9maWxlbmFtZT4gZmlsZSBmb3IgdGhl
 DQorKwk8Y29tbWFuZD5Yb3JnIC1jb25maWd1cmU8L2NvbW1hbmQ+LiAgSWYg
 bm90LCBtb2RpZnkNCisrCTxmaWxlbmFtZT54b3JnLmNvbmY8L2ZpbGVuYW1l
 PiBmb3IgdGhlDQogKwk8YXBwbGljYXRpb24+JnZpcnR1YWxib3g7PC9hcHBs
 aWNhdGlvbj4gdmlkZW8gY2FyZDo8L3BhcmE+DQogKw0KICsgICAgICA8cHJv
 Z3JhbWxpc3Rpbmc+U2VjdGlvbiAiRGV2aWNlIg0KQEAgLTcxLDggKzcxLDgg
 QEANCiArCUJ1c0lEICJQQ0k6MDoyOjAiDQogK0VuZFNlY3Rpb248L3Byb2dy
 YW1saXN0aW5nPg0KICsNCi0rICAgICAgPHBhcmE+VG8gdXNlIDxsaXRlcmFs
 PnZib3htb3VzZV9kcnY8L2xpdGVyYWw+IHBsZWFzZSBhZGp1c3QgdGhlIG1v
 dXNlDQotKwlzZWN0aW9uIGluIHlvdXIgPGZpbGVuYW1lPnhvcmcuY29uZjwv
 ZmlsZW5hbWU+IGxpa2UgdGhpczo8L3BhcmE+DQorKyAgICAgIDxwYXJhPlRv
 IHVzZSA8bGl0ZXJhbD52Ym94bW91c2VfZHJ2PC9saXRlcmFsPiwgYWRqdXN0
 IHRoZSBtb3VzZQ0KKysJc2VjdGlvbiBpbiA8ZmlsZW5hbWU+eG9yZy5jb25m
 PC9maWxlbmFtZT46PC9wYXJhPg0KICsNCiArICAgICAgPHByb2dyYW1saXN0
 aW5nPlNlY3Rpb24gIklucHV0RGV2aWNlIg0KICsJSWRlbnRpZmllciAiTW91
 c2UwIg0KQEAgLTEyNyw3ICsxMjcsNyBAQA0KIC0JbWF5IGJlIGluc3RhbGxl
 ZCB1c2luZyB0aGUgZm9sbG93aW5nIGNvbW1hbmRzOjwvcGFyYT4NCiArCWlu
 IDxmaWxlbmFtZSByb2xlPSJwYWNrYWdlIj5lbXVsYXRvcnMvdmlydHVhbGJv
 eC1vc2U8L2ZpbGVuYW1lPi4NCiArCUFzICZ2aXJ0dWFsYm94OyBpcyB2ZXJ5
 IGFjdGl2ZWx5IGRldmVsb3BlZCwgbWFrZSBzdXJlIHlvdXIgcG9ydHMNCi0r
 CXRyZWUgaXMgdXAgdG8gZGF0ZSBiZWZvcmUgaW5zdGFsbGluZy4gIEluc3Rh
 bGwgdXNpbmcgdGhlIGZvbGxvd2luZw0KKysJdHJlZSBpcyB1cCB0byBkYXRl
 IGJlZm9yZSBpbnN0YWxsaW5nLiAgSW5zdGFsbCB1c2luZyB0aGVzZQ0KICsJ
 Y29tbWFuZHM6PC9wYXJhPg0KICANCiAgICAgICAgPHNjcmVlbj4mcHJvbXB0
 LnJvb3Q7IDx1c2VyaW5wdXQ+Y2QgL3Vzci9wb3J0cy9lbXVsYXRvcnMvdmly
 dHVhbGJveC1vc2U8L3VzZXJpbnB1dD4NCkBAIC0xNDIsNyArMTQyLDcgQEAN
 CiAtCXRoZSBmdW5jdGlvbnMgcHJvdmlkZWQgYnkgdGhlICZtYW4uc3lzY3Rs
 LjM7IGxpYnJhcnkuPC9wYXJhPg0KICsgICAgICA8cGFyYT5UbyB1c2UgdGhl
 IGtlcm5lbCBtb2R1bGVzIHRoYXQgYWxsb3cgYnJpZGdlZCBvciBob3N0LW9u
 bHkNCiArCW5ldHdvcmtpbmcsIGFkZCB0aGUgZm9sbG93aW5nIHRvIDxmaWxl
 bmFtZT4vZXRjL3JjLmNvbmY8L2ZpbGVuYW1lPg0KLSsJYW5kIHJlYm9vdCB5
 b3VyIGNvbXB1dGVyOjwvcGFyYT4NCisrCWFuZCByZWJvb3QgdGhlIGNvbXB1
 dGVyOjwvcGFyYT4NCiAgDQogLSAgICAgIDxwYXJhPldoZW4gdXNpbmcgYW4g
 b2xkZXIgdmVyc2lvbiBvZiB0aGUgcG9ydCwgZm9sbG93IHRoZSBpbnN0cnVj
 dGlvbnMNCiAtCWJlbG93IHRvIG1ha2Ugc3VyZSA8ZmlsZW5hbWUgY2xhc3M9
 ImRpcmVjdG9yeSI+cHJvYzwvZmlsZW5hbWU+IGlzDQpAQCAtMTcwLDI4ICsx
 NzAsMjggQEANCiArICAgICAgPHByb2dyYW1saXN0aW5nPnZib3huZXRfZW5h
 YmxlPSJZRVMiPC9wcm9ncmFtbGlzdGluZz4NCiAgDQogICAgICAgIDxwYXJh
 PlRoZSA8Z3JvdXBuYW1lPnZib3h1c2VyczwvZ3JvdXBuYW1lPiBncm91cCBp
 cyBjcmVhdGVkIGR1cmluZw0KLSAJdGhlIGluc3RhbGxhdGlvbiBvZiA8YXBw
 bGljYXRpb24+JnZpcnR1YWxib3g7PC9hcHBsaWNhdGlvbj4uDQorIAlpbnN0
 YWxsYXRpb24gb2YgPGFwcGxpY2F0aW9uPiZ2aXJ0dWFsYm94OzwvYXBwbGlj
 YXRpb24+Lg0KIEBAIC0xMDY2LDYgKzExNTYsMjEgQEANCiAgDQogICAgICAg
 IDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PnB3IGdyb3VwbW9k
 IHZib3h1c2VycyAtbSA8cmVwbGFjZWFibGU+eW91cnVzZXJuYW1lPC9yZXBs
 YWNlYWJsZT48L3VzZXJpbnB1dD48L3NjcmVlbj4NCiAgDQogKyAgICAgIDxw
 YXJhPlRoZSBkZWZhdWx0IHBlcm1pc3Npb25zIGZvciA8ZmlsZW5hbWUNCiAr
 CSAgY2xhc3M9ImRldmljZWZpbGUiPi9kZXYvdmJveG5ldGN0bDwvZmlsZW5h
 bWU+IGFyZSByZXN0cmljdGl2ZSBhbmQNCi0rCXdpbGwgbmVlZCB0byBiZSBj
 aGFuZ2VkIGZvciBicmlkZ2VkIG5ldHdvcmtpbmcuPC9wYXJhPg0KKysJbmVl
 ZCB0byBiZSBjaGFuZ2VkIGZvciBicmlkZ2VkIG5ldHdvcmtpbmcuPC9wYXJh
 Pg0KICsNCiArICAgICAgPHBhcmE+VG8gdGVzdCBpdCB0ZW1wb3JhcmlseTo8
 L3BhcmE+DQogKw0KICsgICAgICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVz
 ZXJpbnB1dD5jaG93biByb290OnZib3h1c2VycyAvZGV2L3Zib3huZXRjdGw8
 L3VzZXJpbnB1dD4NCiArJnByb21wdC5yb290OyA8dXNlcmlucHV0PmNobW9k
 IDA2NjAgL2Rldi92Ym94bmV0Y3RsPC91c2VyaW5wdXQ+PC9zY3JlZW4+DQog
 Kw0KLSsgICAgICA8cGFyYT5UbyBtYWtlIHRoZSBwZXJtaXNzaW9ucyBjaGFu
 Z2UgcGVybWFuZW50LCBhZGQgdGhlIGZvbGxvd2luZw0KKysgICAgICA8cGFy
 YT5UbyBtYWtlIHRoZSBwZXJtaXNzaW9ucyBjaGFuZ2UgcGVybWFuZW50LCBh
 ZGQgdGhlc2UNCiArCWxpbmVzIHRvIDxmaWxlbmFtZT4vZXRjL2RldmZzLmNv
 bmY8L2ZpbGVuYW1lPjoNCiArDQogKyAgICAgIDxwcm9ncmFtbGlzdGluZz5v
 d24gICAgIHZib3huZXRjdGwgcm9vdDp2Ym94dXNlcnMNCiArcGVybSAgICB2
 Ym94bmV0Y3RsIDA2NjA8L3Byb2dyYW1saXN0aW5nPg0KICsNCiAgICAgICAg
 PHBhcmE+VG8gbGF1bmNoIDxhcHBsaWNhdGlvbj4mdmlydHVhbGJveDs8L2Fw
 cGxpY2F0aW9uPiwgZWl0aGVyIHNlbGVjdA0KLSAJdGhlIDxndWltZW51aXRl
 bT5TdW4gVmlydHVhbEJveDwvZ3VpbWVudWl0ZW0+IGl0ZW0gZnJvbSB5b3Vy
 DQorIAl0aGUgPGd1aW1lbnVpdGVtPlN1biBWaXJ0dWFsQm94PC9ndWltZW51
 aXRlbT4gaXRlbSBmcm9tIHRoZQ0KICAJZ3JhcGhpYyBlbnZpcm9ubWVudCdz
 IG1lbnUsIG9yIHR5cGUgdGhlIGZvbGxvd2luZyBpbiBhDQogQEAgLTEwODEs
 NiArMTE4Niw3MSBAQA0KICAJdmlzaXQgdGhlIHJlbGV2YW50IHBhZ2UgaW4g
 dGhlICZvczsgd2lraSwgYXQgPHVsaW5rDQo=
 
 ---902635197-1461172185-1322769237=:12893--

From: Manolis Kiagias <sonic2000gr@gmail.com>
To: Warren Block <wblock@wonkity.com>
Cc: freebsd-doc@freebsd.org, bug-followup@freebsd.org
Subject: Re: docs/162961: [PATCH] Update VirtualBox section in handbook
Date: Thu, 01 Dec 2011 22:53:58 +0200

 On 1/12/2011 9:53 μμ, Warren Block wrote:
 > On Thu, 1 Dec 2011, Manolis Kiagias wrote:
 >
 >> Here is the latest version of the patch, with few more minor fixes 
 >> and a complete whitespace overhaul:
 >>
 >> http://people.freebsd.org/~manolis/patches/virtualization-virtualbox-chapter-patch-new.txt 
 >>
 >>
 >> A test build is here:
 >>
 >> http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/virtualization-guest.html 
 >>
 >>
 >> If there are no objections / fixes, this goes in tomorrow :)
 >
 > A few quick suggestions:
 
 Thanks, this looks fine. I will integrate it tomorrow.

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/162961: commit references a PR
Date: Fri,  2 Dec 2011 17:22:09 +0000 (UTC)

 manolis     2011-12-02 17:22:01 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/virtualization chapter.sgml 
   Log:
   Update the VirtualBox sections with new info:
   
   - FreeBSD Guest Additions
   - Guest CD/DVD support
   - Guest USB support
   
   The information comes mostly from the FreeBSD wiki and was converted for the
   Documentation Project by Eric Newberry as part of the Google Code-in contest.
   Eric's mentors were beat and decke. Thank you all for this nice work!
   
   PR:             docs/162961
   Authored by:    Eric Newberry
   Submitted by:   beat
   Reviewed by:    beat, wblock
   
   Revision  Changes    Path
   1.26      +201 -31   doc/en_US.ISO8859-1/books/handbook/virtualization/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: manolis 
State-Changed-When: Fri Dec 2 17:37:42 UTC 2011 
State-Changed-Why:  
Changes committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=162961 
>Unformatted:
