fog 1.10.0 → 1.10.1

data/lib/fog/aws/requests/cdn/get_streaming_distribution_list.rb

@@ -5,43 +5,39 @@ module Fog
 
         require 'fog/aws/parsers/cdn/get_streaming_distribution_list'
 
-        # List information about distributions in CloudFront
+        # List information about distributions in CloudFront.
         #
-        # ==== Parameters
-        # * options<~Hash> - config arguments for list.  Defaults to {}.
-        #   * 'Marker'<~String> - limits object keys to only those that appear
-        #     lexicographically after its value.
-        #   * 'MaxItems'<~Integer> - limits number of object keys returned
+        # @param options [Hash] Config arguments for list. 
+        # @option options Marker [String] Limits object keys to only those that appear lexicographically after its value.
+        # @option options MaxItems [Integer] Limits number of object keys returned.
         #
-        # ==== Returns
-        # * response<~Excon::Response>:
-        #   * body<~Hash>:
-        #     * 'IsTruncated'<~Boolean> - Whether or not the listing is truncated
-        #     * 'Marker'<~String> - Marker specified for query
-        #     * 'MaxItems'<~Integer> - Maximum number of keys specified for query
-        #     * 'NextMarker'<~String> - Marker to specify for next page (id of last result of current page)
-        #     * 'StreamingDistributionSummary'<~Array>:
-        #       * 'S3Origin'<~Hash>:
-        #         * 'DNSName'<~String> - origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'
-        #         * 'OriginAccessIdentity'<~String> - Optional: Used when serving private content
+        # @return [Excon::Response]
+        #   * body [Hash]:
+        #     * IsTruncated [Boolean] - Whether or not the listing is truncated.
+        #     * Marker [String] - Marker specified for query.
+        #     * MaxItems [Integer] - Maximum number of keys specified for query.
+        #     * NextMarker [String] - Marker to specify for next page (id of last result of current page).
+        #     * StreamingDistributionSummary [Array]:
+        #       * S3Origin [Hash]:
+        #         * DNSName [String] - Origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'.
+        #         * OriginAccessIdentity [String] - Optional: Used when serving private content.
         #       or
-        #       * 'CustomOrigin'<~Hash>:
-        #         * 'DNSName'<~String> - origin to associate with distribution, ie 'www.example.com'
-        #         * 'HTTPPort'<~Integer> - HTTP port of origin, in [80, 443] or (1024...65535)
-        #         * 'HTTPSPort'<~Integer> - HTTPS port of origin, in [80, 443] or (1024...65535)
-        #       * 'OriginProtocolPolicy'<~String> - Policy on using http vs https, in ['http-only', 'match-viewer']
-        #       * 'Comment'<~String> - comment associated with distribution
-        #       * 'CNAME'<~Array> - array of associated cnames
-        #       * 'Enabled'<~Boolean> - whether or not distribution is enabled
-        #       * 'Id'<~String> - Id of distribution
-        #       * 'LastModifiedTime'<~String> - Timestamp of last modification of distribution
-        #       * 'Origin'<~String> - s3 origin bucket
-        #       * 'Status'<~String> - Status of distribution
-        #       * 'TrustedSigners'<~Array> - trusted signers
+        #       * CustomOrigin [Hash]:
+        #         * DNSName [String] - Origin to associate with distribution, ie 'www.example.com'.
+        #         * HTTPPort [Integer] - HTTP port of origin, in [80, 443] or (1024...65535).
+        #         * HTTPSPort [Integer] - HTTPS port of origin, in [80, 443] or (1024...65535).
+        #       * OriginProtocolPolicy [String] - Policy on using http vs https, in ['http-only', 'match-viewer'].
+        #       * Comment [String] - Comment associated with distribution.
+        #       * CNAME [Array] - Array of associated cnames.
+        #       * Enabled [Boolean] - Whether or not distribution is enabled.
+        #       * Id [String] - Id of distribution.
+        #       * LastModifiedTime [String] - Timestamp of last modification of distribution.
+        #       * Origin [String] - S3 origin bucket.
+        #       * Status [String] - Status of distribution.
+        #       * TrustedSigners [Array] - Trusted signers.
         #
