docs/53621: devname(3)'s man page needs an example

[Faried Nawaz]

>Number:         53621
>Category:       docs
>Synopsis:       devname(3)'s man page needs an example
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jun 22 17:00:25 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Faried Nawaz
>Release:        FreeBSD 5.1-CURRENT i386
>Organization:
Hungry Programmers, Inc
>Environment:
System: FreeBSD semuta.nilpotent.org 5.1-CURRENT FreeBSD 5.1-CURRENT #0: Mon Jun 23 00:16:32 PKST 2003 root at semuta.nilpotent.org:/usr/obj/usr/src/sys/semuta i386
>Description:
	devname(3)'s man page is hard to figure out.  Sure, it includes an
	xref to stat(2), but I think a little bit more info can help.
>How-To-Repeat:
	man 3 devname
>Fix:
	I suggest adding an example.  Something like

EXAMPLE

     int fd;
     struct stat buf;
     char *name;

     fd = open("/dev/tun", O_RDWR);
     fstat(fd, &buf)
     printf("devname is /dev/%s\n", devname(buf.st_rdev, S_IFCHR))

     prints out

     devname is /dev/tun5

>Release-Note:
>Audit-Trail:
>Unformatted: