svn commit: r54707 - head/en_US.ISO8859-1/books/handbook/boot

[Fernando Apesteguía]

Author: fernape (ports committer)
Date: Mon Nov 23 18:57:58 2020
New Revision: 54707
URL: https://svnweb.freebsd.org/changeset/doc/54707

Log:
  handbook/boot: fix unload + load example
  
  The unload + load example in the 12.2.3 section doesn't seem to work.
  The original problem was reported in https://reviews.freebsd.org/D24960.
  
  Correct the example by using fully qualified paths since this is how it works
  now. Tested in 12.1, 12.2 and 13-current.
  
  Approved by:	docs (gbe@)
  Differential Revision:		https://reviews.freebsd.org/27277

Modified:
  head/en_US.ISO8859-1/books/handbook/boot/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/boot/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/boot/chapter.xml	Mon Nov 23 18:43:24 2020	(r54706)
+++ head/en_US.ISO8859-1/books/handbook/boot/chapter.xml	Mon Nov 23 18:57:58 2020	(r54707)
@@ -449,19 +449,21 @@ boot:</screen>
 	previous or another, specified kernel:</para>
 
       <screen><userinput>unload</userinput>
-<userinput>load <replaceable>kernel.old</replaceable></userinput></screen>
+<userinput>load <replaceable>/path/to/kernelfile</replaceable></userinput></screen>
 
-      <para>Use <filename>kernel.GENERIC</filename> to refer to the
-	default kernel that comes with an installation, or
-	<filename>kernel.old</filename>, to refer to the previously
-	installed kernel before a system upgrade or before configuring
-	a custom kernel.</para>
+      <para>Use the qualified
+	<filename>/boot/GENERIC/kernel</filename> to refer to
+	the default kernel that comes with an installation, or
+	<filename>/boot/kernel.old/kernel</filename>, to refer to the
+	previously installed kernel before a system upgrade or before
+	configuring a custom kernel.</para>
 
       <para>Use the following to load the usual modules with another
-	kernel:</para>
+	kernel.  Note that in this case it is not necessary the
+	qualified name:</para>
 
       <screen><userinput>unload</userinput>
-<userinput>set kernel="<replaceable>kernel.old</replaceable>"</userinput>
+<userinput>set kernel="<replaceable>mykernel</replaceable>"</userinput>
 <userinput>boot-conf</userinput></screen>
 
       <para>To load an automated kernel configuration script:</para>