svn commit: r768717 - /commons/proper/exec/trunk/src/site/apt/tutorial.apt

[sebb]

Author: sebb
Date: Sun Apr 26 15:02:39 2009
New Revision: 768717

URL: http://svn.apache.org/viewvc?rev=768717&view=rev
Log:
EXEC-38 - use addArgument() not addArguments()
Also remove Jakarta branding
Add another substitution example

Modified:
    commons/proper/exec/trunk/src/site/apt/tutorial.apt

Modified: commons/proper/exec/trunk/src/site/apt/tutorial.apt
URL: 
http://svn.apache.org/viewvc/commons/proper/exec/trunk/src/site/apt/tutorial.apt?rev=768717&r1=768716&r2=768717&view=diff
==============================================================================
--- commons/proper/exec/trunk/src/site/apt/tutorial.apt (original)
+++ commons/proper/exec/trunk/src/site/apt/tutorial.apt Sun Apr 26 15:02:39 2009
@@ -17,13 +17,13 @@
 ~~
 
  --------
-Jakarta Commons Exec Tutorial
+Apache Commons Exec Tutorial
  --------
  --------
 12 November 2008
  --------
 
-Jakarta Commons Exec
+Apache Commons Exec
 
 * The First Encounter
 
@@ -33,7 +33,7 @@
   with tons of code".
   
   Well, we learned it the hard way (in my case more than once) that using 
plain Runtime.exec() can be 
-  a painful experience. Therefore you are invited to delve into commons-exec 
and having a look at the
+  a painful experience. Therefore you are invited to delve into commons-exec 
and have a look at the
   hard lessons the easy way ...
   
 * Taming Your First Process
@@ -66,18 +66,18 @@
 
 * To Watchdog Or Not To Watchdog
 
-  You happily printed a while but now your application blocks - your printing 
subprocess
-  hangs for some obvious or not so obvious reasons. Starting is easy but what 
to do with a run-away
-  Acrobat Reader?! Luckily commons-exec provides a watchdog doing the work for 
you and here is
-  the improved code
+  You happily printed for a while but now your application blocks - your 
printing subprocess
+  hangs for some obvious or not so obvious reason. Starting is easy but what 
to do with a run-away
+  Acrobat Reader?! Luckily commons-exec provides a watchdog which does the 
work for you.
+  Here is the improved code
 
 +----------------------------------------------------------------------------
 String line = "AcroRd32.exe /p /h " + file.getAbsolutePath();
 CommandLine commandLine = CommandLine.parse(line);
-ExecuteWatchdog watchdog = new ExecuteWatchdog(60000);
 DefaultExecutor executor = new DefaultExecutor();
-executor.setWatchdog(watchdog);
 executor.setExitValue(1);
+ExecuteWatchdog watchdog = new ExecuteWatchdog(60000);
+executor.setWatchdog(watchdog);
 int exitValue = executor.execute(commandLine);
 +----------------------------------------------------------------------------
 
@@ -99,10 +99,10 @@
 +----------------------------------------------------------------------------
 String line = "AcroRd32.exe /p /h \"" + file.getAbsolutePath() + "\"";
 CommandLine commandLine = CommandLine.parse(line);
-ExecuteWatchdog watchdog = new ExecuteWatchdog(60000);
 DefaultExecutor executor = new DefaultExecutor();
-executor.setWatchdog(watchdog);
 executor.setExitValue(1);
+ExecuteWatchdog watchdog = new ExecuteWatchdog(60000);
+executor.setWatchdog(watchdog);
 int exitValue = executor.execute(commandLine);
 +----------------------------------------------------------------------------
   
@@ -118,13 +118,13 @@
   
 +----------------------------------------------------------------------------
 CommandLine commandLine = CommandLine.parse("AcroRd32.exe");
-commandLine.addArguments("/p");
-commandLine.addArguments("/h");
-commandLine.addArguments(file.getAbsolutePath());
-ExecuteWatchdog watchdog = new ExecuteWatchdog(60000);
+commandLine.addArgument("/p");
+commandLine.addArgument("/h");
+commandLine.addArgument(file.getAbsolutePath());
 DefaultExecutor executor = new DefaultExecutor();
-executor.setWatchdog(watchdog);
 executor.setExitValue(1);
+ExecuteWatchdog watchdog = new ExecuteWatchdog(60000);
+executor.setWatchdog(watchdog);
 int exitValue = executor.execute(commandLine);
 +----------------------------------------------------------------------------
 
@@ -141,5 +141,15 @@
 HashMap params = new HashMap();
 params.put("file", "C:\Document And Settings\documents\432432.pdf");
 commandLine  = CommandLine.parse("AcroRd32.exe /p /h \"${file}\"", params);
+
+// Or you can use expansion with individual parameters:
+
+CommandLine commandLine = CommandLine.parse("AcroRd32.exe");
+commandLine.addArgument("/p");
+commandLine.addArgument("/h");
+commandLine.addArgument("${file}");
+HashMap params = new HashMap();
+params.put("file", "C:\Document And Settings\documents\432432.pdf");
+commandLine.setSubstitutionMap(params);
 +----------------------------------------------------------------------------
   
\ No newline at end of file