Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(325)

Unified Diff: docs/cocoa_tips_and_tricks.md

Issue 1306233003: Markdown style fixes for: (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: style changes Created 5 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « docs/closure_compilation.md ('k') | docs/code_coverage.md » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: docs/cocoa_tips_and_tricks.md
diff --git a/docs/cocoa_tips_and_tricks.md b/docs/cocoa_tips_and_tricks.md
index d13ba68f6e16b18d74a0b2df792066f2bc24e881..2ab0329af5786f75046feb320e0f9ac2790f3ae5 100644
--- a/docs/cocoa_tips_and_tricks.md
+++ b/docs/cocoa_tips_and_tricks.md
@@ -1,12 +1,16 @@
-# Introduction
+# Cocoa Tips and Tricks
-A collection of idioms that we use when writing the Cocoa views and controllers for Chromium.
+A collection of idioms that we use when writing the Cocoa views and controllers
+for Chromium.
+
+[TOC]
## NSWindowController Initialization
-To make sure that |window| and |delegate| are wired up correctly in your xib, it's useful to add this to your window controller:
+To make sure that |window| and |delegate| are wired up correctly in your xib,
+it's useful to add this to your window controller:
-```
+```objective-c
- (void)awakeFromNib {
DCHECK([self window]);
DCHECK_EQ(self, [[self window] delegate]);
@@ -15,14 +19,19 @@ To make sure that |window| and |delegate| are wired up correctly in your xib, it
## NSWindowController Cleanup
-"You want the window controller to release itself it |-windowDidClose:|, because else it could die while its views are still around. if it (auto)releases itself in the callback, the window and its views are already gone and they won't send messages to the released controller."
+"You want the window controller to release itself it |-windowDidClose:|, because
+else it could die while its views are still around. if it (auto)releases itself
+in the callback, the window and its views are already gone and they won't send
+messages to the released controller."
- Nico Weber (thakis@)
-See [Window Closing Behavior, ADC Reference](http://developer.apple.com/mac/library/documentation/Cocoa/Conceptual/Documents/Concepts/WindowClosingBehav.html#//apple_ref/doc/uid/20000027) for the full story.
+See
+[Window Closing Behavior, ADC Reference](http://developer.apple.com/mac/library/documentation/Cocoa/Conceptual/Documents/Concepts/WindowClosingBehav.html#//apple_ref/doc/uid/20000027)
+for the full story.
What this means in practice is:
-```
+```objective-c
@interface MyWindowController : NSWindowController<NSWindowDelegate> {
IBOutlet NSButton* closeButton_;
}
@@ -57,13 +66,20 @@ What this means in practice is:
## Unit Tests
-There are four Chromium-specific GTest macros for writing ObjC++ test cases. These macros are EXPECT\_NSEQ, EXPECT\_NSNE, and ASSERT variants by the same names. These test `-[id<NSObject> isEqual:]` and will print the object's `-description` in GTest-style if the assertion fails. These macros are defined in //testing/gtest\_mac.h. Just include that file and you can start using them.
+There are four Chromium-specific GTest macros for writing ObjC++ test cases.
+These macros are `EXPECT_NSEQ`, `EXPECT_NSNE`, and `ASSERT` variants by the same
+names. These test `-[id<NSObject> isEqual:]` and will print the object's
+`-description` in GTest-style if the assertion fails. These macros are defined
+in `//testing/gtest_mac.h`. Just include that file and you can start using them.
This allows you to write this:
+
+```objective-c
+EXPECT_NSEQ(@"foo", aString);
```
- EXPECT_NSEQ(@"foo", aString);
-```
+
Instead of this:
+
+```objective-c
+EXPECT_TRUE([aString isEqualToString:@"foo"]);
```
- EXPECT_TRUE([aString isEqualToString:@"foo"]);
-```
« no previous file with comments | « docs/closure_compilation.md ('k') | docs/code_coverage.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698