robust_excel_ole 0.3.5 → 0.3.6

data/Changelog

@@ -0,0 +1,33 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+
+## [0.3.6] - 2015-10-25
+
+### Added
+- Excel#recreate: reopening a closed Excel
+- Excel::new(:reuse => <WIN32OLE_excel>): 
+  uplifting an Excel represented as object of the class WIN32OLE to an object of the class Excel
+- Excel#close, Excel::close_all: with managing unsaved workbooks
+- Excel::kill_all
+- Excel::excel_processes: yield Excel objects opened with RobustExcelOle
+- Book::new: uplifting a WIN32OLE object to a Book object
+- Subclassing for Sheet
+- Method missing: error messages for dead objects
+- trace to stdout or file
+
+
+### Changed
+
+## [0.3.5] - 2015-08-13
+
+### Added
+- Subclassing of Excel and Book
+- Book#reopen: allows to reopen workbooks
+- Book.inspect, Excel.inspect
+- Excel#close
+- Book_spec separated in managable pieces
+
+### Changed
+- removed cashing from Ranges.rb and Sheet.rb
+- cells: (1,1) as origin (instead (0,0))
+- bug fixes in application examples

data/README.rdoc

@@ -10,6 +10,7 @@ Goals:
 - provide convenient methods for frequent (common) tasks
 - support the use of simultaneously running Excel instances
 - allow the presence of referenced libraries and provide some support for that
+- supports EXCEL 2010, EXCEL 2007
 
 This is work in progress.
 
@@ -73,18 +74,26 @@ Closing the workbook and saving it before if it has unsaved changes.
 
 === Reopening a workbook.
 
-A special feature of robust_excel_ole is that it allows to reopen books after closing them.
+A special feature of robust_excel_ole is that it allows to reopen workbooks after closing them.
 
   book = Book.open('workbook.xls')
   book.close
   book.reopen
 
-The closed book is now alive again, i.e. is open and responds to Excel methods.
+The closed workbook is now alive again, i.e. is open and responds to Excel methods.
+This feature is a result of providing identity transparence and storing the file name.
 
-This feature is achieved by providing identity transperence and by storing the file name.
-Identity transperence means that the same Book objects refer to the same Excel files, and vice versa.
+=== The Book objects and transperence identity
+
+An Excel file (or workbook) is represented by a Book object. A Book object is defined by the full name of the workbook and the Excel instance in which it is opened. RobustExcelOle aims to ensure identity transperency.
+Identity transparence means that the same Book objects refer to the same Excel files, and vice versa.
 In other words, a Book objects is a proxy of an Excel file.
 
+=== Uplifting a workbook to a Book object
+
+A Book object can be created when giving an Excel workbook.
+
+   book = Book.new(win32ole_workbook)
 
 === Saving a workbook.
 
@@ -94,18 +103,23 @@ Saving a workbook with a file name.
 
   book.save_as('another_workbook.xls')
 
-The option is +:if_exists+. Example:
+The options are +:if_exists+ and +if_obstructed+.
 
 Saving a workbook and overwriting the file if it exists before.
 
   book.save_as('another_workbook.xls', :if_exists => :overwrite)
 
+If a workbook is blocking the workbook that should be saved, then the former one can be saved and closed before.
+
+  book = Book.open('workbook.xls')
+  book2 = Book.open('another_workbook.xls')
+  book2.save_as('dir/workbook.xls', :if_exists => :overwrite, :if_obstructed => :save)
 
 === Unobtrusively opening a workbook
 
-The method +unobtrusively+ enables the user to read or modify a workbook, no matter if it is open in some Excel instance, if it is saved or unsaved, and if it is writable or not. When opening a workbook unobtrusively, its status remains unchanged. This status includes, whether the book is opened or closed, saved or unsaved, readonly or writable. 
+The method +unobtrusively+ enables the user to read or modify a workbook, no matter if it is open in some Excel instance, if it is saved or unsaved, and if it is writable or not. When opening a workbook unobtrusively, its status remains unchanged. This status includes, whether the workbook is opened or closed, saved or unsaved, readonly or writable. 
 
