rubyXL 3.4.14 → 3.4.33

data/lib/rubyXL/parser.rb

@@ -1,6 +1,5 @@
 module RubyXL
   class Parser
-
     # Parse <tt>.xslx</tt> file by reading it from local disk.
     def self.parse(src_file_path)
       begin
@@ -18,12 +17,11 @@ module RubyXL
     def self.parse_buffer(buffer)
       root = nil # Zip::File.open_buffer somehow fails to return the value from the block :(
       begin
-        ::Zip::File.open_buffer(buffer) { |zip_file| root = RubyXL::WorkbookRoot.parse_zip_file(zip_file)  } 
+        ::Zip::File.open_buffer(buffer) { |zip_file| root = RubyXL::WorkbookRoot.parse_zip_file(zip_file) }
         root.workbook
       rescue ::Zip::Error => e
         raise e, "XLSX file format error: #{e}", e.backtrace
       end
     end
-
   end
 end

data/lib/rubyXL/worksheet.rb

@@ -1,98 +1,105 @@
 module RubyXL
-module LegacyWorksheet
-  include Enumerable
-
-  def initialize(params = {})
-    super
-    self.workbook   = params[:workbook]
-    self.sheet_name = params[:sheet_name]
-    self.sheet_id   = params[:sheet_id]
-    self.sheet_data = RubyXL::SheetData.new
-    self.cols = RubyXL::ColumnRanges.new
-    @comments = [] # Do not optimize! These are arrays, so they will share the pointer!
-    @printer_settings = []
-    @generic_storage = []
-  end
+  module LegacyWorksheet
+    TEXT_LENGTH_LIMIT_IN_CELL = 32767 # 2 ** 15 - 1
+
+    include Enumerable
+
+    def initialize(params = {})
+      super
+      self.workbook   = params[:workbook]
+      self.sheet_name = params[:sheet_name]
+      self.sheet_id   = params[:sheet_id]
+      self.sheet_data = RubyXL::SheetData.new
+      self.cols = RubyXL::ColumnRanges.new
+      @comments = [] # Do not optimize! These are arrays, so they will share the pointer!
+      @printer_settings = []
+      @generic_storage = []
+    end
 
-  # allows for easier access to sheet_data
-  def [](row = 0)
-    sheet_data[row]
-  end
+    # allows for easier access to sheet_data
+    def [](row = 0)
+      sheet_data[row]
+    end
 
-  def each
-    sheet_data.rows.each { |row| yield(row) }
-  end
+    def each
+      sheet_data.rows.each { |row| yield(row) }
+    end
 
-  def add_row(row_index = 0, params = {})
-    new_row = RubyXL::Row.new(params)
-    new_row.worksheet = self
-    sheet_data.rows[row_index] = new_row
-  end
+    def add_row(row_index = 0, params = {})
+      new_row = RubyXL::Row.new(params)
+      new_row.worksheet = self
+      sheet_data.rows[row_index] = new_row
+    end
+
+    def add_cell(row_index = 0, column_index = 0, data = '', formula = nil, overwrite = true)
+      validate_workbook
+      validate_nonnegative(row_index)
+      validate_nonnegative(column_index)
+      row = sheet_data.rows[row_index] || add_row(row_index)
+
+      c = row.cells[column_index]
 
-  def add_cell(row_index = 0, column_index = 0, data = '', formula = nil, overwrite = true)
-    validate_workbook
-    validate_nonnegative(row_index)
-    validate_nonnegative(column_index)
-    row = sheet_data.rows[row_index] || add_row(row_index)
-
-    c = row.cells[column_index]
-
-    if overwrite || c.nil?
-      c = RubyXL::Cell.new
-      c.worksheet = self
-      c.row = row_index
-      c.column = column_index
-
-      if formula then
-        c.formula = RubyXL::Formula.new(:expression => formula)
-        c.raw_value = data
-      else
-        case data
-        when Numeric          then c.raw_value = data
-        when String           then
+      if overwrite || c.nil?
+        c = RubyXL::Cell.new
+        c.worksheet = self
+        c.row = row_index
+        c.column = column_index
+
+        if formula then
+          c.formula = RubyXL::Formula.new(:expression => formula)
           c.raw_value = data
