rubyXL 3.3.15 → 3.3.16

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cbf354d127afcb15c81218739d5a092b8bb41de7
+  data.tar.gz: 504efe47d0b6bd8ec35965fda0db5fdab339c3e5
+SHA512:
+  metadata.gz: 1ce62590ad386c957c8e68db937b5702fc8aab86a0536414b6134f3c73d2b7db03c8426bb0fd43b77b6da9f6eb46405f798f1f8906bdcb609c7fa823a89b99df
+  data.tar.gz: 5f7c1c4ccca984714f663c79e9485db4e1d98aa49ee637168aa79fe0e2dc74351ae491bfd7ba777a16f78861f8eda6fac398f5de44f9e206d5a644c9f8d3d1d7

data/Gemfile

@@ -5,12 +5,12 @@ gem "nokogiri", ">= 1.4.4"
 gem "rubyzip", ">= 1.1.6" , :require => 'zip'
 
 # Development dependencies.
-group :development do
+group :development, :test do
   gem "bundler"
   gem "rake"
   gem "jeweler"
-#  gem "simplecov", ">= 0"
-  gem "rspec", ">= 1.3.4"
+  gem "rspec"
+  gem "simplecov"
 
 #  gem 'stackprof'
   gem 'ruby-prof'

data/README.rdoc

@@ -29,11 +29,15 @@ Please note that proprietary binary +xls+ format is *not* supported.
   workbook['Sheet1']     # Finds and returns worksheet titled "Sheet1"
 
 ==== Accessing a Row (Array of Cells)
+Please note that worksheets are sparse collections. Your code *must* expect that any row it encounters may be `nil`.
+
   worksheet = workbook[0]
   worksheet.sheet_data[0] # Returns first row of the worksheet
   worksheet[0]            # Returns first row of the worksheet
 
 ==== Accessing a Cell object
+Please note that rows are sparse collections. Your code *must* expect that any cell it encounters may be `nil`.
+
   worksheet = workbook[0]
   worksheet.sheet_data[0][0] # Returns cell A1 in the worksheet
   worksheet[0][0]            # Returns cell A1 in the worksheet
@@ -47,7 +51,7 @@ Please note that proprietary binary +xls+ format is *not* supported.
   cell.fill_color
   cell.horizontal_alignment
   cell.vertical_alignment
-  cell.border_top
+  cell.get_border(:top)
 
 ==== Wrappers for accessing Row properties 
 Please note: these methods are being phased out in favor of the OOXML object model.

data/Rakefile

@@ -1,7 +1,7 @@
 # encoding: utf-8
 require 'rubygems'
-require 'bundler'
 
+require 'bundler'
 begin
   Bundler.setup(:default, :development)
 rescue Bundler::BundlerError => e
@@ -9,7 +9,6 @@ rescue Bundler::BundlerError => e
   $stderr.puts "Run `bundle install` to install missing gems"
   exit e.status_code
 end
-require 'rake'
 
 require 'jeweler'
 Jeweler::Tasks.new do |gem|
@@ -30,18 +29,9 @@ Rake::TestTask.new(:test) do |test|
   test.libs << 'lib' << 'test'
   test.pattern = 'test/**/test_*.rb'
   test.verbose = true
+  test.warning = true
 end
 
-=begin
-require 'rcov/rcovtask'
-Rcov::RcovTask.new do |test|
-  test.libs << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
-  test.rcov_opts << '--exclude "gems/*"'
-end
-=end
-
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new(:spec)
 task :default => :spec
@@ -56,8 +46,8 @@ Rake::RDocTask.new do |rdoc|
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
 
-desc "Dump profiling data"
-task :profile do
+desc "Dump profiling data with stackprof"
+task :stackprof do
   require 'benchmark'
   require 'stackprof'
 
@@ -83,8 +73,8 @@ task :profile do
   }
 end
 
-desc "Dump profiling data 2"
-task :prof do
+desc "Dump profiling data with ruby-prof"
+task :rubyprof do
   require 'benchmark'
   require 'ruby-prof'
 

data/VERSION

@@ -1 +1 @@
-3.3.15
+3.3.16

data/lib/rubyXL/convenience_methods.rb

@@ -1,4 +1,5 @@
 module RubyXL
+
   module WorkbookConvenienceMethods
     SHEET_NAME_TEMPLATE = 'Sheet%d'
 
@@ -208,7 +209,7 @@ module RubyXL
         raise 'invalid shift option'
       end
 
