D issues are now tracked on GitHub. This Bugzilla instance remains as a read-only archive.
Issue 8708 - Documentation for std.process.exec family is inaccurate
Summary: Documentation for std.process.exec family is inaccurate
Status: RESOLVED FIXED
Alias: None
Product: D
Classification: Unclassified
Component: phobos (show other issues)
Version: D2
Hardware: All All
: P2 minor
Assignee: No Owner
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-09-22 16:15 UTC by Jonathan M Davis
Modified: 2015-06-09 01:31 UTC (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this issue.
Description Jonathan M Davis 2012-09-22 16:15:35 UTC 
It implies that the exec* functions return upon success, which they do not. Rather, the new process replaces the current process, and they only return if the exec* call fails. To quote the man page:

> The exec() functions only return if an error has have occurred. The return value is -1, and errno  is set to indicate the error.

http://linux.die.net/man/3/exec
http://msdn.microsoft.com/en-us/library/3xw6zy53.aspx
Comment 1 Greg Ward 2012-09-24 08:31:37 UTC 
Coincidentally, I discovered this doc bug at about the same time. So I submitted a pull request: https://github.com/D-Programming-Language/phobos/pull/812 .
Comment 2 Vladimir Panteleev 2014-09-09 13:53:41 UTC 
Pull was merged, fixed I guess.