groupdocs_conversion_cloud 25.3 → 25.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c761ea9eead21060dd8262678a420a731fb0b2efd16ad73a89b2e1bbc6a9b8ab
-  data.tar.gz: 26dd999d3d107e12ec2b6f227ae3d8a7566030f35ecfad716272d811556664bd
+  metadata.gz: 645be37f44377ac287345c3956a3da7945bb7e6b6260f374731604ac4aceb635
+  data.tar.gz: f2a8aba7d205d0d7eb83a42f43b738f28fbfd350bd15be8f4b7860a2e5719d29
 SHA512:
-  metadata.gz: 0a61128103138b416204248cdde150044a11568769f186c3699dcfd5cbd3a3116a422615675d77692d2fd6276362506ff2ee43dcbfeb0771e7a7ceb57c684000
-  data.tar.gz: d1e08a68f8c63db97260b74be8e4eb34bc3b0e1a4fb1121b922937db19f534ffeaff0fb59d889cffa3e0f64ead68690a904458f663c647330195de9032103e16
+  metadata.gz: 4416d35931324dd36204b593747dddec626758787fb87f16870efb83d510b04d1812f8fb8df49bc37f3890546bc6f35f6c21a04682ccb7794222c8eb59c16b1f
+  data.tar.gz: '0094040627a33ca0b7c0aaf80b278eae56fb0b8471b1566dfc26378403aaedda0b562d3cbdc23345a0c7fa7a52d1f8b2841ffc72802aff79ab2d8a7ec9aa7083'

data/lib/groupdocs_conversion_cloud/models/consumption_result.rb

@@ -37,11 +37,15 @@ module GroupDocsConversionCloud
     # Amount of MBs processed
     attr_accessor :quantity
 
+    # Billed API calls number
+    attr_accessor :billed_api_calls
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'credit' => :'Credit',
-        :'quantity' => :'Quantity'
+        :'quantity' => :'Quantity',
+        :'billed_api_calls' => :'BilledApiCalls'
       }
     end
 
@@ -49,7 +53,8 @@ module GroupDocsConversionCloud
     def self.swagger_types
       {
         :'credit' => :'Float',
-        :'quantity' => :'Float'
+        :'quantity' => :'Float',
+        :'billed_api_calls' => :'Float'
       }
     end
 
@@ -69,6 +74,10 @@ module GroupDocsConversionCloud
         self.quantity = attributes[:'Quantity']
       end
 
+      if attributes.key?(:'BilledApiCalls')
+        self.billed_api_calls = attributes[:'BilledApiCalls']
+      end
+
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -83,6 +92,10 @@ module GroupDocsConversionCloud
         invalid_properties.push("invalid value for 'quantity', quantity cannot be nil.")
       end
 
+      if @billed_api_calls.nil?
+        invalid_properties.push("invalid value for 'billed_api_calls', billed_api_calls cannot be nil.")
+      end
+
       return invalid_properties
     end
 
@@ -91,6 +104,7 @@ module GroupDocsConversionCloud
     def valid?
       return false if @credit.nil?
       return false if @quantity.nil?
+      return false if @billed_api_calls.nil?
       return true
     end
 
@@ -100,7 +114,8 @@ module GroupDocsConversionCloud
       return true if self.equal?(other)
       self.class == other.class &&
           credit == other.credit &&
-          quantity == other.quantity
+          quantity == other.quantity &&
+          billed_api_calls == other.billed_api_calls
     end
 
     # @see the `==` method
@@ -112,7 +127,7 @@ module GroupDocsConversionCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [credit, quantity].hash
+      [credit, quantity, billed_api_calls].hash
     end
 
     # Downcases first letter.

data/lib/groupdocs_conversion_cloud/models/csv_load_options.rb

@@ -58,8 +58,8 @@ module GroupDocsConversionCloud
     # Set password to unprotect protected document
     attr_accessor :password
 
-    # Hide comments
-    attr_accessor :hide_comments
+    # Represents the way comments are printed with the sheet. Default is PrintNoComments.
+    attr_accessor :print_comments
 
     # Delimiter of a Csv file
     attr_accessor :separator
@@ -78,6 +78,27 @@ module GroupDocsConversionCloud
 
     # File encoding
     attr_accessor :encoding
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
@@ -91,7 +112,7 @@ module GroupDocsConversionCloud
         :'convert_range' => :'ConvertRange',
         :'skip_empty_rows_and_columns' => :'SkipEmptyRowsAndColumns',
         :'password' => :'Password',
