Merge pull request #1016 from mickaelandrieu/master

REFS #948 - Add docs

@@ -984,6 +984,31 @@ are referenced by ``CSS3`` selectors::
         }, true);
         }, true);
     });
     });
 
 
+``fillLabels())``
+-------------------------------------------------------------------------------
+
+**Signature:** ``fillLabels(String selector, Object values[, Boolean submit])``
+
+.. versionadded:: 1.1
+
+Fills a form with provided field values using associated label text Fields
+are referenced by label content values::
+
+    casper.start('http://some.tld/contact.form', function() {
+        this.fillLabels('fform#contact-form', {
+            Email:         'chuck@norris.com',
+            Password:      'chuck',
+            Content:       'Am watching thou',
+            Check:         true,
+            No:            true,
+            Topic:         'bar',
+            Multitopic:    ['bar', 'car'],
+            File:          fpath,
+            "1":           true,
+            "3":           true,
+            Strange:       "very"
+        }, true);
+    });
 
 
 ``fillXPath()``
 ``fillXPath()``
 -------------------------------------------------------------------------------
 -------------------------------------------------------------------------------