diff --git a/reference/ssh2/functions/ssh2-shell.xml b/reference/ssh2/functions/ssh2-shell.xml
index faf85c832b..a7900cf72b 100644
--- a/reference/ssh2/functions/ssh2-shell.xml
+++ b/reference/ssh2/functions/ssh2-shell.xml
@@ -9,10 +9,10 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>resource</type><methodname>ssh2_shell</methodname>
+   <type class="union"><type>resource</type><type>false</type></type><methodname>ssh2_shell</methodname>
    <methodparam><type>resource</type><parameter>session</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>term_type</parameter><initializer>"vanilla"</initializer></methodparam>
-   <methodparam choice="opt"><type>array</type><parameter>env</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>env</parameter><initializer>&null;</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>width</parameter><initializer>80</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>height</parameter><initializer>25</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>width_height_type</parameter><initializer>SSH2_TERM_UNIT_CHARS</initializer></methodparam>
@@ -86,7 +86,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   Returns a stream &resource; on success, &return.falseforfailure;.
   </para>
  </refsect1>