-        # ==== See Also
-        # http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/ListStreamingDistributions.html
-
+        # @see http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/ListStreamingDistributions.html
+        
         def get_streaming_distribution_list(options = {})
           request({
             :expects    => 200,

data/lib/fog/aws/requests/cdn/post_distribution.rb

@@ -5,54 +5,52 @@ module Fog
 
         require 'fog/aws/parsers/cdn/distribution'
 
-        # create a new distribution in CloudFront
+        # Create a new distribution in CloudFront.
         #
-        # ==== Parameters
-        # * options<~Hash> - config for distribution.  Defaults to {}.
+        # @param options [Hash] Config for distribution.
+        # 
         #   REQUIRED:
-        #   * 'S3Origin'<~Hash>:
-        #     * 'DNSName'<~String> - origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'
-        #     * 'OriginAccessIdentity'<~String> - Optional: Used when serving private content
+        #   * S3Origin [Hash]:
+        #     * DNSName [String] Origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'.
+        #     * OriginAccessIdentity [String] Optional: used when serving private content.
         #   or
-        #   * 'CustomOrigin'<~Hash>:
-        #     * 'DNSName'<~String> - origin to associate with distribution, ie 'www.example.com'
-        #     * 'HTTPPort'<~Integer> - Optional HTTP port of origin, in [80, 443] or (1024...65535), defaults to 80
-        #     * 'HTTPSPort'<~Integer> - Optional HTTPS port of origin, in [80, 443] or (1024...65535), defaults to 443
-        #     * 'OriginProtocolPolicy'<~String> - Policy on using http vs https, in ['http-only', 'match-viewer']
+        #   * CustomOrigin [Hash]:
+        #     * DNSName [String] Origin to associate with distribution, ie 'www.example.com'.
+        #     * HTTPPort [Integer] Optional HTTP port of origin, in [80, 443] or (1024...65535), defaults to 80.
+        #     * HTTPSPort [Integer] Optional HTTPS port of origin, in [80, 443] or (1024...65535), defaults to 443.
+        #     * OriginProtocolPolicy [String] Policy on using http vs https, in ['http-only', 'match-viewer'].
         #   OPTIONAL:
-        #   * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #   * 'Comment'<~String> - Optional comment about distribution
-        #   * 'CNAME'<~Array> - Optional array of strings to set as CNAMEs
-        #   * 'DefaultRootObject'<~String> - Optional default object to return for '/'
-        #   * 'Enabled'<~Boolean> - Whether or not distribution should accept requests, defaults to true
-        #   * 'Logging'<~Hash>: Optional logging config
-        #     * 'Bucket'<~String> - Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'
-        #     * 'Prefix'<~String> - Optional prefix for log filenames, ie 'myprefix/'
-        #   * 'OriginAccessIdentity'<~String> - Used for serving private content, in format 'origin-access-identity/cloudfront/ID'
-        #   * 'RequiredProtocols'<~String> - Optional, set to 'https' to force https connections
-        #   * 'TrustedSigners'<~Array> - Optional grant of rights to up to 5 aws accounts to generate signed URLs for private content, elements are either 'Self' for your own account or an AWS Account Number
+        #   * CallerReference [String] Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #   * Comment [String] Optional comment about distribution.
+        #   * CNAME [Array] Optional array of strings to set as CNAMEs.
+        #   * DefaultRootObject [String] Optional default object to return for '/'.
+        #   * Enabled [Boolean] Whether or not distribution should accept requests, defaults to true.
+        #   * Logging [Hash]: Optional logging config.
+        #     * Bucket [String] Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'.
+        #     * Prefix [String] Optional prefix for log filenames, ie 'myprefix/'.
+        #   * OriginAccessIdentity [String] Used for serving private content, in format 'origin-access-identity/cloudfront/ID'.
+        #   * RequiredProtocols [String] Optional, set to 'https' to force https connections.
+        #   * TrustedSigners [Array] Optional grant of rights to up to 5 aws accounts to generate signed URLs for private content, elements are either 'Self' for your own account or an AWS Account Number.
         #
-        # ==== Returns
-        # * response<~Excon::Response>:
-        #   * body<~Hash>:
-        #     * 'DomainName'<~String>: Domain name of distribution
-        #     * 'Id'<~String> - Id of distribution
-        #     * 'LastModifiedTime'<~String> - Timestamp of last modification of distribution
-        #     * 'Status'<~String> - Status of distribution
-        #     * 'DistributionConfig'<~Array>:
-        #       * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #       * 'CNAME'<~Array> - array of associated cnames
-        #       * 'Comment'<~String> - comment associated with distribution
-        #       * 'Enabled'<~Boolean> - whether or not distribution is enabled
-        #       * 'Logging'<~Hash>:
-        #         * 'Bucket'<~String> - bucket logs are stored in
-        #         * 'Prefix'<~String> - prefix logs are stored with
-        #       * 'Origin'<~String> - s3 origin bucket
-        #       * 'TrustedSigners'<~Array> - trusted signers
+        # @return [Excon::Response]
+        #   * body [Hash]:
+        #     * DomainName [String] - Domain name of distribution.
+        #     * Id [String] - Id of distribution.
+        #     * LastModifiedTime [String] - Timestamp of last modification of distribution.
+        #     * Status [String] - Status of distribution.
+        #     * DistributionConfig [Array]:
+        #       * CallerReference [String] - Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #       * CNAME [Array] - Array of associated cnames.
+        #       * Comment [String] - Comment associated with distribution.
+        #       * Enabled [Boolean] - Whether or not distribution is enabled.
+        #       * Logging [Hash]:
+        #         * Bucket [String] - Bucket logs are stored in.
+        #         * Prefix [String] - Prefix logs are stored with.
+        #       * Origin [String] - S3 origin bucket.
+        #       * TrustedSigners [Array] - Trusted signers.
         #
-        # ==== See Also
-        # http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateDistribution.html
-
+        # @see http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateDistribution.html
+        
         def post_distribution(options = {})
           options['CallerReference'] = Time.now.to_i.to_s
           data = '<?xml version="1.0" encoding="UTF-8"?>'

data/lib/fog/aws/requests/cdn/post_invalidation.rb

@@ -5,27 +5,23 @@ module Fog
 
         require 'fog/aws/parsers/cdn/post_invalidation'
 
-        # List information about distributions in CloudFront
+        # List information about distributions in CloudFront.
         #
-        # ==== Parameters
-        # * distribution_id<~String> - Id of distribution for invalidations
-        # * paths<~Array> - Array of string paths to objects to invalidate
-        # * caller_reference<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
+        # @param distribution_id [String] Id of distribution for invalidations.
+        # @param paths [Array] Array of string paths to objects to invalidate.
+        # @param caller_reference [String] Used to prevent replay, defaults to Time.now.to_i.to_s.
         #
+        # @return [Excon::Response]
+        #   * body [Hash]:
+        #     * Id [String] - Id of invalidation.
+        #     * Status [String] - Status of invalidation.
+        #     * CreateTime [Integer] - Time of invalidation creation.
+        #     * InvalidationBatch [Array]:
+        #       * Path [Array] - Array of strings of objects to invalidate.
+        #       * CallerReference [String] - Used to prevent replay, defaults to Time.now.to_i.to_s.
         #
-        # ==== Returns
-        # * response<~Excon::Response>:
-        #   * body<~Hash>:
-        #     * 'Id'<~String> - Id of invalidation
-        #     * 'Status'<~String> - Status of invalidation
-        #     * 'CreateTime'<~Integer> - Time of invalidation creation
-        #     * 'InvalidationBatch'<~Array>:
-        #       * 'Path'<~Array> - Array of strings of objects to invalidate
-        #       * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #
-        # ==== See Also
-        # http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateInvalidation.html
-
+        # @see http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateInvalidation.html
+        
         def post_invalidation(distribution_id, paths, caller_reference = Time.now.to_i.to_s)
           body = '<?xml version="1.0" encoding="UTF-8"?>'
           body << "<InvalidationBatch>"

data/lib/fog/aws/requests/cdn/post_streaming_distribution.rb

@@ -5,41 +5,39 @@ module Fog
 
         require 'fog/aws/parsers/cdn/streaming_distribution'
 
-        # create a new streaming distribution in CloudFront
+        # Create a new streaming distribution in CloudFront.
         #
-        # ==== Parameters
-        # * options<~Hash> - config for distribution.  Defaults to {}.
+        # @param options [Hash] Config for distribution.
+        # 
         #   REQUIRED:
-        #   * 'S3Origin'<~Hash>:
-        #     * 'DNSName'<~String> - origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'
+        #   * S3Origin [Hash]:
+        #     * DNSName [String] Origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'.
         #   OPTIONAL:
-        #   * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #   * 'Comment'<~String> - Optional comment about distribution
-        #   * 'CNAME'<~Array> - Optional array of strings to set as CNAMEs
-        #   * 'Enabled'<~Boolean> - Whether or not distribution should accept requests, defaults to true
-        #   * 'Logging'<~Hash>: Optional logging config
-        #     * 'Bucket'<~String> - Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'
-        #     * 'Prefix'<~String> - Optional prefix for log filenames, ie 'myprefix/'
+        #   * CallerReference [String] Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #   * Comment [String] Optional comment about distribution.
+        #   * CNAME [Array] Optional array of strings to set as CNAMEs.
+        #   * Enabled [Boolean] Whether or not distribution should accept requests, defaults to true.
+        #   * Logging [Hash]: Optional logging config.
+        #     * Bucket [String] Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'.
+        #     * Prefix [String] Optional prefix for log filenames, ie 'myprefix/'.
         #
-        # ==== Returns
-        # * response<~Excon::Response>:
-        #   * body<~Hash>:
-        #     * 'Id'<~String> - Id of distribution
-        #     * 'Status'<~String> - Status of distribution
-        #     * 'LastModifiedTime'<~String> - Timestamp of last modification of distribution
-        #     * 'DomainName'<~String>: Domain name of distribution
-        #     * 'StreamingDistributionConfig'<~Array>:
-        #       * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #       * 'CNAME'<~Array> - array of associated cnames
-        #       * 'Comment'<~String> - comment associated with distribution
-        #       * 'Enabled'<~Boolean> - whether or not distribution is enabled
-        #       * 'Logging'<~Hash>:
-        #         * 'Bucket'<~String> - bucket logs are stored in
-        #         * 'Prefix'<~String> - prefix logs are stored with
+        # @return [Excon::Response]
+        #   * body[Hash]:
+        #     * Id [String] - Id of distribution.
+        #     * Status'[String] - Status of distribution.
+        #     * LastModifiedTime [String] - Timestamp of last modification of distribution.
+        #     * DomainName [String] - Domain name of distribution.
+        #     * StreamingDistributionConfig [Array]:
+        #       * CallerReference [String] - Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #       * CNAME [Array] - Array of associated cnames.
+        #       * Comment [String] - Comment associated with distribution.
+        #       * Enabled [Boolean] - Whether or not distribution is enabled.
+        #       * Logging [Hash]:
+        #         * Bucket [String] - Bucket logs are stored in.
+        #         * Prefix [String] - Prefix logs are stored with.
         #
-        # ==== See Also
-        # http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateStreamingDistribution.html
-
+        # @see http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateStreamingDistribution.html
+        
         def post_streaming_distribution(options = {})
           options['CallerReference'] = Time.now.to_i.to_s
           data = '<?xml version="1.0" encoding="UTF-8"?>'

data/lib/fog/aws/requests/cdn/put_distribution_config.rb

@@ -5,55 +5,53 @@ module Fog
 
         require 'fog/aws/parsers/cdn/distribution'
 
-        # update a distribution in CloudFront
+        # Update a distribution in CloudFront.
         #
-        # ==== Parameters
-        # * distribution_id<~String> - Id of distribution to update config for
-        # * options<~Hash> - config for distribution.  Defaults to {}.
+        # @parm distribution_id [String] Id of distribution to update config for.
+        # @param options [Hash] Config for distribution.
+        # 
         #   REQUIRED:
-        #   * 'S3Origin'<~Hash>:
-        #     * 'DNSName'<~String> - origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'
-        #     * 'OriginAccessIdentity'<~String> - Optional: Used when serving private content
+        #   * S3Origin [Hash]:
+        #     * DNSName [String] - origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'.
+        #     * OriginAccessIdentity [String] - Optional: Used when serving private content.
         #   or
-        #   * 'CustomOrigin'<~Hash>:
-        #     * 'DNSName'<~String> - origin to associate with distribution, ie 'www.example.com'
-        #     * 'HTTPPort'<~Integer> - HTTP port of origin, in [80, 443] or (1024...65535)
-        #     * 'HTTPSPort'<~Integer> - HTTPS port of origin, in [80, 443] or (1024...65535)
-        #     * 'OriginProtocolPolicy'<~String> - Policy on using http vs https, in ['http-only', 'match-viewer']
+        #   * CustomOrigin [Hash]:
+        #     * DNSName [String] - Origin to associate with distribution, ie 'www.example.com'.
+        #     * HTTPPort [Integer] - HTTP port of origin, in [80, 443] or (1024...65535).
+        #     * HTTPSPort [Integer] - HTTPS port of origin, in [80, 443] or (1024...65535).
+        #     * OriginProtocolPolicy [String] - Policy on using http vs https, in ['http-only', 'match-viewer'].
         #   OPTIONAL:
-        #   * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #   * 'Comment'<~String> - Optional comment about distribution
-        #   * 'CNAME'<~Array> - Optional array of strings to set as CNAMEs
-        #   * 'DefaultRootObject'<~String> - Optional default object to return for '/'
-        #   * 'Enabled'<~Boolean> - Whether or not distribution should accept requests, defaults to true
-        #   * 'Logging'<~Hash>: Optional logging config
-        #     * 'Bucket'<~String> - Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'
-        #     * 'Prefix'<~String> - Optional prefix for log filenames, ie 'myprefix/'
-        #   * 'OriginAccessIdentity'<~String> - Used for serving private content, in format 'origin-access-identity/cloudfront/ID'
-        #   * 'RequiredProtocols'<~String> - Optional, set to 'https' to force https connections
-        #   * 'TrustedSigners'<~Array> - Optional grant of rights to up to 5 aws accounts to generate signed URLs for private content, elements are either 'Self' for your own account or an AWS Account Number
+        #   * CallerReference [String] Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #   * Comment [String] Optional comment about distribution.
+        #   * CNAME [Array] Optional array of strings to set as CNAMEs.
+        #   * DefaultRootObject [String] Optional default object to return for '/'.
+        #   * Enabled [Boolean] Whether or not distribution should accept requests, defaults to true.
+        #   * Logging [Hash]: Optional logging config.
+        #     * Bucket [String] Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'.
+        #     * Prefix [String] Optional prefix for log filenames, ie 'myprefix/'.
+        #   * OriginAccessIdentity [String] Used for serving private content, in format 'origin-access-identity/cloudfront/ID'.
+        #   * RequiredProtocols [String] Optional, set to 'https' to force https connections.
+        #   * TrustedSigners [Array] Optional grant of rights to up to 5 aws accounts to generate signed URLs for private content, elements are either 'Self' for your own account or an AWS Account Number.
         #
-        # ==== Returns
-        # * response<~Excon::Response>:
-        #   * body<~Hash>:
-        #     * 'DomainName'<~String>: Domain name of distribution
-        #     * 'Id'<~String> - Id of distribution
-        #     * 'LastModifiedTime'<~String> - Timestamp of last modification of distribution
-        #     * 'Status'<~String> - Status of distribution
-        #     * 'DistributionConfig'<~Array>:
-        #       * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #       * 'CNAME'<~Array> - array of associated cnames
-        #       * 'Comment'<~String> - comment associated with distribution
-        #       * 'Enabled'<~Boolean> - whether or not distribution is enabled
-        #       * 'Logging'<~Hash>:
-        #         * 'Bucket'<~String> - bucket logs are stored in
-        #         * 'Prefix'<~String> - prefix logs are stored with
-        #       * 'Origin'<~String> - s3 origin bucket
-        #       * 'TrustedSigners'<~Array> - trusted signers
+        # @return [Excon::Response]
+        #   * body [Hash]:
+        #     * DomainName [String]: Domain name of distribution.
+        #     * Id [String] - Id of distribution.
+        #     * LastModifiedTime [String] - Timestamp of last modification of distribution.
+        #     * Status [String] - Status of distribution.
+        #     * DistributionConfig [Array]:
+        #       * CallerReference [String] - Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #       * CNAME [Array] - Array of associated cnames.
+        #       * Comment [String] - Comment associated with distribution.
+        #       * Enabled [Boolean] - Whether or not distribution is enabled.
+        #       * Logging [Hash]:
+        #         * Bucket [String] - Bucket logs are stored in.
+        #         * Prefix [String] - Prefix logs are stored with.
+        #       * Origin [String] - S3 origin bucket.
+        #       * TrustedSigners [Array] - Trusted signers.
         #
-        # ==== See Also
-        # http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateDistribution.html
-
+        # @see http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/CreateDistribution.html
+        
         def put_distribution_config(distribution_id, etag, options = {})
           data = '<?xml version="1.0" encoding="UTF-8"?>'
           data << "<DistributionConfig xmlns=\"http://cloudfront.amazonaws.com/doc/#{@version}/\">"

data/lib/fog/aws/requests/cdn/put_streaming_distribution_config.rb

@@ -5,44 +5,42 @@ module Fog
 
         require 'fog/aws/parsers/cdn/streaming_distribution'
 
-        # update a streaming distribution in CloudFront
+        # Update a streaming distribution in CloudFront.
         #
-        # ==== Parameters
-        # * distribution_id<~String> - Id of distribution to update config for
-        # * options<~Hash> - config for distribution.  Defaults to {}.
+        # @param distribution_id [String] - Id of distribution to update config for.
+        # @param options [Hash] - Config for distribution.
+        # 
         #   REQUIRED:
-        #   * 'S3Origin'<~Hash>:
-        #     * 'DNSName'<~String> - origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'
+        #   * S3Origin [Hash]:
+        #     * DNSName [String] Origin to associate with distribution, ie 'mybucket.s3.amazonaws.com'.
         #   OPTIONAL:
-        #   * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #   * 'Comment'<~String> - Optional comment about distribution
-        #   * 'CNAME'<~Array> - Optional array of strings to set as CNAMEs
-        #   * 'Enabled'<~Boolean> - Whether or not distribution should accept requests, defaults to true
-        #   * 'Logging'<~Hash>: Optional logging config
-        #     * 'Bucket'<~String> - Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'
-        #     * 'Prefix'<~String> - Optional prefix for log filenames, ie 'myprefix/'
+        # @option options CallerReference [String] Used to prevent replay, defaults to Time.now.to_i.to_s
+        # @option options Comment [String] Optional comment about distribution
+        # @option options CNAME [Array] Optional array of strings to set as CNAMEs
+        # @option options Enabled [Boolean] Whether or not distribution should accept requests, defaults to true
+        # @option options Logging [Hash]: Optional logging config
+        #   * Bucket [String] Bucket to store logs in, ie 'mylogs.s3.amazonaws.com'
+        #   * Prefix String] Optional prefix for log filenames, ie 'myprefix/'
         #
-        # ==== Returns
-        # * response<~Excon::Response>:
-        #   * body<~Hash>:
-        #     * 'DomainName'<~String>: Domain name of distribution
-        #     * 'Id'<~String> - Id of distribution
-        #     * 'LastModifiedTime'<~String> - Timestamp of last modification of distribution
-        #     * 'Status'<~String> - Status of distribution
-        #     * 'StreamingDistributionConfig'<~Array>:
-        #       * 'CallerReference'<~String> - Used to prevent replay, defaults to Time.now.to_i.to_s
-        #       * 'CNAME'<~Array> - array of associated cnames
-        #       * 'Comment'<~String> - comment associated with distribution
-        #       * 'Enabled'<~Boolean> - whether or not distribution is enabled
-        #       * 'Logging'<~Hash>:
-        #         * 'Bucket'<~String> - bucket logs are stored in
-        #         * 'Prefix'<~String> - prefix logs are stored with
-        #       * 'Origin'<~String> - s3 origin bucket
-        #       * 'TrustedSigners'<~Array> - trusted signers
+        # @return [Excon::Response]
+        #   * body [Hash]:
+        #     * DomainName [String] - Domain name of distribution.
+        #     * Id [String] - Id of distribution.
+        #     * LastModifiedTime [String] - Timestamp of last modification of distribution.
+        #     * Status [String] - Status of distribution.
+        #     * StreamingDistributionConfig [Array]:
+        #       * CallerReference [String] - Used to prevent replay, defaults to Time.now.to_i.to_s.
+        #       * CNAME [Array] - Array of associated cnames.
+        #       * Comment [String] - Comment associated with distribution.
+        #       * Enabled [Boolean] - Whether or not distribution is enabled.
+        #       * Logging [Hash]:
+        #         * Bucket [String] - Bucket logs are stored in.
+        #         * Prefix [String] - Prefix logs are stored with.
+        #       * Origin [String] - S3 origin bucket.
+        #       * TrustedSigners [Array] - Trusted signers.
         #
-        # ==== See Also
-        # http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/PutStreamingDistribution.html
-
+        # @see http://docs.amazonwebservices.com/AmazonCloudFront/latest/APIReference/PutStreamingDistribution.html
+        
         def put_streaming_distribution_config(distribution_id, etag, options = {})
           data = '<?xml version="1.0" encoding="UTF-8"?>'
           data << "<StreamingDistributionConfig xmlns=\"http://cloudfront.amazonaws.com/doc/#{@version}/\">"