-          c.datatype = RubyXL::DataType::RAW_STRING
-        when RubyXL::RichText then
-          c.is = data
-          c.datatype = RubyXL::DataType::INLINE_STRING
-        when Date, DateTime then
-          c.raw_value = workbook.date_to_num(data)
-        when NilClass         then nil
+        else
+          case data
+          when Numeric          then c.raw_value = data
+          when String           then
+            if data.length > TEXT_LENGTH_LIMIT_IN_CELL
+              raise ArgumentError, "The maximum length of cell contents (text) is #{TEXT_LENGTH_LIMIT_IN_CELL} characters"
+            end
+            c.raw_value = data
+            c.datatype = RubyXL::DataType::RAW_STRING
+          when RubyXL::RichText then
+            if data.to_s.length > TEXT_LENGTH_LIMIT_IN_CELL
+              raise ArgumentError, "The maximum length of cell contents (text) is #{TEXT_LENGTH_LIMIT_IN_CELL} characters"
+            end
+            c.is = data
+            c.datatype = RubyXL::DataType::INLINE_STRING
+          when Time, Date, DateTime then
+            c.raw_value = workbook.date_to_num(data)
+          when NilClass then nil
+          end
         end
+
+        range = cols&.locate_range(column_index)
+        c.style_index = row.style_index || range&.style_index || 0
+        row.cells[column_index] = c
       end
 
-      range = cols && cols.locate_range(column_index)
-      c.style_index = row.style_index || (range && range.style_index) || 0
-      row.cells[column_index] = c
+      c
     end
 
-    c
-  end
+    private
 
-  private
+    # validates Workbook, ensures that this worksheet is in @workbook
+    def validate_workbook
+      unless @workbook.nil? || @workbook.worksheets.nil?
+        return if @workbook.worksheets.any? { |sheet| sheet.equal?(self) }
+      end
 
-  #validates Workbook, ensures that this worksheet is in @workbook
-  def validate_workbook()
-    unless @workbook.nil? || @workbook.worksheets.nil?
-      return if @workbook.worksheets.any? { |sheet| sheet.equal?(self) }
+      raise "This worksheet #{self} is not in workbook #{@workbook}"
     end
 
-    raise "This worksheet #{self} is not in workbook #{@workbook}"
-  end
-
-  # 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)
+    # 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)
 
-    sheet_data.rows[row_index] || add_row(row_index)
-  end
+      sheet_data.rows[row_index] || add_row(row_index)
+    end
 
-  def validate_nonnegative(row_or_col)
-    raise 'Row and Column arguments must be nonnegative' if row_or_col < 0
+    def validate_nonnegative(row_or_col)
+      raise 'Row and Column arguments must be nonnegative' if row_or_col < 0
+    end
+    private :validate_nonnegative
   end
-  private :validate_nonnegative
-
-end #end class
 end

data/lib/rubyXL.rb

@@ -9,5 +9,4 @@ module RubyXL
     return path unless path.absolute?
     path.relative_path_from(OOXMLTopLevelObject::ROOT)
   end
-
 end

data/rdoc/README_rdoc.html

@@ -4,7 +4,7 @@
 <head>
 <meta charset="UTF-8">
 
-<title>README - rubyXL 3.4.14</title>
+<title>README - rubyXL 3.4.33</title>
 
 <script type="text/javascript">
   var rdoc_rel_prefix = "./";
@@ -21,7 +21,6 @@
 <link href="./css/rdoc.css" rel="stylesheet">
 
 
-
 <body id="top" role="document" class="file">
 <nav role="navigation">
   <div id="project-navigation">
@@ -42,7 +41,7 @@
     <div id="search-field-wrapper">
       <input id="search-field" role="combobox" aria-label="Search"
              aria-autocomplete="list" aria-controls="search-results"
-             type="text" name="search" placeholder="Search" spellcheck="false"
+             type="text" name="search" placeholder="Search (/) for a class, method, ..." spellcheck="false"
              title="Type to search, Up and Down to navigate, Enter to load">
     </div>
 
@@ -58,60 +57,112 @@
 <div class="nav-section">
   <h3>Table of Contents</h3>
 