-One option chooses the Excel instance in which a closed book is opened. The options +:reuse (default) indicates that the closed book is opened in the Excel instance of the book, if it exists, or that another Excel instance is reused. The option +:hidden+ provokes that the closed book is opened in a separate Excel instance that is not visible and has no DisplayAlerts. Any following closed book would be opened in this Excel instance as well when using this option. Moreover, an Excel instance can be given directly where to open the closed book.
+One option chooses the Excel instance in which a closed workbook is opened. The options +:reuse (default) indicates that the closed workbook is opened in the Excel instance of the workbook, if it exists, or that another Excel instance is reused. The option +:hidden+ provokes that the closed workbook is opened in a separate Excel instance that is not visible and has no DisplayAlerts. Any following closed workbook would be opened in this Excel instance as well when using this option. Moreover, an Excel instance can be given directly where to open the closed workbook.
 
 Further options are +:read_only+, +:readonly_excel+, and +:keep_open. The option +:readonly_excel+ chooses whether a book that is opened as ReadOnly and that shall be modified shall be opned as writable in the Excel instance where it was open so far, or if it shall be opened as writable in another running Excel instance, if such an Excel exists, or opened in a new Excel instance.
 
@@ -149,6 +163,27 @@ or
   book.nvalue("name")
   => "value"
 
+=== Activating a workbook.
+
+Brings the window of a workbook to the foreground . Make it available for keyboard inputs and make the Excel instance visible.
+
+  book.activate
+
+
+=== Making a workbook visible or invisible
+
+Open a workbook and make the Excel instance visible.
+
+  book = Book.open('workbook.xls', :visivble => true)
+
+Make the workbook invisible.
+
+  book.visible = false
+
+Make the workbook visible
+
+  book.visible = true
+
 === Making an Excel visible or invisible, and enable and disable DisplayAlerts.
 
 Make an Excel visible
@@ -287,11 +322,11 @@ Getting a running Excel instance and reusing it.
 
 Reusing a running Excel instance, making it visible and turning on displayalerts.
 
-   excel2 = Excel.new(:reuse => true, :visible => true, :displayalerts => true).
+  excel2 = Excel.new(:reuse => true, :visible => true, :displayalerts => true).
 
-Reusing a certain running Excel instance.
+Uplifting an Excel instance represented as WIN32OLE object to an Excel object
 
-   excel3 = Excel.new(:excel => excel1)
+  excel = Excel.new(:reuse => win32ole_object)
 
 === Making Excel visible or invisible
 
@@ -316,8 +351,6 @@ Turning DisplayAlerts off.
   excel.displayalerts = false
 
 Turning on and off in a block.
-  
-  with_displayalerts
 
   excel = Excel.create
   excel.with_displayalerts true do
@@ -329,10 +362,39 @@ Turning on and off in a block.
   excel = Excel.current
   excel.close
 
+Closing the Excel instance and terminating the Excel process
+
+  excel.close(:hard => true)
+
 === Closing all Excel instances.
 
   Excel.close_all
 
+ Closing the Excel instances and terminating the Excel processes
+
+  Excel.close_all(:hard => true) 
+
+=== Terminating all Excel processes
+
+  Excel.kill_all
+
+=== Recreating an Excel instance    
+
+Reopening the closed Excel instance. This includes reopening all workbooks that were open in that Excel instance.
+
+  excel.close
+  excel.recreate
+
+Options are :visible and :displayalerts
+
+  excel.recreate(:visible => true, :displayalerts => true)
+
+=== Providing Excel instances
+
+Providing all Excel instances (opened via RobustExcelOle) as objects of the class Excel
+
+  Excel.excel_objects
+
 === Examples
 
 === Example 1 
@@ -363,7 +425,7 @@ Closing the book.
 
 === Example 2
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
@@ -381,25 +443,25 @@ Closing the books.
   new_book.close
   another_book.close
 
