emulators/virtualbox-ose: Update description and message files

- Add updated information about supported versions, installation
  commands and mitigation for a known issue.
- Removed reference to the wiki page.

Reviewed on github:

https://github.com/freebsd/freebsd-ports/pull/115

PR:             254412

2 files changed, 28 insertions, 16 deletions

diff --git a/emulators/virtualbox-ose-additions/pkg-descr b/emulators/virtualbox-ose-additions/pkg-descr
index e93c940f7f4a..54c521686dd9 100644
--- a/emulators/virtualbox-ose-additions/pkg-descr
+++ b/emulators/virtualbox-ose-additions/pkg-descr
@@ -1,9 +1,8 @@
-These additions are for installation inside a FreeBSD guest.
+VirtualBox Guest Additions provide closer integration between host and
+guest, and improve the performance of guest systems.
 
-VirtualBox is a family of powerful x86 virtualization products for
-enterprise as well as home use. Not only is VirtualBox an extremely
-feature rich, high performance product for enterprise customers, it
-is also the only professional solution that is freely available as
-Open Source Software under the terms of the GNU General Public License.
+This FreeBSD provided package can be installed in FreeBSD guest machines.
+
+Additions are not intended for use on Host machines.
 
 WWW: https://www.virtualbox.org/
diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message
index e8b5c6a5edfa..221b43a1fee4 100644
--- a/emulators/virtualbox-ose-additions/pkg-message
+++ b/emulators/virtualbox-ose-additions/pkg-message
@@ -1,23 +1,36 @@
 [
 { type: install
   message: <<EOM
-VirtualBox Guest Additions were installed.
+VirtualBox Guest Additions are installed.
 
+To enable and start the required services:
 
-You need to enable the vboxguest startscript to load the kernel module and
-vboxservice to use host time synchronization.
+# sysrc vboxguest_enable="YES"
+# sysrc vboxservice_enable="YES"
 
-vboxguest_enable="YES"
-vboxservice_enable="YES"
+To start the services, restart the system.
 
-You also have to add all X11 users that want to use any of the additional
-features (clipboard sharing, window scaling) to the wheel group.
+In some situations, a panic will occur when the kernel module loads.
+Having no more than one virtual CPU might mitigate the issue.
 
-% pw groupmod wheel -m jerry
+For features such as window scaling and clipboard sharing, membership of
+the wheel group is required. With username jerry as an example:
 
-Reboot the machine to load the needed kernel modules.
+# pw groupmod wheel -m jerry
 
-For detailed informations please visit http://wiki.freebsd.org/VirtualBox
+The settings dialogue for FreeBSD guests encourages use of the VMSVGA
+graphics controller. Whilst this might suit installations of FreeBSD
+without a desktop environment (a common use case), it is not appropriate
+where Guest Additions are installed.
+
+Where Guest Additions are installed:
+
+1. prefer VBoxSVGA
+
+2. do not enable 3D acceleration (doing so will invisibly
+   lose the preference for VBoxSVGA)
+
+– you may ignore the yellow alert that encourages use of VMSVGA.
 EOM
 }
 ]