remove the largely out of date examples related to kernel

building: more accurate information can be found elsewhere;

while here, replace Gt sequences;

prompted by a diff from il ka;
ok deraadt guenther

1 files changed, 18 insertions, 72 deletions

diff --git a/usr.sbin/config/config.8 b/usr.sbin/config/config.8
index 748aaab7ac9..d79619fc663 100644
--- a/usr.sbin/config/config.8
+++ b/usr.sbin/config/config.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: config.8,v 1.65 2017/10/07 06:41:43 guenther Exp $
+.\"	$OpenBSD: config.8,v 1.66 2018/04/25 12:01:11 jmc Exp $
 .\"	$NetBSD: config.8,v 1.10 1996/08/31 20:58:16 mycroft Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     from: @(#)config.8	8.2 (Berkeley) 4/19/94
 .\"
-.Dd $Mdocdate: October 7 2017 $
+.Dd $Mdocdate: April 25 2018 $
 .Dt CONFIG 8
 .Os
 .Sh NAME
@@ -249,11 +249,11 @@ When invoked, the kernel identification is first shown.
 OpenBSD 5.3-current (GENERIC.MP) #91: Mon Mar 25 16:43:17 MDT 2013
     deraadt@i386.openbsd.org:/usr/src/sys/arch/i386/compile/GENERIC.MP
 Enter 'help' for information
