From c60a58ff261a91d005a7a20d18660d72ab4e3980 Mon Sep 17 00:00:00 2001
From: Colin Viebrock <colin@viebrock.ca>
Date: Mon, 23 Jul 2012 14:29:29 -0500
Subject: [PATCH] Someone else can re-word this, but a easy-to-find paragraph
 on deleteing Eloquent models seemed missing. Signed-off-by: Colin Viebrock
 <colin@viebrock.ca>

---
 laravel/documentation/database/eloquent.md | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/laravel/documentation/database/eloquent.md b/laravel/documentation/database/eloquent.md
index 71e3a402..7a7e1b9c 100644
--- a/laravel/documentation/database/eloquent.md
+++ b/laravel/documentation/database/eloquent.md
@@ -15,6 +15,7 @@
 - [Setter & Getter Methods](#getter-and-setter-methods)
 - [Mass-Assignment](#mass-assignment)
 - [Converting Models To Arrays](#to-array)
+- [Deleting Models](#delete)
 
 <a name="the-basics"></a>
 ## The Basics
@@ -331,7 +332,7 @@ However, you may often only want to insert a new record into the intermediate ta
 	$user->roles()->attach($role_id);
 
 It's also possible to attach data for fields in the intermediate table (pivot table), to do this add a second array variable to the attach command containing the data you want to attach:
-	
+
 	$user->roles()->attach($role_id, array('expires' => $expires));
 
 <a name="sync-method"></a>
@@ -427,14 +428,14 @@ If you find yourself eager loading the same models often, you may want to use **
 	class Book extends Eloquent {
 
 	     public $includes = array('author');
-	     
+
 	     public function author()
 	     {
 	          return $this->belongs_to('Author');
 	     }
 
 	}
-	
+
 **$includes** takes the same arguments that **with** takes. The following is now eagerly loaded.
 
 	foreach (Book::all() as $book)
@@ -536,4 +537,13 @@ Sometimes you may wish to limit the attributes that are included in your model's
 
 		public static $hidden = array('password');
 
-	}
\ No newline at end of file
+	}
+
+<a name="delete"></a>
+## Deleting Models
+
+Because Eloquent inherits all the features and methods of Fluent queries, deleting models is a snap:
+
+	$author->delete();
+
+Note, however, than this won't delete any related models (e.g. all the author's Book models will still exist), unless you have set up [foreign keys](/docs/database/schema#foreign-keys) and cascading deletes.
\ No newline at end of file