-Reopening the book.
+Reopening the workbook.
 
-  reopened_book = Book.open('workbook.xls')
+  reopened_book = book.reopen
 
-The writable book is being prefered.  
+The writable workbook is being prefered.  
 
   reopened_book === book
   => true
 
-Opening another book.
-Since the book was not open before, reopening the book fails and the :default_excel option applies.
-According to :default_excel => :new a new Excel is created, and the book is opened there.
+Opening another workbook.
+Since the workbook was not open before, reopening the workbook fails and the :default_excel option applies.
+According to :default_excel => :new a new Excel is created, and the workbook is opened there.
 
   different_book = Book.open('different.xls', :default_excel => :new)
   
 
 === Example 3
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
@@ -407,7 +469,7 @@ Adding a copy of the first sheet after the second sheet.
 
   book.add_sheet(book[0], :as => 'Sheet1_copy', :after => book[1])
 
-Opening a new book with the same name in a new Excel. Leave the book that contains unsaved changes in the old Excel.
+Opening a new workbook with the same name in a new Excel. Leave the workbook that contains unsaved changes in the old Excel.
 
   new_book = Book.open('workbook.xls', :if_unsaved => :new_excel)
 
@@ -416,7 +478,7 @@ Accessing a sheet and change a cell.
   sheet = new_book[0]
   sheet[1,1] = "another"
 
-Opening another book with the same name in the running Excel. The book that contains unsaved changes will be closed before. 
+Opening another workbook with the same name in the running Excel. The book that contains unsaved changes will be closed before. 
 
   third_book = Book.open('workbook.xls', :if_unsaved => :forget)
 
@@ -424,21 +486,21 @@ Adding a sheet.
 
   third_book.add_sheet
 
-Closing the book without saving it.
+Closing the workbook without saving it.
 
   third_book.close(:if_unsaved => :forget)
 
-Closing the first book and saving it before.
+Closing the first workbook and saving it before.
 
   book.close(:if_unsaved => :save)
 
 === Example 4
 
-Opening a book.
+Opening a workbook.
 
   book1 = Book.open('workbook.xls')
 
-Opening a book with the same name in a different path. Close the old book.
+Opening a book with the same name in a different path. Close the old workbook.
 
   book2 = Book.open('more/workbook.xls', :if_obstructed => :forget)
 
@@ -447,22 +509,22 @@ Changing its cell.
   sheet = book2[0]
   sheet[1,1] = "new"
 
-Opening a book with the same name in a different path. The old book that was modified will be saved and closed before.
+Opening a workbook with the same name in a different path. The old workbook that was modified will be saved and closed before.
 
   book3 = Book.open('workbook.xls', :if_obstructed => :save)
 
-Opening a book with the same name in a different path. The other book will be closed, because it does not contain unsaved changes.
+Opening a workbook with the same name in a different path. The other workbook will be closed, because it does not contain unsaved changes.
 
   book4 = Book.open('more/workbook.xls', :if_obstructed => :close_if_unsaved)
 
-Closing the book.
+Closing the workbook.
 
   book4.close
 
 
 === Example 5
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
@@ -471,14 +533,14 @@ Printing its first cell.
   sheet = book[0]
   p "1st cell: #{sheet[1,1].Value}"
 
-Unobtrusively modify the book.
+Unobtrusively modify the workbook.
 
   Book.unobtrusively('workbook.xls') do |book|
     sheet = book[0]
     sheet[1,1] = 'simple'
   end
 
-The book is modified, but its status is unchanged.
+The workbook is modified, but its status is unchanged.
 
   new_sheet = book[0]
   not (new_sheet[1,1].Value == sheet[1,1].Value) 
@@ -497,12 +559,12 @@ For more details about usage: see link:https://github.com/Thomas008/robust_excel
 robust_excel_ole started as a simple fork from tomiacannondale's wrap_excel adapted to Ruby 1.8.6.
 The functionality of wrap_excel is optimised and extended by new features.
 Most notable extensions include:
