dirname(3): fix section ordering
IMPLEMENTATION NOTES come before RETURN VALUES MFC after: 2 weeks Reported by: make manlint Sponsored by: Dell EMC Isilon
This commit is contained in:
parent
a966418a66
commit
3d54bd2294
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=318700
@ -37,6 +37,16 @@ Any trailing
|
|||||||
.Sq \&/
|
.Sq \&/
|
||||||
characters are not counted as part of the directory
|
characters are not counted as part of the directory
|
||||||
name.
|
name.
|
||||||
|
.Sh IMPLEMENTATION NOTES
|
||||||
|
This implementation of
|
||||||
|
.Fn dirname
|
||||||
|
uses the buffer provided by the caller to store the resulting parent
|
||||||
|
directory.
|
||||||
|
Other vendor implementations may return a pointer to internal storage
|
||||||
|
space instead.
|
||||||
|
The advantage of the former approach is that it ensures thread-safety,
|
||||||
|
while also placing no upper limit on the supported length of the
|
||||||
|
pathname.
|
||||||
.Sh RETURN VALUES
|
.Sh RETURN VALUES
|
||||||
If
|
If
|
||||||
.Fa path
|
.Fa path
|
||||||
@ -50,16 +60,6 @@ signifying the current directory.
|
|||||||
Otherwise,
|
Otherwise,
|
||||||
it returns a pointer to the parent directory of
|
it returns a pointer to the parent directory of
|
||||||
.Fa path .
|
.Fa path .
|
||||||
.Sh IMPLEMENTATION NOTES
|
|
||||||
This implementation of
|
|
||||||
.Fn dirname
|
|
||||||
uses the buffer provided by the caller to store the resulting parent
|
|
||||||
directory.
|
|
||||||
Other vendor implementations may return a pointer to internal storage
|
|
||||||
space instead.
|
|
||||||
The advantage of the former approach is that it ensures thread-safety,
|
|
||||||
while also placing no upper limit on the supported length of the
|
|
||||||
pathname.
|
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr basename 1 ,
|
.Xr basename 1 ,
|
||||||
.Xr dirname 1 ,
|
.Xr dirname 1 ,
|
||||||
|
Loading…
Reference in New Issue
Block a user