Documentation corrections

lib/aviator/core/session.rb

@@ -1,13 +1,14 @@
+#
+# Author::    Mark Maglana (mmaglana@gmail.com)
+# Copyright:: Copyright (c) 2014 Mark Maglana
+# License::   Distributed under the MIT license
+# Homepage::  http://aviator.github.io/www/
+#
 module Aviator
 
   #
   # Manages a provider (e.g. OpenStack) session.
   #
-  # Author::    Mark Maglana (mmaglana@gmail.com)
-  # Copyright:: Copyright (c) 2014 Mark Maglana
-  # License::   Distributed under the MIT license
-  # Homepage::  http://aviator.github.io/www/
-  #
   class Session
 
     class AuthenticationError < StandardError
@@ -360,7 +361,7 @@ def log_file
     #  session.request :compute_service, :create_server, :api_version => v1
     #
     # The available options vary depending on the provider. See the documentation
-    # on the provider's Provider class for more information (e.g. Aviator::OpenStack::Provider)
+    # on the provider's Provider class for more information (e.g. Aviator::Openstack::Provider)
     #
     def request(service_name, request_name, opts={}, &params)
       service = send("#{service_name.to_s}_service")

lib/aviator/openstack/identity/requests/v3/public/create_token.rb

@@ -1,7 +1,6 @@
-# Original work by Stephen Paul Suarez
-# https://github.com/musashi-dev/aviator/blob/develop/lib/aviator/openstack/identity/v3/public/create_token.rb
-
 module Aviator
+  # Original work by Stephen Paul Suarez
+  # https://github.com/musashi-dev/aviator/blob/develop/lib/aviator/openstack/identity/v3/public/create_token.rb
 
   define_request :create_token, :inherit => [:openstack, :common, :v3, :public, :base] do
 

lib/aviator/openstack/provider.rb

@@ -1,13 +1,6 @@
 module Aviator
 module Openstack
 
-  #
-  # Manages a provider (e.g. OpenStack) session.
-  #
-  # Author::    Mark Maglana (mmaglana@gmail.com)
-  # Copyright:: Copyright (c) 2014 Mark Maglana
-  # License::   Distributed under the MIT license
-  # Homepage::  http://aviator.github.io/www/
   #
   # <b>Request Options</b>
   #
@@ -16,10 +9,10 @@ module Openstack
   #
   # :api_version => :v2::
   #     Forces Aviator to use the request class for the v2 API. For any other
-  #     version, replace Note that this may throw an error if no such request
-  #     class exists. If you want to globally specify the API version to use for
-  #     a specific service, declare it in your config file under the correct
-  #     environment. For example:
+  #     version, replace :v2 with the desired one. Note that this may throw an
+  #     error if no such request class for the given api version exists. If you
+  #     want to globally specify the API version to use for a specific service,
+  #     declare it in your config file under the correct environment. For example:
   #
   #  production:
   #    provider: openstack