Module "system"
===============

This module provides a simple API for calling shell commands
 
builtin system(command, encoding);
----------------------------------

This function calls the specified shell command and returns the text written
to stdout.

If the output is not UTF-8 encoded, the encoding must be specified with a
2nd parameter. Valid encodings are the same as for the '#encoding' compiler
pragma (see 'SPL Language Reference' for a list).

If UTF-8 encoding is expected but the output fails to pass the UTF-8 test,
the output is assumed to be latin1 encoded.

A newline at the end of the output is automatically removed.
 
