/**
@page changes Changes


## 1.2.1 February 26 2025

- Added the `workbook_set_size()` function to set the size of the window when
  the file is opened. This is generally only useful on macOS since Microsoft
  Windows uses the window size from the last time an Excel file was
  opened/saved. Feature request [#472][gh_472].

  [gh_472]: https://github.com/jmcnamara/libxlsxwriter/issues/472

- Improved the cmake build support for using the `minizip` library.
  Pull request [#471][gh_471].

  [gh_471]: https://github.com/jmcnamara/libxlsxwriter/issues/471


### Packagers:

- This is serial version 1.2.1. This is not a semver version.

- This is shared object library version `libxlsxwriter.so.8`. This should be
  updated automatically via `make` and `cmake` as part of the build process.

- This version tries to improve the overall `cmake` build process when using
  minizip via the `-DUSE_SYSTEM_MINIZIP=ON` configuration option.

- Please report any downstream patches back upstream to help improve the overall
  build process.


## 1.2.0 January 11 2025

- Added `format_set_font_family()` and `format_set_font_charset()` format
  functions to support Middle Eastern and Asian fonts.
  Feature request [#468][gh_468].

  [gh_468]: https://github.com/jmcnamara/libxlsxwriter/issues/468


## 1.1.9 October 24 2024

 - Fix minor pointer/value error in `lxw_name_to_row()` and `lxw_name_to_col()`
   utility functions. Issue [#459][gh_459].

   [gh_459]: https://github.com/jmcnamara/libxlsxwriter/issues/459


## 1.1.8 July 31 2024

- Added support for embedding images into worksheets with
  `worksheet_embed_image()`.

  This can be useful if you are building up a spreadsheet of products with a
  column of images for each product. Embedded images move with the cell so they
  can be used in worksheet tables or data ranges that will be sorted or
  filtered.

  This functionality is the equivalent of Excel's menu option to insert an image
  using the option to "Place in Cell" which is available in Excel 365 versions
  from 2023 onwards.

- Fixed various issues:

  - [Failure on 32bit architectures #441](https://github.com/jmcnamara/libxlsxwriter/issues/441)
  - [workbook_validate_sheet_name buffer-overflow #442](https://github.com/jmcnamara/libxlsxwriter/issues/442)
  - [workbook_add_worksheet does not return a reasonable worksheet #443](https://github.com/jmcnamara/libxlsxwriter/issues/443)
  - [workbook_define_name stack-buffer-underflow #444](https://github.com/jmcnamara/libxlsxwriter/issues/444)
  - [workbook_close stack-buffer-overflow #445](https://github.com/jmcnamara/libxlsxwriter/issues/445)
  - [_store_array_formula heap-buffer-overflow #446](https://github.com/jmcnamara/libxlsxwriter/issues/446)
  - [worksheet_set_selection stack-buffer-overflow #447](https://github.com/jmcnamara/libxlsxwriter/issues/447)


- Note this version is tagged as `v1.1.8` instead of `RELEASE_1.1.8` for better
  interoperability with Xcode.


## 1.1.7 April 5 2024

- Bump `.so` version to 6. This was missed in the previous release.


## 1.1.6 April 4 2024

- Updated vendored version of minizip to v 1.3.0 to include upstream fixes.

  Feature request [#419][gh_419].

  [gh_419]: https://github.com/jmcnamara/libxlsxwriter/issues/419

- Added `quote_prefix` format property.

  Feature request [#385][gh_385].

  [gh_385]: https://github.com/jmcnamara/libxlsxwriter/issues/385

- Added support for signed VBA projects.
  </p>

- Fix worksheet password hashing algorithm for long passwords. Replace/fix
  the worksheet protection password algorithm so that is works correctly
  for strings over 24 chars.
  </p>

- Fix cmake minizip version check.

  Feature request [#405][gh_405].

  [gh_405]: https://github.com/jmcnamara/libxlsxwriter/issues/405

- Fix for buffer overflow with utf-8 strings in data validation.

  Feature request [#394][gh_394].

  [gh_394]: https://github.com/jmcnamara/libxlsxwriter/issues/394

- Fix for range in text type conditional format.

  Feature request [#395][gh_395].

  [gh_395]: https://github.com/jmcnamara/libxlsxwriter/issues/395

- Fix 32bit multiply with overflow issue for images.

  Fix multiply with overflow issue when image locations in the worksheet
  were greater than the u32 max value.

- Added Swift package manager support.
  </p>

- Added support for building Zig library.
  </p>

## 1.1.5 December 30 2022

- Added support for writing a workbook to a memory buffer instead of to a file
  via the `output_buffer` parameter of @ref workbook_new_opt(). See also
  @ref output_buffer.c.

- Add support for using in-memory data instead of temporary files on systems where
 `fmemopen()` and `open_memstream()` are supported. This requires the `USE_MEM_FILE`
  compilation option.


## 1.1.4 October 9 2021

- Added support for Worksheet tables. Tables in Excel are a way of grouping a
  range of cells into a single entity that has common formatting or that can
  be referenced from formulas. Tables can have column headers, autofilters,
  total rows, column formulas and default formatting. See @ref
  working_with_tables and @ref tables.c.

- Added support for adding a macro button to a worksheet. See @ref macro.c.

## 1.1.3 August 9 2021

- Changed worksheet_filter_column2() parameter name "operator" to "and_or" to
  avoid a conflict with the C++ reserved keyword.

## 1.1.2 August 8 2021

- Added support for autofilter rules. See @ref working_with_autofilters and
  @ref autofilter.c.

  Feature request [#254][gh_254].

  [gh_254]: https://github.com/jmcnamara/libxlsxwriter/issues/254

- Added Description/Alt Text and Decorative accessibility options for
  charts. These options were already available for images.


## 1.1.1 July 12 2021

- Added optional third party library to handle sprintf handling of
  doubles. This is to avoid issues with number formatting in some locales. The
  optional library is the Milo Yip DTOA implementation. See @ref gsg_dtoa.

  Issue [#272][gh_272].

  [gh_272]: https://github.com/jmcnamara/libxlsxwriter/issues/272

- Added the #LXW_EXPLICIT_FALSE variable to allow the default bold property in
  chart title fonts to be turned off.

  Issue [#199][gh_199].

  [gh_199]: https://github.com/jmcnamara/libxlsxwriter/issues/199

## 1.1.0 July 9 2021

- Fix for Cocoapod issue where local md5 files conflicted with BoringSSL headers.

  Issue [#342][gh_342].

  [gh_342]: https://github.com/jmcnamara/libxlsxwriter/issues/342

## 1.0.9 July 7 2021

- Added support for Excel 365 dynamic arrays. See
 `worksheet_write_dynamic_array_formula()` `worksheet_write_dynamic_formula()`
 and @ref ww_formulas_dynamic_arrays.


## 1.0.8 July 3 2021

- Fix for dynamic library soname on Linux.


## 1.0.7 July 1 2021

- Added support for writing Unix date/times via the
  `worksheet_write_unixtime()` function.

- Added support for dynamic library soname version to help packagers and build
  systems differentiate ABI versions.


## 1.0.6 May 28 2021

- Added support for using OpenSSL MD5 functions instead of built in third
  party library. See @ref gsg_md5.


## 1.0.5 May 13 2021

- Added support for worksheet background images via
  `worksheet_set_background()`.


## 1.0.4 May 8 2021

- Added support for GIF image files (and in Excel 365, animated GIF files).


## 1.0.3 April 20 2021

- Added some fixes to make the library compile more cleanly as an R library.


## 1.0.2 April 15 2021

- Added option to set row heights and column widths in pixels via the
  `worksheet_set_row_pixels()` and `worksheet_set_column_pixels()` functions.

## 1.0.1 March 30 2021

- Added support for [pkg-config][pkg-config] to Make/Cmake installs. See the
  @ref gsg_using section of the Getting Started guide.
  </p>

  [pkg-config]: https://www.freedesktop.org/wiki/Software/pkg-config/

- Added ability to add accessibility options "description" and "decorative" to
  images via `worksheet_insert_image_opt()` and #lxw_image_options.
  </p>

- Added the `workbook_read_only_recommended()` function to set the Excel
  "Read-only Recommended" option that is available when saving a file.
  </p>

- Fixed issue where pattern formats without colors were given a default black
  fill color.
  </p>

- Added option to set a chart crossing to 'min' via
  `chart_axis_set_crossing_min()` as well as the existing 'max' option. The
  'min' option isn't available in the Excel interface but can be enabled via
  VBA.
  </p>

- Added some additional information on using constant_memory mode with memory
  mounted /tmp directories. See @ref ww_mem_temp.

  Issue [#306][gh_306].

  [gh_306]: https://github.com/jmcnamara/libxlsxwriter/issues/306

- Added build option to compile libxlsxwriter as a "universal binary" for both
  Apple silicon and Intel-based Macs, i.e., arm64 and x86_64. See @ref
  gsg_universal.
  </p>

- Fixed issue where the limit for header/footer strings was
  255 bytes instead of 255 characters and as a result UTF8
  strings were being truncated.

  Issue [#305][gh_305].

  [gh_305]: https://github.com/jmcnamara/libxlsxwriter/issues/305


## 1.0.0 September 7 2020

- Added support for worksheet conditional formatting. See
  `worksheet_conditional_format_range()` and @ref
  working_with_conditional_formatting.

  Feature request [#32][gh_32] and [#302][gh_302].

  [gh_302]: https://github.com/jmcnamara/libxlsxwriter/issues/302
  [gh_32]:  https://github.com/jmcnamara/libxlsxwriter/issues/32

- Added performance optimization for search for control characters in strings
  in `worksheet_write_string()`.

  Issue [#298][gh_298].

  [gh_298]: https://github.com/jmcnamara/libxlsxwriter/issues/298

- Made `lxw_datetime_to_excel_datetime()` a function public.
  </p>

- There are now over 1000 test cases, including 650 tests that compare the
  output from libxlsxwriter, byte for byte, against test files created in
  Excel. This is also the 100th release of libxlsxwriter.


## 0.9.9 August 17 2020

- Added support for images in headers and footers. See `worksheet_set_header_opt()`.

- Added `worksheet_ignore_errors()` function to ignore Excel worksheet
  errors/warnings in user defined ranges.


## 0.9.8 August 11 2020

- Added formatting for chart data labels and chart custom data labels. See
  @ref chart_custom_labels and @ref chart_data_labels.c.


## 0.9.7 August 4 2020

- Changed #lxw_chart_data_label field from `.delete` to `.hide` in order to
  avoid reserved word conflict with C++.
  Issue [#300][gh_300].

  [gh_300]: https://github.com/jmcnamara/libxlsxwriter/issues/300


## 0.9.6 August 3 2020

- Added support for chart custom data labels. See @ref chart_custom_labels and
  @ref chart_data_labels.c.

- Fix for issue where array formulas weren't included in the output file for
  certain ranges/conditions. Issue [#735][gh_735].

  [gh_735]: https://github.com/jmcnamara/XlsxWriter/issues/735


## 0.9.5 May 31 2020

- Fix for issue where hyperlinks urls and tips were ignored for
  `worksheet_insert_image_buffer_opt()` images.
  Issue [#292][gh_292].

  [gh_292]: https://github.com/jmcnamara/libxlsxwriter/issues/292

- Added #LXW_CHART_LINE_STACKED and #LXW_CHART_LINE_STACKED_PERCENT line
  charts subtypes.

- Removed LXW_ERROR_SHEETNAME_RESERVED warning which was used with the
  reserved worksheet name "History". However, this is an allowed worksheet
  name in some Excel variants so the warning has been turned into a
  documentation note instead.


## 0.9.4 January 19 2020

- Added option to specify worksheet "object positioning" for images and charts
  to define how they move or size with underlying cells. See @ref
  ww_object_position_options and @ref working_with_object_positioning.


## 0.9.3 January 13 2020

- Fix Xcode/Cocoapods build warnings.


## 0.9.2 January 13 2020

- Added support for writing cell comments, see @ref working_with_comments.

- Makefile now respects DESTDIR and PREFIX, including when setting rpath on
  macOS.

- Changed function names in bundled MD5 code to avoid conflicts with OpenSSL.


## 0.9.1 December 26 2019

- Fix to missing MD5 linkage in Cocoapod file.
  Issue [#259][gh_259].

  [gh_259]: https://github.com/jmcnamara/libxlsxwriter/issues/259


## 0.9.0 December 26 2019

- Fix to avoid duplicate images being copied to an libxlsxwriter file. Excel
  uses an optimization where it only stores one copy of a repeated/duplicate
  image in a workbook. Libxlsxwriter didn't do this which meant that the file
  size would increase when then was a large number of repeated images. This
  release fixes that issue and replicates Excel's behavior.

  Note, that this change adds a dependency on the [Openwall MD5] library,
  which is now included with the libxlsxwriter third party source files. It is
  possible to compile libxlsxwriter without this library, and thus getting the
  older behavior, by passing `USE_NO_MD5=1` to make.


  [Openwall MD5]: https://openwall.info/wiki/people/solar/software/public-domain-source-code/md5

## 0.8.9 December 16 2019

- Added support for default hyperlink style in `worksheet_write_url()`.

- Added support for hyperlink in images, see `worksheet_insert_image_opt()`.

- Fixed several `worksheet_write_url()` edge cases.


## 0.8.8 November 17 2019

- Added option to allow a user defined, or overridden, image description used
  with `worksheet_insert_image()`. By default it uses the filename as the
  description.
  Issue [#238][gh_238].

  [gh_238]: https://github.com/jmcnamara/libxlsxwriter/issues/238

- Added Windows portable version of `fopen` to handle utf8 filenames when
  working with images.
  Issue [#238][gh_238].

  [gh_238]: https://github.com/jmcnamara/libxlsxwriter/issues/238

- Added an option to allow chart fonts to be rotation to 270 deg to give a
  stacked orientation. Also added support for East Asian vertical chart fonts.

- Refactored struct types used in pubic APIs to remove or document hidden
  fields. @b Note: This change introduces backward incompatible API
  changes. However, it should minimize any future changes of this nature.
  See issue [#252][gh_252].

  [gh_252]: https://github.com/jmcnamara/libxlsxwriter/issues/252



## 0.8.7 June 20 2019

- Added support for adding VBA macros to workbooks. These macros can be
  extracted from existing xlsm files, created in Excel, and added to new xlsm
  files. See @ref working_with_macros.
  Feature request [#29][gh_29].

  [gh_29]: https://github.com/jmcnamara/libxlsxwriter/issues/29

- Added support for ZIP64 extensions when writing very large xlsx files to
  allow the zip container, or individual XML files within it, to be greater
  than 4 GB. See @ref workbook_new_opt().
  Feature request [#228][gh_228].

  [gh_228]: https://github.com/jmcnamara/libxlsxwriter/issues/228

- Added extra validity checks on worksheet names.
  Issues [#223][gh_223] and [#230][gh_230].

  [gh_223]: https://github.com/jmcnamara/libxlsxwriter/issues/223
  [gh_230]: https://github.com/jmcnamara/libxlsxwriter/issues/230


## 0.8.6 April 7 2019

- Fixed issue where images that started in hidden rows/columns weren't placed
  correctly in the worksheet.

- Fixed the mime-type reported by system `file(1)`. The mime-type reported
  by "file --mime-type"/magic was incorrect for XlsxWriter files since it
  expected the `[Content_types]` to be the first file in the zip container.


## 0.8.5 February 10 2019

- Fix compile-time warnings with strict prototypes enabled.
  Issue [#208][gh_208].

  [gh_208]: https://github.com/jmcnamara/libxlsxwriter/issues/208

- Make py.test name configurable.
  Pull request [#206][gh_206].

  [gh_206]: https://github.com/jmcnamara/libxlsxwriter/pull/206


## 0.8.4 November 10 2018

- Fix for issue when hashing number formats.
  Issue [#203][gh_203].

  [gh_203]: https://github.com/jmcnamara/libxlsxwriter/issues/203


## 0.8.3 October 1 2018

- Added `worksheet_write_rich_string()` function to allow writing of
  multi-format rich strings. See @ref rich_strings.c
  Feature request [#37][gh_37].

  [gh_37]: https://github.com/jmcnamara/libxlsxwriter/issues/37


## 0.8.2 September 16 2018

- Added new chartsheet functionality: `chartsheet_set_tab_color()`, and
  `chartsheet_set_zoom()`.


## 0.8.1 September 15 2018

- Fix for chartsheet and worksheet ordering issue.

- Added new chartsheet functionality: `chartsheet_protect()`,
  `chartsheet_hide()`, `chartsheet_select()` and
  `chartsheet_set_first_sheet()`.


## 0.8.0 September 12 2018

- Added chartsheet support. A chartsheet is a type of worksheet that only
  contains a chart. See the @ref chartsheet.h "Chartsheet" object and @ref
  chartsheet.c.


## 0.7.9 September 1 2018

- Added `chart_axis_set_label_align()` function to set the alignment of chart
  category axis labels.
  Feature request [#186][gh_186].

  [gh_186]: https://github.com/jmcnamara/libxlsxwriter/issues/186

- Added `lxw_version()` function to get the library version.
  Feature request [#194][gh_194].

  [gh_194]: https://github.com/jmcnamara/libxlsxwriter/pull/194


## 0.7.8 August 30 2018

- Added `worksheet_insert_image_buffer()` function to insert images from
  memory buffers. See @ref image_buffer.c.
  Feature request [#125][gh_125].

  [gh_125]: https://github.com/jmcnamara/libxlsxwriter/issues/125


## 0.7.7 May 16 2018

- Fix to ensure the use of wide filenames on Windows with Microsoft Visual
  C++.
  Issue [#153][gh_153].

  [gh_153]: https://github.com/jmcnamara/libxlsxwriter/issues/153

- Added docs on building an app with Cmake and Microsoft Visual C++ on
  Windows.


## 0.7.6 January 11 2018

- Added support for worksheet Grouping and Outlines.
  See @ref working_with_outlines.
  Feature request [#30][gh_30].

  [gh_30]: https://github.com/jmcnamara/libxlsxwriter/issues/30

- Fix include of libxlsxwriter as a Cocoapod on macOS.
  Issue [#94][gh_94].

  [gh_94]: https://github.com/jmcnamara/libxlsxwriter/issues/94


## 0.7.5 September 25 2017

- Added support for data validations and dropdown lists. See @ref
  working_with_data_validation and @ref data_validate.c.
  Feature request [#31][gh_31].

  [gh_31]: https://github.com/jmcnamara/libxlsxwriter/issues/31


## 0.7.4 August 20 2017

- Fix make build system "install" target for compatibility with macOS
  [brew/homebrew](https://brew.sh) installer. See @ref gsg_brew.


## 0.7.3 August 12 2017


- Build system fixes for Gentoo.
  Issue [#116][gh_116].

  [gh_116]: https://github.com/jmcnamara/libxlsxwriter/issues/116


## 0.7.2 July 26 2017

- Changed font sizes from integer to double to allow fractional font sizes.
  Issue [#114][gh_114].

  [gh_114]: https://github.com/jmcnamara/libxlsxwriter/issues/114


## 0.7.1 July 24 2017

- Fixed issue where internal file creation and modification dates were in the
  local timezone instead of UTC.
  Issue [#110][gh_110].

  [gh_110]: https://github.com/jmcnamara/libxlsxwriter/issues/110


## 0.7.0 June 26 2017

- Added support for CMake build system.
  Thanks to Alex Huszagh.

- Fixed issue where image filehandles weren't closed until the overall file
  was closed causing the system to run out of filehandles.
  Issue [#106][gh_106].

  [gh_106]: https://github.com/jmcnamara/libxlsxwriter/issues/106

## 0.6.9 January 30 2017

- Added chart trendlines. See @ref chart_trendlines and
  @ref chart_data_tools.c.


## 0.6.8 January 28 2017

- Added chart error bars. See @ref chart_error_bars and
  @ref chart_data_tools.c.

## 0.6.7 January 24 2017

- Added chart data labels. See @ref chart_labels.


## 0.6.6 January 22 2017

- Added functions to set chart Up-Down bars: see `chart_set_up_down_bars()`
  and `chart_set_up_down_bars_format()` and @ref chart_data_tools.c.

- Added functions to handle blank and hidden data in charts: see
  `chart_show_blanks_as()` and `chart_show_hidden_data()`.


## 0.6.5 January 21 2017

- Added functions to set the overlap and gap between series: see
  `chart_set_series_overlap()` and `chart_set_series_gap()`.


## 0.6.4 January 20 2017

- Added chart data table option, see `chart_set_table()` and
  `chart_set_table_grid()`.

- Added Clustered Chart example, see @ref chart_clustered.c.


## 0.6.3 January 19 2017

- Added `chart_set_drop_lines()` and `chart_set_high_low_lines()` functions to
  add chart Drop and High-Low lines to indicate category values.
  See @ref chart_data_tools.c.


## 0.6.2 January 17 2017

- Added `chart_series_set_smooth()` function to set the line smoothing
  property of a line or scatter chart series.


## 0.6.1 January 16 2017

- Added option to set formatting for points in a chart. This allow the colors
  of Pie chart segments to be defined. See @ref chart_points.


## 0.6.0 January 15 2017

- Added option to set the number format for a chart axis, see
  `chart_axis_set_num_format()`.

- Added "invert if negative" option for series fills, see
  `chart_series_set_invert_if_negative()`.


## 0.5.9 January 14 2017

- Added support for chart axis crossing. See `chart_axis_set_crossing()` and
  `chart_axis_set_crossing_max()`.


## 0.5.8 January 13 2017

- Added `chart_axis_set_major_tick_mark()` and
  `chart_axis_set_minor_tick_mark()` functions to chart axis tick marks.


## 0.5.7 January 12 2017

- Added `chart_axis_set_display_units()` function to set chart axis display
  units.


## 0.5.6 January 11 2017

- Added `chart_axis_set_interval_unit()` and `chart_axis_set_interval_tick()`
  functions to adjust category axis intervals.


## 0.5.5 January 10 2017

- Added `chart_axis_set_major_unit()` and `chart_axis_set_minor_unit()` to set
  the major and minor units of a category axis.


## 0.5.4 January 9 2017

- Added `chart_axis_set_label_position()` option to position the axis labels
  (numbers).

- Improved documentation for @ref ww_charts_axes.


## 0.5.3 January 8 2017

- Added `chart_axis_set_position()` option to position a category axis
  horizontally on, or between, the axis tick marks.


## 0.5.2 January 7 2017

- Added option to turn off chart axis: `chart_axis_off()`.


## 0.5.1 January 6 2017

- Added chart major and minor gridlines handling, see:

  - `chart_axis_major_gridlines_set_visible()`
  - `chart_axis_minor_gridlines_set_visible()`
  - `chart_axis_major_gridlines_set_line()`
  - `chart_axis_minor_gridlines_set_line()`


## 0.5.0 January 5 2017

- Added chart and plot area formatting. See `chart_chartarea_set_line()` and
  `chart_plotarea_set_line()`.


## 0.4.9 January 4 2017

- Added support for chart patterns. See @ref chart_patterns.


## 0.4.8 January 3 2017

- Added support for chart markers. See @ref chart_markers.


## 0.4.7 January 2 2017

- Added `chart_axis_set_reverse()` function to reverse the order of a chart
  axis.

- Added `chart_axis_set_min()`and `chart_axis_set_max()` functions to set the
  minimum and maximum value for a chart axis.

- Added `chart_axis_set_log_base()` function to set the log base of a chart
  axis.
  Feature request [#70][gh_70].

  [gh_70]: https://github.com/jmcnamara/libxlsxwriter/issues/70


## 0.4.6 January 1 2017

- Added functions to set chart line and fill properties, see:

  - `chart_series_set_line()`. Feature request [#83][gh_83].
  - `chart_series_set_fill()`.
  - `chart_axis_set_line()`.
  - `chart_axis_set_fill()`.
  - @ref chart_lines.
  - @ref chart_fills.

  [gh_83]: https://github.com/jmcnamara/libxlsxwriter/issues/83


## 0.4.5 December 31 2016

- Added functions to set chart legend properties: see  `chart_legend_set_position()`,
  `chart_legend_set_font()` and `chart_legend_delete_series()`.


## 0.4.4 December 30 2016
- Added chart fonts. See `chart_axis_set_name_font()`, `chart_axis_set_num_font()`,
  `chart_title_set_name_font()` and @ref chart_fonts.


## 0.4.3 December 26 2016

- Added `workbook_get_worksheet_by_name()` function to get a worksheet
  object from its name.

- Added `workbook_validate_worksheet_name()` function to validate a worksheet
  name.

- Fix for parameter length check when strings are UTF-8.
  Issue [#84][gh_84].

  [gh_84]: https://github.com/jmcnamara/libxlsxwriter/issues/84


## 0.4.2 July 14 2016

- Added support for OpenBSD and better support for FreeBSD. See @ref gsg_bsd.


## 0.4.1 July 11 2016

- Switched to using
  [tmpfileplus](http://www.di-mgt.com.au/c_function_to_create_temp_file.html)
  for temporary file handles to work around issue when the temp directory on
  Windows isn't writeable. The temp file directory is now also configurable at
  runtime, see @ref gsg_tmpdir.

  Issue [#63][gh_63].

  [gh_63]: https://github.com/jmcnamara/libxlsxwriter/issues/63


## 0.4.0 July 5 2016

- Added fixes for MSVC 2010.

- Refactored public APIs to return #lxw_error instead of int.


## 0.3.9 July 2 2016

- Added support for MinGW, MinGW-w64, Cygwin, MSYS and MSYS2.
  See @ref gsg_ming.


## 0.3.8 June 11 2016

- Added workbook functions to set custom document properties. See
  `workbook_set_custom_property_string()` and @ref doc_custom_properties.c.


## 0.3.7 June 2 2016

- Added updated Cocoapods file for Cocoapods 1.0.0. This also add support for
  the "use_frameworks" directive. Thanks to Ludovico Rossi. See @ref
  getting_started for instructions on how to use the cocoapod.

  Pull request [#50][gh_50].

  [gh_50]: https://github.com/jmcnamara/libxlsxwriter/issues/50


## 0.3.6 June 1 2016

- Fix for `worksheet_insert_image()` issue when handling images with zero dpi.


## 0.3.5 May 31 2016

- Refactored the error handling and reporting for when the file creation
  subsystem fails due to file permissions or other issues. The new error codes
  are in `#lxw_error` and the codes can be converted to strings, for reporting,
  using the new `lxw_strerror()` function.

  Issue [#49][gh_49].

  [gh_49]: https://github.com/jmcnamara/libxlsxwriter/issues/49


## 0.3.4 May 28 2016

- Updated the @ref getting_started docs with instructions on how to build
  libxlsxwriter for Windows using Microsoft Visual Studio and added links to
  the example MSVC project:
  [MSVCLibXlsxWriter](https://github.com/jmcnamara/MSVCLibXlsxWriter).


## 0.3.3 May 23 2016

- Added support for charts via the @ref chart.h "The Chart object". See the
  examples of the supported chart types:

  - @ref chart_area.c       "Area chart"
  - @ref chart_bar.c        "Bar chart"
  - @ref chart_column.c     "Column chart"
  - @ref chart_line.c       "Line chart"
  - @ref chart_scatter.c    "Scatter chart"
  - @ref chart_radar.c      "Radar chart"
  - @ref chart_pie.c        "Pie chart"
  - @ref chart_doughnut.c   "Doughnut chart"
  - @ref chart_styles.c     "Built-in charts styles"

  Feature request [#36][gh_36].

  [gh_36]: https://github.com/jmcnamara/libxlsxwriter/issues/36


## 0.3.2 April 8 2016

- Added the `worksheet_write_boolean()` function to write Excel boolean
  values.
  Feature request [#47][gh_47].

  [gh_47]: https://github.com/jmcnamara/libxlsxwriter/issues/47


## 0.3.1 January 9 2016

- Improved performance 20-30% for large data files.


## 0.3.0 January 4 2016

- Renamed `worksheet_set_row()` function to `worksheet_set_row_opt()` for
  consistency with current and future APIs. The `worksheet_set_row()` function
  is now used without the options parameter.

  Note: This is a backward incompatible change.


- Renamed `worksheet_set_column()` function to `worksheet_set_column_opt()`
  for consistency with current and future APIs. The `worksheet_set_column()`
  function is now used without the options parameter.

  Note: This is a backward incompatible change.


## 0.2.9 January 3 2016

- Added the `worksheet_insert_image()` function to add PNG and JPG images to
  worksheets. See @ref demo.c and @ref images.c.


## 0.2.8 December 22 2015

- Added `worksheet_set_default_row()` function to allow setting of default row
  height and hiding unused rows. See the @ref hide_row_col.c example.


## 0.2.7 December 21 2015

- Added support for escaping control characters in strings. This prevents
  unreadable files if string data contains control characters.
  Issue [#42][gh_42].

  [gh_42]: https://github.com/jmcnamara/libxlsxwriter/issues/42


## 0.2.6 December 19 2015

- Added `worksheet_protect()` function to protect Excel worksheet elements
  from modification. See the @ref worksheet_protection.c example.


## 0.2.5 December 14 2015

- Added `workbook_set_properties()` function to set Excel document properties
  such as Author and Title. See the @ref doc_properties.c example.


## 0.2.4 December 13 2015

- Added `worksheet_hide()` function to hide a worksheet. See the @ref
  hide_sheet.c example.

- Added `worksheet_set_first_sheet()` function to set the first visible
  worksheet in a workbook with a large number of worksheets.


## 0.2.3 December 12 2015

- Added `worksheet_set_tab_color()` function to set the worksheet tab
  color. See the @ref tab_colors.c example.


## 0.2.2 December 11 2015

- Replaced shared strings hash table with a Red/Black tree implementation for
  better performance.
  Thanks to Martin Renters. Pull Request [#41][gh_41].

  [gh_41]: https://github.com/jmcnamara/libxlsxwriter/issues/41


## 0.2.1 December 11 2015

- Added `worksheet_right_to_left()` function. This can be used to change the
  default direction of the worksheet from left-to-right when creating Arabic,
  Hebrew or other near or far eastern worksheets that use right-to-left as the
  default direction.

- Added `worksheet_hide_zero()` function to hide zero cell values.

- Added `worksheet_set_zoom()` method to set the worksheet zoom factor.


## 0.2.0 December 9 2015

- Added `worksheet_set_selection()` function to set the cell selected range on
  a worksheet.


## 0.1.9 December 7 2015

- Replaced main worksheet data structure with a Red/Black tree implementation
  for better performance when data isn't added in linear row-column order.
  Thanks to Martin Renters. Pull Request [#14][gh_14] and [#16][gh_16].

  [gh_14]: https://github.com/jmcnamara/libxlsxwriter/issues/14
  [gh_16]: https://github.com/jmcnamara/libxlsxwriter/issues/16


## 0.1.8 December 7 2015

- Added `worksheet_freeze_panes()` and `worksheet_split_panes()` to allow
  setting worksheet panes. See @ref panes.c example.

- Added link to [Xcode project][libxlsxwriterCocoaExamples] for iOS and OS X
  with Objective-C and Swift, provided by Ludovico Rossi.

- Added improved support for Windows.

  [libxlsxwriterCocoaExamples]: https://github.com/lrossi/libxlsxwriterCocoaExamples

## 0.1.7 September 27 2015

- Fixed Cocoapod spec file for iOS and OS X.


## 0.1.6 September 27 2015

- Added Cocoapod spec file to allow the library to be installed using
  [CocoaPods](https://cocoapods.org).
  Pull Request [#7](https://github.com/jmcnamara/libxlsxwriter/issues/7).


## 0.1.5 May 3 2015

- Added `worksheet_write_url()` function to write urls/hyperlinks to
  worksheets. See also @ref hyperlinks.c.


## 0.1.4 March 18 2015

- Added `worksheet_autofilter()` function to add autofilters to worksheets.
  See also @ref autofilter.c.


## 0.1.3 March 15 2015

- Added `worksheet_write_array_formula()` function to allow writing of
  array formulas in worksheets.


## 0.1.2 March 14 2015

- Added `worksheet_set_h_pagebreaks()` and `worksheet_set_v_pagebreaks()`
  functions to define worksheet page breaks.

- Added LXW_FOREACH_WORKSHEET() macro to allow iteration over all the
  worksheets in a workbook.

- Added `worksheet_set_print_scale()` function to set the scale factor for
  the printed page.

- Added `worksheet_set_start_page()` function to set the start page number
  when printing.


## 0.1.1 March 13 2015

- Added `worksheet_print_area()` function to control the print area of a
  worksheet.

- Added `worksheet_fit_to_pages()` function to fit the printed area to a
  specific number of pages both vertically and horizontally.


## 0.1.0 March 12 2015

- Added `worksheet_repeat_rows()` and `worksheet_repeat_columns()` functions
  to control the repeated rows/columns on printed worksheets.


## 0.0.9 March 9 2015

- Added `worksheet_gridlines()` function to show/hide screen and print
  gridlines.

- Added `worksheet_center_horizontally()` and `worksheet_center_vertically()`
  functions to center worksheet on the printed page.

- Added `worksheet_print_row_col_headers()` function to enable printing of row
  and column headers.


## 0.0.8 March 8 2015

- Added support for worksheet headers and footers via the
  `worksheet_set_header()` and `worksheet_set_footer()` functions. See also
  @ref headers_footers.c.


## 0.0.7 March 7 2015

- Added the `worksheet_merge_range()` method to merge worksheet cells. See
  also @ref merge_range.c.


## 0.0.6 March 5 2015

- Added the `workbook_define_name()` method to create defined names and ranges
  in a workbook or worksheet.


## 0.0.5 March 6 2015

- Added `worksheet_select()` function to set worksheets as selected.

- Added `worksheet_activate()` to set the active worksheet.

- Several portability fixes to fix warnings with different compilers.


## 0.0.4 March 1 2015

- Added `worksheet_set_margins()` function to set top, bottom, left and right
  margins in a worksheet.

- Fix for issue where format objects were written to the file in the order of
  creation rather than the order of use. This issue caused incorrect formats
  in cells.
  Issue [#3](https://github.com/jmcnamara/libxlsxwriter/issues/3).

- Fix for issue where tmp files in `constant_memory` mode weren't closed
  until application exited.
  Issue [#1](https://github.com/jmcnamara/libxlsxwriter/issues/1).


## 0.0.3 January 7 2015

-   Added worksheet page setup methods.

    -   `worksheet_set_landscape()`
    -   `worksheet_set_portrait()`
    -   `worksheet_set_page_view()`
    -   `worksheet_set_paper()`
    -   `worksheet_print_across()`


## 0.0.2 June 26 2014

- First public release.


## 0.0.1 June 8 2014

- First GitHub release.


*/