-* books can be opened in already running Excel instances (instead of opening a new Excel whenever a book is opened)
-* a book management system stores all books that have been open. This book store is being used, e.g., for reopening a book that has been closed before. It provides transperency identity, i.e., equal Excel books correspond to equal Book objects of RobustExcelOle.
+* workbooks can be opened in already running Excel instances (instead of opening a new Excel whenever a book is opened)
+* a workbook management system stores all workbooks that have been open. This workbook store is being used, e.g., for reopening a workbook that has been closed before. It provides transparency identity, i.e., equal Excel workbooks correspond to equal Book objects of RobustExcelOle.
 
 Some features in robust_excel_ole that are not compatible with wrap_excel:
 * +open+ uses by default a running Excel instance instead of creating a new one,
-  and opens a book by default in writable mode instead of read_only 
+  and opens a workbook by default in writable mode instead of read_only 
 * +close+ closes the workbook instead of closing all workbooks and the Excel instance.
 * +save_as+ instead of +save+.
 

data/README_detail.rdoc

@@ -10,6 +10,7 @@ Goals:
 - provide convenient methods for frequent (common) tasks
 - support the use of simultaneously running Excel instances
 - allow the presence of referenced libraries and provide some support for that
+- supports EXCEL 2010, EXCEL 2007
 
 This is work in progress.
 
@@ -112,18 +113,28 @@ The option specifies: If the workbook is unsaved, then
 
 === Reopening a workbook.
 
-A special feature of robust_excel_ole is that it allows to reopen books after closing them.
+A special feature of robust_excel_ole is that it allows to reopen workbooks after closing them.
 
   book = Book.open('workbook.xls')
   book.close
   book.reopen
 
-The closed book is now alive again, i.e. is open and responds to Excel methods.
+The closed workbook is now alive again, i.e. is open and responds to Excel methods.
 
-This feature is achieved by providing identity transperence and by storing the file name.
-Identity transperence means that the same Book objects refer to the same Excel files, and vice versa.
+This feature is a result of providing identity transparence and storing the file name.
+
+=== The Book objects and transperence identity
+
+An Excel file (or workbook) is represented by a Book object. A Book object is defined by the full name of the workbook and the Excel instance in which it is opened. RobustExcelOle aims to ensure identity transperency.
+Identity transparence means that the same Book objects refer to the same Excel files, and vice versa.
 In other words, a Book objects is a proxy of an Excel file.
 
+=== Uplifting a workbook to a Book object
+
+A Book object can be created when giving an Excel workbook.
+
+   book = Book.new(win32ole_workbook)
+
 
 === Saving a workbook.
 
@@ -131,41 +142,53 @@ Simple save.
 
   book.save
 
-Saving a book with a file name.
+Saving a workbook with a file name.
 
   book.save_as('another_workbook.xls')
 
 Options are the following:
 
 +:if_exists+:: +:raise+ (default), +:overwrite+, +:alert+
++:if_obstruced+:: +:raise (default), +:forget+, +:save+, +close_if_saved
 
 The option +:if_exists+ :
 
-If a book with the file name already exists, then
+If a workbook with the file name already exists, then
 
 +:raise+::     Raise an exeption. Don't write the file.
-+:overwrite+:: Delete the existing file and write the file. If the book is open in an Excel instance, then raise an exception.
++:overwrite+:: Delete the existing file and write the file. If the workbook is open in an Excel instance, then raise an exception.
 +:alert+::     Give the control to Excel.
   
+Examples:
+
+Saving a workbook and overwriting the file if it exists before.
+
+  book.save_as('another_workbook.xls', :if_exists => :overwrite) 
+
+If a workbook is blocking the workbook that should be saved, then the former one can be saved and closed before.
+
+  book = Book.open('workbook.xls')
+  book2 = Book.open('another_workbook.xls')
+  book2.save_as('dir/workbook.xls', :if_exists => :overwrite, :if_obstructed => :save)  
 
 === Unobtrusively modifying a workbook
 
