Bug 35730

Summary: mknod(8) page refers to non-existent file device.<architecture>
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Gary W. Swearingen 2002-03-10 07:50:01 UTC 
The mknod(8) man page refers to the non-existent file
"/usr/src/sys/conf/device.<architecture>".  (Yes, I have
the source cvsup'd. :-)

It also has a couple of English problems; see below:
================

Fix: 

Determine which file documents major/minor device numbers, if any,
and either replace the filename or remove the stuff following the
/dev/MAKEDEV reference.

In the "Compatibility" section, change "wound" to "would" and
change "chown(8) like functionality" to "chown(8)-like functionality"
(or reword it).
How-To-Repeat: n/a
================
Comment 1 Dima Dorfman 2002-03-10 08:51:51 UTC 
"Gary W. Swearingen" <swear@blarg.net> wrote:
> >Fix:
> 
> Determine which file documents major/minor device numbers, if any,
> and either replace the filename or remove the stuff following the
> /dev/MAKEDEV reference.

It's sys/conf/majors.  I fixed this in -current about four months ago,
but somehow forgot to MFC it.

> In the "Compatibility" section, change "wound" to "would" and
> change "chown(8) like functionality" to "chown(8)-like functionality"
> (or reword it).

Fixed.  I'll MFC the above change when I do this one.
Comment 2 dd freebsd_committer freebsd_triage 2002-03-10 08:52:01 UTC 
State Changed
From-To: open->closed

fixed, thanks.
Comment 3 Gary W. Swearingen 2003-02-11 03:26:16 UTC 
Please re-open this PR to have the main problem fixed in 4.x.
(It's not currently a problem in "5.x".)

The English has already been corrected. This should fix the problem
with the non-existent file.

Patch based on
.\" $FreeBSD: src/sbin/mknod/mknod.8,v 1.11.2.8 2002/03/19 01:56:38 dd Exp $

--- /pr/work/mknod..orig.8	Mon Feb 10 19:14:58 2003
+++ /pr/work/mknod.8	Mon Feb 10 19:25:34 2003
@@ -80,13 +80,7 @@
 major device number to use for a particular device, check the file
 .Pa /dev/MAKEDEV
 to see if the device is known, or check
-the system dependent device configuration file:
-.Bd -ragged -offset indent
-.Dq Pa /usr/src/sys/conf/device. Ns Aq Ar architecture
-.Ed
-.Pp
-(for example
-.Pa device.hp300 ) .
+.Pa /usr/src/sys/conf/majors .
 .It Ar minor
 The minor device number tells the kernel which subunit
 the node corresponds to on the device; for example,
Comment 4 Giorgos Keramidas freebsd_committer freebsd_triage 2003-02-12 15:59:26 UTC 
State Changed
From-To: closed->patched

The change the PR describes has been fixed in current, but 4.X needs 
fixing too.  Thanks to Gary W. Swearingen for the reminder.
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2003-03-04 18:17:11 UTC 
State Changed
From-To: patched->closed

I've committed the change to RELENG_4 as revision 1.11.2.10 of 
file src/sbin/mknod/mknod.8