Merge branch 'master' of github.com:omab/django-social-auth

diff --cc README.rst
index 9cbe49cb7cc2404bc1fd907ee8cb7403aa51deb3,28db1f60309119aea0381f14888370a08f3593fd..958b55adac258b8d3b161a7f9a630b68dc3b66e5
--- 1/README.rst
--- 2/README.rst
+++ b/README.rst
@@@ -683,15 -684,12 +683,17 @@@ at `Facebook development resources`_
        FACEBOOK_APP_ID
        FACEBOOK_API_SECRET
  
- - also it's possible to define extra permissions with::
+ - Define ``FACEBOOK_EXTENDED_PERMISSIONS`` to get extra permissions from facebook.
+   NOTE: to get users' email addresses, you must request the 'email' permission::
+ 
+      FACEBOOK_EXTENDED_PERMISSIONS = ['email']
  
-      FACEBOOK_EXTENDED_PERMISSIONS = [...]
  
 +  Take into account that Facebook doesn't return user email by default, this
 +  setting is needed if email is required::
 +
 +     FACEBOOK_EXTENDED_PERMISSIONS = ['email']
 +
  - Define ``FACEBOOK_PROFILE_EXTRA_PARAMS`` to pass extra parameters to
    https://graph.facebook.com/me when gathering the user profile data, like::
  

diff --cc doc/backends/facebook.rst
index 63dfefaa751b7ee00a4a0688318fe093a2661ed9,8f38c054bf38bec196838a40de93e1cdd930f1ea..098d04c2df3aed797d63be1ade8286d5df94956f
--- 1/doc/backends/facebook.rst
--- 2/doc/backends/facebook.rst
+++ b/doc/backends/facebook.rst
@@@ -12,15 -12,11 +12,16 @@@ at `Facebook development resources`_
        FACEBOOK_APP_ID
        FACEBOOK_API_SECRET
  
- - also it's possible to define extra permissions with::
+ - Define ``FACEBOOK_EXTENDED_PERMISSIONS`` to get extra permissions from facebook.
+   NOTE: to get users' email addresses, you must request the 'email' permission::
  
-      FACEBOOK_EXTENDED_PERMISSIONS = [...]
+      FACEBOOK_EXTENDED_PERMISSIONS = ['email']
  
 +  Take into account that Facebook doesn't return user email by default, this
 +  setting is needed if email is required::
 +
 +     FACEBOOK_EXTENDED_PERMISSIONS = ['email']
 +
  - Define ``FACEBOOK_PROFILE_EXTRA_PARAMS`` to pass extra parameters to
    https://graph.facebook.com/me when gathering the user profile data, like::