docs: better usage example, no copy/paste

1 files changed, 3 insertions, 7 deletions

diff --git a/it.class b/it.class
index 4fdb8bc..193daad 100644
--- a/it.class
+++ b/it.class
@@ -534,7 +534,7 @@ static function filter_keys($array, $keys, $p = array())
  * Construct shell command using it::shell_command, log it, execute it and return output as string.
  * {keyword} quotes and inserts value from assoc array like ET()
  * {0} .. {n} quotes and inserts positional arguments
- * {-opts} takes an array and inserts options a la it_html attributes (value, true, false or null)
+ * {-opts} array of opts => {value,true,false,null}: it::exec('ls {-opts}', ['-opts' => ["-l" => true]]);
  * @param $cmd Format string with {keywords} a la ET()
  * @param $values (zero, one or more arrays can be passed)
  * @return output of command. shell errors not detectable, see error_log in /www/server/logs
@@ -554,12 +554,8 @@ static function exec(/* $cmd, $values1 = array(), ... */)
 
 /**
  * Construct shell command using it::shell_command, log it, execute it and return exit code.
- * stdout/stderr is forwarded to stdout/stderror of calling script
- * {keyword} quotes and inserts value from assoc array like ET()
- * {0} .. {n} quotes and inserts positional arguments
- * {-opts} array of opts => {value,true,false,null}: it::exec('ls {-opts}', ['-opts' => ["-l" => true]]);
- * @param $cmd Format string with {keywords} a la ET()
- * @param $values (zero, one or more arrays can be passed)
+ * stdout/stderr is forwarded to stdout/stderror of calling script.
+ * See ::exec above for usage
  * @return exit code of command.
  */
 static function system(/* $cmd, $values1 = array(), ... */)