+
+
   <ul class="link-list" role="directory">
-    <li><a href="#label-rubyXL">rubyXL</a>
-    <li><a href="#label-To+Install-3A">To Install:</a>
-    <li><a href="#label-To+Use-3A">To Use:</a>
-    <li><a href="#label-Convenience+methods">Convenience methods</a>
-    <li><a href="#label-Parsing+an+existing+workbook">Parsing an existing workbook</a>
-    <li><a href="#label-Creating+a+new+Workbook">Creating a new Workbook</a>
-    <li><a href="#label-Accessing">Accessing</a>
-    <li><a href="#label-Accessing+a+Worksheet">Accessing a Worksheet</a>
-    <li><a href="#label-Accessing+a+Row+-28Array+of+Cells-29">Accessing a Row (Array of Cells)</a>
-    <li><a href="#label-Accessing+a+Cell+object">Accessing a Cell object</a>
-    <li><a href="#label-Wrappers+for+accessing+Cell+properties">Wrappers for accessing Cell properties</a>
-    <li><a href="#label-Wrappers+for+accessing+Row+properties+">Wrappers for accessing Row properties </a>
-    <li><a href="#label-Accessing+column+properties">Accessing column properties</a>
-    <li><a href="#label-Modifying">Modifying</a>
-    <li><a href="#label-Adding+Worksheets">Adding Worksheets</a>
-    <li><a href="#label-Renaming+Worksheets">Renaming Worksheets</a>
-    <li><a href="#label-Adding+Cells">Adding Cells</a>
-    <li><a href="#label-Changing+Cells">Changing Cells</a>
-    <li><a href="#label-Changing+Fonts">Changing Fonts</a>
-    <li><a href="#label-Changing+Fills+++++">Changing Fills     </a>
-    <li><a href="#label-Changing+Borders">Changing Borders</a>
-    <li><a href="#label-Changing+Alignment">Changing Alignment</a>
-    <li><a href="#label-Horizontal">Horizontal</a>
-    <li><a href="#label-Vertical">Vertical</a>
-    <li><a href="#label-Rotation">Rotation</a>
-    <li><a href="#label-Changing+Row+Height">Changing Row Height</a>
-    <li><a href="#label-Changing+Column+Width">Changing Column Width</a>
-    <li><a href="#label-Merging+Cells">Merging Cells</a>
-    <li><a href="#label-Insert+Row">Insert Row</a>
-    <li><a href="#label-Insert+Column">Insert Column</a>
-    <li><a href="#label-Delete+Row">Delete Row</a>
-    <li><a href="#label-Delete+Column">Delete Column</a>
-    <li><a href="#label-Insert+Cell">Insert Cell</a>
-    <li><a href="#label-Delete+Cell">Delete Cell</a>
-    <li><a href="#label-Modifying+Cell+Format">Modifying Cell Format</a>
-    <li><a href="#label-I-2FO">I/O</a>
-    <li><a href="#label-Miscellaneous">Miscellaneous</a>
-    <li><a href="#label-Suppress+warnings+about+malformed+input+files">Suppress warnings about malformed input files</a>
-    <li><a href="#label-For+more+information">For more information</a>
-    <li><a href="#label-Contributing+to+rubyXL">Contributing to rubyXL</a>
-    <li><a href="#label-Copyright">Copyright</a>
+              <li>
+            <details open>
+              <summary>      <a href="#label-rubyXL">rubyXL</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-To+Install-3A">To Install:</a>
+          <li>
+            <details open>
+              <summary>      <a href="#label-To+Use-3A">To Use:</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-Convenience+methods">Convenience methods</a>
+          <li>      <a href="#label-Parsing+an+existing+workbook">Parsing an existing workbook</a>
+          <li>      <a href="#label-Creating+a+new+Workbook">Creating a new Workbook</a>
+          <li>
+            <details open>
+              <summary>      <a href="#label-Accessing">Accessing</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-Accessing+a+Worksheet">Accessing a Worksheet</a>
+          <li>      <a href="#label-Accessing+a+Row+-28Array+of+Cells-29">Accessing a Row (Array of Cells)</a>
+          <li>      <a href="#label-Accessing+a+Cell+object">Accessing a Cell object</a>
+          <li>      <a href="#label-Wrappers+for+accessing+Cell+properties">Wrappers for accessing Cell properties</a>
+          <li>      <a href="#label-Wrappers+for+accessing+Row+properties+">Wrappers for accessing Row properties </a>
+          <li>      <a href="#label-Accessing+column+properties">Accessing column properties</a>
+
+              </ul>
+            </details>
+          </li>
+          <li>
+            <details open>
+              <summary>      <a href="#label-Modifying">Modifying</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-Adding+Worksheets">Adding Worksheets</a>
+          <li>      <a href="#label-Renaming+Worksheets">Renaming Worksheets</a>
+          <li>      <a href="#label-Adding+Cells">Adding Cells</a>
+          <li>      <a href="#label-Changing+Cells">Changing Cells</a>
+          <li>      <a href="#label-Changing+Fonts">Changing Fonts</a>
+          <li>      <a href="#label-Changing+Fills+++++">Changing Fills     </a>
+          <li>      <a href="#label-Changing+Borders">Changing Borders</a>
+          <li>
+            <details open>
+              <summary>      <a href="#label-Changing+Alignment">Changing Alignment</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-Horizontal">Horizontal</a>
+          <li>      <a href="#label-Vertical">Vertical</a>
+          <li>      <a href="#label-Rotation">Rotation</a>
+
+              </ul>
+            </details>
+          </li>
+          <li>      <a href="#label-Changing+Row+Height">Changing Row Height</a>
+          <li>      <a href="#label-Changing+Column+Width">Changing Column Width</a>
+          <li>      <a href="#label-Merging+Cells">Merging Cells</a>
+          <li>      <a href="#label-Insert+Row">Insert Row</a>
+          <li>      <a href="#label-Insert+Column">Insert Column</a>
+          <li>      <a href="#label-Delete+Row">Delete Row</a>
+          <li>      <a href="#label-Delete+Column">Delete Column</a>
+          <li>      <a href="#label-Insert+Cell">Insert Cell</a>
+          <li>      <a href="#label-Delete+Cell">Delete Cell</a>
+          <li>      <a href="#label-Modifying+Cell+Format">Modifying Cell Format</a>
+          <li>      <a href="#label-Add+hyperlink+to+a+Cell">Add hyperlink to a Cell</a>
+
+              </ul>
+            </details>
+          </li>
+
+              </ul>
+            </details>
+          </li>
+          <li>      <a href="#label-I-2FO">I/O</a>
+          <li>
+            <details open>
+              <summary>      <a href="#label-Miscellaneous">Miscellaneous</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-Suppress+warnings+about+malformed+input+files">Suppress warnings about malformed input files</a>
+
+              </ul>
+            </details>
+          </li>
+          <li>      <a href="#label-Data+validation+-28colloquially+referred+to+as+-22dropdown+list-22-29">Data validation (colloquially referred to as “dropdown list”)</a>
+          <li>      <a href="#label-For+more+information">For more information</a>
+          <li>      <a href="#label-Contributing+to+rubyXL">Contributing to rubyXL</a>
+          <li>      <a href="#label-Copyright">Copyright</a>
+
+              </ul>
+            </details>
+          </li>
+
   </ul>
 </div>
 
 
   <div id="project-metadata">