-        :'hide_comments' => :'HideComments',
+        :'print_comments' => :'PrintComments',
         :'separator' => :'Separator',
         :'is_multi_encoded' => :'IsMultiEncoded',
         :'has_formula' => :'HasFormula',
@@ -113,7 +134,7 @@ module GroupDocsConversionCloud
         :'convert_range' => :'String',
         :'skip_empty_rows_and_columns' => :'BOOLEAN',
         :'password' => :'String',
-        :'hide_comments' => :'BOOLEAN',
+        :'print_comments' => :'String',
         :'separator' => :'String',
         :'is_multi_encoded' => :'BOOLEAN',
         :'has_formula' => :'BOOLEAN',
@@ -169,8 +190,8 @@ module GroupDocsConversionCloud
         self.password = attributes[:'Password']
       end
 
-      if attributes.key?(:'HideComments')
-        self.hide_comments = attributes[:'HideComments']
+      if attributes.key?(:'PrintComments')
+        self.print_comments = attributes[:'PrintComments']
       end
 
       if attributes.key?(:'Separator')
@@ -219,8 +240,8 @@ module GroupDocsConversionCloud
         invalid_properties.push("invalid value for 'skip_empty_rows_and_columns', skip_empty_rows_and_columns cannot be nil.")
       end
 
-      if @hide_comments.nil?
-        invalid_properties.push("invalid value for 'hide_comments', hide_comments cannot be nil.")
+      if @print_comments.nil?
+        invalid_properties.push("invalid value for 'print_comments', print_comments cannot be nil.")
       end
 
       if @separator.nil?
@@ -253,7 +274,9 @@ module GroupDocsConversionCloud
       return false if @show_hidden_sheets.nil?
       return false if @one_page_per_sheet.nil?
       return false if @skip_empty_rows_and_columns.nil?
-      return false if @hide_comments.nil?
+      return false if @print_comments.nil?
+      print_comments_validator = EnumAttributeValidator.new('String', ["PrintInPlace", "PrintNoComments", "PrintSheetEnd", "PrintWithThreadedComments"])
+      return false unless print_comments_validator.valid?(@print_comments)
       return false if @separator.nil?
       return false if @is_multi_encoded.nil?
       return false if @has_formula.nil?
@@ -262,6 +285,20 @@ module GroupDocsConversionCloud
       return true
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] print_comments Object to be assigned
+    def print_comments=(print_comments)
+      validator = EnumAttributeValidator.new('String', ["PrintInPlace", "PrintNoComments", "PrintSheetEnd", "PrintWithThreadedComments"])
+      if print_comments.to_i == 0
+        unless validator.valid?(print_comments)
+          raise ArgumentError, "invalid value for 'print_comments', must be one of #{validator.allowable_values}."
+        end
+        @print_comments = print_comments
+      else
+        @print_comments = validator.allowable_values[print_comments.to_i]
+      end
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(other)
@@ -276,7 +313,7 @@ module GroupDocsConversionCloud
           convert_range == other.convert_range &&
           skip_empty_rows_and_columns == other.skip_empty_rows_and_columns &&
           password == other.password &&
-          hide_comments == other.hide_comments &&
+          print_comments == other.print_comments &&
           separator == other.separator &&
           is_multi_encoded == other.is_multi_encoded &&
           has_formula == other.has_formula &&
@@ -294,7 +331,7 @@ module GroupDocsConversionCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [format, default_font, font_substitutes, show_grid_lines, show_hidden_sheets, one_page_per_sheet, convert_range, skip_empty_rows_and_columns, password, hide_comments, separator, is_multi_encoded, has_formula, convert_numeric_data, convert_date_time_data, encoding].hash
+      [format, default_font, font_substitutes, show_grid_lines, show_hidden_sheets, one_page_per_sheet, convert_range, skip_empty_rows_and_columns, password, print_comments, separator, is_multi_encoded, has_formula, convert_numeric_data, convert_date_time_data, encoding].hash
     end
 
     # Downcases first letter.

data/lib/groupdocs_conversion_cloud/models/odp_load_options.rb

@@ -34,6 +34,27 @@ module GroupDocsConversionCloud
     # The format of input file, (\"docx\", for example). This field must be filled with correct input file format when using ConvertDirect method, which accept input file as binary stream, and, because of that, API can correctly handle LoadOptions. In regular conversion, the input file format taken from the input file name and this field ignored.
     attr_accessor :format
 
