From 5e6e91b7dc20a1872c553d49ebb2144d22396177 Mon Sep 17 00:00:00 2001
From: Adam Harvey <aharvey@php.net>
Date: Mon, 2 Apr 2012 06:52:56 +0000
Subject: [PATCH] Fix doc bug #61596 (Documentation doesn't mention negative
 return values).

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@324696 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/strings/functions/sscanf.xml | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/reference/strings/functions/sscanf.xml b/reference/strings/functions/sscanf.xml
index a29c70d6b5..5dd8b69bc7 100644
--- a/reference/strings/functions/sscanf.xml
+++ b/reference/strings/functions/sscanf.xml
@@ -83,11 +83,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   If only
-   two parameters were passed to this function, the values parsed
-   will be returned as an array. Otherwise, if optional parameters are passed,
-   the function will return the number of assigned values. The optional
-   parameters must be passed by reference.
+   If only two parameters were passed to this function, the values parsed will
+   be returned as an array. Otherwise, if optional parameters are passed, the
+   function will return the number of assigned values. The optional parameters
+   must be passed by reference.
+  </para>
+  <para>
+   If there are more substrings expected in the <parameter>format</parameter>
+   than there are available within <parameter>str</parameter>,
+   <literal>-1</literal> will be returned.
   </para>
  </refsect1>