Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 21 Feb 2003 14:01:32 +0200
From:      Ruslan Ermilov <ru@freebsd.org>
To:        Tom Rhodes <trhodes@freebsd.org>
Cc:        current@freebsd.org
Subject:   Re: cvs commit: src/share/man/man4 Makefile
Message-ID:  <20030221120132.GB30966@sunbay.com>
In-Reply-To: <200302152228.h1FMSYBr005847@repoman.freebsd.org>
References:  <200302152228.h1FMSYBr005847@repoman.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--9zSXsLTf0vkW971A
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sat, Feb 15, 2003 at 02:28:34PM -0800, Tom Rhodes wrote:
> trhodes     2003/02/15 14:28:34 PST
>=20
>   Modified files:
>     share/man/man4       Makefile=20
>   Log:
>   Link several of the if_* modules to their respected manual pages.
>  =20
>   Revision  Changes    Path
>   1.190     +40 -0     src/share/man/man4/Makefile
>=20
Hmm, if we really want this, mdoc(7) rules say that we should also
add "if_*"'s to the NAME sections of all affected manpages, e.g.:

%%%
Index: an.4
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /home/ncvs/src/share/man/man4/an.4,v
retrieving revision 1.15
diff -u -r1.15 an.4
--- an.4	15 Feb 2003 17:12:53 -0000	1.15
+++ an.4	21 Feb 2003 11:52:33 -0000
@@ -34,7 +34,7 @@
 .Dt AN 4
 .Os
 .Sh NAME
-.Nm an
+.Nm an , if_an
 .Nd "Aironet Communications 4500/4800 wireless network adapter driver"
 .Sh SYNOPSIS
 .Cd "device an"
%%%

But my personal opinion on this change is that it is unnecessary.
The "if_*" convention on calling network interface modules is an
internal implementation detail, and only to allow ifconfig(8) to
automatically load driver modules.

Any other opinions?


Cheers,
--=20
Ruslan Ermilov		Sysadmin and DBA,
ru@sunbay.com		Sunbay Software AG,
ru@FreeBSD.org		FreeBSD committer,
+380.652.512.251	Simferopol, Ukraine

http://www.FreeBSD.org	The Power To Serve
http://www.oracle.com	Enabling The Information Age

--9zSXsLTf0vkW971A
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)

iD8DBQE+VhUcUkv4P6juNwoRAk65AJ0cKAj7a6unD/R2+kQEEXpZXofnHwCfeglL
GXmOVJKhkUp1X1ntclQ/qJg=
=s5OI
-----END PGP SIGNATURE-----

--9zSXsLTf0vkW971A--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-current" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030221120132.GB30966>