# HG changeset patch
# User Rik <rik@octave.org>
# Date 1412570474 25200
# Node ID eeb2a01cdc26ec76c4eaa4d91dc240be6c804517
# Parent  672674d5e8d9809adcc02aea13662f2ca4b422e2
doc: Improve docstrings for dos() and unix().

* dos.m, unix.m: State that Octave will wait (stall) on system command to
finish before returning status and output.

diff -r 672674d5e8d9 -r eeb2a01cdc26 scripts/miscellaneous/dos.m
--- a/scripts/miscellaneous/dos.m	Sun Oct 05 20:55:35 2014 -0700
+++ b/scripts/miscellaneous/dos.m	Sun Oct 05 21:41:14 2014 -0700
@@ -21,12 +21,15 @@
 ## @deftypefnx {Function File} {@var{status} =} dos ("@var{command}")
 ## @deftypefnx {Function File} {[@var{status}, @var{text}] =} dos ("@var{command"})
 ## @deftypefnx {Function File} {[@dots{}] =} dos ("@var{command}", "-echo")
-## Execute a system command if running under a Windows-like operating
-## system, otherwise do nothing.  Return the exit status of the program
-## in @var{status} and any output from the command in @var{text}.
+## Execute a system command if running under a Windows-like operating system,
+## otherwise do nothing.
+##
+## Octave waits for the external command to finish before returning the exit
+## status of the program in @var{status} and any output in @var{text}.
+##
 ## When called with no output argument, or the @qcode{"-echo"} argument is
 ## given, then @var{text} is also sent to standard output.
-## @seealso{unix, system, isunix, ispc}
+## @seealso{unix, system, isunix, ismac, ispc}
 ## @end deftypefn
 
 ## Author: octave-forge ???
diff -r 672674d5e8d9 -r eeb2a01cdc26 scripts/miscellaneous/unix.m
--- a/scripts/miscellaneous/unix.m	Sun Oct 05 20:55:35 2014 -0700
+++ b/scripts/miscellaneous/unix.m	Sun Oct 05 21:41:14 2014 -0700
@@ -21,12 +21,15 @@
 ## @deftypefnx {Function File} {@var{status} =} unix ("@var{command}")
 ## @deftypefnx {Function File} {[@var{status}, @var{text}] =} unix ("@var{command}")
 ## @deftypefnx {Function File} {[@dots{}] =} unix ("@var{command}", "-echo")
-## Execute a system command if running under a Unix-like operating
-## system, otherwise do nothing.  Return the exit status of the program
-## in @var{status} and any output from the command in @var{text}.
+## Execute a system command if running under a Unix-like operating system,
+## otherwise do nothing.
+##
+## Octave waits for the external command to finish before returning the exit
+## status of the program in @var{status} and any output in @var{text}.
+##
 ## When called with no output argument, or the @qcode{"-echo"} argument is
 ## given, then @var{text} is also sent to standard output.
-## @seealso{dos, system, isunix, ispc}
+## @seealso{dos, system, isunix, ismac, ispc}
 ## @end deftypefn
 
 ## Author: octave-forge ???