-      return add_cell(row,col,data,formula)
+      return add_cell(row, col, data, formula)
     end
 
     # by default, only sets cell to nil
@@ -324,13 +325,13 @@ module RubyXL
       validate_workbook
       validate_nonnegative(column_index)
 
-      #delete column
+      # Delete column
       sheet_data.rows.each { |row| row.cells.delete_at(column_index) }
 
-      # Change column numbers for cells to the right of the deleted column
+      # Update column numbers for cells to the right of the deleted column
       sheet_data.rows.each_with_index { |row, row_index|
-        row.cells.each_with_index { |c, column_index|
-          c.column = column_index if c.is_a?(Cell)
+        row.cells.each_with_index { |c, ci|
+          c.column = ci if c.is_a?(Cell)
         }
       }
 
@@ -380,7 +381,7 @@ module RubyXL
       validate_workbook
       validate_nonnegative(row)
       row = sheet_data.rows[row]
-      row && row.ht || 13
+      row && row.ht || RubyXL::Row::DEFAULT_HEIGHT
     end
 
     def get_row_border(row, border_direction)
@@ -473,6 +474,21 @@ module RubyXL
       (width - (5.0 / RubyXL::Font::MAX_DIGIT_WIDTH)).round
     end
 
+    # Set raw column width value
+    def change_column_width_raw(column_index, width)
+      validate_workbook
+      ensure_cell_exists(0, column_index)
+      range = cols.get_range(column_index)
+      range.width = width
+      range.custom_width = true
+    end
+
+    # Get column width measured in number of digits, as per
+    # http://msdn.microsoft.com/en-us/library/documentformat.openxml.spreadsheet.column%28v=office.14%29.aspx
+    def change_column_width(column_index, width_in_chars = RubyXL::ColumnRange::DEFAULT_WIDTH)
+      change_column_width_raw(column_index, ((width_in_chars + (5.0 / RubyXL::Font::MAX_DIGIT_WIDTH)) * 256).to_i / 256.0)
+    end
+
     # Helper method to get the style index for a column
     def get_col_style(column_index)
       range = cols.locate_range(column_index)
@@ -486,6 +502,19 @@ module RubyXL
       @workbook.get_fill_color(get_col_xf(col))
     end
 
+    def change_column_fill(column_index, color_code = 'ffffff')
+      validate_workbook
+      RubyXL::Color.validate_color(color_code)
+      ensure_cell_exists(0, column_index)
+
+      cols.get_range(column_index).style_index = @workbook.modify_fill(get_col_style(column_index), color_code)
+
+      sheet_data.rows.each { |row|
+        c = row[column_index]
+        c.change_fill(color_code) if c
+      }
+    end
+
     def get_column_border(col, border_direction)
       validate_workbook
 
@@ -725,70 +754,16 @@ module RubyXL
       }
     end
 
-    # Returns 2D array of just the cell values (without style or formula information)
-    def extract_data(args = {})
-      warn "[DEPRECATION] `#{__method__}` is deprecated.  Please access data directly by iterating through .sheet_data.rows"
-      sheet_data.rows.map { |row|
-        row.cells.map { |c| c && c.value(args) } unless row.nil?
-      }
-    end
-
-    def get_table(headers = [], opts = {})
-      warn "[DEPRECATION] `#{__method__}` is deprecated.  Please access data directly by iterating through .sheet_data.rows"
+    # Merges cells within a rectangular area
+    def merge_cells(start_row, start_col, end_row, end_col)
       validate_workbook
 
