[docs] Start a doc on ClangImporter C->Swift name mapping

[jrose-apple]

Includes enums in all their flavors, plus swift_wrapper structs.

Planned future content:

• Methods, initializers, properties
  • "Omit-needless-words" rules
  • NSError
  • Boolean properties
  • Inferred default arguments
  • Factory methods as initializers
• Protocols (mainly just that they check for collision)
• CF types (low-priority since non-Apple people can't make them)
• Custom names, including import-as-member and import-as-accessor
• swift_private

[jrose-apple]

@swift-ci Please smoke test

[beccadax]

This is a very welcome addition to our docs folder!

[nkcsgexi]

Thanks for adding this! Could you mention where the name translation APIs are declared in the compiler source? I presume it's SwiftNameTranslation.h?

[jrose-apple]

swift/AST/SwiftNameTranslation.h is for Swift-to-ObjC, not ObjC-to-Swift. Most of what's talked about here is in swift/ClangImporter/ImportName.h, but not all of it.

[jrose-apple]

@swift-ci Please smoke test

[nkcsgexi]

ah, OK. Notice that both directions of translation are interesting for cross-language automatic renaming.

[jrose-apple]

Notice that both directions of translation are interesting for cross-language automatic renaming.

I think I'll rename the file to CToSwiftNameTranslation, leaving room for a future SwiftToCNameTranslation.

[nkcsgexi]

I think I'll rename the file to CToSwiftNameTranslation, leaving room for a future SwiftToCNameTranslation.

Sounds good, Thank you!

[jrose-apple]

@swift-ci Please smoke test

[jrose-apple]

We've got three approving reviewers so far, so if anyone else has comments we can take it in post-commit review.