From 5cb19e77259a89d0b34d819e9b3a7f1dc67d8dd8 Mon Sep 17 00:00:00 2001
From: Johnny Chen <johnny.chen@apple.com>
Date: Wed, 20 Jul 2011 01:06:37 +0000
Subject: [PATCH] Add some docstrings for SBFileSpec class.

llvm-svn: 135553
---
 lldb/scripts/Python/interface/SBFileSpec.i | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/lldb/scripts/Python/interface/SBFileSpec.i b/lldb/scripts/Python/interface/SBFileSpec.i
index 5897af442877..e2ef74bc93a0 100644
--- a/lldb/scripts/Python/interface/SBFileSpec.i
+++ b/lldb/scripts/Python/interface/SBFileSpec.i
@@ -9,6 +9,27 @@
 
 namespace lldb {
 
+%feature("docstring",
+"Represents a file specfication that divides the path into a directory and
+basename.  The string values of the paths are put into uniqued string pools
+for fast comparisons and efficient memory usage.
+
+For example, the following code
+
+        lineEntry = context.GetLineEntry()
+        self.expect(lineEntry.GetFileSpec().GetDirectory(), 'The line entry should have the correct directory',
+                    exe=False,
+            substrs = [self.mydir])
+        self.expect(lineEntry.GetFileSpec().GetFilename(), 'The line entry should have the correct filename',
+                    exe=False,
+            substrs = ['main.c'])
+        self.assertTrue(lineEntry.GetLine() == self.line,
+                        'The line entry's line number should match ')
+
+gets the line entry from the symbol context when a thread is stopped.
+It gets the file spec corresponding to the line entry and checks that
+the filename and the directory matches wat we expect.
+") SBFileSpec;
 class SBFileSpec
 {
 public: