revert changes and update doc instead

Author: jwshinjwshin

src/lib/sidenav/drawer.spec.ts

@@ -102,18 +102,6 @@ describe('MdDrawer', () => {
       expect(testComponent.backdropClickedCount).toBe(1);
     }));
 
-    it('should emit the escapeKeydown event when ESCAPE key is pressed', () => {
-      let fixture = TestBed.createComponent(BasicTestApp);
-      let testComponent: BasicTestApp = fixture.debugElement.componentInstance;
-      let drawer = fixture.debugElement.query(By.directive(MdDrawer));
-      expect(testComponent.escapeKeydownCount).toBe(0);
-
-      dispatchKeyboardEvent(drawer.nativeElement, 'keydown', ESCAPE);
-      fixture.detectChanges();
-
-      expect(testComponent.escapeKeydownCount).toBe(1);
-    });
-
     it('should close when pressing escape', fakeAsync(() => {
       let fixture = TestBed.createComponent(BasicTestApp);
 
@@ -398,8 +386,7 @@ class DrawerContainerTwoDrawerTestApp {
     <md-drawer-container (backdropClick)="backdropClicked()">
       <md-drawer #drawer position="start"
                  (open)="open()"
-                 (close)="close()"
-                 (escapeKeydown)="escapeKeydown()">
+                 (close)="close()">
         <button #drawerButton>Content.</button>
       </md-drawer>
       <button (click)="drawer.open()" class="open" #openButton></button>
@@ -427,10 +414,6 @@ class BasicTestApp {
   backdropClicked() {
     this.backdropClickedCount++;
   }
-
-  escapeKeydown() {
-    this.escapeKeydownCount++;
-  }
 }
 
 @Component({

src/lib/sidenav/drawer.ts

@@ -152,9 +152,6 @@ export class MdDrawer implements AfterContentInit, OnDestroy {
   /** Event emitted when the drawer's position changes. */
   @Output('positionChanged') onPositionChanged = new EventEmitter<void>();
 
-  /** Event emitted when ESCAPE is pressed. */
-  @Output() escapeKeydown = new EventEmitter<void>();
-
   /** @deprecated */
   @Output('align-changed') onAlignChanged = new EventEmitter<void>();
 
@@ -262,12 +259,9 @@ export class MdDrawer implements AfterContentInit, OnDestroy {
    * @docs-private
    */
   handleKeydown(event: KeyboardEvent) {
-    if (event.keyCode === ESCAPE) {
-      this.escapeKeydown.emit();
-      if (!this.disableClose) {
-        this.close();
-        event.stopPropagation();
-      }
+    if (event.keyCode === ESCAPE && !this.disableClose) {
+      this.close();
+      event.stopPropagation();
     }
   }
 

src/lib/sidenav/sidenav.md

@@ -70,3 +70,19 @@ html, body, material-app, md-sidenav-container, .my-content {
 ### FABs inside sidenav
 For a sidenav with a FAB (Floating Action Button) or other floating element, the recommended approach is to place the FAB
 outside of the scrollable region and absolutely position it.
+
+### Sidenav vs. Drawer
+The difference between sidenav and drawer is that the sidenav takes up fullscreen whereas drawer is a smaller element
+that takes up a subsection of the screen. `md-sidenav` has to be placed inside `md-sidenav-container` and `md-drawer`
+has to be placed inside `md-drawer-container`. More functionalities will be added to sidenav in the future.
+
+
+### Disabling closing of sidenav and drawer
+By default, sidenav and drawer can be closed either by clicking on the backdrop or by pressing <kbd>ESCAPE</kbd>.
+`disableClose` attribute can be set on `md-drawer` or `md-sidenav` to disable closing by two methods. To enable one
+of the two methods to allow closing with `disableClose` attribute set, then custom event handlers can be used as below:
+```html
+<md-drawer-container (backdropClick)="customBackdropClickHandler()">
+  <md-drawer disableClose (keydown)="customKeydownHandler($event)"></md-drawer>
+</md-drawer-container>
+```