Loading...
--- Libc/Libc-583/gen/dirname.3
+++ Libc/Libc-262/gen/dirname.3
@@ -25,20 +25,18 @@
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $OpenBSD: dirname.3,v 1.9 2000/04/18 03:01:25 aaron Exp $
-.\" $FreeBSD: src/lib/libc/gen/dirname.3,v 1.8 2004/07/02 23:52:10 ru Exp $
+.\" $FreeBSD: src/lib/libc/gen/dirname.3,v 1.4 2001/10/01 16:08:50 ru Exp $
.\"
.Dd August 17, 1997
.Dt DIRNAME 3
.Os
.Sh NAME
.Nm dirname
-.Nd extract the directory part of a pathname
+.Nd extract the directory portition of a pathname
.Sh SYNOPSIS
.In libgen.h
.Ft char *
-.Fo dirname
-.Fa "char *path"
-.Fc
+.Fn dirname "const char *path"
.Sh DESCRIPTION
The
.Fn dirname
@@ -46,13 +44,13 @@
is the converse of
.Xr basename 3 ;
it returns a pointer to the parent directory of the pathname pointed to by
-.Fa path .
+.Ar path .
Any trailing
.Sq \&/
characters are not counted as part of the directory
name.
If
-.Fa path
+.Ar path
is a null pointer, the empty string, or contains no
.Sq \&/
characters,
@@ -64,7 +62,7 @@
On successful completion,
.Fn dirname
returns a pointer to the parent directory of
-.Fa path .
+.Ar path .
.Pp
If
.Fn dirname
@@ -80,9 +78,7 @@
.Dv MAXPATHLEN .
.El
.Sh WARNINGS
-The
.Fn dirname
-function
returns a pointer to internal static storage space that will be overwritten
by subsequent calls (each function has its own separate storage).
.Pp
@@ -90,25 +86,12 @@
.Fn dirname
may modify the contents of the string passed to
.Fn dirname ;
-if portability is desired,
-this should be taken into account when writing code which calls this function.
-.Sh LEGACY SYNOPSIS
-.Fd #include <libgen.h>
-.Pp
-.Ft char *
-.br
-.Fo dirname
-.Fa "const char *path"
-.Fc ;
-.Pp
-In legacy mode,
-.Fa path
-will not be changed.
+this should be taken into account when writing code which calls this function
+if portability is desired.
.Sh SEE ALSO
.Xr basename 1 ,
.Xr dirname 1 ,
-.Xr basename 3 ,
-.Xr compat 5
+.Xr basename 3
.Sh STANDARDS
The
.Fn dirname
@@ -122,4 +105,4 @@
and
.Fx 4.2 .
.Sh AUTHORS
-.An "Todd C. Miller" Aq Todd.Miller@courtesan.com
+Todd C. Miller <Todd.Miller@courtesan.com>