+    # Determines whether the document structure should be preserved when converting     to PDF (default is false).
+    attr_accessor :preserve_document_structure
+
+    # Value indicating whether custom document properties should be cleared.
+    attr_accessor :clear_custom_document_properties
+
+    # Value indicating whether built in document properties should be cleared.
+    attr_accessor :clear_built_in_document_properties
+
+    # Implements GroupDocs.Conversion.Contracts.IDocumentsContainerLoadOptions.Depth     Default: 1
+    attr_accessor :depth
+
+    # Implements GroupDocs.Conversion.Contracts.IDocumentsContainerLoadOptions.ConvertOwned     Default is false
+    attr_accessor :convert_owned
+
+    # Implements GroupDocs.Conversion.Contracts.IDocumentsContainerLoadOptions.ConvertOwner     Default is true
+    attr_accessor :convert_owner
+
+    # Show hidden slides.
+    attr_accessor :show_hidden_slides
+
     # Default font for rendering the presentation. The following font will be used if a presentation font is missing.
     attr_accessor :default_font
 
@@ -43,21 +64,49 @@ module GroupDocsConversionCloud
     # Set password to unprotect protected document
     attr_accessor :password
 
-    # Hide comments
-    attr_accessor :hide_comments
+    # Represents the way comments are printed with the slide. Default is None.
+    attr_accessor :comments_position
+
+    # Represents the way notes are printed with the slide. Default is None.
+    attr_accessor :notes_position
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
 
-    # Show hidden slides
-    attr_accessor :show_hidden_slides
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'format' => :'Format',
+        :'preserve_document_structure' => :'PreserveDocumentStructure',
+        :'clear_custom_document_properties' => :'ClearCustomDocumentProperties',
+        :'clear_built_in_document_properties' => :'ClearBuiltInDocumentProperties',
+        :'depth' => :'Depth',
+        :'convert_owned' => :'ConvertOwned',
+        :'convert_owner' => :'ConvertOwner',
+        :'show_hidden_slides' => :'ShowHiddenSlides',
         :'default_font' => :'DefaultFont',
         :'font_substitutes' => :'FontSubstitutes',
         :'password' => :'Password',
-        :'hide_comments' => :'HideComments',
-        :'show_hidden_slides' => :'ShowHiddenSlides'
+        :'comments_position' => :'CommentsPosition',
+        :'notes_position' => :'NotesPosition'
       }
     end
 
@@ -65,11 +114,18 @@ module GroupDocsConversionCloud
     def self.swagger_types
       {
         :'format' => :'String',
+        :'preserve_document_structure' => :'BOOLEAN',
+        :'clear_custom_document_properties' => :'BOOLEAN',
+        :'clear_built_in_document_properties' => :'BOOLEAN',
+        :'depth' => :'Integer',
+        :'convert_owned' => :'BOOLEAN',
+        :'convert_owner' => :'BOOLEAN',
+        :'show_hidden_slides' => :'BOOLEAN',
         :'default_font' => :'String',
         :'font_substitutes' => :'Hash<String, String>',
         :'password' => :'String',
-        :'hide_comments' => :'BOOLEAN',
-        :'show_hidden_slides' => :'BOOLEAN'
+        :'comments_position' => :'String',
+        :'notes_position' => :'String'
       }
     end
 
@@ -85,6 +141,34 @@ module GroupDocsConversionCloud
         self.format = attributes[:'Format']
       end
 
+      if attributes.key?(:'PreserveDocumentStructure')
+        self.preserve_document_structure = attributes[:'PreserveDocumentStructure']
+      end
+
+      if attributes.key?(:'ClearCustomDocumentProperties')
+        self.clear_custom_document_properties = attributes[:'ClearCustomDocumentProperties']
+      end
+
+      if attributes.key?(:'ClearBuiltInDocumentProperties')
+        self.clear_built_in_document_properties = attributes[:'ClearBuiltInDocumentProperties']
+      end
+
+      if attributes.key?(:'Depth')
+        self.depth = attributes[:'Depth']
+      end
+
+      if attributes.key?(:'ConvertOwned')
+        self.convert_owned = attributes[:'ConvertOwned']
+      end
+
+      if attributes.key?(:'ConvertOwner')
+        self.convert_owner = attributes[:'ConvertOwner']
+      end
+
+      if attributes.key?(:'ShowHiddenSlides')
+        self.show_hidden_slides = attributes[:'ShowHiddenSlides']
+      end
+
       if attributes.key?(:'DefaultFont')
         self.default_font = attributes[:'DefaultFont']
       end
@@ -99,12 +183,12 @@ module GroupDocsConversionCloud
         self.password = attributes[:'Password']
       end
 
