From bcb91a4ac16b6e554c7eebc0a463aa343df17d3c Mon Sep 17 00:00:00 2001
From: Robert Sesek <rsesek@bluestatic.org>
Date: Sun, 16 Jan 2011 01:42:40 -0500
Subject: [PATCH] Document BSSourceView.h

---
 Source/BSSourceView.h | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/Source/BSSourceView.h b/Source/BSSourceView.h
index 65517d4..672ae64 100644
--- a/Source/BSSourceView.h
+++ b/Source/BSSourceView.h
@@ -19,6 +19,12 @@
 @class BSLineNumberRulerView;
 @protocol BSSourceViewDelegate;
 
+// A BSSourceView is a view that contains an NSTextView that also has a line
+// number ruler. This class wraps synchronization management between the text
+// field and the line numbmering and marker drawing.
+//
+// Rather than setting the string of the text view directly, use the provided
+// methods to load from a file path or to load a string as a virtual file.
 @interface BSSourceView : NSView
 {
  @private
@@ -26,6 +32,7 @@
   BSLineNumberRulerView* ruler_;
   NSScrollView* scrollView_;
 
+  // Set of Breakpoint objects.
   NSSet* markers_;
 
   NSString* file;
@@ -34,8 +41,8 @@
   id<BSSourceViewDelegate> delegate;
 }
 
-@property (assign) NSTextView* textView;
-@property (assign) NSScrollView* scrollView;
+@property (readonly) NSTextView* textView;
+@property (readonly) NSScrollView* scrollView;
 @property (retain) NSSet* markers;
 @property (nonatomic, assign) NSString* file;
 @property (assign) int markedLine;
-- 
2.22.5