From le@univie.ac.at  Mon Dec  1 14:24:36 2003
Return-Path: <le@univie.ac.at>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6C13616A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  1 Dec 2003 14:24:36 -0800 (PST)
Received: from mailbox.univie.ac.at (mailbox.univie.ac.at [131.130.1.27])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5B2F443F93
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  1 Dec 2003 14:24:34 -0800 (PST)
	(envelope-from le@univie.ac.at)
Received: from korben.in.tern (adslle.cc.univie.ac.at [131.130.102.11])
	by mailbox.univie.ac.at (8.12.10/8.12.10) with ESMTP id hB1MOMD0364388
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 1 Dec 2003 23:24:25 +0100
Received: from korben.in.tern (korben.in.tern [127.0.0.1])
	by korben.in.tern (8.12.10/8.12.10) with ESMTP id hB1MONdY002865
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 1 Dec 2003 23:24:24 +0100 (CET)
	(envelope-from le@korben.in.tern)
Received: (from le@localhost)
	by korben.in.tern (8.12.10/8.12.10/Submit) id hB1MOII7002864;
	Mon, 1 Dec 2003 23:24:18 +0100 (CET)
	(envelope-from le)
Message-Id: <200312012224.hB1MOII7002864@korben.in.tern>
Date: Mon, 1 Dec 2003 23:24:18 +0100 (CET)
From: Lukas Ertl <l.ertl@univie.ac.at>
Reply-To: Lukas Ertl <l.ertl@univie.ac.at>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] handbook/multimedia: clarify 5.x behaviour wrt to devfs
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         59879
>Category:       docs
>Synopsis:       [PATCH] handbook/multimedia: clarify 5.x behaviour wrt to devfs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 01 14:30:18 PST 2003
>Closed-Date:    Wed Dec 03 14:01:44 PST 2003
>Last-Modified:  Wed Dec 03 14:01:44 PST 2003
>Originator:     Lukas Ertl
>Release:        FreeBSD 5.2-BETA i386
>Organization:
Vienna University Computer Center
>Environment:
System: FreeBSD korben 5.2-BETA FreeBSD 5.2-BETA #68: Sun Nov 30 23:02:39 CET 2003 le@korben:/usr/obj/usr/src/sys/KORBEN i386


	
>Description:

The multimedia/video playback chapter of the handbook is a little bit
inconsistent about symbolic links when using devfs(5).

Also add a note about "option USER_LDT" being only available on -stable.

>How-To-Repeat:
	
>Fix:

	

--- handbook.diff begins here ---
Index: en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
===================================================================
RCS file: /usr/local/bsdcvs/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml,v
retrieving revision 1.68
diff -u -r1.68 chapter.sgml
--- en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml	24 Nov 2003 03:57:43 -0000	1.68
+++ en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml	1 Dec 2003 22:18:56 -0000
@@ -783,8 +783,16 @@
     <para>On FreeBSD&nbsp;5.X, which uses &man.devfs.5; there
         is a slightly different set of recommended links:</para>
 
-      <screen>&prompt.root; <userinput>ln -sf /dev/acd0c /dev/dvd</userinput>
-&prompt.root; <userinput>ln -sf /dev/acd0c /dev/rdvd</userinput></screen>
+      <screen>&prompt.root; <userinput>ln -sf /dev/acd0 /dev/dvd</userinput>
+&prompt.root; <userinput>ln -sf /dev/acd0 /dev/rdvd</userinput></screen>
+
+    <para>Please note that due to the nature of &man.devfs.5;,
+      manually created links like these will not persist if you reboot
+      your system.  In order to create the symbolic links automatically
+      whenever you boot your system, add the following lines to
+      <filename>/etc/devfs.conf</filename>:</para>
+      <programlisting>link acd0 dvd
+link acd0 rdvd</programlisting>
 
     <para>Additionally, DVD decryption, which requires invoking
       special DVD-ROM functions, requires write permission on the DVD
@@ -805,6 +813,11 @@
 
       <programlisting>option CPU_ENABLE_SSE
 option USER_LDT</programlisting>
+
+    <note>
+      <para><literal>option USER_LDT</literal> is not available on
+        &os;&nbsp;5.X.</para>
+    </note>
 
     <para>To enhance the shared memory X11 interface, it is
       recommended that the values of some &man.sysctl.8; variables
--- handbook.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Tue Dec 2 10:55:29 PST 2003 
Responsible-Changed-Why:  
I'll take this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=59879 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Wed Dec 3 14:01:25 PST 2003 
State-Changed-Why:  
Fixed, thanks! 

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