-      if attributes.key?(:'HideComments')
-        self.hide_comments = attributes[:'HideComments']
+      if attributes.key?(:'CommentsPosition')
+        self.comments_position = attributes[:'CommentsPosition']
       end
 
-      if attributes.key?(:'ShowHiddenSlides')
-        self.show_hidden_slides = attributes[:'ShowHiddenSlides']
+      if attributes.key?(:'NotesPosition')
+        self.notes_position = attributes[:'NotesPosition']
       end
 
     end
@@ -113,36 +197,110 @@ module GroupDocsConversionCloud
     # @return Array for valid properies with the reasons
     def list_invalid_properties
       invalid_properties = []
-      if @hide_comments.nil?
-        invalid_properties.push("invalid value for 'hide_comments', hide_comments cannot be nil.")
+      if @preserve_document_structure.nil?
+        invalid_properties.push("invalid value for 'preserve_document_structure', preserve_document_structure cannot be nil.")
+      end
+
+      if @clear_custom_document_properties.nil?
+        invalid_properties.push("invalid value for 'clear_custom_document_properties', clear_custom_document_properties cannot be nil.")
+      end
+
+      if @clear_built_in_document_properties.nil?
+        invalid_properties.push("invalid value for 'clear_built_in_document_properties', clear_built_in_document_properties cannot be nil.")
+      end
+
+      if @depth.nil?
+        invalid_properties.push("invalid value for 'depth', depth cannot be nil.")
+      end
+
+      if @convert_owned.nil?
+        invalid_properties.push("invalid value for 'convert_owned', convert_owned cannot be nil.")
+      end
+
+      if @convert_owner.nil?
+        invalid_properties.push("invalid value for 'convert_owner', convert_owner cannot be nil.")
       end
 
       if @show_hidden_slides.nil?
         invalid_properties.push("invalid value for 'show_hidden_slides', show_hidden_slides cannot be nil.")
       end
 
+      if @comments_position.nil?
+        invalid_properties.push("invalid value for 'comments_position', comments_position cannot be nil.")
+      end
+
+      if @notes_position.nil?
+        invalid_properties.push("invalid value for 'notes_position', notes_position cannot be nil.")
+      end
+
       return invalid_properties
     end
 
     # Check to see if the all the properties in the model are valid
     # @return true if the model is valid
     def valid?
-      return false if @hide_comments.nil?
+      return false if @preserve_document_structure.nil?
+      return false if @clear_custom_document_properties.nil?
+      return false if @clear_built_in_document_properties.nil?
+      return false if @depth.nil?
+      return false if @convert_owned.nil?
+      return false if @convert_owner.nil?
       return false if @show_hidden_slides.nil?
+      return false if @comments_position.nil?
+      comments_position_validator = EnumAttributeValidator.new('String', ["None", "Bottom", "Right"])
+      return false unless comments_position_validator.valid?(@comments_position)
+      return false if @notes_position.nil?
+      notes_position_validator = EnumAttributeValidator.new('String', ["None", "BottomTruncated", "BottomFull"])
+      return false unless notes_position_validator.valid?(@notes_position)
       return true
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] comments_position Object to be assigned
+    def comments_position=(comments_position)
+      validator = EnumAttributeValidator.new('String', ["None", "Bottom", "Right"])
+      if comments_position.to_i == 0
+        unless validator.valid?(comments_position)
+          raise ArgumentError, "invalid value for 'comments_position', must be one of #{validator.allowable_values}."
+        end
+        @comments_position = comments_position
+      else
+        @comments_position = validator.allowable_values[comments_position.to_i]
+      end
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] notes_position Object to be assigned
+    def notes_position=(notes_position)
+      validator = EnumAttributeValidator.new('String', ["None", "BottomTruncated", "BottomFull"])
+      if notes_position.to_i == 0
+        unless validator.valid?(notes_position)
+          raise ArgumentError, "invalid value for 'notes_position', must be one of #{validator.allowable_values}."
+        end
+        @notes_position = notes_position
+      else
+        @notes_position = validator.allowable_values[notes_position.to_i]
+      end
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(other)
       return true if self.equal?(other)
       self.class == other.class &&
           format == other.format &&
+          preserve_document_structure == other.preserve_document_structure &&
+          clear_custom_document_properties == other.clear_custom_document_properties &&
+          clear_built_in_document_properties == other.clear_built_in_document_properties &&
+          depth == other.depth &&
+          convert_owned == other.convert_owned &&
+          convert_owner == other.convert_owner &&
+          show_hidden_slides == other.show_hidden_slides &&
           default_font == other.default_font &&
           font_substitutes == other.font_substitutes &&
           password == other.password &&
