MAKEDEV.8 improvement pack:

- refer to the section 4 manual page for every device target, whenever
possible
- repair a few minor quoting errors
- repair a few sorting errors
- fix a few device descriptions (ideally they would be synched with the
  .Nd line of their manpages, but we are not there... yet)
- minor mdoc fixes

Thanks to jmc@ for review and a lot of constructive criticism.

1 files changed, 14 insertions, 7 deletions

diff --git a/etc/MAKEDEV.mansub b/etc/MAKEDEV.mansub
index 535a6edee4b..5c4627c01b8 100644
--- a/etc/MAKEDEV.mansub
+++ b/etc/MAKEDEV.mansub
@@ -1,4 +1,4 @@
-dnl	$OpenBSD: MAKEDEV.mansub,v 1.1 2004/02/16 19:03:30 miod Exp $
+dnl	$OpenBSD: MAKEDEV.mansub,v 1.2 2004/02/20 19:13:01 miod Exp $
 dnl
 dnl Copyright (c) 2004, Miodrag Vallat
 dnl Copyright (c) 2001-2004 Todd T. Fries <todd@OpenBSD.org>
@@ -66,8 +66,8 @@ dnl store a version string for 'this' file
 dnl
 dnl vers ( uniqueidstring, versionstring, subdir )
 dnl
-dnl example1: vers(__file__, {-$OpenBSD: MAKEDEV.mansub,v 1.1 2004/02/16 19:03:30 miod Exp $-})
-dnl example2: vers(__file__, {-$OpenBSD: MAKEDEV.mansub,v 1.1 2004/02/16 19:03:30 miod Exp $-}, etc.MACHINE)
+dnl example1: vers(__file__, {-$OpenBSD: MAKEDEV.mansub,v 1.2 2004/02/20 19:13:01 miod Exp $-})
+dnl example2: vers(__file__, {-$OpenBSD: MAKEDEV.mansub,v 1.2 2004/02/20 19:13:01 miod Exp $-}, etc.MACHINE)
 dnl
 dnl if subdir is defined, prepend it to the filename in the version string
 dnl
@@ -78,7 +78,7 @@ define({-vers-},
 dnl
 dnl Version info for this file:
 dnl
-vers(__file__, {-$OpenBSD: MAKEDEV.mansub,v 1.1 2004/02/16 19:03:30 miod Exp $-})dnl
+vers(__file__, {-$OpenBSD: MAKEDEV.mansub,v 1.2 2004/02/20 19:13:01 miod Exp $-})dnl
 dnl
 dnl
 define({-_addsubdir-},
@@ -98,11 +98,16 @@ popdef({-_m4_cvs_ver-})dnl
 show_vers()dnl
 -})-})dnl
 dnl
+dnl _devxr(name,optional different xr name)
+dnl
+define({-_devxr-},{-.Xr $1 ifelse(index($1,{- -}),-1,{-4 -})-})dnl
 dnl
 dnl _devitem(pattern, description)
 dnl
-define({-_devitem-},{-.It Ar $1
-$2.-})dnl
+define({-_devitem-},{-.It Ar $2
+$3{--}ifelse($4,nothing,,{-, see
+_devxr({-ifelse($4,,$1,$4)-})-})dnl
+.-})dnl
 dnl
 dnl _devtitle(name,description)
 dnl
@@ -118,7 +123,9 @@ define({-$1__DEV-}, {-Y-})-})dnl
 dnl
 define({-_MKDEV-}, {-$1_mkdev-})dnl
 define({-_TITLE-}, {-$1_title-})dnl
-define({-__devitem-}, {-define($1_dev, {-_devitem($2,$3)-})$4-})dnl
+dnl
+define({-__devitem-}, {-define($1_dev, {-_devitem($1,$2,$3,$4)-})-})dnl
+dnl
 define({-__devtitle-}, {-define($1_title, {-_devtitle($1,$2)-})-})dnl
 define({-_mkdev-})dnl
 define({-_mcdev-})dnl