-The method +unobtrusively+ enables the user to read or modify a workbook, no matter if it is open in some Excel instance, if it is saved or unsaved, and if it is writable or not. When opening a workbook unobtrusively, its status remains unchanged. This status includes, whether the book is opened or closed, saved or unsaved, readonly or writable. 
+The method +unobtrusively+ enables the user to read or modify a workbook, no matter if it is open in some Excel instance, if it is saved or unsaved, and if it is writable or not. When opening a workbook unobtrusively, its status remains unchanged. This status includes, whether the workbook is opened or closed, saved or unsaved, readonly or writable. 
 
-One option chooses the Excel instance in which a closed book is opened. The options +:reuse (default) indicates that the closed book is opened in the Excel instance of the book, if it exists, or that another Excel instance is reused. The option +:hidden+ provokes that the closed book is opened in a separate Excel instance that is not visible and has no DisplayAlerts. Any following closed book would be opened in this Excel instance as well when using this option. Moreover, an Excel instance can be given directly where to open the closed book.
+One option chooses the Excel instance in which a closed workbook is opened. The options +:reuse (default) indicates that the closed workbook is opened in the Excel instance of the workbook, if it exists, or that another Excel instance is reused. The option +:hidden+ provokes that the closed workbook is opened in a separate Excel instance that is not visible and has no DisplayAlerts. Any following closed workbook would be opened in this Excel instance as well when using this option. Moreover, an Excel instance can be given directly where to open the closed workbook.
 
 Options are the following:
 
-:reuse (default) : open a closed book in the Excel instance of the book, if it exists, otherwise reuse another Excel
-:hidden          : open a closed book in one separate Excel instance that is not visible and has no displayaslerts
+:reuse (default) : open a closed workbook in the Excel instance of the workbook, if it exists, otherwise reuse another Excel
+:hidden          : open a closed workbook in one separate Excel instance that is not visible and has no displayaslerts
 <excel-instance> : open a closed workbooks in the given Excel instance
                
-+:read_only+:: Open the book unobtrusively for reading only  (default: false)
-+:readonly_excel+::  if the book is opened only as ReadOnly and shall be modified, then
++:read_only+:: Open the workbook unobtrusively for reading only  (default: false)
++:readonly_excel+::  if the workbook is opened only as ReadOnly and shall be modified, then
                      true:  close it and open it as writable in the excel instance where it was open so far
                      false (default) open it as writable in another running excel instance, if it exists, 
                                      otherwise open in a new excel instance
-+:keep_open+:: let the book open after unobtrusively opening (default: false)
++:keep_open+:: let the workbook open after unobtrusively opening (default: false)
 
   Book.unobtrusively('workbook.xls') do |book|
     # some modification
@@ -206,6 +229,26 @@ or
   book.nvalue("name")
   => "value"
 
+=== Activating a workbook.
+
+Bring the focus to a workbook. Make it available for keyboard inputs and make the Excel instance visible.
+
+  book.activate
+
+=== Making a workbook visible or invisible
+
+Open a workbook and make the Excel instance visible.
+
+  book = Book.open('workbook.xls', :visivble => true)
+
+Make the workbook invisible.
+
+  book.visible = false
+
+Make the workbook visible
+
+  book.visible = true
+
 === Making an Excel visible or invisible, and enable and disable DisplayAlerts.
 
 Make an Excel visible
@@ -347,11 +390,11 @@ Getting a running Excel instance and reusing it.
 
 Reusing a running Excel instance, making it visible and turning on displayalerts.
 
-   excel2 = Excel.new(:reuse => true, :visible => true, :displayalerts => true).
+  excel2 = Excel.new(:reuse => true, :visible => true, :displayalerts => true).
 
-Reusing a certain running Excel instance.
+Uplifting an Excel instance represented as WIN32OLE object to an Excel object
 