-          hide_comments == other.hide_comments &&
-          show_hidden_slides == other.show_hidden_slides
+          comments_position == other.comments_position &&
+          notes_position == other.notes_position
     end
 
     # @see the `==` method
@@ -154,7 +312,7 @@ module GroupDocsConversionCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [format, default_font, font_substitutes, password, hide_comments, show_hidden_slides].hash
+      [format, preserve_document_structure, clear_custom_document_properties, clear_built_in_document_properties, depth, convert_owned, convert_owner, show_hidden_slides, default_font, font_substitutes, password, comments_position, notes_position].hash
     end
 
     # Downcases first letter.

data/lib/groupdocs_conversion_cloud/models/ods_load_options.rb

@@ -58,8 +58,29 @@ module GroupDocsConversionCloud
     # Set password to unprotect protected document
     attr_accessor :password
 
-    # Hide comments
-    attr_accessor :hide_comments
+    # Represents the way comments are printed with the sheet. Default is PrintNoComments.
+    attr_accessor :print_comments
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
@@ -73,7 +94,7 @@ module GroupDocsConversionCloud
         :'convert_range' => :'ConvertRange',
         :'skip_empty_rows_and_columns' => :'SkipEmptyRowsAndColumns',
         :'password' => :'Password',
-        :'hide_comments' => :'HideComments'
+        :'print_comments' => :'PrintComments'
       }
     end
 
@@ -89,7 +110,7 @@ module GroupDocsConversionCloud
         :'convert_range' => :'String',
         :'skip_empty_rows_and_columns' => :'BOOLEAN',
         :'password' => :'String',
-        :'hide_comments' => :'BOOLEAN'
+        :'print_comments' => :'String'
       }
     end
 
@@ -139,8 +160,8 @@ module GroupDocsConversionCloud
         self.password = attributes[:'Password']
       end
 
-      if attributes.key?(:'HideComments')
-        self.hide_comments = attributes[:'HideComments']
+      if attributes.key?(:'PrintComments')
+        self.print_comments = attributes[:'PrintComments']
       end
 
     end
@@ -165,8 +186,8 @@ module GroupDocsConversionCloud
         invalid_properties.push("invalid value for 'skip_empty_rows_and_columns', skip_empty_rows_and_columns cannot be nil.")
       end
 
-      if @hide_comments.nil?
-        invalid_properties.push("invalid value for 'hide_comments', hide_comments cannot be nil.")
+      if @print_comments.nil?
+        invalid_properties.push("invalid value for 'print_comments', print_comments cannot be nil.")
       end
 
       return invalid_properties
@@ -179,10 +200,26 @@ module GroupDocsConversionCloud
       return false if @show_hidden_sheets.nil?
       return false if @one_page_per_sheet.nil?
       return false if @skip_empty_rows_and_columns.nil?
-      return false if @hide_comments.nil?
+      return false if @print_comments.nil?
+      print_comments_validator = EnumAttributeValidator.new('String', ["PrintInPlace", "PrintNoComments", "PrintSheetEnd", "PrintWithThreadedComments"])
+      return false unless print_comments_validator.valid?(@print_comments)
       return true
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] print_comments Object to be assigned
+    def print_comments=(print_comments)
+      validator = EnumAttributeValidator.new('String', ["PrintInPlace", "PrintNoComments", "PrintSheetEnd", "PrintWithThreadedComments"])
+      if print_comments.to_i == 0
+        unless validator.valid?(print_comments)
+          raise ArgumentError, "invalid value for 'print_comments', must be one of #{validator.allowable_values}."
+        end
+        @print_comments = print_comments
+      else
+        @print_comments = validator.allowable_values[print_comments.to_i]
+      end
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(other)
@@ -197,7 +234,7 @@ module GroupDocsConversionCloud
           convert_range == other.convert_range &&
           skip_empty_rows_and_columns == other.skip_empty_rows_and_columns &&
           password == other.password &&
-          hide_comments == other.hide_comments
+          print_comments == other.print_comments
     end
 
     # @see the `==` method
@@ -209,7 +246,7 @@ module GroupDocsConversionCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [format, default_font, font_substitutes, show_grid_lines, show_hidden_sheets, one_page_per_sheet, convert_range, skip_empty_rows_and_columns, password, hide_comments].hash
+      [format, default_font, font_substitutes, show_grid_lines, show_hidden_sheets, one_page_per_sheet, convert_range, skip_empty_rows_and_columns, password, print_comments].hash
     end
 
     # Downcases first letter.