-      headers = [headers] unless headers.is_a?(Array)
-      row_num = find_first_row_with_content(headers)
-      return nil if row_num.nil?
-
-      table_hash = {}
-      table_hash[:table] = []
-
-      header_row = sheet_data[row_num]
-      header_row.cells.each_with_index { |header_cell, index|
-        break if index>0 && !opts[:last_header].nil? && !header_row[index-1].nil? && !header_row[index-1].value.nil? && header_row[index-1].value.to_s==opts[:last_header]
-        next if header_cell.nil? || header_cell.value.nil?
-        header = header_cell.value.to_s
-        table_hash[:sorted_headers]||=[]
-        table_hash[:sorted_headers] << header
-        table_hash[header] = []
-
-        original_row = row_num + 1
-        current_row = original_row
-
-        row = sheet_data.rows[current_row]
-        cell = row && row.cells[index]
-
-        # makes array of hashes in table_hash[:table]
-        # as well as hash of arrays in table_hash[header]
-        table_index = current_row - original_row
-        cell_test = (!cell.nil? && !cell.value.nil?)
-
-        while cell_test || (table_hash[:table][table_index] && !table_hash[:table][table_index].empty?)
-          table_hash[header] << cell.value if cell_test
-          table_index = current_row - original_row
-
-          if cell_test then
-            table_hash[:table][table_index] ||= {}
-            table_hash[:table][table_index][header] = cell.value
-          end
-
-          current_row += 1
-          if sheet_data.rows[current_row].nil? then
-            cell = nil
-          else
-            cell = sheet_data.rows[current_row].cells[index]
-          end
-          cell_test = (!cell.nil? && !cell.value.nil?)
-        end
-      }
-
-      return table_hash
+      self.merged_cells ||= RubyXL::MergedCells.new
+      # TODO: add validation to make sure ranges are not intersecting with existing ones
+      merged_cells << RubyXL::MergedCell.new(:ref => RubyXL::Reference.new(start_row, end_row, start_col, end_col))
     end
-
   end
 
-
   module CellConvenienceMethods
 
     def change_contents(data, formula_expression = nil)

data/lib/rubyXL/objects/ooxml_object.rb

@@ -218,6 +218,8 @@ module RubyXL
     private :obtain_class_variable
 
     def initialize(params = {})
+      @local_namespaces = nil
+
       obtain_class_variable(:@@ooxml_attributes).each_value { |v|
         instance_variable_set("@#{v[:accessor]}", params[v[:accessor]]) unless v[:computed]
       }
@@ -300,7 +302,7 @@ module RubyXL
       elem = xml.create_element(node_name_override || obtain_class_variable(:@@ooxml_tag_name), attrs, element_text)
 
       if @local_namespaces.nil? || @local_namespaces.empty? then # If no local namespaces provided in the original document,
-        # use the defualts
+        # use the defaults
         obtain_class_variable(:@@ooxml_namespaces).each_pair { |k, v| elem.add_namespace_definition(v, k) }
       else # otherwise preserve the original ones
         @local_namespaces.each { |ns| elem.add_namespace_definition(ns.prefix, ns.href) }

data/lib/rubyXL/objects/sheet_data.rb

@@ -161,6 +161,8 @@ module RubyXL
     def get_font
       @worksheet.workbook.fonts[xf.font_id]
     end
+
+    DEFAULT_HEIGHT = 13
   end
 
   # http://www.schemacentral.com/sc/ooxml/e-ssml_sheetData-1.html

data/lib/rubyXL/objects/text.rb

@@ -24,7 +24,7 @@ module RubyXL
     end
 
     def to_s
-      value.to_s.gsub(ESCAPED_UNICODE) { |m| $1.hex.chr(Encoding::UTF_8) }
+      value.to_s.gsub(ESCAPED_UNICODE) { |m| $1.hex.chr(::Encoding::UTF_8) }
     end
   end
 

data/lib/rubyXL/worksheet.rb

@@ -23,59 +23,6 @@ module LegacyWorksheet
     sheet_data.rows.each { |row| yield(row) }
   end
 
-  # finds first row which contains at least all strings in cells_content
-  def find_first_row_with_content(cells_content)
-    validate_workbook
-
-    sheet_data.rows.each_with_index { |row, index|
-      next if row.nil?
-      cells_content = cells_content.map { |header| header.to_s.strip.downcase }
-      original_cells_content = row.cells.map { |cell| (cell && cell.value).to_s.strip.downcase }
-
-      if (cells_content & original_cells_content).size == cells_content.size
-        return index
-      end
-    }
-    return nil
-  end
-  private :find_first_row_with_content
-
-  # Set raw column width value
-  def change_column_width_raw(column_index, width)
-    validate_workbook
-    ensure_cell_exists(0, column_index)
-    range = cols.get_range(column_index)
-    range.width = width
-    range.custom_width = true
-  end
-
-  # Get column width measured in number of digits, as per
-  # http://msdn.microsoft.com/en-us/library/documentformat.openxml.spreadsheet.column%28v=office.14%29.aspx
-  def change_column_width(column_index, width_in_chars = RubyXL::ColumnRange::DEFAULT_WIDTH)
-    change_column_width_raw(column_index, ((width_in_chars + (5.0 / RubyXL::Font::MAX_DIGIT_WIDTH)) * 256).to_i / 256.0)
-  end
-
-  def change_column_fill(column_index, color_index='ffffff')
-    validate_workbook
-    Color.validate_color(color_index)
-    ensure_cell_exists(0, column_index)
-
-    cols.get_range(column_index).style_index = @workbook.modify_fill(get_col_style(column_index), color_index)
-
-    sheet_data.rows.each { |row|
-      c = row[column_index]
-      c.change_fill(color_index) if c
-    }
-  end
-
-  # merges cells within a rectangular range
-  def merge_cells(row1 = 0, col1 = 0, row2 = 0, col2 = 0)
-    validate_workbook
-
-    self.merged_cells ||= RubyXL::MergedCells.new
-    merged_cells << RubyXL::MergedCell.new(:ref => RubyXL::Reference.new(row1, row2, col1, col2))
-  end
-
   def add_row(row_index = 0, params = {})
     new_row = RubyXL::Row.new(params)
     new_row.worksheet = self