-   excel3 = Excel.new(:excel => excel1)
+  excel = Excel.new(:reuse => win32ole_object)
 
 === Making Excel visible or invisible
 
@@ -359,7 +402,6 @@ Making Excel visible.
 
   excel = Excel.create
   excel.visible = true
-  puts "visible" if excel.visible
 
 Making Excel invisible
 
@@ -371,29 +413,55 @@ Turning DisplayAlerts on.
 
   excel = Excel.create
   excel.displayalerts = true
-  puts "allows displayalerts" if excel.displayalerts
 
 Turning DisplayAlerts off.
 
   excel.displayalerts = false
 
 Turning on and off in a block.
-  
-  with_displayalerts
 
   excel = Excel.create
   excel.with_displayalerts true do
     book = Book.open('workbook.xls')
   end
 
+=== Closing an Excel
+
+  excel = Excel.current
+  excel.close
+
+Closing the Excel instance and terminating the Excel process
+
+  excel.close(:hard => true)
+
 === Closing all Excel instances.
 
   Excel.close_all
 
-=== Closing an Excel
+ Closing the Excel instances and terminating the Excel processes
+
+  Excel.close_all(:hard => true) 
+
+=== Terminating all Excel processes
+
+  Excel.kill_all
+
+=== Recreating an Excel instance    
+
+Reopening the closed Excel instance. This includes reopening all workbooks that were open in that Excel instance.
 
-  excel = Excel.current
   excel.close
+  excel.recreate
+
+Options are :visible and :displayalerts
+
+  excel.recreate(:visible => true, :displayalerts => true)
+
+=== Providing Excel instances
+
+Providing all Excel instances (opened via RobustExcelOle) as objects of the class Excel
+
+  Excel.excel_objects
 
 
 === Examples
@@ -404,7 +472,7 @@ Including robust_excel_ole.
 
 === Example 1 
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
@@ -416,57 +484,57 @@ Changing the first cell.
 
   sheet[1,1] = "new"
   
-Saving the book.
+Saving the workbook.
 
   book.save
 
-Saving the book with a different name, and overwrite if a file with this name exists.
+Saving the workbook with a different name, and overwrite if a file with this name exists.
 
   book.save_as('different_workbook.xls', :if_exists => :overwrite)
 
-Closing the book.
+Closing the workbook.
 
   book.close  
 
 === Example 2
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
-Opening the book in a new Excel instance and make it visible.
+Opening the workbook in a new Excel instance and make it visible.
 
   new_book = Book.open('workbook.xls', :force_excel => :new, :visible => true)
 
-Opening the book in a given Excel instance.
+Opening the workbook in a given Excel instance.
 
   another_book = Book.open('workbook.xls', :force_excel => book.excel)
 
-Closing the books.
+Closing the workbooks.
 
   book.close
   new_book.close
   another_book.close
 
-Reopening the book.
+Reopening the workbook.
 
-  reopened_book = Book.open('workbook.xls')
+  reopened_book = book.reopen
 
 The writable book is being prefered.  
 
   reopened_book == book
   => true
 
-Opening another book.
-Since the book was not open before, reopening the book fails and the :default_excel option applies.
-According to :default_excel => :new a new Excel is created, and the book is opened there.
+Opening another workbook.
+Since the workbook was not open before, reopening the workbook fails and the :default_excel option applies.
+According to :default_excel => :new a new Excel is created, and the workbook is opened there.
 
   different_book = Book.open('different.xls', :default_excel => :new)
   
 
 === Example 3
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
@@ -474,9 +542,9 @@ Adding a copy of the first sheet after the second sheet.
 
   book.add_sheet(book[0], :as => 'Sheet1_copy', :after => book[1])
 
-Close the book.
+Close the workbook.
 
-Opening a new book with the same name in a new Excel. Leave the book that contains unsaved changes in the old Excel.
+Opening a new workbook with the same name in a new Excel. Leave the workbook that contains unsaved changes in the old Excel.
 
   new_book = Book.open('workbook.xls', :if_unsaved => :new_excel)
 