-ukc\*(Gt
+ukc>
 .Ed
 .Pp
 One or more warnings may be printed before the
-.Li ukc\*(Gt
+.Li ukc>
 prompt.
 .Bd -literal -offset indent
 warning: no output file specified
@@ -325,61 +325,7 @@ is the number of minutes west of GMT and
 is non-zero if Daylight Saving Time is in effect.
 Without arguments, displays its current value.
 .El
-.Sh EXAMPLES (kernel building)
-Note:
-The standard
-.Ox
-kernel configuration
-(GENERIC or GENERIC.MP)
-is suitable for most purposes.
-Use of an alternative kernel configuration is not recommended.
-A custom kernel is built in the following way.
-.Pp
-To compile a kernel from a non-writable media (such as a CD-ROM)
-mounted on
-.Pa /usr/src ,
-do the following:
-.Bd -literal -offset indent
-# cd /somedir
-# cp /usr/src/sys/arch/somearch/conf/SOMEFILE .
-# vi SOMEFILE	(to make any changes)
-# config -s /usr/src/sys -b . SOMEFILE
-# make
-.Ed
-.Pp
-To compile a kernel inside a writable source tree, do the following:
-.Bd -literal -offset indent
-# cd /usr/src/sys/arch/somearch/conf
-# vi SOMEFILE	(to make any changes)
-# config SOMEFILE
-# cd ../compile/SOMEFILE
-# make
-.Ed
-.Pp
-In the examples above,
-.Ar somedir
-is a writable directory,
-.Ar somearch
-is the architecture (e.g. i386),
-and
-.Ar SOMEFILE
-should be a name indicative of a particular configuration (often
-that of the hostname).
-.Nm config
-will warn if a
-.Dq make clean
-is required.
-.Pp
-The new kernel, called
-.Pa bsd ,
-can be copied to
-.Pa /bsd
-and the system will boot it next time.
-Most people save their backup kernels as
-.Pa /bsd.1 ,
-.Pa /bsd.2 ,
-etc.
-.Sh EXAMPLES (kernel modification)
+.Sh EXAMPLES
 The Ethernet card is not detected at boot because the kernel configuration
 does not match the physical hardware configuration,
 e.g. wrong IRQ in OpenBSD/i386.
@@ -387,13 +333,13 @@ The Ethernet card is supposed to use the
 .Xr ne 4
 driver.
 .Bd -literal
-.No ukc\*(Gt Ic find ne
+.No ukc> Ic find ne
 24 ne0 at isa0 port 0x240 size 0 iomem 0xd8000 iosiz 0 irq 9 drq -1 drq2 -1 flags 0x0
 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 flags 0x0
 26 ne* at isapnp0 port -1 size 0 iomem -1 iosiz 0 irq -1 drq -1 flags 0x0
 27 ne* at pci* dev -1 function -1 flags 0x0
 28 ne* at pcmcia* function -1 irq -1 flags 0x0
-ukc\*(Gt
+ukc>
 .Ed
 .Pp
 ne1 seems to match the configuration except it uses IRQ 10 instead of IRQ 5.
@@ -402,7 +348,7 @@ So the irq on ne1 should be changed via the
 command.
 The device can be specified by either name or number.
 .Bd -literal
-.No ukc\*(Gt Ic change ne1
+.No ukc> Ic change ne1
 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1
 .No change (y/n) \&? Ic y
 .No port [0x300] \&?
@@ -415,13 +361,13 @@ The device can be specified by either name or number.
 .No flags [0] \&?
 25 ne1 changed
 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 5 drq -1 drq2 -1 flags 0x0
-ukc\*(Gt
+ukc>
 .Ed
 .Pp
 It's also possible to disable all devices with a common attribute.
 For example:
 .Bd -literal
-.No ukc\*(Gt Ic disable port 0x300
+.No ukc> Ic disable port 0x300
  25 ne1 disabled
  72 we1 disabled
  75 el0 disabled
@@ -434,26 +380,26 @@ command is useful for finding which devices have a certain attribute.
 It can also be used to find those devices with a particular value for
 an attribute.
 .Bd -literal
-.No ukc\*(Gt Ic show slot
+.No ukc> Ic show slot
   2 ahc* at eisa0 slot -1
  10 uha* at eisa0 slot -1
  12 ep0 at eisa0 slot -1
  17 ep* at eisa0 slot -1
 102 ahb* at eisa0 slot -1
 103 fea* at eisa0 slot -1
-.No ukc\*(Gt Ic show port 0x300
+.No ukc> Ic show port 0x300
  25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 flags 0x0
  72 we1 at isa0 port 0x300 size 0 iomem 0xcc000 iosiz 0 irq 10 drq -1 drq2 -1 flags 0x0
  75 el0 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 9 drq -1 drq2 -1 flags 0x0
  77 ie1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 flags 0x0
-ukc\*(Gt
+ukc>
 .Ed
 .Pp
 It is possible to add new devices, but only devices that were linked into the
 kernel.
 If a new device is added, following devices will be renumbered.
 .Bd -literal
-.No ukc\*(Gt Ic find ep
+.No ukc> Ic find ep
  11 ep0 at isa0 port -1 size 0 iomem -1 iosiz 0 irq -1 drq -1 drq2 -1 flags 0x0
  12 ep0 at eisa0 slot -1 flags 0x0
  13 ep0 at pci* dev -1 function -1 flags 0x0
@@ -462,11 +408,11 @@ If a new device is added, following devices will be renumbered.
  16 ep* at eisa0 slot -1 flags 0x0
  17 ep* at pci* dev -1 function -1 flags 0x0
  18 ep* at pcmcia* dev -1 irq -1 flags 0x0
-.No ukc\*(Gt Ic add ep1
+.No ukc> Ic add ep1
 .No "Clone Device (DevNo, 'q' or '\&?') \&?" Ic 13
 .No "Insert before Device (DevNo, 'q' or '\&?')" Ic 14
  14 ep1 at pci* dev -1 function -1
-.No ukc\*(Gt Ic change 14
+.No ukc> Ic change 14
  14 ep1 at pci* dev -1 function -1
 .No change (y/n) \&? Ic y
 .No dev [-1] \&? Ic 14
@@ -474,7 +420,7 @@ If a new device is added, following devices will be renumbered.
 .No flags [0] \&? Ic 18
  14 ep1 changed
  14 ep1 at pci* dev 14 function -1 flags 0x12
-ukc\*(Gt
+ukc>
 .Ed
 .Pp
 When done, exit the program with the
@@ -493,7 +439,7 @@ or
 .Fl f
 was given, else ignore changes).
 .Bd -literal
-.No ukc\*(Gt Ic quit
+.No ukc> Ic quit
 .Ed
 .Sh SEE ALSO
 .Xr options 4 ,