[Form] Add doc for FormEvents
Adjust upgrade file rendering
Fixed grammar error in docblock
minor #12510 Fixed grammar error in docblock (gerryvdm)

This PR was submitted for the 2.7 branch but it was merged into the 2.3 branch instead (closes #12510).

Discussion
----------

Fixed grammar error in docblock

Commits
-------

ba8d937 Fixed grammar error in docblock
minor #12501 Adjust upgrade file rendering & backport missing notes (stloyd)

This PR was merged into the 2.3 branch.

Discussion
----------

Adjust upgrade file rendering & backport missing notes

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| License       | MIT

Commits
-------

d9c2e6d Adjust upgrade file rendering
Azerbaijani locale
minor #12502 Azerbaijani locale (seferov)

This PR was submitted for the 2.7 branch but it was merged into the 2.3 branch instead (closes #12502).

Discussion
----------

Azerbaijani locale

[Form] [Validator] [Security] Azerbaijani translation added

| Q             | A
| ------------- | ---
| Fixed tickets | none
| License       | MIT

Commits
-------

7f7b700 Azerbaijani locale
minor #12496 [Form] Add doc for FormEvents (GromNaN)

This PR was merged into the 2.3 branch.

Discussion
----------

[Form] Add doc for FormEvents

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | no
| Fixed tickets | n/a
| License       | MIT
| Doc PR        | n/a

Provide the same level of phpdoc for form events than we have for other event classes.

http://api.symfony.com/2.3/Symfony/Component/HttpKernel/KernelEvents.html
http://api.symfony.com/2.3/Symfony/Component/Form/FormEvents.html

Commits
-------

656d45f [Form] Add doc for FormEvents
be smarter when guessing the document root
[SecurityBundle] Authentication entry point is only registered with firewall exception listener, not with authentication listeners
bug #12296 [SecurityBundle] Authentication entry point is only registered with firewall exception listener, not with authentication listeners (rjkip)

This PR was submitted for the master branch but it was merged into the 2.3 branch instead (closes #12296).

Discussion
----------

[SecurityBundle] Authentication entry point is only registered with firewall exception listener, not with authentication listeners

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | no
| BC breaks?    | when relying on this configuration behaviour
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | #12261
| License       | MIT
| Doc PR        | —

See symfony/symfony#12261.

I configured a different firewall entry point for one firewall. However, when authentication had to be performed, it still called BasicAuthenticationEntryPoint::start() instead of my service's start(). My service was instantiated, yet never used.

The issue appears to be that the entry point is registered with the firewall's exception listener, but not with the BasicAuthenticationListener. This means that when the BasicAuthenticationListener determines the user has  provided wrong credentials, BasicAuthenticationEntryPoint is still used. Only in case of an exception would my  entry point service be used.

In my opinion, this is not correct behaviour. Can someone confirm this? Are there currently tests that pertain to the `entry_point` configuration on which I can base a test?

---

Test setup:

```yaml
# security.yml
security:
    firewalls:
        api:
            pattern: ^/api/
            http_basic: ~
            entry_point: my.service
        default:
            anonymous: ~
```

Commits
-------

92c8dfb [SecurityBundle] Authentication entry point is only registered with firewall exception listener, not with authentication listeners
bug #12525 [Bundle][FrameworkBundle] be smarter when guessing the document root (xabbuh)

This PR was merged into the 2.3 branch.

Discussion
----------

[Bundle][FrameworkBundle] be smarter when guessing the document root

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | #12524
| License       | MIT
| Doc PR        |

Commits
-------

e28f5b8 be smarter when guessing the document root
updated CHANGELOG for 2.3.22
update CONTRIBUTORS for 2.3.22
updated VERSION for 2.3.22
fixed typo
bumped Symfony version to 2.3.23
[FrameworkBundle] cache:clear command fills *.php.meta files with wrong data
bug #12137 [FrameworkBundle] cache:clear command fills *.php.meta files with wrong data (Strate)

This PR was submitted for the 2.5 branch but it was merged into the 2.3 branch instead (closes #12137).

Discussion
----------

[FrameworkBundle] cache:clear command fills *.php.meta files with wrong data

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | #12110
| License       | MIT

Test and fix of ticket #12110

Commits
-------

76273bf [FrameworkBundle] cache:clear command fills *.php.meta files with wrong data
Make `\Request::get` more performant.