"Scripting Examples" update.
authorAndy Wingo <wingo@pobox.com>
Tue, 28 Feb 2017 15:22:42 +0000 (16:22 +0100)
committerAndy Wingo <wingo@pobox.com>
Tue, 28 Feb 2017 15:22:42 +0000 (16:22 +0100)
* doc/ref/scheme-scripts.texi (Scripting Examples): Mention system* and
  open-pipe.

doc/ref/scheme-scripts.texi

index 7552dba33e5df748e61352f0f9644a5450f8cd00..296bea7722af35de04832851a7a82c078a60ba0a 100644 (file)
@@ -402,6 +402,17 @@ $ ./choose 50 100
 100891344545564193334812497256
 @end example
 
+Finally, seasoned scripters are probably missing a mention of
+subprocesses.  In Bash, for example, most shell scripts run other
+programs like @code{sed} or the like to do the actual work.
+
+In Guile it's often possible get everything done within Guile itself, so
+do give that a try first.  But if you just need to run a program and
+wait for it to finish, use @code{system*}.  If you need to run a
+sub-program and capture its output, or give it input, use
+@code{open-pipe}.  @xref{Processes}, and @xref{Pipes}, for more
+information.
+
 
 @c Local Variables:
 @c TeX-master: "guile.texi"