-    <div id="fileindex-section" class="nav-section">
+    
+<div id="fileindex-section" class="nav-section">
   <h3>Pages</h3>
 
   <ul class="link-list">
-  
     <li><a href="./README_rdoc.html">README</a>
-  
   </ul>
 </div>
 
@@ -122,7 +173,7 @@
 
 <h1 id="label-rubyXL">rubyXL<span><a href="#label-rubyXL">&para;</a> <a href="#top">&uarr;</a></span></h1>
 
-<p><a href="http://badge.fury.io/rb/rubyXL"><img src="https://badge.fury.io/rb/rubyXL.svg" alt="Gem Version" /></a> <a href="https://codeclimate.com/github/weshatheleopard/rubyXL"><img src="https://codeclimate.com/github/weshatheleopard/rubyXL.png" alt="Code Climate" /></a> <a href="https://circleci.com/gh/weshatheleopard/rubyXL"><img src="https://circleci.com/gh/weshatheleopard/rubyXL.svg?style=svg" alt="CircleCI" /></a></p>
+<p><a href="http://badge.fury.io/rb/rubyXL"><img src="https://badge.fury.io/rb/rubyXL.svg"></a> <a href="https://codeclimate.com/github/weshatheleopard/rubyXL"><img src="https://codeclimate.com/github/weshatheleopard/rubyXL.png"></a> <a href="https://circleci.com/gh/weshatheleopard/rubyXL"><img src="https://circleci.com/gh/weshatheleopard/rubyXL.svg?style=svg"></a></p>
 
 <p>This gem supports operating on <code>xlsx</code> files (Open XML format). While it is capable of properly parsing the entire OOXML structure, its current main emphasis is on reading files produced by MS Excel, making minor modifications to them and saving them to be opened again, while preserving as much of the structure as possible.</p>
 