@@ -118,13 +65,13 @@ module LegacyWorksheet
     raise "This worksheet #{self} is not in workbook #{@workbook}"
   end
 
-  # Ensures that cell with +row_index+ and +column_index+ exists in
-  #  +sheet_data+ arrays, growing them up if necessary.
+  # Ensures that storage space for a cell with +row_index+ and +column_index+
+  # exists in +sheet_data+ arrays, growing them up if necessary.
   def ensure_cell_exists(row_index, column_index = 0)
     validate_nonnegative(row_index)
     validate_nonnegative(column_index)
 
-    row = sheet_data.rows[row_index] || add_row(row_index)
+    sheet_data.rows[row_index] || add_row(row_index)
   end  
 
   def get_col_xf(column_index)

data/rdoc/README_rdoc.html

@@ -4,7 +4,7 @@
 <head>
 <meta charset="UTF-8">
 
-<title>README - rubyXL 3.3.15</title>
+<title>README - rubyXL 3.3.16</title>
 
 <script type="text/javascript">
   var rdoc_rel_prefix = "./";
@@ -138,7 +138,7 @@ preserving as much of the structure as possible.</p>
 
 <h2 id="label-To+Use-3A">To Use:<span><a href="#label-To+Use-3A">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'rubyXL'</span> <span class="ruby-comment"># Assuming rubygems is already required</span>
+<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;rubyXL&#39;</span> <span class="ruby-comment"># Assuming rubygems is already required</span>
 </pre>
 
 <h3 id="label-Parsing+an+existing+workbook">Parsing an existing workbook<span><a href="#label-Parsing+an+existing+workbook">&para;</a> <a href="#top">&uarr;</a></span></h3>
@@ -157,11 +157,14 @@ preserving as much of the structure as possible.</p>
 
 <pre class="ruby"><span class="ruby-identifier">workbook</span>.<span class="ruby-identifier">worksheets</span>[<span class="ruby-value">0</span>] <span class="ruby-comment"># Returns first worksheet</span>
 <span class="ruby-identifier">workbook</span>[<span class="ruby-value">0</span>]            <span class="ruby-comment"># Returns first worksheet</span>
-<span class="ruby-identifier">workbook</span>[<span class="ruby-string">'Sheet1'</span>]     <span class="ruby-comment"># Finds and returns worksheet titled &quot;Sheet1&quot;</span>
+<span class="ruby-identifier">workbook</span>[<span class="ruby-string">&#39;Sheet1&#39;</span>]     <span class="ruby-comment"># Finds and returns worksheet titled &quot;Sheet1&quot;</span>
 </pre>
 
 <h4 id="label-Accessing+a+Row+-28Array+of+Cells-29">Accessing a Row (Array of Cells)<span><a href="#label-Accessing+a+Row+-28Array+of+Cells-29">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
+<p>Please note that worksheets are sparse collections. Your code
+<strong>must</strong> expect that any row it encounters may be `nil`.</p>
+
 <pre class="ruby"><span class="ruby-identifier">worksheet</span> = <span class="ruby-identifier">workbook</span>[<span class="ruby-value">0</span>]
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>] <span class="ruby-comment"># Returns first row of the worksheet</span>
 <span class="ruby-identifier">worksheet</span>[<span class="ruby-value">0</span>]            <span class="ruby-comment"># Returns first row of the worksheet</span>
