Docs state that accessor macros require the `names:` argument, but in reality they do not

[daltonclaybrook]

Location

https://docs.swift.org/swift-book/documentation/the-swift-programming-language/attributes/#attached

Description

The documentation for the @attached macro attribute states the following:

The peer, member, and accessor macro roles require a names: argument, listing the names of the symbols that the macro generates.

But in reality, accessor macros do not require the names: argument as they simply generate accessors for the stored property they're attached to. (See discussion on the Swift forums)

Correction

The sentence should be changed to:

The peer and member macro roles require a names: argument, listing the names of the symbols that the macro generates.

[vanvoorden]

Just to be safe… it might also be a good idea to open an issue in https://github.com/swiftlang/swift-syntax and confirm there that this is a legit behavior.

[hborla]

It's a deliberate behavior that's documented in the attached macro proposal (this is also a behavior of the compiler and not of swift-syntax).