@@ -485,7 +553,7 @@ Accessing a sheet and change a cell.
   sheet = new_book[0]
   sheet[1,1] = "another"
 
-Opening another book with the same name in the running Excel. The book that contains unsaved changes will be closed before. 
+Opening another workbook with the same name in the running Excel. The workbook that contains unsaved changes will be closed before. 
 
   third_book = Book.open('workbook.xls', :if_unsaved => :forget)
 
@@ -493,21 +561,21 @@ Adding a sheet.
 
   third_book.add_sheet
 
-Closing the book without saving it.
+Closing the workbook without saving it.
 
   third_book.close(:if_unsaved => :forget)
 
-Closing the first book and saving it before.
+Closing the first workbook and saving it before.
 
   book.close(:if_unsaved => :save)
 
 === Example 4
 
-Opening a book.
+Opening a workbook.
 
   book1 = Book.open('workbook.xls')
 
-Opening a book with the same name in a different path. Close the old book.
+Opening a workbook with the same name in a different path. Close the old workbook.
 
   book2 = Book.open('more/workbook.xls', :if_obstructed => :forget)
 
@@ -516,22 +584,22 @@ Changing its cell.
   sheet = book2[0]
   sheet[1,1] = "new"
 
-Opening a book with the same name in a different path. The old book that was modified will be saved and closed before.
+Opening a workbook with the same name in a different path. The old workbook that was modified will be saved and closed before.
 
   book3 = Book.open('workbook.xls', :if_obstructed => :save)
 
-Opening a book with the same name in a different path. The other book will be closed, because it does not contain unsaved changes.
+Opening a workbook with the same name in a different path. The other workbook will be closed, because it does not contain unsaved changes.
 
   book4 = Book.open('more/workbook.xls', :if_obstructed => :close_if_unsaved)
 
-Closing the book.
+Closing the workbook.
 
   book4.close
 
 
 === Example 5
 
-Opening a book.
+Opening a workbook.
 
   book = Book.open('workbook.xls')
 
@@ -540,14 +608,14 @@ Printing its first cell.
   sheet = book[0]
   p "1st cell: #{sheet[1,1].Value}"
 
-Unobtrusively modify the book.
+Unobtrusively modify the workbook.
 
   Book.unobtrusively('workbook.xls') do |book|
     sheet = book[0]
     sheet[1,1] = 'simple'
   end
 
-The book is modified, but its status is unchanged.
+The workbook is modified, but its status is unchanged.
 
   new_sheet = book[0]
   not (new_sheet[1,1].Value == sheet[1,1].Value) 
@@ -562,12 +630,12 @@ The book is modified, but its status is unchanged.
 robust_excel_ole started as a simple fork from tomiacannondale's wrap_excel adapted to Ruby 1.8.6.
 The functionality of wrap_excel is optimised and extended by new features.
 Most notable extensions include:
-* books can be opened in already running Excel instances (instead of opening a new Excel whenever a book is opened)
-* a book management system stores all books that have been open. This book store is being used, e.g., for reopening a book that has been closed before. It provides transperency identity, i.e., equal Excel books correspond to equal Book objects of RobustExcelOle.
+* workbooks can be opened in already running Excel instances (instead of opening a new Excel whenever a workbook is opened)
+* a workbook management system stores all workbooks that have been open. This book store is being used, e.g., for reopening a workbook that has been closed before. It provides transparency identity, i.e., equal Excel workbooks correspond to equal Book objects of RobustExcelOle.
 
 Some features in robust_excel_ole that are not compatible with wrap_excel:
 * +open+ uses by default a running Excel instance instead of creating a new one,
-  and opens a book by default in writable mode instead of read_only 
+  and opens a workbook by default in writable mode instead of read_only 
 * +close+ closes the workbook instead of closing all workbooks and the Excel instance.
 * +save_as+ instead of +save+.