adding comments for deprecated endpoints

Author: dmgarland

lib/bitbucket_rest_api/repos.rb

@@ -12,10 +12,10 @@ class Repos < API
                  :Following   => 'following',
                  :Sources     => 'sources',
                  :Forks       => 'forks',
-                 :Commits =>'commits',
-                 :Download=>'download',
-                 :Webhooks => 'webhooks',
-                 :PullRequest    => 'pull_request'
+                 :Commits     => 'commits',
+                 :Download    => 'download',
+                 :Webhooks    => 'webhooks',
+                 :PullRequest => 'pull_request'
 
     DEFAULT_REPO_OPTIONS = {
         "website"         => "",
@@ -93,7 +93,7 @@ def pull_request
     #   repos = BitBucket::Repos.new
     #   repos.branches 'user-name', 'repo-name'
     #
-    def branches(user_name, repo_name, params={ })
+    def branches(user_name, repo_name, params={})
       _update_user_repo_params(user_name, repo_name)
       _validate_user_repo_params(user, repo) unless (user? && repo?)
       normalize! params
@@ -105,6 +105,7 @@ def branches(user_name, repo_name, params={ })
 
     alias :list_branches :branches
 
+    # FIXME: 'POST a new repository' is a deprecated feature of the API
     # Create a new repository for the authenticated user.
     #
     # = Parameters
@@ -188,6 +189,7 @@ def get(user_name, repo_name, params={ })
 
     alias :find :get
 
+    # FIXME: 'DELETE an existing repository' is a deprecated feature of the API
     # Delete a repository
     #
     # = Examples