From f4732a9a929aa909f9ba3050cf474ac6f87871fe Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Thu, 9 Oct 2014 11:17:59 -0700
Subject: [PATCH 01/15] added introduction

---
 components/browser_kit/index.rst        |  7 +++++++
 components/browser_kit/introduction.rst | 18 ++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 components/browser_kit/index.rst
 create mode 100644 components/browser_kit/introduction.rst

diff --git a/components/browser_kit/index.rst b/components/browser_kit/index.rst
new file mode 100644
index 00000000000..624a0aeb12f
--- /dev/null
+++ b/components/browser_kit/index.rst
@@ -0,0 +1,7 @@
+Browser Kit
+====
+
+.. toctree::
+    :maxdepth: 2
+
+    introduction
diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
new file mode 100644
index 00000000000..495c979108a
--- /dev/null
+++ b/components/browser_kit/introduction.rst
@@ -0,0 +1,18 @@
+.. index::
+   single: Yaml
+   single: Components; Yaml
+
+The Browser Kit Component
+=========================
+
+    The Browser Kit component simulates the behavior of a web browser.
+
+The Browser Kit component allows you to make web request, click on links and submit forms. 
+
+Installation
+------------
+
+You can install the component in 2 different ways:
+
+* :doc:`Install it via Composer </components/using_components>` (``symfony/browser-kit`` on `Packagist`_);
+* Use the official Git repository (https://github.com/symfony/BrowserKit).

From 9cda9822c04c848a2dfd9232066f0efffd1bda63 Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 09:54:20 -0700
Subject: [PATCH 02/15] fixed a few mistakes

---
 components/browser_kit/index.rst        |  4 ++--
 components/browser_kit/introduction.rst | 12 ++++++------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/components/browser_kit/index.rst b/components/browser_kit/index.rst
index 624a0aeb12f..692b45d63f3 100644
--- a/components/browser_kit/index.rst
+++ b/components/browser_kit/index.rst
@@ -1,5 +1,5 @@
-Browser Kit
-====
+BrowserKit
+==========
 
 .. toctree::
     :maxdepth: 2
diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 495c979108a..32dc1db9750 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -1,13 +1,13 @@
 .. index::
-   single: Yaml
-   single: Components; Yaml
+   single: BrowserKit
+   single: Components; BrowserKit
 
-The Browser Kit Component
+The BrowserKit Component
 =========================
 
-    The Browser Kit component simulates the behavior of a web browser.
+    The BrowserKit component simulates the behavior of a web browser.
 
-The Browser Kit component allows you to make web request, click on links and submit forms. 
+The BrowserKit component allows you to make web request, click on links and submit forms. 
 
 Installation
 ------------
@@ -15,4 +15,4 @@ Installation
 You can install the component in 2 different ways:
 
 * :doc:`Install it via Composer </components/using_components>` (``symfony/browser-kit`` on `Packagist`_);
-* Use the official Git repository (https://github.com/symfony/BrowserKit).
+* Use the official Git repository (https://github.com/symfony/BrowserKit).
\ No newline at end of file

From 33a3a6410e5d90ba2edec173890c57329597f44c Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 11:31:38 -0700
Subject: [PATCH 03/15] syntax fix

---
 components/browser_kit/introduction.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 32dc1db9750..b3f221c3ae8 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -3,7 +3,7 @@
    single: Components; BrowserKit
 
 The BrowserKit Component
-=========================
+========================
 
     The BrowserKit component simulates the behavior of a web browser.
 

From 9ae95dc3d1bd6a64b4fb7fa73c29ebc39cc1eea4 Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 11:48:04 -0700
Subject: [PATCH 04/15] added in sections that I apln to fill out

---
 components/browser_kit/introduction.rst | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index b3f221c3ae8..a5326bfb71c 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -15,4 +15,22 @@ Installation
 You can install the component in 2 different ways:
 
 * :doc:`Install it via Composer </components/using_components>` (``symfony/browser-kit`` on `Packagist`_);
-* Use the official Git repository (https://github.com/symfony/BrowserKit).
\ No newline at end of file
+* Use the official Git repository (https://github.com/symfony/BrowserKit).
+
+Usage
+-----
+
+.. note::
+    The component only provide an abstract client and does not provide any "default" backend for the HTTP layer.
+
+Making Request
+~~~~~~~~~~~~~~
+
+Clicking Links
+~~~~~~~~~~~~~~
+
+Submiting Forms
+~~~~~~~~~~~~~~~~
+
+Creating a Client
+-----------------
\ No newline at end of file

From 4d9e48d35f935b6f4e49d3359ec6dbe6cefcd42e Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 14:00:26 -0700
Subject: [PATCH 05/15] added links with info about clients and packagist link

---
 components/browser_kit/introduction.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index a5326bfb71c..024e4dc8b24 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -33,4 +33,11 @@ Submiting Forms
 ~~~~~~~~~~~~~~~~
 
 Creating a Client
------------------
\ No newline at end of file
+-----------------
+
+For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
+
+For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
+
+.. _Packagist: https://packagist.org/packages/symfony/event-dispatcher
+.. _Goutte: https://github.com/fabpot/Goutte
\ No newline at end of file

From 59a9dbfc790be9d6ce5333c544d71809ce9acbfa Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 14:09:56 -0700
Subject: [PATCH 06/15] added links to index and map files

---
 components/index.rst   | 1 +
 components/map.rst.inc | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/components/index.rst b/components/index.rst
index 739b9e84f9c..780b33b2c9e 100644
--- a/components/index.rst
+++ b/components/index.rst
@@ -5,6 +5,7 @@ The Components
     :hidden:
 
     using_components
+    browser_kit/index
     class_loader/index
     config/index
     console/index
diff --git a/components/map.rst.inc b/components/map.rst.inc
index 572f19352d8..f25975d6853 100644
--- a/components/map.rst.inc
+++ b/components/map.rst.inc
@@ -1,5 +1,9 @@
 * :doc:`/components/using_components`
 
+* :doc:`/components/browser_kit/index`
+  
+  * :doc:`/components/browser_kit/introduction`
+
 * :doc:`/components/class_loader/index`
 
   * :doc:`/components/class_loader/introduction`

From f956182fd30bc73d0bc7c5d290f35b79e014b052 Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 14:40:11 -0700
Subject: [PATCH 07/15] make a basic request

---
 components/browser_kit/introduction.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 024e4dc8b24..bcf4a8f6fee 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -26,6 +26,16 @@ Usage
 Making Request
 ~~~~~~~~~~~~~~
 
+To make a request you use the client's request method. 
+The first two arguments are for the HTTP method and the request url.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    $client = new Client();
+    $response = $client->request('GET', 'http://symfony.com');
+
 Clicking Links
 ~~~~~~~~~~~~~~
 

From 51f320a06ed18fb899e02dd4a076cc91eee502be Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 14:42:30 -0700
Subject: [PATCH 08/15] fixed spelling

---
 components/browser_kit/introduction.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index bcf4a8f6fee..7edc304c30e 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -21,7 +21,7 @@ Usage
 -----
 
 .. note::
-    The component only provide an abstract client and does not provide any "default" backend for the HTTP layer.
+    The component only provides an abstract client and does not provide any "default" backend for the HTTP layer.
 
 Making Request
 ~~~~~~~~~~~~~~

From d4c24e4dcba984d4d45143057ef9d4b36a3035bf Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Fri, 10 Oct 2014 15:03:05 -0700
Subject: [PATCH 09/15] added a link snippit

---
 components/browser_kit/introduction.rst | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 7edc304c30e..f3d150d97c8 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -28,17 +28,29 @@ Making Request
 
 To make a request you use the client's request method. 
 The first two arguments are for the HTTP method and the request url.
+The request method will return a crawler object.
 
 .. code-block:: php
 
     use ACME\Client;
 
     $client = new Client();
-    $response = $client->request('GET', 'http://symfony.com');
+    $crawler = $client->request('GET', 'http://symfony.com');
 
 Clicking Links
 ~~~~~~~~~~~~~~
 
+select a link with the crawler and pass it to the click method to click on the link.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    $client = new Client();
+    $crawler = $client->request('GET', 'http://symfony.com');
+    $link = $crawler->selectLink('Go elsewhere...')->link();
+    $client->click($link);
+
 Submiting Forms
 ~~~~~~~~~~~~~~~~
 

From cd4f6ecc50fa4d0718ec8694f65f5f52edd47e6e Mon Sep 17 00:00:00 2001
From: yamiko <rparker@yamiko.org>
Date: Mon, 13 Oct 2014 09:40:20 -0700
Subject: [PATCH 10/15] more outlines, fixed link, added more about creating a
 client

---
 components/browser_kit/introduction.rst | 35 ++++++++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index f3d150d97c8..c4f27a7e30b 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -17,8 +17,8 @@ You can install the component in 2 different ways:
 * :doc:`Install it via Composer </components/using_components>` (``symfony/browser-kit`` on `Packagist`_);
 * Use the official Git repository (https://github.com/symfony/BrowserKit).
 
-Usage
------
+Basic Usage
+-----------
 
 .. note::
     The component only provides an abstract client and does not provide any "default" backend for the HTTP layer.
@@ -40,7 +40,7 @@ The request method will return a crawler object.
 Clicking Links
 ~~~~~~~~~~~~~~
 
-select a link with the crawler and pass it to the click method to click on the link.
+Select a link with the crawler and pass it to the click method to click on the link.
 
 .. code-block:: php
 
@@ -54,12 +54,39 @@ select a link with the crawler and pass it to the click method to click on the l
 Submiting Forms
 ~~~~~~~~~~~~~~~~
 
+
+Cookies
+-------
+
+History
+-------
+
+Insulated Request
+-----------------
+
 Creating a Client
 -----------------
 
+To create your own client you must extend the abstract client class and implement the doRequest method.
+This method accepts a request and should return a response.
+
+.. code-block:: php
+    namespace ACME;
+    
+    use Symfony\Component\BrowserKit\Client as BaseClient;
+    use Symfony\Component\BrowserKit\Response;
+
+    class Client extends BaseClient {
+        protected function doRequest($request) {
+            // convert request into a response
+            // ...
+            return new Response($content, $status, $headers);
+        }
+    }
+
 For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
 
 For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
 
-.. _Packagist: https://packagist.org/packages/symfony/event-dispatcher
+.. _Packagist: https://packagist.org/packages/symfony/browser-kit
 .. _Goutte: https://github.com/fabpot/Goutte
\ No newline at end of file

From 05c89d5d35aa921d8540b8b77b41478339e1d345 Mon Sep 17 00:00:00 2001
From: "Robert M. Parker" <rparker@yamiko.ninja>
Date: Sat, 23 May 2015 10:55:22 -0700
Subject: [PATCH 11/15] added form submissions and moved creating a client to
 top

---
 components/browser_kit/introduction.rst | 67 ++++++++++++++++---------
 1 file changed, 42 insertions(+), 25 deletions(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index c4f27a7e30b..45b2c6247c2 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -23,6 +23,32 @@ Basic Usage
 .. note::
     The component only provides an abstract client and does not provide any "default" backend for the HTTP layer.
 
+Creating a Client
+-----------------
+
+To create your own client you must extend the abstract client class and implement the doRequest method.
+This method accepts a request and should return a response.
+
+.. code-block:: php
+
+    namespace ACME;
+
+    use Symfony\Component\BrowserKit\Client as BaseClient;
+    use Symfony\Component\BrowserKit\Response;
+
+    class Client extends BaseClient {
+        protected function doRequest($request) {
+            // convert request into a response
+            // ...
+            return new Response($content, $status, $headers);
+        }
+    }
+
+For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
+
+For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
+
+
 Making Request
 ~~~~~~~~~~~~~~
 
@@ -52,8 +78,23 @@ Select a link with the crawler and pass it to the click method to click on the l
     $client->click($link);
 
 Submiting Forms
-~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~
+
+.. code-block:: php
 
+    use ACME\Client;
+
+    // make a real request to an external site
+    $client = new Client();
+    $crawler = $client->request('GET', 'https://github.com/login');
+
+    // select the form and fill in some values
+    $form = $crawler->selectButton('Log in')->form();
+    $form['login'] = 'symfonyfan';
+    $form['password'] = 'anypass';
+
+    // submit that form
+    $crawler = $client->submit($form);
 
 Cookies
 -------
@@ -64,29 +105,5 @@ History
 Insulated Request
 -----------------
 
-Creating a Client
------------------
-
-To create your own client you must extend the abstract client class and implement the doRequest method.
-This method accepts a request and should return a response.
-
-.. code-block:: php
-    namespace ACME;
-    
-    use Symfony\Component\BrowserKit\Client as BaseClient;
-    use Symfony\Component\BrowserKit\Response;
-
-    class Client extends BaseClient {
-        protected function doRequest($request) {
-            // convert request into a response
-            // ...
-            return new Response($content, $status, $headers);
-        }
-    }
-
-For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
-
-For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
-
 .. _Packagist: https://packagist.org/packages/symfony/browser-kit
 .. _Goutte: https://github.com/fabpot/Goutte
\ No newline at end of file

From 982476e72518f7e0b3437d5c8ad33ed898f45c44 Mon Sep 17 00:00:00 2001
From: "Robert M. Parker" <rparker@yamiko.ninja>
Date: Sat, 23 May 2015 11:20:57 -0700
Subject: [PATCH 12/15] added docs on histroy

---
 components/browser_kit/introduction.rst | 36 +++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 45b2c6247c2..322219054e9 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -80,6 +80,9 @@ Select a link with the crawler and pass it to the click method to click on the l
 Submiting Forms
 ~~~~~~~~~~~~~~~
 
+You can submit forms with the submit method which takes a form object.
+You can get the form object by using the crawler to select the button and running the form method.
+
 .. code-block:: php
 
     use ACME\Client;
@@ -102,6 +105,39 @@ Cookies
 History
 -------
 
+The client stores all your request allowing you to go back and forward in your history.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    // make a real request to an external site
+    $client = new Client();
+    $home_crawler = $client->request('GET', 'http://symfony.com');
+
+    // select and click on a link
+    $doc_link = $crawler->selectLink('Documentation')->link();
+    $doc_crawler = $client->click($link);
+
+    // go back to home page
+    $home_crawler = $client->back();
+
+    // go forward to documentation page
+    $doc_crawler = $client->forward();
+
+You can restart the clients history with the restart method. This will also clear out the CookieJar.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    // make a real request to an external site
+    $client = new Client();
+    $home_crawler = $client->request('GET', 'http://symfony.com');
+
+    // restart history
+    $client->restart();
+
 Insulated Request
 -----------------
 

From 0923ac450cc4dc828a29a1a6cd3b57b2b67382e5 Mon Sep 17 00:00:00 2001
From: robert Parker <robert@yamiko.org>
Date: Tue, 27 Oct 2015 20:21:57 -0700
Subject: [PATCH 13/15] Adding documentation for cookies

---
 components/browser_kit/introduction.rst | 92 ++++++++++++++++++++++++-
 1 file changed, 90 insertions(+), 2 deletions(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 322219054e9..710b0bf65fd 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -102,6 +102,96 @@ You can get the form object by using the crawler to select the button and runnin
 Cookies
 -------
 
+Retreiving Cookies
+~~~~~~~~~~~~~~~~~~ 
+
+The Crawler has a cookieJar which is a container for storing and recieving cookies.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    // Make a request
+    $client = new Client();
+    $crawler = $client->request('GET', 'http://symfony.com');
+
+    // Get the cookie Jar
+    $cookieJar = $crawler->getCookieJar();
+
+    // Get a cookie by name
+    $flavor = $cookieJar->get('flavor');
+
+    // Get cookie data
+    $name = $flavor->getName();
+    $value = $flavor->getValue();
+    $raw = $flavor->getRawValue();
+    $secure = $flavor->isSecure();
+    $isHttpOnly = $flavor->isHttpOnly();
+    $isExpired = $flavor->isExpired();
+    $expires = $flavor->getExpiresTime();
+    $path = $flavor->getPath();
+    $domain = $flavor->getDomain();
+
+Looping Through Cookies
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    // Make a request
+    $client = new Client();
+    $crawler = $client->request('GET', 'http://symfony.com');
+
+    // Get the cookie Jar
+    $cookieJar = $crawler->getCookieJar();
+
+    // Get array with all cookies
+    $cookies = $cookieJar->all();
+    foreach($cookies as $cookie) 
+    {
+        // ...
+    }
+
+    // Get all values
+    $values = $cookieJar->allValues('http://symfony.com');
+    foreach($values as $value)
+    {
+        // ...
+    }
+
+    // Get all raw values
+    $rawValues = $cookieJar->allRawValues('http://symfony.com');
+    foreach($rawValues as $rawValue)
+    {
+        // ...
+    }
+
+.. note::
+    These cookie jar methods only return cookies that have not expired.
+
+Setting Cookies
+~~~~~~~~~~~~~~~
+
+You can define create cookies and add them to a cookie jar that can be injected it into the client constructor. 
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    // create cookies and add to cookie jar
+    $expires = new \DateTime();
+    $expires->add(new \DateInterval('P1D'));
+    $cookie = new Cookie(
+        'flavor',
+        'chocolate chip',
+        $now->getTimestamp()
+    );
+
+    // create a client and set the cookies
+    $client = new Client(array(), array(), $cookieJar);
+    // ...
+
 History
 -------
 
@@ -138,8 +228,6 @@ You can restart the clients history with the restart method. This will also clea
     // restart history
     $client->restart();
 
-Insulated Request
------------------
 
 .. _Packagist: https://packagist.org/packages/symfony/browser-kit
 .. _Goutte: https://github.com/fabpot/Goutte
\ No newline at end of file

From 2731858e5061362d54048910335ca631662116d8 Mon Sep 17 00:00:00 2001
From: "Robert M. Parker" <rparker@yamiko.ninja>
Date: Thu, 19 Nov 2015 01:34:29 -0800
Subject: [PATCH 14/15] spelling and formating

---
 components/browser_kit/introduction.rst | 31 ++++++++++++++-----------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 710b0bf65fd..4af1366d3d7 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -7,12 +7,12 @@ The BrowserKit Component
 
     The BrowserKit component simulates the behavior of a web browser.
 
-The BrowserKit component allows you to make web request, click on links and submit forms. 
+The BrowserKit component allows you to make web requests, click on links and submit forms. 
 
 Installation
 ------------
 
-You can install the component in 2 different ways:
+You can install the component in two different ways:
 
 * :doc:`Install it via Composer </components/using_components>` (``symfony/browser-kit`` on `Packagist`_);
 * Use the official Git repository (https://github.com/symfony/BrowserKit).
@@ -21,13 +21,14 @@ Basic Usage
 -----------
 
 .. note::
+
     The component only provides an abstract client and does not provide any "default" backend for the HTTP layer.
 
 Creating a Client
 -----------------
 
 To create your own client you must extend the abstract client class and implement the doRequest method.
-This method accepts a request and should return a response.
+This method accepts a requests and should return a response.
 
 .. code-block:: php
 
@@ -36,8 +37,10 @@ This method accepts a request and should return a response.
     use Symfony\Component\BrowserKit\Client as BaseClient;
     use Symfony\Component\BrowserKit\Response;
 
-    class Client extends BaseClient {
-        protected function doRequest($request) {
+    class Client extends BaseClient 
+    {
+        protected function doRequest($request) 
+        {
             // convert request into a response
             // ...
             return new Response($content, $status, $headers);
@@ -46,14 +49,14 @@ This method accepts a request and should return a response.
 
 For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
 
-For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
+For an implementation based on ``HttpKernelInterface``, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
 
 
-Making Request
+Making Requests
 ~~~~~~~~~~~~~~
 
-To make a request you use the client's request method. 
-The first two arguments are for the HTTP method and the request url.
+To make a request you use the client's request_ method. 
+The first two arguments are for the HTTP method and the request URL.
 The request method will return a crawler object.
 
 .. code-block:: php
@@ -66,7 +69,7 @@ The request method will return a crawler object.
 Clicking Links
 ~~~~~~~~~~~~~~
 
-Select a link with the crawler and pass it to the click method to click on the link.
+Select a link with the crawler and pass it to the click_ method to click on the link.
 
 .. code-block:: php
 
@@ -195,7 +198,7 @@ You can define create cookies and add them to a cookie jar that can be injected
 History
 -------
 
-The client stores all your request allowing you to go back and forward in your history.
+The client stores all your requests allowing you to go back and forward in your history.
 
 .. code-block:: php
 
@@ -215,7 +218,7 @@ The client stores all your request allowing you to go back and forward in your h
     // go forward to documentation page
     $doc_crawler = $client->forward();
 
-You can restart the clients history with the restart method. This will also clear out the CookieJar.
+You can restart the client's history with the restart method. This will also clear out the CookieJar.
 
 .. code-block:: php
 
@@ -230,4 +233,6 @@ You can restart the clients history with the restart method. This will also clea
 
 
 .. _Packagist: https://packagist.org/packages/symfony/browser-kit
-.. _Goutte: https://github.com/fabpot/Goutte
\ No newline at end of file
+.. _Goutte: https://github.com/fabpot/Goutte
+.. _request: http://api.symfony.com/2.3/Symfony/Component/BrowserKit/Client.html#method_request
+.. _click: http://api.symfony.com/2.3/Symfony/Component/BrowserKit/Client.html#method_click
\ No newline at end of file

From f119848f51d71f42c25acd8a473d60bab6e6c162 Mon Sep 17 00:00:00 2001
From: "Robert M. Parker" <rparker@yamiko.ninja>
Date: Thu, 19 Nov 2015 01:37:27 -0800
Subject: [PATCH 15/15] fix title underline

---
 components/browser_kit/introduction.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/browser_kit/introduction.rst b/components/browser_kit/introduction.rst
index 4af1366d3d7..e2a8f5ecffe 100644
--- a/components/browser_kit/introduction.rst
+++ b/components/browser_kit/introduction.rst
@@ -53,7 +53,7 @@ For an implementation based on ``HttpKernelInterface``, have a look at the Clien
 
 
 Making Requests
-~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~
 
 To make a request you use the client's request_ method. 
 The first two arguments are for the HTTP method and the request URL.