svn commit: r347644 - stable/11/lib/libc/gen

[Alan Somers]

Author: asomers
Date: Thu May 16 03:30:36 2019
New Revision: 347644
URL: https://svnweb.freebsd.org/changeset/base/347644

Log:
  MFC r347032 (except for the part about d_off):
  
  directory.3: add a STANDARDS section
  
  Reviewed by:	jilles, ngie
  Sponsored by:	The FreeBSD Foundation
  Differential Revision:	https://reviews.freebsd.org/D20111

Modified:
  stable/11/lib/libc/gen/directory.3
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/lib/libc/gen/directory.3
==============================================================================
--- stable/11/lib/libc/gen/directory.3	Thu May 16 03:24:08 2019	(r347643)
+++ stable/11/lib/libc/gen/directory.3	Thu May 16 03:30:36 2019	(r347644)
@@ -28,7 +28,7 @@
 .\"     @(#)directory.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd August 31, 2016
+.Dd April 30, 2019
 .Dt DIRECTORY 3
 .Os
 .Sh NAME
@@ -264,6 +264,29 @@ return (NOT_FOUND);
 .Xr open 2 ,
 .Xr read 2 ,
 .Xr dir 5
+.Sh STANDARDS
+The
+.Fn closedir ,
+.Fn dirfd ,
+.Fn fdopendir ,
+.Fn opendir ,
+.Fn readdir ,
+.Fn readdir_r ,
+.Fn rewinddir ,
+.Fn seekdir
+and
+.Fn telldir
+functions are expected to conform to
+.St -p1003.1-2008 .
+The
+.Fn fdclosedir
+function and the
+.Fa d_reclen
+and
+.Fa d_type
+fields of
+.Vt struct dirent
+are non-standard, and should not be used in portable programs.
 .Sh HISTORY
 The
 .Fn opendir ,