[PATCH] D35379: Add documentation for @available

2022-08-02 Thread Nico Weber via Phabricator via cfe-commits
thakis accepted this revision. thakis marked an inline comment as done. thakis added a comment. This revision is now accepted and ready to land. Herald added a reviewer: aaron.ballman. Herald added a project: All. landed long ago in 11cafc82b72a80fb9a7266bbda7fc7a0cc1b51a0 / 564004ae78c61a9292a15

[PATCH] D35379: Add documentation for @available

2017-07-17 Thread Alex Lorenz via Phabricator via cfe-commits
arphaman added inline comments. Comment at: docs/LanguageExtensions.rst:1347 + +In rare cases, the availability annotation on an API might be overly +conservative. For example, ``[NSProcessInfo processInfo]`` secretly responds to thakis wrote: > arphaman wrote:

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Nico Weber via Phabricator via cfe-commits
thakis marked an inline comment as done. thakis added inline comments. Comment at: docs/LanguageExtensions.rst:1278 +It is possible use the newest SDK but still build a program that can run on +older macOS and iOS versions, by passing ``-mmacosx-version-info=`` / +``--miphoneos-v

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Sidney San Martín via Phabricator via cfe-commits
sdy added inline comments. Comment at: docs/LanguageExtensions.rst:1278 +It is possible use the newest SDK but still build a program that can run on +older macOS and iOS versions, by passing ``-mmacosx-version-info=`` / +``--miphoneos-version-min=``. thakis wrote

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Nico Weber via Phabricator via cfe-commits
thakis added a comment. I went ahead and landed this in r308044, given that I addressed the nits and removed the possibly contentious bits. Happy to address remaining nits in a follow-up. https://reviews.llvm.org/D35379 ___ cfe-commits mailing lis

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Nico Weber via Phabricator via cfe-commits
thakis added a comment. Mostly done, thanks! Comment at: docs/LanguageExtensions.rst:1274 +Objective-C @available +-- sdy wrote: > sdy wrote: > > I think "Objective-C" is redundant, this is already in the ObjC section and > > most of the

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Nico Weber via Phabricator via cfe-commits
thakis updated this revision to Diff 106652. thakis marked 3 inline comments as done. thakis added a comment. sdy comments https://reviews.llvm.org/D35379 Files: docs/LanguageExtensions.rst include/clang/Basic/AttrDocs.td Index: include/clang/Basic/AttrDocs.td =

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Sidney San Martín via Phabricator via cfe-commits
sdy added inline comments. Comment at: docs/LanguageExtensions.rst:1274 +Objective-C @available +-- I think "Objective-C" is redundant, this is already in the ObjC section and most of the other headers don't start with "Objective-C".

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Nico Weber via Phabricator via cfe-commits
thakis updated this revision to Diff 106650. thakis marked an inline comment as done. thakis added a comment. arphaman comments https://reviews.llvm.org/D35379 Files: docs/LanguageExtensions.rst include/clang/Basic/AttrDocs.td Index: include/clang/Basic/AttrDocs.td

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Nico Weber via Phabricator via cfe-commits
thakis marked 7 inline comments as done. thakis added a comment. Thanks, all done, much better! Comment at: docs/LanguageExtensions.rst:1347 + +In rare cases, the availability annotation on an API might be overly +conservative. For example, ``[NSProcessInfo processInfo]`` secr

[PATCH] D35379: Add documentation for @available

2017-07-14 Thread Alex Lorenz via Phabricator via cfe-commits
arphaman added a comment. Thanks for doing this! I have some comments: Comment at: docs/LanguageExtensions.rst:1277 +It is possible use the newest SDK but still build a program that can run on +older macOS and iOS versions, by passing ``-mmacosx-version-info=`` /

[PATCH] D35379: Add documentation for @available

2017-07-13 Thread Nico Weber via Phabricator via cfe-commits
thakis updated this revision to Diff 106528. thakis marked an inline comment as done. thakis added a comment. Document *, add example with multiple platforms https://reviews.llvm.org/D35379 Files: docs/LanguageExtensions.rst include/clang/Basic/AttrDocs.td Index: include/clang/Basic/AttrDo

[PATCH] D35379: Add documentation for @available

2017-07-13 Thread Erik Pilkington via Phabricator via cfe-commits
erik.pilkington added inline comments. Comment at: docs/LanguageExtensions.rst:1309 + void my_fun(NSSomeClass* var) { +if (@available(macOS 10.12)) { + [var fancyNewMethod]; thakis wrote: > erik.pilkington wrote: > > Don't forget the '*', ie @available(

[PATCH] D35379: Add documentation for @available

2017-07-13 Thread Nico Weber via Phabricator via cfe-commits
thakis added inline comments. Comment at: docs/LanguageExtensions.rst:1290 -.. _langext-overloading: - erik.pilkington wrote: > did you mean to remove this? I meant to move it above the "protocol-qualifier mangling of parameters" section; I think that's where

[PATCH] D35379: Add documentation for @available

2017-07-13 Thread Nico Weber via Phabricator via cfe-commits
thakis updated this revision to Diff 106513. thakis marked an inline comment as done. thakis added a comment. comments https://reviews.llvm.org/D35379 Files: docs/LanguageExtensions.rst include/clang/Basic/AttrDocs.td Index: include/clang/Basic/AttrDocs.td =

[PATCH] D35379: Add documentation for @available

2017-07-13 Thread Erik Pilkington via Phabricator via cfe-commits
erik.pilkington added a reviewer: arphaman. erik.pilkington added a subscriber: arphaman. erik.pilkington added a comment. This looks great, thanks for working on this! LGTM, but @arphaman might have some thoughts. Comment at: docs/LanguageExtensions.rst:1290 -.. _langext-ov

[PATCH] D35379: Add documentation for @available

2017-07-13 Thread Nico Weber via Phabricator via cfe-commits
thakis created this revision. Based on https://devstreaming-cdn.apple.com/videos/wwdc/2017/411a7o9phe4uekm/411/411_whats_new_in_llvm.pdf (I couldn't find a way to play the corresponding video on linux, so I didn't look at that.) https://reviews.llvm.org/D35379 Files: docs/LanguageExtension