@@ -169,6 +172,9 @@ preserving as much of the structure as possible.</p>
 
 <h4 id="label-Accessing+a+Cell+object">Accessing a Cell object<span><a href="#label-Accessing+a+Cell+object">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
+<p>Please note that rows are sparse collections. Your code
+<strong>must</strong> expect that any cell it encounters may be `nil`.</p>
+
 <pre class="ruby"><span class="ruby-identifier">worksheet</span> = <span class="ruby-identifier">workbook</span>[<span class="ruby-value">0</span>]
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>] <span class="ruby-comment"># Returns cell A1 in the worksheet</span>
 <span class="ruby-identifier">worksheet</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>]            <span class="ruby-comment"># Returns cell A1 in the worksheet</span>
@@ -184,7 +190,7 @@ preserving as much of the structure as possible.</p>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">fill_color</span>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">horizontal_alignment</span>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">vertical_alignment</span>
-<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">border_top</span>
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">get_border</span>(:<span class="ruby-identifier">top</span>)
 </pre>
 
 <h4 id="label-Wrappers+for+accessing+Row+properties+">Wrappers for accessing Row properties <span><a href="#label-Wrappers+for+accessing+Row+properties+">&para;</a> <a href="#top">&uarr;</a></span></h4>
@@ -239,18 +245,18 @@ You should access and iterate through rows and cells directly:</p>
 
 <h4 id="label-Adding+Worksheets">Adding Worksheets<span><a href="#label-Adding+Worksheets">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span> = <span class="ruby-identifier">workbook</span>.<span class="ruby-identifier">add_worksheet</span>(<span class="ruby-string">'Sheet2'</span>)
