Some docstrings

akrabat · Sep 28, 2011 · e7c95fb · e7c95fb
1 parent eaebd09
commit e7c95fb
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/src/api.py b/src/api.py
@@ -34,12 +34,15 @@ def prepare(self, content):
         return content
 
     def upload(self, content):
+        """Return the url to the new paste"""
         raise NotImplementedError()
 
     def fetch(self, id):
+        """Return (content, syntax, url)"""
         raise NotImplementedError()
 
     def normalised_syntax(self):
+        """Return our best guess given the language file path"""
         syntax = self.view.settings().get('syntax')
         syntax.lower()\
             .replace('.tmlanguage', '')\
@@ -48,4 +51,5 @@ def normalised_syntax(self):
 
     def syntax(self):
         syntax = self.normalise_syntax(syntax)
+        """Return a syntax known to the pastebin"""
         return self.SYNTAXES.get(syntax, '')