Rename two directories: headers -> posix-headers, functions -> posix-functions.

1 files changed, 27 insertions, 0 deletions

diff --git a/doc/posix-functions/fork.texi b/doc/posix-functions/fork.texi
new file mode 100644
index 0000000000..d914c2eb04
--- /dev/null
+++ b/doc/posix-functions/fork.texi
@@ -0,0 +1,27 @@
+@node fork
+@section @code{fork}
+@findex fork
+
+POSIX specification: @url{http://www.opengroup.org/susv3xsh/fork.html}
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on some platforms:
+mingw.
+@item
+On some platforms, @code{fork} followed by a call of the @code{exec} family
+(@code{execl}, @code{execlp}, @code{execle}, @code{execv}, @code{execvp},
+or @code{execve}) is less efficient than @code{vfork} followed by the same
+call.  @code{vfork} is a variant of @code{fork} that has been introduced to
+optimize the @code{fork}/@code{exec} pattern.
+@item
+On Windows platforms (excluding Cygwin), this function is not implemented; use
+@code{spawnvp} instead.
+@end itemize