Identity though foreign entities (@id on associations) - conflicting statements in documentation

[calumbrodie]

http://www.doctrine-project.org/docs/orm/2.0/en/tutorials/composite-primary-keys.html#identity-through-foreign-entities.

Under this section it states that

'Set a key associationKey: with the field name of the association in YAML.'

And in the code example (for Yaml) it shows

      associationKey: true

The first statement makes it look as if you can choose a field from your associated entity to use as the primary key for the entity you are mapping - while the second example looks as if you are forced to use the primary Id of the associated entity.

I'm not sure which is correct but they cannot both be.

-Thanks

[calumbrodie]

After having a look through the code that relates to this feature - I'm seems like just changing the following would clear this up.

'Set a key associationKey: with the field name of the association in YAML.'

to

'Set a key associationKey: with the value true .'

[android-leha]

Please, insert example of YAML in the doc