+<pre class="ruby"><span class="ruby-identifier">worksheet</span> = <span class="ruby-identifier">workbook</span>.<span class="ruby-identifier">add_worksheet</span>(<span class="ruby-string">&#39;Sheet2&#39;</span>)
 </pre>
 
 <h4 id="label-Renaming+Worksheets">Renaming Worksheets<span><a href="#label-Renaming+Worksheets">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_name</span> = <span class="ruby-string">'Cool New Name'</span>
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_name</span> = <span class="ruby-string">&#39;Cool New Name&#39;</span>
 </pre>
 
 <h4 id="label-Adding+Cells">Adding Cells<span><a href="#label-Adding+Cells">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">add_cell</span>(<span class="ruby-value">0</span>, <span class="ruby-value">0</span>, <span class="ruby-string">'A1'</span>)      <span class="ruby-comment"># Sets cell A1 to string &quot;A1&quot;</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">add_cell</span>(<span class="ruby-value">0</span>, <span class="ruby-value">1</span>, <span class="ruby-string">''</span>, <span class="ruby-string">'A1'</span>)  <span class="ruby-comment"># Sets formula in the cell B1 to '=A1'</span>
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">add_cell</span>(<span class="ruby-value">0</span>, <span class="ruby-value">0</span>, <span class="ruby-string">&#39;A1&#39;</span>)      <span class="ruby-comment"># Sets cell A1 to string &quot;A1&quot;</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">add_cell</span>(<span class="ruby-value">0</span>, <span class="ruby-value">1</span>, <span class="ruby-string">&#39;&#39;</span>, <span class="ruby-string">&#39;A1&#39;</span>)  <span class="ruby-comment"># Sets formula in the cell B1 to &#39;=A1&#39;</span>
 </pre>
 
 <h4 id="label-Changing+Cells">Changing Cells<span><a href="#label-Changing+Cells">&para;</a> <a href="#top">&uarr;</a></span></h4>
@@ -262,23 +268,23 @@ You should access and iterate through rows and cells directly:</p>
 
 <pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_font_bold</span>(<span class="ruby-keyword">true</span>) <span class="ruby-comment"># Makes A1 bold</span>
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_italics</span>(<span class="ruby-value">0</span>,<span class="ruby-keyword">true</span>)              <span class="ruby-comment"># Makes first row italicized</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_font_name</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'Courier'</span>)   <span class="ruby-comment"># Makes first column have font Courier</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_font_name</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;Courier&#39;</span>)   <span class="ruby-comment"># Makes first column have font Courier</span>
 </pre>
 
 <h4 id="label-Changing+Fills+++++">Changing Fills     <span><a href="#label-Changing+Fills+++++">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_fill</span>(<span class="ruby-string">'0ba53d'</span>)  <span class="ruby-comment"># Sets A1 to have fill #0ba53d</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_fill</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'0ba53d'</span>)            <span class="ruby-comment"># Sets first row to have fill #0ba53d</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_fill</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'0ba53d'</span>)         <span class="ruby-comment"># Sets first column to have fill #0ba53d</span>
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_fill</span>(<span class="ruby-string">&#39;0ba53d&#39;</span>)  <span class="ruby-comment"># Sets A1 to have fill #0ba53d</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_fill</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;0ba53d&#39;</span>)            <span class="ruby-comment"># Sets first row to have fill #0ba53d</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_fill</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;0ba53d&#39;</span>)         <span class="ruby-comment"># Sets first column to have fill #0ba53d</span>
 </pre>
 
 <h4 id="label-Changing+Borders">Changing Borders<span><a href="#label-Changing+Borders">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
 <pre class="ruby"><span class="ruby-comment"># Possible weights: hairline, thin, medium, thick</span>
 <span class="ruby-comment"># Possible &quot;directions&quot;: top, bottom, left, right, diagonal</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_border</span>(:<span class="ruby-identifier">top</span>, <span class="ruby-string">'thin'</span>)  <span class="ruby-comment"># Sets A1 to have a top, thin border</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_border</span>(<span class="ruby-value">0</span>, :<span class="ruby-identifier">left</span>, <span class="ruby-string">'hairline'</span>)       <span class="ruby-comment"># Sets first row to have a left, hairline border</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_border</span>(<span class="ruby-value">0</span>, :<span class="ruby-identifier">diagonal</span>, <span class="ruby-string">'medium'</span>)  <span class="ruby-comment"># Sets first column to have diagonal, medium border</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_border</span>(:<span class="ruby-identifier">top</span>, <span class="ruby-string">&#39;thin&#39;</span>)  <span class="ruby-comment"># Sets A1 to have a top, thin border</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_border</span>(<span class="ruby-value">0</span>, :<span class="ruby-identifier">left</span>, <span class="ruby-string">&#39;hairline&#39;</span>)       <span class="ruby-comment"># Sets first row to have a left, hairline border</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_border</span>(<span class="ruby-value">0</span>, :<span class="ruby-identifier">diagonal</span>, <span class="ruby-string">&#39;medium&#39;</span>)  <span class="ruby-comment"># Sets first column to have diagonal, medium border</span>
 </pre>
 
 <h4 id="label-Changing+Alignment">Changing Alignment<span><a href="#label-Changing+Alignment">&para;</a> <a href="#top">&uarr;</a></span></h4>
@@ -287,18 +293,18 @@ You should access and iterate through rows and cells directly:</p>
 
 <p>center, distributed, justify, left, right</p>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_horizontal_alignment</span>(<span class="ruby-string">'center'</span>) <span class="ruby-comment"># Sets A1 to be centered</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_horizontal_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'justify'</span>)          <span class="ruby-comment"># Sets first row to be justified</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_horizontal_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'right'</span>)         <span class="ruby-comment"># Sets first column to be right-aligned</span>
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_horizontal_alignment</span>(<span class="ruby-string">&#39;center&#39;</span>) <span class="ruby-comment"># Sets A1 to be centered</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_horizontal_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;justify&#39;</span>)          <span class="ruby-comment"># Sets first row to be justified</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_horizontal_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;right&#39;</span>)         <span class="ruby-comment"># Sets first column to be right-aligned</span>
 </pre>
 
 <h5 id="label-Vertical">Vertical<span><a href="#label-Vertical">&para;</a> <a href="#top">&uarr;</a></span></h5>
 
 <p>bottom, center, distributed, top</p>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_vertical_alignment</span>(<span class="ruby-string">'bottom'</span>)  <span class="ruby-comment"># Sets A1 to be bottom aligned</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_vertical_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'distributed'</span>)       <span class="ruby-comment"># Sets first row to be distributed vertically</span>
-<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_vertical_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">'top'</span>)            <span class="ruby-comment"># Sets first column to be top aligned</span>
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_vertical_alignment</span>(<span class="ruby-string">&#39;bottom&#39;</span>)  <span class="ruby-comment"># Sets A1 to be bottom aligned</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_vertical_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;distributed&#39;</span>)       <span class="ruby-comment"># Sets first row to be distributed vertically</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_vertical_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;top&#39;</span>)            <span class="ruby-comment"># Sets first column to be top aligned</span>
 </pre>
 
 <h4 id="label-Changing+Row+Height">Changing Row Height<span><a href="#label-Changing+Row+Height">&para;</a> <a href="#top">&uarr;</a></span></h4>
@@ -392,7 +398,7 @@ have been moved, as the formulas do not adapt to the shifted cells</p>
 <h4 id="label-Modifying+Cell+Format">Modifying Cell Format<span><a href="#label-Modifying+Cell+Format">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
 <pre class="ruby"><span class="ruby-identifier">cell</span> = <span class="ruby-identifier">worksheet</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>]
-<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">set_number_format</span> <span class="ruby-string">'0.0000%'</span>    <span class="ruby-comment"># For formats, see https://support.office.com/en-us/article/5026bbd6-04bc-48cd-bf33-80f18b4eae68</span>
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">set_number_format</span> <span class="ruby-string">&#39;0.0000%&#39;</span>    <span class="ruby-comment"># For formats, see https://support.office.com/en-us/article/5026bbd6-04bc-48cd-bf33-80f18b4eae68</span>
 </pre>
 
 <h2 id="label-I-2FO">I/O<span><a href="#label-I-2FO">&para;</a> <a href="#top">&uarr;</a></span></h2>
@@ -413,8 +419,8 @@ handy for web servers.</p>
 
 <h2 id="label-Miscellaneous">Miscellaneous<span><a href="#label-Miscellaneous">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<pre class="ruby"><span class="ruby-constant">Reference</span>.<span class="ruby-identifier">ind2ref</span>(<span class="ruby-value">0</span>,<span class="ruby-value">0</span>) <span class="ruby-operator">==</span> <span class="ruby-string">'A1'</span>    <span class="ruby-comment"># Converts row and column index to Excel-style cell reference</span>
-<span class="ruby-constant">Reference</span>.<span class="ruby-identifier">ref2ind</span>(<span class="ruby-string">'A1'</span>) <span class="ruby-operator">==</span> [<span class="ruby-value">0</span>, <span class="ruby-value">0</span>] <span class="ruby-comment"># Converts Excel-style cell reference to row and column index</span>
+<pre class="ruby"><span class="ruby-constant">Reference</span>.<span class="ruby-identifier">ind2ref</span>(<span class="ruby-value">0</span>,<span class="ruby-value">0</span>) <span class="ruby-operator">==</span> <span class="ruby-string">&#39;A1&#39;</span>    <span class="ruby-comment"># Converts row and column index to Excel-style cell reference</span>
+<span class="ruby-constant">Reference</span>.<span class="ruby-identifier">ref2ind</span>(<span class="ruby-string">&#39;A1&#39;</span>) <span class="ruby-operator">==</span> [<span class="ruby-value">0</span>, <span class="ruby-value">0</span>] <span class="ruby-comment"># Converts Excel-style cell reference to row and column index</span>
 </pre>
 
 <h2 id="label-For+more+information">For more information<span><a href="#label-For+more+information">&para;</a> <a href="#top">&uarr;</a></span></h2>
@@ -423,11 +429,11 @@ handy for web servers.</p>
 
 <h2 id="label-Contributing+to+rubyXL">Contributing to rubyXL<span><a href="#label-Contributing+to+rubyXL">&para;</a> <a href="#top">&uarr;</a></span></h2>
 <ul><li>
-<p>Check out the latest master to make sure the feature hasn’t been
-implemented or the bug hasn’t been fixed yet</p>
+<p>Check out the latest master to make sure the feature hasn&#39;t been
+implemented or the bug hasn&#39;t been fixed yet</p>
 </li><li>
-<p>Check out the issue tracker to make sure someone already hasn’t requested
-it and/or contributed it</p>
+<p>Check out the issue tracker to make sure someone already hasn&#39;t
+requested it and/or contributed it</p>
 </li><li>
 <p>Fork the project</p>
 </li><li>
@@ -435,8 +441,8 @@ it and/or contributed it</p>
 </li><li>
 <p>Commit and push until you are happy with your contribution</p>
 </li><li>
-<p>Make sure to add tests for it. This is important so I don’t break it in a
-future version unintentionally.</p>
+<p>Make sure to add tests for it. This is important so I don&#39;t break it in
+a future version unintentionally.</p>
 </li><li>
 <p>Please try not to mess with the Rakefile, version, or history. If you want
 to have your own version, or is otherwise necessary, that is fine, but
@@ -453,7 +459,7 @@ further details.</p>
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="http://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.0.
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>