From fc4d37062c46886d3bc1fb0b6c3626d779be4ecd Mon Sep 17 00:00:00 2001
From: Ben Reynwar <ben@reynwar.net>
Date: Tue, 14 Aug 2012 10:28:23 -0700
Subject: docs: Modified argument formating in python docstrings in grc.

---
 grc/base/Connection.py | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

(limited to 'grc/base/Connection.py')

diff --git a/grc/base/Connection.py b/grc/base/Connection.py
index 3ce7fd07f9..b9afe1434d 100644
--- a/grc/base/Connection.py
+++ b/grc/base/Connection.py
@@ -25,11 +25,15 @@ class Connection(Element):
 	def __init__(self, flow_graph, porta, portb):
 		"""
 		Make a new connection given the parent and 2 ports.
-		@param flow_graph the parent of this element
-		@param porta a port (any direction)
-		@param portb a port (any direction)
+		
+		Args:
+		    flow_graph: the parent of this element
+		    porta: a port (any direction)
+		    portb: a port (any direction)
 		@throws Error cannot make connection
-		@return a new connection
+		
+		Returns:
+		    a new connection
 		"""
 		Element.__init__(self, flow_graph)
 		source = sink = None
@@ -70,7 +74,9 @@ class Connection(Element):
 	def get_enabled(self):
 		"""
 		Get the enabled state of this connection.
-		@return true if source and sink blocks are enabled
+		
+		Returns:
+		    true if source and sink blocks are enabled
 		"""
 		return self.get_source().get_parent().get_enabled() and \
 			self.get_sink().get_parent().get_enabled()
@@ -87,7 +93,9 @@ class Connection(Element):
 	def export_data(self):
 		"""
 		Export this connection's info.
-		@return a nested data odict
+		
+		Returns:
+		    a nested data odict
 		"""
 		n = odict()
 		n['source_block_id'] = self.get_source().get_parent().get_id()
-- 
cgit v1.2.3