I don't understand this "feature".

• Is thename attribute special here?
• If it's special: what does that imply?
• If it's not special: why mention this at all? If it's just like any other attribute, why mention thisname attribute in particular?

Thanks!

Thename attribute is not special itself. Actually, this tip indicates that you can use an attribute namedname, which wasn't possible before 5.1. Also, this shows that if you need to add aname attribute on a tag, youmust use a "special" syntax. Otherwise, thename attribute will be interpreted asthe tag name, not as an attribute of it.

By doing

MailerSendmailTransport:tags:        -{ name: 'app.mail_transport', alias: 'sendmail' }

You declare a tag with theapp.mail_transport nameand an attribute calledalias. This is a bit misleading becausealias andname keys are at the same level. If you actually need an attribute calledname, you must do the following:

MailerSmtpTransport:arguments:['%mailer_host%']tags:            -app.mail_transport:{ name: 'arbitrary-value', alias: 'smtp' }

It took me some time to fully understand what this PR was all about 😄

By default, thename XML attribute contains the tag name, and so cannot be used to set an attribute namedname. As of 5.1, there is a way to usename as an attribute by passing the tag name in the body of the XML element instead.

Thanks for your explanation. Now I can fully understand what's happening here. So, I've done some tweaks while merging to hopefully make it less confusing to readers:6e6565b

Perfect! 🙂