[Lldb-commits] [lldb] r135536 - /lldb/trunk/scripts/Python/interface/SBStream.i

[Johnny Chen]

Author: johnny
Date: Tue Jul 19 18:24:36 2011
New Revision: 135536

URL: http://llvm.org/viewvc/llvm-project?rev=135536&view=rev
Log:
Add some docstrings for SBStream class.

Modified:
    lldb/trunk/scripts/Python/interface/SBStream.i

Modified: lldb/trunk/scripts/Python/interface/SBStream.i
URL: http://llvm.org/viewvc/llvm-project/lldb/trunk/scripts/Python/interface/SBStream.i?rev=135536&r1=135535&r2=135536&view=diff
==============================================================================
--- lldb/trunk/scripts/Python/interface/SBStream.i (original)
+++ lldb/trunk/scripts/Python/interface/SBStream.i Tue Jul 19 18:24:36 2011
@@ -11,6 +11,33 @@
 
 namespace lldb {
 
+%feature("docstring",
+"Represents a destination for streaming data output to. By default, a string
+stream is created.
+
+For example (from test/source-manager/TestSourceManager.py),
+
+        # Create the filespec for 'main.c'.
+        filespec = lldb.SBFileSpec('main.c', False)
+        source_mgr = self.dbg.GetSourceManager()
+        # Use a string stream as the destination.
+        stream = lldb.SBStream()
+        source_mgr.DisplaySourceLinesWithLineNumbers(filespec,
+                                                     self.line,
+                                                     2, # context before
+                                                     2, # context after
+                                                     '=>', # prefix for current line
+                                                     stream)
+
+        #    2    
+        #    3    int main(int argc, char const *argv[]) {
+        # => 4        printf('Hello world.\\n'); // Set break point at this line.
+        #    5        return 0;
+        #    6    }
+        self.expect(stream.GetData(), 'Source code displayed correctly',
+                    exe=False,
+            patterns = ['=> %d.*Hello world' % self.line])
+") SBStream;
 class SBStream
 {
 public:
@@ -22,14 +49,22 @@
     bool
     IsValid() const;
 
-    // If this stream is not redirected to a file, it will maintain a local
-    // cache for the stream data which can be accessed using this accessor.
+    %feature("docstring", "
+    //--------------------------------------------------------------------------
+    /// If this stream is not redirected to a file, it will maintain a local
+    /// cache for the stream data which can be accessed using this accessor.
+    //--------------------------------------------------------------------------
+    ") GetData;
     const char *
     GetData ();
 
-    // If this stream is not redirected to a file, it will maintain a local
-    // cache for the stream output whose length can be accessed using this 
-    // accessor.
+    %feature("docstring", "
+    //--------------------------------------------------------------------------
+    /// If this stream is not redirected to a file, it will maintain a local
+    /// cache for the stream output whose length can be accessed using this 
+    /// accessor.
+    //--------------------------------------------------------------------------
+    ") GetSize;
     size_t
     GetSize();
 
@@ -45,9 +80,13 @@
     void
     RedirectToFileDescriptor (int fd, bool transfer_fh_ownership);
 
-    // If the stream is redirected to a file, forget about the file and if
-    // ownership of the file was transfered to this object, close the file.
-    // If the stream is backed by a local cache, clear this cache.
+    %feature("docstring", "
+    //--------------------------------------------------------------------------
+    /// If the stream is redirected to a file, forget about the file and if
+    /// ownership of the file was transfered to this object, close the file.
+    /// If the stream is backed by a local cache, clear this cache.
+    //--------------------------------------------------------------------------
+    ") Clear;
     void
     Clear ();
 };