@@ -189,6 +240,15 @@
 <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>
+
+<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">value</span>                 <span class="ruby-comment"># Returns a properly converted value in the cell (if the file claims that the cell</span>
+                           <span class="ruby-comment"># is holding a number, returns a respective Integer or Float, and so on).</span>
+</pre>
+
+<p>Or, if you prefer Excel-style references (single-cell only!)</p>
+
+<pre class="ruby"><span class="ruby-identifier">cell</span> = <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">cell_at</span>(<span class="ruby-string">&#39;B11&#39;</span>)
 </pre>
 
 <h4 id="label-Wrappers+for+accessing+Cell+properties">Wrappers for accessing Cell properties<span><a href="#label-Wrappers+for+accessing+Cell+properties">&para;</a> <a href="#top">&uarr;</a></span></h4>
@@ -294,38 +354,30 @@
 
 <h5 id="label-Horizontal">Horizontal<span><a href="#label-Horizontal">&para;</a> <a href="#top">&uarr;</a></span></h5>
 
-<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">&#39;center&#39;</span>) <span class="ruby-comment"># Sets A1 to be centered</span>
+<pre class="ruby"><span class="ruby-comment"># Possible alignments: center, distributed, justify, left, right</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_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">&#39;bottom&#39;</span>)  <span class="ruby-comment"># Sets A1 to be bottom aligned</span>
+<pre class="ruby"><span class="ruby-comment"># Possible alignments: bottom, center, distributed, top</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_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>
 
 <h5 id="label-Rotation">Rotation<span><a href="#label-Rotation">&para;</a> <a href="#top">&uarr;</a></span></h5>
 
-<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_text_rotation</span>(<span class="ruby-value">90</span>)  <span class="ruby-comment"># Sets A1 to be rotated by 90 degrees</span>
+<pre class="ruby"><span class="ruby-comment"># Possible values:</span>
+<span class="ruby-comment"># * 0-90 - degrees counterclockwise, around the bottom LEFT corner of the cell;</span>
+<span class="ruby-comment"># * 91-179 - degrees clockwise, around the bottom RIGHT corner of the cell;</span>
+<span class="ruby-comment"># * 180-254 - degrees clockwise, around the bottom LEFT corner of the cell, text becomes progressively invisible</span>
+<span class="ruby-comment"># * 255 - text is in normal rotation but displayed vertically (one letter under another), line feed starts new line to the right of the previous.</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_text_rotation</span>(<span class="ruby-value">90</span>)  <span class="ruby-comment"># Sets A1 to be rotated by 90 degrees</span>
 </pre>
 
-<p>Values:</p>
-<ul><li>
-<p>0-90 - degrees counterclockwise, around the bottom LEFT corner of the cell;</p>
-</li><li>
-<p>91-179 - degrees clockwise, around the bottom RIGHT corner of the cell;</p>
-</li><li>
-<p>180-254 - degrees clockwise, around the bottom LEFT corner of the cell, text becomes progressively invisible</p>
-</li><li>
-<p>255 - text is in normal rotation but displayed vertically (one letter under another), line feed starts new line to the right of the previous.</p>
-</li></ul>
-
 <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>
 
 <pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_height</span>(<span class="ruby-value">0</span>, <span class="ruby-value">30</span>)  <span class="ruby-comment"># Sets first row height to 30</span>
