Commit Graph

13 Commits

Author SHA1 Message Date
Volodymyr Sapsai
84c7b632e8 [docs] Fix Objective-C bridging attribute name. (#28495)
Correct attribute name is `objc_bridge_mutable` according to
40963b2bf0/clang/include/clang/Basic/Attr.td (L1743)
2019-12-02 10:53:08 -08:00
Jordan Rose
ab72b999ee [docs] CToSwift: Tweak wording around "overrides"
The previous wording referred to a method or property satisfying a
protocol requirement as an "override", which both Clang and the Swift
Clang Importer use internally sometimes. But most people who program
Objective-C (or Swift) don't think of this as an override, so this
document shouldn't use that language. (Thanks, Varun!)
2019-10-29 09:58:16 -07:00
Jordan Rose
618afde2a6 [docs] CToSwift: Add section on methods
There's a lot here, so I might have missed something, but I think this
document is complete!
2019-10-25 15:38:01 -07:00
Jordan Rose
d6117a43b7 [docs] CToSwift: document omit-needless-words (#27749)
...and update the dirty lie that property names aren't transformed.

The only thing left to do is methods!
2019-10-24 18:35:33 -07:00
Jordan Rose
1bb666a362 [docs] CToSwiftName: Add the section on ObjC properties
Fairly simple except in the few cases they aren't.
2019-10-01 20:08:08 -07:00
Jordan Rose
dfe0085aea [docs] CToSwift: Finish swift_name section
Struct/union fields, ObjC properties, ObjC methods
2019-10-01 20:08:06 -07:00
Jordan Rose
40fdae4a8a [docs] CToSwift: remove the import-as-member-subscript discussion
This fits in the model but was never implemented, so take it back out.
2019-09-27 20:14:07 -07:00
Jordan Rose
4ade7ae11f [docs] CToSwift: swift_name for all top-level declarations (#27227)
That is: types, globals, C functions, and enumerators, including a
discussion of import-as-member for each. Still more to come:
swift_name for properties, methods, and struct fields.
2019-09-19 16:31:41 -07:00
Jordan Rose
2d63ae4133 [docs] CToSwift: Describe swift_private (prepend '__') 2019-09-11 19:45:10 -07:00
Jordan Rose
afecd41904 [docs] CToSwift: Objective-C Protocols ("Protocol" appended) 2019-09-11 09:16:00 -07:00
Jordan Rose
9cc26ef7a2 [docs] CToSwift: CF types (how they're recognized + dropping "Ref") 2019-09-11 09:16:00 -07:00
Jordan Rose
7aeeb0d508 [docs] CToSwift: Move word-splitting into its own section
It's used all over the place in name importing, not just for enums.
2019-09-11 09:16:00 -07:00
Jordan Rose
682c45ca60 [docs] Start a doc on ClangImporter C->Swift name mapping (#26947)
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
2019-09-03 15:16:29 -07:00