Brackets for notes in source

I just lost 15 mins of my life trying to figure out how RxSwift redefines [ ] because of this line in the First Edition:

[existing code: .subscribe(onDisposed: .. ]

Or was that some objective C not properly converted into Swift? It kind of reads as a capture list, hmmmm…
That’s a terrible terrible convention. Make it a proper comment! Those are all valid swift code symbols, it’s in the code typeface, and how many decades ago was the comment invented to solve this problem?
(No idea if this has been changed in subsequent editions.)

This topic was automatically closed after 166 days. New replies are no longer allowed.