@@ -338,8 +390,9 @@
 
 <h4 id="label-Merging+Cells">Merging Cells<span><a href="#label-Merging+Cells">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">merge_cells</span>(<span class="ruby-value">0</span>, <span class="ruby-value">0</span>, <span class="ruby-value">1</span>, <span class="ruby-value">1</span>)  <span class="ruby-comment"># Merges A1:B2</span>
-</pre>
+<pre>worksheet.merge_cells(0, 1, 2, 3)  # Merges B1:D3
+worksheet.merge_cells(&#39;A2:C4&#39;)     # Merges A2:C4
+worksheet.merge_cells(row_from: 0, row_to: 1, col_from 2:, col_to: 3) # Merges C1:D2</pre>
 
 <h4 id="label-Insert+Row">Insert Row<span><a href="#label-Insert+Row">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
@@ -404,9 +457,16 @@
 <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">&#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>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">change_text_wrap</span>(<span class="ruby-keyword">true</span>)         <span class="ruby-comment"># Makes the text in the cell to wrap.</span>
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">change_shrink_to_fit</span>(<span class="ruby-keyword">true</span>)     <span class="ruby-comment"># Makes the text in the cell to shrink to fit.</span>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">change_text_indent</span>(<span class="ruby-value">1</span>)          <span class="ruby-comment"># Indents the text in the cell by 1 level</span>
 </pre>
 
+<h4 id="label-Add+hyperlink+to+a+Cell">Add hyperlink to a Cell<span><a href="#label-Add+hyperlink+to+a+Cell">&para;</a> <a href="#top">&uarr;</a></span></h4>
+
+<pre class="ruby"><span class="ruby-identifier">cell</span>.<span class="ruby-identifier">add_hyperlink</span>(<span class="ruby-string">&#39;http://example.com&#39;</span>)
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">add_hyperlink</span>(<span class="ruby-string">&#39;http://example.com&#39;</span>, <span class="ruby-string">&#39;Some tooltip text&#39;</span>)
+</pre>
+
 <h2 id="label-I-2FO">I/O<span><a href="#label-I-2FO">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
 <p>By default, the gem operates with files on the local filesystem:</p>
@@ -432,15 +492,20 @@
 <pre class="ruby"><span class="ruby-constant">RubyXL</span>.<span class="ruby-identifier">class_variable_set</span>(<span class="ruby-value">:@@suppress_warnings</span>, <span class="ruby-keyword">true</span>)
 </pre>
 
+<h2 id="label-Data+validation+-28colloquially+referred+to+as+-22dropdown+list-22-29">Data validation (colloquially referred to as “dropdown list”)<span><a href="#label-Data+validation+-28colloquially+referred+to+as+-22dropdown+list-22-29">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">add_validation_list</span>(<span class="ruby-string">&quot;A1&quot;</span>, [ <span class="ruby-string">&quot;value1&quot;</span>, <span class="ruby-string">&quot;value2&quot;</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>
 
 <p>Take a look at the files in spec/lib/ for rspecs on most methods</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&#39;t been implemented or the bug hasn&#39;t been fixed yet</p>
+<p>Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet</p>
 </li><li>
-<p>Check out the issue tracker to make sure someone already hasn&#39;t requested it and/or contributed it</p>
+<p>Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it</p>
 </li><li>
 <p>Fork the project</p>
 </li><li>
@@ -448,21 +513,22 @@
 </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&#39;t break it in a future version unintentionally.</p>
+<p>Make sure to add tests for it. This is important so I don’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 please isolate to its own commit so I can cherry-pick around it.</p>
 </li></ul>
 
 <h2 id="label-Copyright">Copyright<span><a href="#label-Copyright">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<p>Copyright © 2011 Vivek Bhagwat, 2013-2020 Wesha. See LICENSE.txt for further details.</p>
+<p>Copyright © 2011 Vivek Bhagwat, 2013-2022 Wesha. See LICENSE.txt for further details.</p>
+
 </main>
 
 
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="https://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.
+  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.6.3.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>