xlsxwriter 0.0.3 → 0.0.4.pre.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a6f5f03efc612b8ffe35f2ef05469e2866793dd4
-  data.tar.gz: 62d0c4d63bc61a782fd481ef906b13fb28e9ac74
+  metadata.gz: 839412a8decaf536e0038b052d1011decb97def0
+  data.tar.gz: b0f75509d82602b093b07a2eb82309b0da97d595
 SHA512:
-  metadata.gz: 7536f8487db5f37a3b1cce3f2b74eeba1f00f64db1c6ee55ad5ee58f4ca65c78a12fc3e5f4d939cbb4cd85f333b3a525a0ce2b36bb7a53ead4e7a22d0652d424
-  data.tar.gz: 0e718cd11773b8774cdc86dae2ecbe5c4a82bcabb43387b8ebd70db3bee983a7e7307398d9fa1e910c2898efab8dd067e4d88b17fc7873ffac887e0f4b67e2d7
+  metadata.gz: 2a664d20a84b92fa12ff13bc6f8ef8505a6c403aacc9909ca69954480e6d7fd3913939a817d96bf90a69170b74a812704a76af5be1021c43561de31ae263bfe2
+  data.tar.gz: e348114d307aa35244210e9b62f8cd3e89b38b9dd25f9724de94e17c9226393da5021a72d22e121196a20d6777fad5058708167fd9e62175713f49d3a3ce740f

data/ext/xlsxwriter/libxlsxwriter/{LICENSE.txt → License.txt}

@@ -1,3 +1,6 @@
+/**
+
+@page license License
 
 Libxlsxwriter is released under a FreeBSD license:
 
@@ -31,8 +34,8 @@ Libxlsxwriter is released under a FreeBSD license:
     official policies, either expressed or implied, of the FreeBSD Project.
 
 
-Libxlsxwriter includes `queue.h` from FreeBSD and the `minizip` component of
-`zlib` which have the following licenses:
+Libxlsxwriter includes `queue.h` and `tree.h` from FreeBSD, the `minizip`
+component of `zlib` and `tmpfileplus` which have the following licenses:
 
 
 Queue.h from FreeBSD:
@@ -65,7 +68,35 @@ Queue.h from FreeBSD:
     SUCH DAMAGE.
 
 
-Zlib has the following License/Copyright:
+Tree.h from FreeBSD:
+
+    Copyright 2002 Niels Provos <provos@citi.umich.edu>
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions
+    are met:
+    1. Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+    IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+The `minizip` files used in the libxlsxwriter source tree are taken from the
+`zlib` ` contrib/minizip` directory. [Zlib](http://www.zlib.net) has the
+following License/Copyright:
 
     (C) 1995-2013 Jean-loup Gailly and Mark Adler
 
@@ -87,3 +118,33 @@ Zlib has the following License/Copyright:
 
     Jean-loup Gailly        Mark Adler
     jloup@gzip.org          madler@alumni.caltech.edu
+
+The `minizip` files have the following additional copyright declarations:
+
+    Copyright (C) 1998-2010 Gilles Vollant
+    (minizip) ( http://www.winimage.com/zLibDll/minizip.html )
+
+    Modifications for Zip64 support
+    Copyright (C) 2009-2010 Mathias Svensson ( http://result42.com )
+
+Note, it is possible to compile libxlsxwriter without statically linking the
+`minizip` files and instead dynamically linking to `lminizip`, see
+@ref gsg_minizip.
+
+[Tmpfileplus](http://www.di-mgt.com.au/c_function_to_create_temp_file.html)
+has the following license:
+
+     This Source Code Form is subject to the terms of the Mozilla Public
+     License, v. 2.0. If a copy of the MPL was not distributed with this
+     file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+     Copyright (c) 2012-16 David Ireland, DI Management Services Pty Ltd
+     <http://www.di-mgt.com.au/contact/>.
+
+See the [Mozilla Public License, v. 2.0](http://mozilla.org/MPL/2.0/).
+
+Note, it is possible to compile libxlsxwriter using the standard library
+`tmpfile()` function instead of `tmpfileplus`, see @ref gsg_tmpdir.
+
+Next: @ref changes
+*/

data/ext/xlsxwriter/libxlsxwriter/Makefile

@@ -11,11 +11,15 @@ ifdef V
 Q=
 endif
 
+INSTALL_DIR ?= /usr/local
+
 .PHONY: docs tags examples
 
 # Build the libs.
 all :
+ifndef USE_SYSTEM_MINIZIP
 	$(Q)$(MAKE) -C third_party/minizip
+endif
 ifndef USE_STANDARD_TMPFILE
 	$(Q)$(MAKE) -C third_party/tmpfileplus
 endif
@@ -31,11 +35,13 @@ clean :
 	$(Q)$(MAKE) clean -C test/unit
 	$(Q)$(MAKE) clean -C test/functional/src
 	$(Q)$(MAKE) clean -C examples
-	$(Q)$(MAKE) clean -C third_party/minizip
 	$(Q)rm -rf docs/html
 	$(Q)rm -rf test/functional/__pycache__
 	$(Q)rm -f  test/functional/*.pyc
 	$(Q)rm -f  lib/*
+ifndef USE_STANDARD_TMPFILE
+	$(Q)$(MAKE) clean -C third_party/minizip
+endif
 ifndef USE_STANDARD_TMPFILE
 	$(Q)$(MAKE) clean -C third_party/tmpfileplus
 endif
@@ -43,6 +49,12 @@ endif
 # Run the unit tests.
 test : all test_functional test_unit
 
+# Test for C++ const correctness on APIs.
+test_const : all
+	$(Q)$(MAKE) clean -C test/functional/src
+	$(Q)! $(MAKE) -C test/functional/src CFLAGS=-Wwrite-strings 2>&1 | grep -A 1 "note:"
+
+
 # Run the functional tests.
 test_functional : all
 	$(Q)$(MAKE) -C test/functional/src
@@ -51,7 +63,9 @@ test_functional : all
 # Run all tests.
 test_unit :
 	@echo "Compiling unit tests ..."
+ifndef USE_SYSTEM_MINIZIP
 	$(Q)$(MAKE) -C third_party/minizip
+endif
 ifndef USE_STANDARD_TMPFILE
 	$(Q)$(MAKE) -C third_party/tmpfileplus
 endif
@@ -83,14 +97,16 @@ docs:
 	$(Q)$(MAKE) -C docs
 
 # Simple minded install.
-install:
-	$(Q)cp -r include/* /usr/include
-	$(Q)cp lib/* /usr/lib
+install: all
+	$(Q)mkdir -p        $(INSTALL_DIR)/include
+	$(Q)cp -R include/* $(INSTALL_DIR)/include
+	$(Q)mkdir -p        $(INSTALL_DIR)/lib
+	$(Q)cp lib/*        $(INSTALL_DIR)/lib
 
 # Simpler minded uninstall.
 uninstall:
-	$(Q)rm -rf /usr/include/xlsxwriter*
-	$(Q)rm /usr/lib/libxlsxwriter.*
+	$(Q)rm -rf $(INSTALL_DIR)/include/xlsxwriter*
+	$(Q)rm     $(INSTALL_DIR)/lib/libxlsxwriter.*
 
 # Strip the lib files.
 strip:
@@ -98,16 +114,35 @@ strip:
 
 # Run a coverity static analysis.
 coverity:
+ifndef USE_SYSTEM_MINIZIP
 	$(Q)$(MAKE) -C third_party/minizip
+endif
+ifndef USE_STANDARD_TMPFILE
+	$(Q)$(MAKE) -C third_party/tmpfileplus
+endif
 	$(Q)$(MAKE) -C src clean
 	$(Q)rm -f  lib/*
 	$(Q)rm -rf  cov-int
 	$(Q)rm -f libxlsxwriter-coverity.tgz
-	$(Q)../cov-analysis-macosx-7.7.0.4/bin/cov-build --dir cov-int make -C src libxlsxwriter.a
+	$(Q)../../cov-analysis-linux64-8.7.0/bin/cov-build --dir cov-int make -C src libxlsxwriter.a
 	$(Q)tar -czf libxlsxwriter-coverity.tgz cov-int
 	$(Q)$(MAKE) -C src clean
 	$(Q)rm -f  lib/*
 
+# Run a scan-build static analysis.
+scan_build:
+ifndef USE_SYSTEM_MINIZIP
+	$(Q)$(MAKE) -C third_party/minizip
+endif
+ifndef USE_STANDARD_TMPFILE
+	$(Q)$(MAKE) -C third_party/tmpfileplus
+endif
+	$(Q)$(MAKE) -C src clean
+	$(Q)rm -f  lib/*
+	$(Q)scan-build make -C src libxlsxwriter.a
+	$(Q)$(MAKE) -C src clean
+	$(Q)rm -f  lib/*
+
 spellcheck:
 	$(Q)for f in docs/src/*.dox;         do aspell --lang=en_US --check $$f; done
 	$(Q)for f in include/xlsxwriter/*.h; do aspell --lang=en_US --check $$f; done

data/ext/xlsxwriter/libxlsxwriter/include/xlsxwriter.h

@@ -18,6 +18,6 @@
 #include "xlsxwriter/format.h"
 #include "xlsxwriter/utility.h"
 
-#define LXW_VERSION "0.4.6"
+#define LXW_VERSION "0.7.5"
 
 #endif /* __LXW_XLSXWRITER_H__ */

data/ext/xlsxwriter/libxlsxwriter/include/xlsxwriter/app.h

@@ -11,8 +11,8 @@
 
 #include <stdint.h>
 #include <string.h>
-#include "xlsxwriter/workbook.h"
-#include "xlsxwriter/common.h"
+#include "workbook.h"
+#include "common.h"
 
 /* Define the queue.h TAILQ structs for the App structs. */
 STAILQ_HEAD(lxw_heading_pairs, lxw_heading_pair);

data/ext/xlsxwriter/libxlsxwriter/include/xlsxwriter/chart.h

@@ -81,8 +81,11 @@ STAILQ_HEAD(lxw_chart_series_list, lxw_chart_series);
 STAILQ_HEAD(lxw_series_data_points, lxw_series_data_point);
 
 #define LXW_CHART_NUM_FORMAT_LEN 128
+#define LXW_CHART_DEFAULT_GAP 501
 
-/** Available chart types . */
+/**
+ * @brief Available chart types.
+ */
 typedef enum lxw_chart_type {
 
     /** None. */
@@ -149,7 +152,9 @@ typedef enum lxw_chart_type {
     LXW_CHART_RADAR_FILLED
 } lxw_chart_type;
 
-/** Chart legend positions. */
+/**
+ * @brief Chart legend positions.
+ */
 typedef enum lxw_chart_legend_position {
 
     /** No chart legend. */
@@ -174,7 +179,8 @@ typedef enum lxw_chart_legend_position {
     LXW_CHART_LEGEND_OVERLAY_LEFT
 } lxw_chart_legend_position;
 
-/** @brief Chart line dash types.
+/**
+ * @brief Chart line dash types.
  *
  * The dash types are shown in the order that they appear in the Excel dialog.
  * See @ref chart_lines.
@@ -209,8 +215,254 @@ typedef enum lxw_chart_line_dash_type {
     LXW_CHART_LINE_DASH_DOT,
     LXW_CHART_LINE_DASH_SYSTEM_DASH_DOT,
     LXW_CHART_LINE_DASH_SYSTEM_DASH_DOT_DOT
+} lxw_chart_line_dash_type;
+
+/**
+ * @brief Chart marker types.
+ */
+typedef enum lxw_chart_marker_type {
+
+    /** Automatic, series default, marker type. */
+    LXW_CHART_MARKER_AUTOMATIC,
+
+    /** No marker type. */
+    LXW_CHART_MARKER_NONE,
+
+    /** Square marker type. */
+    LXW_CHART_MARKER_SQUARE,
+
+    /** Diamond marker type. */
+    LXW_CHART_MARKER_DIAMOND,
+
+    /** Triangle marker type. */
+    LXW_CHART_MARKER_TRIANGLE,
+
+    /** X shape marker type. */
+    LXW_CHART_MARKER_X,
+
+    /** Star marker type. */
+    LXW_CHART_MARKER_STAR,
+
+    /** Short dash marker type. */
+    LXW_CHART_MARKER_SHORT_DASH,
+
+    /** Long dash marker type. */
+    LXW_CHART_MARKER_LONG_DASH,
+
+    /** Circle marker type. */
+    LXW_CHART_MARKER_CIRCLE,
+
+    /** Plus (+) marker type. */
+    LXW_CHART_MARKER_PLUS
+} lxw_chart_marker_type;
+
+/**
+ * @brief Chart pattern types.
+ */
+typedef enum lxw_chart_pattern_type {
+
+    /** None pattern. */
+    LXW_CHART_PATTERN_NONE,
+
+    /** 5 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_5,
+
+    /** 10 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_10,
+
+    /** 20 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_20,
+
+    /** 25 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_25,
+
+    /** 30 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_30,
+
+    /** 40 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_40,
+
+    /** 50 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_50,
+
+    /** 60 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_60,
+
+    /** 70 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_70,
+
+    /** 75 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_75,
+
+    /** 80 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_80,
+
+    /** 90 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_90,
+
+    /** Light downward diagonal pattern. */
+    LXW_CHART_PATTERN_LIGHT_DOWNWARD_DIAGONAL,
+
+    /** Light upward diagonal pattern. */
+    LXW_CHART_PATTERN_LIGHT_UPWARD_DIAGONAL,
+
+    /** Dark downward diagonal pattern. */
+    LXW_CHART_PATTERN_DARK_DOWNWARD_DIAGONAL,
+
+    /** Dark upward diagonal pattern. */
+    LXW_CHART_PATTERN_DARK_UPWARD_DIAGONAL,
+
+    /** Wide downward diagonal pattern. */
+    LXW_CHART_PATTERN_WIDE_DOWNWARD_DIAGONAL,
+
+    /** Wide upward diagonal pattern. */
+    LXW_CHART_PATTERN_WIDE_UPWARD_DIAGONAL,
+
+    /** Light vertical pattern. */
+    LXW_CHART_PATTERN_LIGHT_VERTICAL,
+
+    /** Light horizontal pattern. */
+    LXW_CHART_PATTERN_LIGHT_HORIZONTAL,
+
+    /** Narrow vertical pattern. */
+    LXW_CHART_PATTERN_NARROW_VERTICAL,
+
+    /** Narrow horizontal pattern. */
+    LXW_CHART_PATTERN_NARROW_HORIZONTAL,
+
+    /** Dark vertical pattern. */
+    LXW_CHART_PATTERN_DARK_VERTICAL,
+
+    /** Dark horizontal pattern. */
+    LXW_CHART_PATTERN_DARK_HORIZONTAL,
+
+    /** Dashed downward diagonal pattern. */
+    LXW_CHART_PATTERN_DASHED_DOWNWARD_DIAGONAL,
+
+    /** Dashed upward diagonal pattern. */
+    LXW_CHART_PATTERN_DASHED_UPWARD_DIAGONAL,
+
+    /** Dashed horizontal pattern. */
+    LXW_CHART_PATTERN_DASHED_HORIZONTAL,
+
+    /** Dashed vertical pattern. */
+    LXW_CHART_PATTERN_DASHED_VERTICAL,
+
+    /** Small confetti pattern. */
+    LXW_CHART_PATTERN_SMALL_CONFETTI,
+
+    /** Large confetti pattern. */
+    LXW_CHART_PATTERN_LARGE_CONFETTI,
+
+    /** Zigzag pattern. */
+    LXW_CHART_PATTERN_ZIGZAG,
+
+    /** Wave pattern. */
+    LXW_CHART_PATTERN_WAVE,
+
+    /** Diagonal brick pattern. */
+    LXW_CHART_PATTERN_DIAGONAL_BRICK,
+
+    /** Horizontal brick pattern. */
+    LXW_CHART_PATTERN_HORIZONTAL_BRICK,
+
+    /** Weave pattern. */
+    LXW_CHART_PATTERN_WEAVE,
+
+    /** Plaid pattern. */
+    LXW_CHART_PATTERN_PLAID,
+
+    /** Divot pattern. */
+    LXW_CHART_PATTERN_DIVOT,
+
+    /** Dotted grid pattern. */
+    LXW_CHART_PATTERN_DOTTED_GRID,
+
+    /** Dotted diamond pattern. */
+    LXW_CHART_PATTERN_DOTTED_DIAMOND,
+
+    /** Shingle pattern. */
+    LXW_CHART_PATTERN_SHINGLE,
+
+    /** Trellis pattern. */
+    LXW_CHART_PATTERN_TRELLIS,
 
-} lxw_chart_liLINE_ne_dash_type;
+    /** Sphere pattern. */
+    LXW_CHART_PATTERN_SPHERE,
+
+    /** Small grid pattern. */
+    LXW_CHART_PATTERN_SMALL_GRID,
+
+    /** Large grid pattern. */
+    LXW_CHART_PATTERN_LARGE_GRID,
+
+    /** Small check pattern. */
+    LXW_CHART_PATTERN_SMALL_CHECK,
+
+    /** Large check pattern. */
+    LXW_CHART_PATTERN_LARGE_CHECK,
+
+    /** Outlined diamond pattern. */
+    LXW_CHART_PATTERN_OUTLINED_DIAMOND,
+
+    /** Solid diamond pattern. */
+    LXW_CHART_PATTERN_SOLID_DIAMOND
+} lxw_chart_pattern_type;
+
+/**
+ * @brief Chart data label positions.
+ */
+typedef enum lxw_chart_label_position {
+    /** Series data label position: default position. */
+    LXW_CHART_LABEL_POSITION_DEFAULT,
+
+    /** Series data label position: center. */
+    LXW_CHART_LABEL_POSITION_CENTER,
+
+    /** Series data label position: right. */
+    LXW_CHART_LABEL_POSITION_RIGHT,
+
+    /** Series data label position: left. */
+    LXW_CHART_LABEL_POSITION_LEFT,
+
+    /** Series data label position: above. */
+    LXW_CHART_LABEL_POSITION_ABOVE,
+
+    /** Series data label position: below. */
+    LXW_CHART_LABEL_POSITION_BELOW,
+
+    /** Series data label position: inside base.  */
+    LXW_CHART_LABEL_POSITION_INSIDE_BASE,
+
+    /** Series data label position: inside end. */
+    LXW_CHART_LABEL_POSITION_INSIDE_END,
+
+    /** Series data label position: outside end. */
+    LXW_CHART_LABEL_POSITION_OUTSIDE_END,
+
+    /** Series data label position: best fit. */
+    LXW_CHART_LABEL_POSITION_BEST_FIT
+} lxw_chart_label_position;
+
+/**
+ * @brief Chart data label separator.
+ */
+typedef enum lxw_chart_label_separator {
+    /** Series data label separator: comma (the default). */
+    LXW_CHART_LABEL_SEPARATOR_COMMA,
+
+    /** Series data label separator: semicolon. */
+    LXW_CHART_LABEL_SEPARATOR_SEMICOLON,
+
+    /** Series data label separator: period. */
+    LXW_CHART_LABEL_SEPARATOR_PERIOD,
+
+    /** Series data label separator: newline. */
+    LXW_CHART_LABEL_SEPARATOR_NEWLINE,
+
+    /** Series data label separator: space. */
+    LXW_CHART_LABEL_SEPARATOR_SPACE
+} lxw_chart_label_separator;
 
 enum lxw_chart_subtype {
 
@@ -226,17 +478,96 @@ enum lxw_chart_grouping {
     LXW_GROUPING_STACKED
 };
 
-enum lxw_chart_axis_tick_position {
-    LXW_CHART_AXIS_POSITION_BETWEEN,
-    LXW_CHART_AXIS_POSITION_ON_TICK
-};
+/**
+ * @brief Axis positions for category axes.
+ */
+typedef enum lxw_chart_axis_tick_position {
 
-enum lxw_chart_position {
-    LXW_CHART_AXIS_RIGHT,
-    LXW_CHART_AXIS_LEFT,
-    LXW_CHART_AXIS_TOP,
-    LXW_CHART_AXIS_BOTTOM
-};
+    LXW_CHART_AXIS_POSITION_DEFAULT,
+
+    /** Position category axis on tick marks. */
+    LXW_CHART_AXIS_POSITION_ON_TICK,
+
+    /** Position category axis between tick marks. */
+    LXW_CHART_AXIS_POSITION_BETWEEN
+} lxw_chart_axis_tick_position;
+
+/**
+ * @brief Axis label positions.
+ */
+typedef enum lxw_chart_axis_label_position {
+
+    /** Position the axis labels next to the axis. The default. */
+    LXW_CHART_AXIS_LABEL_POSITION_NEXT_TO,
+
+    /** Position the axis labels at the top of the chart, for horizontal
+     * axes, or to the right for vertical axes.*/
+    LXW_CHART_AXIS_LABEL_POSITION_HIGH,
+
+    /** Position the axis labels at the bottom of the chart, for horizontal
+     * axes, or to the left for vertical axes.*/
+    LXW_CHART_AXIS_LABEL_POSITION_LOW,
+
+    /** Turn off the the axis labels. */
+    LXW_CHART_AXIS_LABEL_POSITION_NONE
+} lxw_chart_axis_label_position;
+
+/**
+ * @brief Display units for chart value axis.
+ */
+typedef enum lxw_chart_axis_display_unit {
+
+    /** Axis display units: None. The default. */
+    LXW_CHART_AXIS_UNITS_NONE,
+
+    /** Axis display units: Hundreds. */
+    LXW_CHART_AXIS_UNITS_HUNDREDS,
+
+    /** Axis display units: Thousands. */
+    LXW_CHART_AXIS_UNITS_THOUSANDS,
+
+    /** Axis display units: Ten thousands. */
+    LXW_CHART_AXIS_UNITS_TEN_THOUSANDS,
+
+    /** Axis display units: Hundred thousands. */
+    LXW_CHART_AXIS_UNITS_HUNDRED_THOUSANDS,
+
+    /** Axis display units: Millions. */
+    LXW_CHART_AXIS_UNITS_MILLIONS,
+
+    /** Axis display units: Ten millions. */
+    LXW_CHART_AXIS_UNITS_TEN_MILLIONS,
+
+    /** Axis display units: Hundred millions. */
+    LXW_CHART_AXIS_UNITS_HUNDRED_MILLIONS,
+
+    /** Axis display units: Billions. */
+    LXW_CHART_AXIS_UNITS_BILLIONS,
+
+    /** Axis display units: Trillions. */
+    LXW_CHART_AXIS_UNITS_TRILLIONS
+} lxw_chart_axis_display_unit;
+
+/**
+ * @brief Tick mark types for an axis.
+ */
+typedef enum lxw_chart_axis_tick_mark {
+
+    /** Default tick mark for the chart axis. Usually outside. */
+    LXW_CHART_AXIS_TICK_MARK_DEFAULT,
+
+    /** No tick mark for the axis. */
+    LXW_CHART_AXIS_TICK_MARK_NONE,
+
+    /** Tick mark inside the axis only. */
+    LXW_CHART_AXIS_TICK_MARK_INSIDE,
+
+    /** Tick mark outside the axis only. */
+    LXW_CHART_AXIS_TICK_MARK_OUTSIDE,
+
+    /** Tick mark inside and outside the axis. */
+    LXW_CHART_AXIS_TICK_MARK_CROSSING
+} lxw_chart_tick_mark;
 
 typedef struct lxw_series_range {
     char *formula;
@@ -291,7 +622,7 @@ typedef struct lxw_chart_line {
 } lxw_chart_line;
 
 /**
- * @brief Struct to represent a chart line.
+ * @brief Struct to represent a chart fill.
  *
  * See @ref chart_fills.
  */
@@ -311,6 +642,28 @@ typedef struct lxw_chart_fill {
 
 } lxw_chart_fill;
 
+/**
+ * @brief Struct to represent a chart pattern.
+ *
+ * See @ref chart_patterns.
+ */
+typedef struct lxw_chart_pattern {
+
+    /** The pattern foreground color. See @ref working_with_colors. */
+    lxw_color_t fg_color;
+
+    /** The pattern background color. See @ref working_with_colors. */
+    lxw_color_t bg_color;
+
+    /** The pattern type. See #lxw_chart_pattern_type. */
+    uint8_t type;
+
+    /* Members for internal use only. */
+    uint8_t has_fg_color;
+    uint8_t has_bg_color;
+
+} lxw_chart_pattern;
+
 /**
  * @brief Struct to represent a chart font.
  *
@@ -322,7 +675,7 @@ typedef struct lxw_chart_font {
     char *name;
 
     /** The chart font size. The default is 11. */
-    uint16_t size;
+    double size;
 
     /** The chart font bold property. Set to 0 or 1. */
     uint8_t bold;
@@ -347,6 +700,16 @@ typedef struct lxw_chart_font {
 
 } lxw_chart_font;
 
+typedef struct lxw_chart_marker {
+
+    uint8_t type;
+    uint8_t size;
+    lxw_chart_line *line;
+    lxw_chart_fill *fill;
+    lxw_chart_pattern *pattern;
+
+} lxw_chart_marker;
+
 typedef struct lxw_chart_legend {
 
     lxw_chart_font *font;
@@ -372,6 +735,126 @@ typedef struct lxw_chart_title {
 
 } lxw_chart_title;
 
+/**
+ * @brief Struct to represent an Excel chart data point.
+ *
+ * The lxw_chart_point used to set the line, fill and pattern of one or more
+ * points in a chart data series. See @ref chart_points.
+ */
+typedef struct lxw_chart_point {
+
+    /** The line/border for the chart point. See @ref chart_lines. */
+    lxw_chart_line *line;
+
+    /** The fill for the chart point. See @ref chart_fills. */
+    lxw_chart_fill *fill;
+
+    /** The pattern for the chart point. See @ref chart_patterns.*/
+    lxw_chart_pattern *pattern;
+
+} lxw_chart_point;
+
+/**
+ * @brief Define how blank values are displayed in a chart.
+ */
+typedef enum lxw_chart_blank {
+
+    /** Show empty chart cells as gaps in the data. The default. */
+    LXW_CHART_BLANKS_AS_GAP,
+
+    /** Show empty chart cells as zeros. */
+    LXW_CHART_BLANKS_AS_ZERO,
+
+    /** Show empty chart cells as connected. Only for charts with lines. */
+    LXW_CHART_BLANKS_AS_CONNECTED
+} lxw_chart_blank;
+
+enum lxw_chart_position {
+    LXW_CHART_AXIS_RIGHT,
+    LXW_CHART_AXIS_LEFT,
+    LXW_CHART_AXIS_TOP,
+    LXW_CHART_AXIS_BOTTOM
+};
+
+/**
+ * @brief Type/amount of data series error bar.
+ */
+typedef enum lxw_chart_error_bar_type {
+    /** Error bar type: Standard error. */
+    LXW_CHART_ERROR_BAR_TYPE_STD_ERROR,
+
+    /** Error bar type: Fixed value. */
+    LXW_CHART_ERROR_BAR_TYPE_FIXED,
+
+    /** Error bar type: Percentage. */
+    LXW_CHART_ERROR_BAR_TYPE_PERCENTAGE,
+
+    /** Error bar type: Standard deviation(s). */
+    LXW_CHART_ERROR_BAR_TYPE_STD_DEV
+} lxw_chart_error_bar_type;
+
+/**
+ * @brief Direction for a data series error bar.
+ */
+typedef enum lxw_chart_error_bar_direction {
+
+    /** Error bar extends in both directions. The default. */
+    LXW_CHART_ERROR_BAR_DIR_BOTH,
+
+    /** Error bar extends in positive direction. */
+    LXW_CHART_ERROR_BAR_DIR_PLUS,
+
+    /** Error bar extends in negative direction. */
+    LXW_CHART_ERROR_BAR_DIR_MINUS
+} lxw_chart_error_bar_direction;
+
+/**
+ * @brief End cap styles for a data series error bar.
+ */
+typedef enum lxw_chart_error_bar_cap {
+    /** Flat end cap. The default. */
+    LXW_CHART_ERROR_BAR_END_CAP,
+
+    /** No end cap. */
+    LXW_CHART_ERROR_BAR_NO_CAP
+} lxw_chart_error_bar_cap;
+
+typedef struct lxw_series_error_bars {
+    uint8_t type;
+    uint8_t direction;
+    uint8_t endcap;
+    uint8_t has_value;
+    uint8_t is_set;
+    uint8_t is_x;
+    uint8_t chart_group;
+    double value;
+    lxw_chart_line *line;
+
+} lxw_series_error_bars;
+
+/**
+ * @brief Series trendline/regression types.
+ */
+typedef enum lxw_chart_trendline_type {
+    /** Trendline type: Linear. */
+    LXW_CHART_TRENDLINE_TYPE_LINEAR,
+
+    /** Trendline type: Logarithm. */
+    LXW_CHART_TRENDLINE_TYPE_LOG,
+
+    /** Trendline type: Polynomial. */
+    LXW_CHART_TRENDLINE_TYPE_POLY,
+
+    /** Trendline type: Power. */
+    LXW_CHART_TRENDLINE_TYPE_POWER,
+
+    /** Trendline type: Exponential. */
+    LXW_CHART_TRENDLINE_TYPE_EXP,
+
+    /** Trendline type: Moving Average. */
+    LXW_CHART_TRENDLINE_TYPE_AVERAGE
+} lxw_chart_trendline_type;
+
 /**
  * @brief Struct to represent an Excel chart data series.
  *
@@ -386,11 +869,57 @@ typedef struct lxw_chart_series {
     lxw_chart_title title;
     lxw_chart_line *line;
     lxw_chart_fill *fill;
+    lxw_chart_pattern *pattern;
+    lxw_chart_marker *marker;
+    lxw_chart_point *points;
+    uint16_t point_count;
+
+    uint8_t smooth;
+    uint8_t invert_if_negative;
+
+    /* Data label parameters. */
+    uint8_t has_labels;
+    uint8_t show_labels_value;
+    uint8_t show_labels_category;
+    uint8_t show_labels_name;
+    uint8_t show_labels_leader;
+    uint8_t show_labels_legend;
+    uint8_t show_labels_percent;
+    uint8_t label_position;
+    uint8_t label_separator;
+    uint8_t default_label_position;
+    char *label_num_format;
+    lxw_chart_font *label_font;
+
+    lxw_series_error_bars *x_error_bars;
+    lxw_series_error_bars *y_error_bars;
+
+    uint8_t has_trendline;
+    uint8_t has_trendline_forecast;
+    uint8_t has_trendline_equation;
+    uint8_t has_trendline_r_squared;
+    uint8_t has_trendline_intercept;
+    uint8_t trendline_type;
+    uint8_t trendline_value;
+    double trendline_forward;
+    double trendline_backward;
+    uint8_t trendline_value_type;
+    char *trendline_name;
+    lxw_chart_line *trendline_line;
+    double trendline_intercept;
 
     STAILQ_ENTRY (lxw_chart_series) list_pointers;
 
 } lxw_chart_series;
 
+/* Struct for major/minor axis gridlines. */
+typedef struct lxw_chart_gridline {
+
+    uint8_t visible;
+    lxw_chart_line *line;
+
+} lxw_chart_gridline;
+
 /**
  * @brief Struct to represent an Excel chart axis.
  *
@@ -401,16 +930,52 @@ typedef struct lxw_chart_axis {
 
     lxw_chart_title title;
 
-    char num_format[LXW_CHART_NUM_FORMAT_LEN];
-    char default_num_format[LXW_CHART_NUM_FORMAT_LEN];
+    char *num_format;
+    char *default_num_format;
+    uint8_t source_linked;
 
-    uint8_t default_major_gridlines;
     uint8_t major_tick_mark;
+    uint8_t minor_tick_mark;
     uint8_t is_horizontal;
 
+    lxw_chart_gridline major_gridlines;
+    lxw_chart_gridline minor_gridlines;
+
     lxw_chart_font *num_font;
     lxw_chart_line *line;
     lxw_chart_fill *fill;
+    lxw_chart_pattern *pattern;
+
+    uint8_t is_category;
+    uint8_t is_date;
+    uint8_t is_value;
+    uint8_t axis_position;
+    uint8_t position_axis;
+    uint8_t label_position;
+    uint8_t hidden;
+    uint8_t reverse;
+
+    uint8_t has_min;
+    double min;
+    uint8_t has_max;
+    double max;
+
+    uint8_t has_major_unit;
+    double major_unit;
+    uint8_t has_minor_unit;
+    double minor_unit;
+
+    uint16_t interval_unit;
+    uint16_t interval_tick;
+
+    uint16_t log_base;
+
+    uint8_t display_units;
+    uint8_t display_units_visible;
+
+    uint8_t has_crossing;
+    uint8_t crossing_max;
+    double crossing;
 
 } lxw_chart_axis;
 
@@ -452,7 +1017,7 @@ typedef struct lxw_chart {
     uint32_t axis_id_4;
 
     uint8_t in_use;
-    uint8_t is_scatter;
+    uint8_t chart_group;
     uint8_t cat_has_num_fmt;
 
     uint8_t has_horiz_cat_axis;
@@ -463,21 +1028,53 @@ typedef struct lxw_chart {
     uint16_t hole_size;
 
     uint8_t no_title;
-    uint8_t has_markers;
     uint8_t has_overlap;
-    int series_overlap_1;
+    int8_t overlap_y1;
+    int8_t overlap_y2;
+    uint16_t gap_y1;
+    uint16_t gap_y2;
 
     uint8_t grouping;
-    uint8_t cross_between;
-    uint8_t cat_axis_position;
-    uint8_t val_axis_position;
+    uint8_t default_cross_between;
 
     lxw_chart_legend legend;
     int16_t *delete_series;
     uint16_t delete_series_count;
+    lxw_chart_marker *default_marker;
+
+    lxw_chart_line *chartarea_line;
+    lxw_chart_fill *chartarea_fill;
+    lxw_chart_pattern *chartarea_pattern;
+    lxw_chart_line *plotarea_line;
+    lxw_chart_fill *plotarea_fill;
+    lxw_chart_pattern *plotarea_pattern;
+
+    uint8_t has_drop_lines;
+    lxw_chart_line *drop_lines_line;
+
+    uint8_t has_high_low_lines;
+    lxw_chart_line *high_low_lines_line;
 
     struct lxw_chart_series_list *series_list;
 
+    uint8_t has_table;
+    uint8_t has_table_vertical;
+    uint8_t has_table_horizontal;
+    uint8_t has_table_outline;
+    uint8_t has_table_legend_keys;
+    lxw_chart_font *table_font;
+
+    uint8_t show_blanks_as;
+    uint8_t show_hidden_data;
+
+    uint8_t has_up_down_bars;
+    lxw_chart_line *up_bar_line;
+    lxw_chart_line *down_bar_line;
+    lxw_chart_fill *up_bar_fill;
+    lxw_chart_fill *down_bar_fill;
+
+    uint8_t default_label_position;
+
     STAILQ_ENTRY (lxw_chart) ordered_list_pointers;
     STAILQ_ENTRY (lxw_chart) list_pointers;
 
@@ -734,139 +1331,1513 @@ void chart_series_set_line(lxw_chart_series *series, lxw_chart_line *line);
 void chart_series_set_fill(lxw_chart_series *series, lxw_chart_fill *fill);
 
 /**
- * @brief Set the name caption of the an axis.
+ * @brief Invert the fill color for negative series values.
  *
- * @param axis A pointer to a chart #lxw_chart_axis object.
- * @param name The name caption of the axis.
+ * @param series  A series object created via `chart_add_series()`.
  *
- * The `%chart_axis_set_name()` function sets the name (also known as title or
- * caption) for an axis. It can be used for the X or Y axes. The name is
- * displayed below an X axis and to the side of a Y axis.
+ * Invert the fill color for negative values. Usually only applicable to
+ * column and bar charts.
  *
  * @code
- *     chart_axis_set_name(chart->x_axis, "Earnings per Quarter");
- *     chart_axis_set_name(chart->y_axis, "US Dollars (Millions)");
+ *     chart_series_set_invert_if_negative(series);
  * @endcode
  *
- * @image html chart_axis_set_name.png
+ */
+void chart_series_set_invert_if_negative(lxw_chart_series *series);
+
+/**
+ * @brief Set the pattern properties for a chart series.
  *
- * The name parameter can also be a formula such as `=Sheet1!$A$1` to point to
- * a cell in the workbook that contains the name:
+ * @param series  A series object created via `chart_add_series()`.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chart series:
  *
  * @code
- *     chart_axis_set_name(chart->x_axis, "=Sheet1!$B1$1");
+ *     lxw_chart_pattern pattern1 = {.type = LXW_CHART_PATTERN_SHINGLE,
+ *                                   .fg_color = 0x804000,
+ *                                   .bg_color = 0XC68C53};
+ *
+ *     lxw_chart_pattern pattern2 = {.type = LXW_CHART_PATTERN_HORIZONTAL_BRICK,
+ *                                   .fg_color = 0XB30000,
+ *                                   .bg_color = 0XFF6666};
+ *
+ *     chart_series_set_pattern(series1, &pattern1);
+ *     chart_series_set_pattern(series2, &pattern2);
+ *
  * @endcode
  *
- * See also the `chart_axis_set_name_range()` function to see how to set the
- * name formula programmatically.
+ * @image html chart_pattern.png
  *
- * This function is applicable to category, date and value axes.
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
  */
-void chart_axis_set_name(lxw_chart_axis *axis, const char *name);
+void chart_series_set_pattern(lxw_chart_series *series,
+                              lxw_chart_pattern *pattern);
 
 /**
- * @brief Set a chart axis name formula using row and column values.
+ * @brief Set the data marker type for a series.
  *
- * @param axis      A pointer to a chart #lxw_chart_axis object.
- * @param sheetname The name of the worksheet that contains the cell range.
- * @param row       The zero indexed row number of the range.
- * @param col       The zero indexed column number of the range.
+ * @param series A series object created via `chart_add_series()`.
+ * @param type   The marker type, see #lxw_chart_marker_type.
  *
- * The `%chart_axis_set_name_range()` function can be used to set an axis name
- * range and is an alternative to using `chart_axis_set_name()` and a string
- * formula:
+ * In Excel a chart marker is used to distinguish data points in a plotted
+ * series. In general only Line and Scatter and Radar chart types use
+ * markers. The libxlsxwriter chart types that can have markers are:
+ *
+ * - #LXW_CHART_LINE
+ * - #LXW_CHART_SCATTER
+ * - #LXW_CHART_SCATTER_STRAIGHT
+ * - #LXW_CHART_SCATTER_STRAIGHT_WITH_MARKERS
+ * - #LXW_CHART_SCATTER_SMOOTH
+ * - #LXW_CHART_SCATTER_SMOOTH_WITH_MARKERS
+ * - #LXW_CHART_RADAR
+ * - #LXW_CHART_RADAR_WITH_MARKERS
+ *
+ * The chart types with `MARKERS` in the name have markers with default colors
+ * and shapes turned on by default but it is possible using the various
+ * `chart_series_set_marker_xxx()` functions below to change these defaults. It
+ * is also possible to turn on an off markers.
+ *
+ * The `%chart_series_set_marker_type()` function is used to specify the
+ * type of the series marker:
  *
  * @code
- *     chart_axis_set_name_range(chart->x_axis, "Sheet1", 1, 0);
- *     chart_axis_set_name_range(chart->y_axis, "Sheet1", 2, 0);
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_DIAMOND);
  * @endcode
- */
-void chart_axis_set_name_range(lxw_chart_axis *axis, const char *sheetname,
-                               lxw_row_t row, lxw_col_t col);
-
+ *
+ * @image html chart_marker1.png
+ *
+ * The available marker types defined by #lxw_chart_marker_type are:
+ *
+ * - #LXW_CHART_MARKER_AUTOMATIC
+ * - #LXW_CHART_MARKER_NONE
+ * - #LXW_CHART_MARKER_SQUARE
+ * - #LXW_CHART_MARKER_DIAMOND
+ * - #LXW_CHART_MARKER_TRIANGLE
+ * - #LXW_CHART_MARKER_X
+ * - #LXW_CHART_MARKER_STAR
+ * - #LXW_CHART_MARKER_SHORT_DASH
+ * - #LXW_CHART_MARKER_LONG_DASH
+ * - #LXW_CHART_MARKER_CIRCLE
+ * - #LXW_CHART_MARKER_PLUS
+ *
+ * The `#LXW_CHART_MARKER_NONE` type can be used to turn off default markers:
+ *
+ * @code
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_NONE);
+ * @endcode
+ *
+ * @image html chart_series_set_marker_none.png
+ *
+ * The `#LXW_CHART_MARKER_AUTOMATIC` type is a special case which turns on a
+ * marker using the default marker style for the particular series. If
+ * automatic is on then other marker properties such as size, line or fill
+ * cannot be set.
+ */
+void chart_series_set_marker_type(lxw_chart_series *series, uint8_t type);
+
+/**
+ * @brief Set the size of a data marker for a series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param size   The size of the marker.
+ *
+ * The `%chart_series_set_marker_size()` function is used to specify the
+ * size of the series marker:
+ *
+ * @code
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_CIRCLE);
+ *     chart_series_set_marker_size(series, 10);
+ * @endcode
+ *
+ * @image html chart_series_set_marker_size.png
+ *
+ */
+void chart_series_set_marker_size(lxw_chart_series *series, uint8_t size);
+
+/**
+ * @brief Set the line properties for a chart series marker.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param line   A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a chart marker:
+ *
+ * @code
+ *     lxw_chart_line line = {.color = LXW_COLOR_BLACK};
+ *     lxw_chart_fill fill = {.color = LXW_COLOR_RED};
+ *
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_SQUARE);
+ *     chart_series_set_marker_size(series, 8);
+ *
+ *     chart_series_set_marker_line(series, &line);
+ *     chart_series_set_marker_fill(series, &fill);
+ * @endcode
+ *
+ * @image html chart_marker2.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_series_set_marker_line(lxw_chart_series *series,
+                                  lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a chart series marker.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param fill   A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a chart marker:
+ *
+ * @code
+ *     chart_series_set_marker_fill(series, &fill);
+ * @endcode
+ *
+ * See the example and image above and also see @ref chart_fills.
+ */
+void chart_series_set_marker_fill(lxw_chart_series *series,
+                                  lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a chart series marker.
+ *
+ * @param series  A series object created via `chart_add_series()`.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chart marker:
+ *
+ * @code
+ *     chart_series_set_marker_pattern(series, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_series_set_marker_pattern(lxw_chart_series *series,
+                                     lxw_chart_pattern *pattern);
+
+/**
+ * @brief Set the formatting for points in the series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param points An NULL terminated array of #lxw_chart_point pointers.
+ *
+ * @return A #lxw_error.
+ *
+ * In general formatting is applied to an entire series in a chart. However,
+ * it is occasionally required to format individual points in a series. In
+ * particular this is required for Pie/Doughnut charts where each segment is
+ * represented by a point.
+ *
+ * @dontinclude chart_pie_colors.c
+ * @skip Add the data series
+ * @until chart_series_set_points
+ *
+ * @image html chart_points1.png
+ *
+ * @note The array of #lxw_chart_point pointers should be NULL terminated
+ * as shown in the example.
+ *
+ * For more details see @ref chart_points
+ */
+lxw_error chart_series_set_points(lxw_chart_series *series,
+                                  lxw_chart_point *points[]);
+
+/**
+ * @brief Smooth a line or scatter chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param smooth Turn off/on the line smoothing. (0/1)
+ *
+ * The `chart_series_set_smooth()` function is used to set the smooth property
+ * of a line series. It is only applicable to the line and scatter chart
+ * types:
+ *
+ * @code
+ *     chart_series_set_smooth(series2, LXW_TRUE);
+ * @endcode
+ *
+ * @image html chart_smooth.png
+ *
+ *
+ */
+void chart_series_set_smooth(lxw_chart_series *series, uint8_t smooth);
+
+/**
+ * @brief Add data labels to a chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels()` function is used to turn on data labels
+ * for a chart series. Data labels indicate the values of the plotted data
+ * points.
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ * @endcode
+ *
+ * @image html chart_labels1.png
+ *
+ * By default data labels are displayed in Excel with only the values shown:
+ *
+ * @image html chart_labels2.png
+ *
+ * However, it is possible to configure other display options, as shown
+ * in the functions below.
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels(lxw_chart_series *series);
+
+/**
+ * @brief Set the display options for the labels of a data series.
+ *
+ * @param series        A series object created via `chart_add_series()`.
+ * @param show_name     Turn on/off the series name in the label caption.
+ * @param show_category Turn on/off the category name in the label caption.
+ * @param show_value    Turn on/off the value in the label caption.
+ *
+ * The `%chart_series_set_labels_options()` function is used to set the
+ * parameters that are displayed in the series data label:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_options(series, LXW_TRUE, LXW_TRUE, LXW_TRUE);
+ * @endcode
+ *
+ * @image html chart_labels3.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_options(lxw_chart_series *series,
+                                     uint8_t show_name, uint8_t show_category,
+                                     uint8_t show_value);
+
+/**
+ * @brief Set the separator for the data label captions.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param separator The separator for the data label options:
+ *                  #lxw_chart_label_separator.
+ *
+ * The `%chart_series_set_labels_separator()` function is used to change the
+ * separator between multiple data label items. The default options is a comma
+ * separator as shown in the previous example.
+ *
+ * The available options are:
+ *
+ * - #LXW_CHART_LABEL_SEPARATOR_SEMICOLON: semicolon separator.
+ * - #LXW_CHART_LABEL_SEPARATOR_PERIOD: a period (dot) separator.
+ * - #LXW_CHART_LABEL_SEPARATOR_NEWLINE: a newline separator.
+ * - #LXW_CHART_LABEL_SEPARATOR_SPACE: a space separator.
+ *
+ * For example:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_options(series, LXW_TRUE, LXW_TRUE, LXW_TRUE);
+ *     chart_series_set_labels_separator(series, LXW_CHART_LABEL_SEPARATOR_NEWLINE);
+ * @endcode
+ *
+ * @image html chart_labels4.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_separator(lxw_chart_series *series,
+                                       uint8_t separator);
+
+/**
+ * @brief Set the data label position for a series.
+ *
+ * @param series   A series object created via `chart_add_series()`.
+ * @param position The data label position: #lxw_chart_label_position.
+ *
+ * The `%chart_series_set_labels_position()` function sets the position of
+ * the labels in the data series:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_position(series, LXW_CHART_LABEL_POSITION_ABOVE);
+ * @endcode
+ *
+ * @image html chart_labels5.png
+ *
+ * In Excel the allowable data label positions vary for different chart
+ * types. The allowable, and default, positions are:
+ *
+ * | Position                              | Line, Scatter | Bar, Column   | Pie, Doughnut | Area, Radar   |
+ * | :------------------------------------ | :------------ | :------------ | :------------ | :------------ |
+ * | #LXW_CHART_LABEL_POSITION_CENTER      | Yes           | Yes           | Yes           | Yes (default) |
+ * | #LXW_CHART_LABEL_POSITION_RIGHT       | Yes (default) |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_LEFT        | Yes           |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_ABOVE       | Yes           |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_BELOW       | Yes           |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_INSIDE_BASE |               | Yes           |               |               |
+ * | #LXW_CHART_LABEL_POSITION_INSIDE_END  |               | Yes           | Yes           |               |
+ * | #LXW_CHART_LABEL_POSITION_OUTSIDE_END |               | Yes (default) | Yes           |               |
+ * | #LXW_CHART_LABEL_POSITION_BEST_FIT    |               |               | Yes (default) |               |
+ *
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_position(lxw_chart_series *series,
+                                      uint8_t position);
+
+/**
+ * @brief Set leader lines for Pie and Doughnut charts.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels_leader_line()` function  is used to turn on
+ * leader lines for the data label of a series. It is mainly used for pie
+ * or doughnut charts:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_leader_line(series);
+ * @endcode
+ *
+ * @note Even when leader lines are turned on they aren't automatically
+ *       visible in Excel or XlsxWriter. Due to an Excel limitation
+ *       (or design) leader lines only appear if the data label is moved
+ *       manually or if the data labels are very close and need to be
+ *       adjusted automatically.
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_leader_line(lxw_chart_series *series);
+
+/**
+ * @brief Set the legend key for a data label in a chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels_legend()` function is used to set the
+ * legend key for a data series:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_legend(series);
+ * @endcode
+ *
+ * @image html chart_labels6.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_legend(lxw_chart_series *series);
+
+/**
+ * @brief Set the percentage for a Pie/Doughnut data point.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels_percentage()` function is used to turn on
+ * the display of data labels as a percentage for a series. It is mainly
+ * used for pie charts:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_options(series, LXW_FALSE, LXW_FALSE, LXW_FALSE);
+ *     chart_series_set_labels_percentage(series);
+ * @endcode
+ *
+ * @image html chart_labels7.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_percentage(lxw_chart_series *series);
+
+/**
+ * @brief Set the number format for chart data labels in a series.
+ *
+ * @param series     A series object created via `chart_add_series()`.
+ * @param num_format The number format string.
+ *
+ * The `%chart_series_set_labels_num_format()` function is used to set the
+ * number format for data labels:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_num_format(series, "$0.00");
+ * @endcode
+ *
+ * @image html chart_labels8.png
+ *
+ * The number format is similar to the Worksheet Cell Format num_format,
+ * see `format_set_num_format()`.
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_num_format(lxw_chart_series *series,
+                                        const char *num_format);
+
+/**
+ * @brief Set the font properties for chart data labels in a series
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param font   A pointer to a chart #lxw_chart_font font struct.
+ *
+ *
+ * The `%chart_series_set_labels_font()` function is used to set the font
+ * for data labels:
+ *
+ * @code
+ *     lxw_chart_font font = {.name = "Consolas", .color = LXW_COLOR_RED};
+ *
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_font(series, &font);
+ * @endcode
+ *
+ * @image html chart_labels9.png
+ *
+ * For more information see @ref chart_fonts and @ref chart_labels.
+ *
+ */
+void chart_series_set_labels_font(lxw_chart_series *series,
+                                  lxw_chart_font *font);
+
+/**
+ * @brief Turn on a trendline for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param type   The type of trendline: #lxw_chart_trendline_type.
+ * @param value  The order/period value for polynomial and moving average
+ *               trendlines.
+ *
+ * A trendline can be added to a chart series to indicate trends in the data
+ * such as a moving average or a polynomial fit. The trendlines types are
+ * shown in the following Excel dialog:
+ *
+ * @image html chart_trendline0.png
+ *
+ * The `%chart_series_set_trendline()` function turns on these trendlines for
+ * a data series:
+ *
+ * @code
+ *     chart = workbook_add_chart(workbook, LXW_CHART_LINE);
+ *     series = chart_add_series(chart, NULL, "Sheet1!$A$1:$A$6");
+ *
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ * @endcode
+ *
+ * @image html chart_trendline2.png
+ *
+ * The `value` parameter corresponds to *order* for a polynomial trendline
+ * and *period* for a Moving Average trendline. It both cases it must be >= 2.
+ * The `value` parameter  is ignored for all other trendlines:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_AVERAGE, 2);
+ * @endcode
+ *
+ * @image html chart_trendline3.png
+ *
+ * The allowable values for the the trendline `type` are:
+ *
+ * - #LXW_CHART_TRENDLINE_TYPE_LINEAR: Linear trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_LOG: Logarithm trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_POLY: Polynomial trendline. The `value`
+ *   parameter corresponds to *order*.
+ * - #LXW_CHART_TRENDLINE_TYPE_POWER: Power trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_EXP: Exponential trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_AVERAGE: Moving Average trendline. The `value`
+ *   parameter corresponds to *period*.
+ *
+ * Other trendline options, such as those shown in the following Excel
+ * dialog, can be set using the functions below.
+ *
+ * @image html chart_trendline1.png
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline(lxw_chart_series *series, uint8_t type,
+                                uint8_t value);
+
+/**
+ * @brief Set the trendline forecast for a chart data series.
+ *
+ * @param series   A series object created via `chart_add_series()`.
+ * @param forward  The forward period.
+ * @param backward The backwards period.
+ *
+ * The `%chart_series_set_trendline_forecast()` function sets the forward
+ * and backward forecast periods for the trendline:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_forecast(series, 0.5, 0.5);
+ * @endcode
+ *
+ * @image html chart_trendline4.png
+ *
+ * @note This feature isn't available for Moving Average in Excel.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_forecast(lxw_chart_series *series,
+                                         double forward, double backward);
+
+/**
+ * @brief Display the equation of a trendline for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_trendline_equation()` function displays the
+ * equation of the trendline on the chart:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_equation(series);
+ * @endcode
+ *
+ * @image html chart_trendline5.png
+ *
+ * @note This feature isn't available for Moving Average in Excel.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_equation(lxw_chart_series *series);
+
+/**
+ * @brief Display the R squared value of a trendline for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_trendline_r_squared()` function displays the
+ * R-squared value for the trendline on the chart:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_r_squared(series);
+ * @endcode
+ *
+ * @image html chart_trendline6.png
+ *
+ * @note This feature isn't available for Moving Average in Excel.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_r_squared(lxw_chart_series *series);
+
+/**
+ * @brief Set the trendline Y-axis intercept for a chart data series.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param intercept Y-axis intercept value.
+ *
+ * The `%chart_series_set_trendline_intercept()` function sets the Y-axis
+ * intercept for the trendline:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_equation(series);
+ *     chart_series_set_trendline_intercept(series, 0.8);
+ * @endcode
+ *
+ * @image html chart_trendline7.png
+ *
+ * As can be seen from the equation on the chart the intercept point
+ * (when X=0) is the same as the value set in the equation.
+ *
+ * @note The intercept feature is only available in Excel for Exponential,
+ *       Linear and Polynomial trendline types.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_intercept(lxw_chart_series *series,
+                                          double intercept);
+
+/**
+ * @brief Set the trendline name for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param name   The name of the trendline to display in the legend.
+ *
+ * The `%chart_series_set_trendline_name()` function sets the name of the
+ * trendline that is displayed in the chart legend. In the examples above
+ * the trendlines are displayed with default names like "Linear (Series 1)"
+ * and "2 per Mov. Avg. (Series 1)". If these names are too verbose or not
+ * descriptive enough you can set your own trendline name:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_name(series, "My trendline");
+ * @endcode
+ *
+ * @image html chart_trendline8.png
+ *
+ * It is often preferable to turn off the trendline caption in the legend.
+ * This is down in Excel by deleting the trendline name from the legend.
+ * In libxlsxwriter this is done using the `chart_legend_delete_series()`
+ * function to delete the zero based series numbers:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *
+ *     // Delete the series name for the second series (=1 in zero base).
+ *     // The -1 value indicates the end of the array of values.
+ *     int16_t names[] = {1, -1};
+ *     chart_legend_delete_series(chart, names);
+ * @endcode
+ *
+ * @image html chart_trendline9.png
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_name(lxw_chart_series *series,
+                                     const char *name);
+
+/**
+ * @brief Set the trendline line properties for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param line   A #lxw_chart_line struct.
+ *
+ * The `%chart_series_set_trendline_line()` function is used to set the line
+ * properties of a trendline:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_LONG_DASH};
+ *
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_line(series, &line);
+ * @endcode
+ *
+ * @image html chart_trendline10.png
+ *
+ * For more information see @ref chart_trendlines and @ref chart_lines.
+ */
+void chart_series_set_trendline_line(lxw_chart_series *series,
+                                     lxw_chart_line *line);
+
+/**
+ * Set the X or Y error bars for a chart series.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param type       The type of error bar: #lxw_chart_error_bar_type.
+ * @param value      The error value.
+ *
+ * Error bars can be added to a chart series to indicate error bounds in the
+ * data. The error bars can be vertical `y_error_bars` (the most common type)
+ * or horizontal `x_error_bars` (for Bar and Scatter charts only).
+ *
+ * @image html chart_error_bars0.png
+ *
+ * The `%chart_series_set_error_bars()` function sets the error bar type
+ * and value associated with the type:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart,
+ *                                                 "=Sheet1!$A$1:$A$5",
+ *                                                 "=Sheet1!$B$1:$B$5");
+ *
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ * @endcode
+ *
+ * @image html chart_error_bars1.png
+ *
+ * The error bar types that be used are:
+ *
+ * - #LXW_CHART_ERROR_BAR_TYPE_STD_ERROR: Standard error.
+ * - #LXW_CHART_ERROR_BAR_TYPE_FIXED: Fixed value.
+ * - #LXW_CHART_ERROR_BAR_TYPE_PERCENTAGE: Percentage.
+ * - #LXW_CHART_ERROR_BAR_TYPE_STD_DEV: Standard deviation(s).
+ *
+ * @note Custom error bars are not currently supported.
+ *
+ * All error bar types, apart from Standard error, should have a valid
+ * value to set the error range:
+ *
+ * @code
+ *     chart_series_set_error_bars(series1->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_FIXED, 2);
+ *
+ *     chart_series_set_error_bars(series2->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_PERCENTAGE, 5);
+ *
+ *     chart_series_set_error_bars(series3->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_DEV, 1);
+ * @endcode
+ *
+ * For the Standard error type the value is ignored.
+ *
+ * For more information see @ref chart_error_bars.
+ */
+void chart_series_set_error_bars(lxw_series_error_bars *error_bars,
+                                 uint8_t type, double value);
+
+/**
+ * @brief Set the direction (up, down or both) of the error bars for a chart
+ *        series.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param direction  The bar direction: #lxw_chart_error_bar_direction .
+ *
+ * The `%chart_series_set_error_bars_direction()` function sets the
+ * direction of the error bars:
+ *
+ * @code
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ *
+ *     chart_series_set_error_bars_direction(series->y_error_bars,
+ *                                           LXW_CHART_ERROR_BAR_DIR_PLUS);
+ * @endcode
+ *
+ * @image html chart_error_bars2.png
+ *
+ * The valid directions are:
+ *
+ * - #LXW_CHART_ERROR_BAR_DIR_BOTH: Error bar extends in both directions.
+ *   The default.
+ * - #LXW_CHART_ERROR_BAR_DIR_PLUS: Error bar extends in positive direction.
+ * - #LXW_CHART_ERROR_BAR_DIR_MINUS: Error bar extends in negative direction.
+ *
+ * For more information see @ref chart_error_bars.
+ */
+void chart_series_set_error_bars_direction(lxw_series_error_bars *error_bars,
+                                           uint8_t direction);
+
+/**
+ * @brief Set the end cap type for the error bars of a chart series.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param endcap     The error bar end cap type: #lxw_chart_error_bar_cap .
+ *
+ * The `%chart_series_set_error_bars_endcap()` function sets the end cap
+ * type for the error bars:
+ *
+ * @code
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ *
+ *     chart_series_set_error_bars_endcap(series->y_error_bars,
+                                          LXW_CHART_ERROR_BAR_NO_CAP);
+ * @endcode
+ *
+ * @image html chart_error_bars3.png
+ *
+ * The valid values are:
+ *
+ * - #LXW_CHART_ERROR_BAR_END_CAP: Flat end cap. The default.
+ * - #LXW_CHART_ERROR_BAR_NO_CAP: No end cap.
+ *
+ * For more information see @ref chart_error_bars.
+ */
+void chart_series_set_error_bars_endcap(lxw_series_error_bars *error_bars,
+                                        uint8_t endcap);
+
+/**
+ * @brief Set the line properties for a chart series error bars.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param line       A #lxw_chart_line struct.
+ *
+ * The `%chart_series_set_error_bars_line()` function sets the line
+ * properties for the error bars:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_ROUND_DOT};
+ *
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ *
+ *     chart_series_set_error_bars_line(series->y_error_bars, &line);
+ * @endcode
+ *
+ * @image html chart_error_bars4.png
+ *
+ * For more information see @ref chart_lines and @ref chart_error_bars.
+ */
+void chart_series_set_error_bars_line(lxw_series_error_bars *error_bars,
+                                      lxw_chart_line *line);
+
+/**
+ * @brief Set the name caption of the an axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param name The name caption of the axis.
+ *
+ * The `%chart_axis_set_name()` function sets the name (also known as title or
+ * caption) for an axis. It can be used for the X or Y axes. The name is
+ * displayed below an X axis and to the side of a Y axis.
+ *
+ * @code
+ *     chart_axis_set_name(chart->x_axis, "Earnings per Quarter");
+ *     chart_axis_set_name(chart->y_axis, "US Dollars (Millions)");
+ * @endcode
+ *
+ * @image html chart_axis_set_name.png
+ *
+ * The name parameter can also be a formula such as `=Sheet1!$A$1` to point to
+ * a cell in the workbook that contains the name:
+ *
+ * @code
+ *     chart_axis_set_name(chart->x_axis, "=Sheet1!$B1$1");
+ * @endcode
+ *
+ * See also the `chart_axis_set_name_range()` function to see how to set the
+ * name formula programmatically.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_name(lxw_chart_axis *axis, const char *name);
+
+/**
+ * @brief Set a chart axis name formula using row and column values.
+ *
+ * @param axis      A pointer to a chart #lxw_chart_axis object.
+ * @param sheetname The name of the worksheet that contains the cell range.
+ * @param row       The zero indexed row number of the range.
+ * @param col       The zero indexed column number of the range.
+ *
+ * The `%chart_axis_set_name_range()` function can be used to set an axis name
+ * range and is an alternative to using `chart_axis_set_name()` and a string
+ * formula:
+ *
+ * @code
+ *     chart_axis_set_name_range(chart->x_axis, "Sheet1", 1, 0);
+ *     chart_axis_set_name_range(chart->y_axis, "Sheet1", 2, 0);
+ * @endcode
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_name_range(lxw_chart_axis *axis, const char *sheetname,
+                               lxw_row_t row, lxw_col_t col);
+
+/**
+ * @brief Set the font properties for a chart axis name.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param font A pointer to a chart #lxw_chart_font font struct.
+ *
+ * The `%chart_axis_set_name_font()` function is used to set the font of an
+ * axis name:
+ *
+ * @code
+ *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *
+ *     chart_axis_set_name(chart->x_axis, "Yearly data");
+ *     chart_axis_set_name_font(chart->x_axis, &font);
+ * @endcode
+ *
+ * @image html chart_axis_set_name_font.png
+ *
+ * For more information see @ref chart_fonts.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_name_font(lxw_chart_axis *axis, lxw_chart_font *font);
+
+/**
+ * @brief Set the font properties for the numbers of a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param font A pointer to a chart #lxw_chart_font font struct.
+ *
+ * The `%chart_axis_set_num_font()` function is used to set the font of the
+ * numbers on an axis:
+ *
+ * @code
+ *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *
+ *     chart_axis_set_num_font(chart->x_axis, &font1);
+ * @endcode
+ *
+ * @image html chart_axis_set_num_font.png
+ *
+ * For more information see @ref chart_fonts.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_num_font(lxw_chart_axis *axis, lxw_chart_font *font);
+
+/**
+ * @brief Set the number format for a chart axis.
+ *
+ * @param axis       A pointer to a chart #lxw_chart_axis object.
+ * @param num_format The number format string.
+ *
+ * The `%chart_axis_set_num_format()` function is used to set the format of
+ * the numbers on an axis:
+ *
+ * @code
+ *     chart_axis_set_num_format(chart->x_axis, "0.00%");
+ *     chart_axis_set_num_format(chart->y_axis, "$#,##0.00");
+ * @endcode
+ *
+ * The number format is similar to the Worksheet Cell Format num_format,
+ * see `format_set_num_format()`.
+ *
+ * @image html chart_axis_num_format.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_num_format(lxw_chart_axis *axis, const char *num_format);
+
+/**
+ * @brief Set the line properties for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param line A #lxw_chart_line struct.
+ *
+ * Set the line properties of a chart axis:
+ *
+ * @code
+ *     // Hide the Y axis.
+ *     lxw_chart_line line = {.none = LXW_TRUE};
+ *
+ *     chart_axis_set_line(chart->y_axis, &line);
+ * @endcode
+ *
+ * @image html chart_axis_set_line.png
+ *
+ * For more information see @ref chart_lines.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_line(lxw_chart_axis *axis, lxw_chart_line *line);
+
 /**
- * @brief Set the font properties for a chart axis name.
+ * @brief Set the fill properties for a chart axis.
  *
  * @param axis A pointer to a chart #lxw_chart_axis object.
- * @param font A pointer to a chart #lxw_chart_font font struct.
+ * @param fill A #lxw_chart_fill struct.
  *
- * The `%chart_axis_set_name_font()` function is used to set the font of an
- * axis name:
+ * Set the fill properties of a chart axis:
  *
  * @code
- *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *     lxw_chart_fill fill = {.color = LXW_COLOR_YELLOW};
  *
- *     chart_axis_set_name(chart->x_axis, "Yearly data");
- *     chart_axis_set_name_font(chart->x_axis, &font);
+ *     chart_axis_set_fill(chart->y_axis, &fill);
  * @endcode
  *
- * @image html chart_axis_set_name_font.png
+ * @image html chart_axis_set_fill.png
  *
- * For more information see @ref chart_fonts.
+ * For more information see @ref chart_fills.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
  */
-void chart_axis_set_name_font(lxw_chart_axis *axis, lxw_chart_font *font);
+void chart_axis_set_fill(lxw_chart_axis *axis, lxw_chart_fill *fill);
 
 /**
- * @brief Set the font properties for the numbers of a chart axis.
+ * @brief Set the pattern properties for a chart axis.
+ *
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chart axis:
+ *
+ * @code
+ *     chart_axis_set_pattern(chart->y_axis, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_pattern(lxw_chart_axis *axis, lxw_chart_pattern *pattern);
+
+/**
+ * @brief Reverse the order of the axis categories or values.
  *
  * @param axis A pointer to a chart #lxw_chart_axis object.
- * @param font A pointer to a chart #lxw_chart_font font struct.
  *
- * The `%chart_axis_set_num_font()` function is used to set the font of the
- * numbers on an axis:
+ * Reverse the order of the axis categories or values:
+ *
+ * @code
+ *     chart_axis_set_reverse(chart->x_axis);
+ * @endcode
+ *
+ * @image html chart_reverse.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_reverse(lxw_chart_axis *axis);
+
+/**
+ * @brief Set the position that the axis will cross the opposite axis.
+ *
+ * @param axis  A pointer to a chart #lxw_chart_axis object.
+ * @param value The category or value that the axis crosses at.
+ *
+ * Set the position that the axis will cross the opposite axis:
+ *
+ * @code
+ *     chart_axis_set_crossing(chart->x_axis, 3);
+ *     chart_axis_set_crossing(chart->y_axis, 8);
+ * @endcode
+ *
+ * @image html chart_crossing1.png
+ *
+ * If crossing is omitted (the default) the crossing will be set automatically
+ * by Excel based on the chart data.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_crossing(lxw_chart_axis *axis, double value);
+
+/**
+ * @brief Set the opposite axis crossing position as the axis maximum.
+ *
+ * @param axis  A pointer to a chart #lxw_chart_axis object.
+ *
+ * Set the position that the opposite axis will cross as the axis maximum.
+ * The default axis crossing position is generally the axis minimum so this
+ * function can be used to reverse the location of the axes without reversing
+ * the number sequence:
+ *
+ * @code
+ *     chart_axis_set_crossing_max(chart->x_axis);
+ *     chart_axis_set_crossing_max(chart->y_axis);
+ * @endcode
+ *
+ * @image html chart_crossing2.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_crossing_max(lxw_chart_axis *axis);
+
+/**
+ * @brief Turn off/hide an axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ *
+ * Turn off, hide, a chart axis:
+ *
+ * @code
+ *     chart_axis_off(chart->x_axis);
+ * @endcode
+ *
+ * @image html chart_axis_off.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_off(lxw_chart_axis *axis);
+
+/**
+ * @brief Position a category axis on or between the axis tick marks.
+ *
+ * @param axis     A pointer to a chart #lxw_chart_axis object.
+ * @param position A #lxw_chart_axis_tick_position value.
+ *
+ * Position a category axis horizontally on, or between, the axis tick marks.
+ *
+ * There are two allowable values:
+ *
+ * - #LXW_CHART_AXIS_POSITION_ON_TICK
+ * - #LXW_CHART_AXIS_POSITION_BETWEEN
+ *
+ * @code
+ *     chart_axis_set_position(chart->x_axis, LXW_CHART_AXIS_POSITION_BETWEEN);
+ * @endcode
+ *
+ * @image html chart_axis_set_position.png
+ *
+ * **Axis types**: This function is applicable to category axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_position(lxw_chart_axis *axis, uint8_t position);
+
+/**
+ * @brief Position the axis labels.
+ *
+ * @param axis     A pointer to a chart #lxw_chart_axis object.
+ * @param position A #lxw_chart_axis_label_position value.
+ *
+ * Position the axis labels for the chart. The labels are the numbers, or
+ * strings or dates, on the axis that indicate the categories or values of
+ * the axis.
+ *
+ * For example:
+ *
+ * @code
+ *     chart_axis_set_label_position(chart->x_axis, LXW_CHART_AXIS_LABEL_POSITION_HIGH);
+       chart_axis_set_label_position(chart->y_axis, LXW_CHART_AXIS_LABEL_POSITION_HIGH);
+ * @endcode
+ *
+ * @image html chart_label_position2.png
+ *
+ * The allowable values:
+ *
+ * - #LXW_CHART_AXIS_LABEL_POSITION_NEXT_TO - The default.
+ * - #LXW_CHART_AXIS_LABEL_POSITION_HIGH - Also right for vertical axes.
+ * - #LXW_CHART_AXIS_LABEL_POSITION_LOW - Also left for vertical axes.
+ * - #LXW_CHART_AXIS_LABEL_POSITION_NONE
+ *
+ * @image html chart_label_position1.png
+ *
+ * The #LXW_CHART_AXIS_LABEL_POSITION_NONE turns off the axis labels. This
+ * is slightly different from `chart_axis_off()` which also turns off the
+ * labels but also turns off tick marks.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_label_position(lxw_chart_axis *axis, uint8_t position);
+
+/**
+ * @brief Set the minimum value for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param min  Minimum value for chart axis. Value axes only.
+ *
+ * Set the minimum value for the axis range.
+ *
+ * @code
+ *     chart_axis_set_min(chart->y_axis, -4);
+ *     chart_axis_set_max(chart->y_axis, 21);
+ * @endcode
+ *
+ * @image html chart_max_min.png
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_min(lxw_chart_axis *axis, double min);
+
+/**
+ * @brief Set the maximum value for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param max  Maximum value for chart axis. Value axes only.
+ *
+ * Set the maximum value for the axis range.
+ *
+ * @code
+ *     chart_axis_set_min(chart->y_axis, -4);
+ *     chart_axis_set_max(chart->y_axis, 21);
+ * @endcode
+ *
+ * See the above image.
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_max(lxw_chart_axis *axis, double max);
+
+/**
+ * @brief Set the log base of the axis range.
+ *
+ * @param axis     A pointer to a chart #lxw_chart_axis object.
+ * @param log_base The log base for value axis. Value axes only.
+ *
+ * Set the log base for the axis:
+ *
+ * @code
+ *     chart_axis_set_log_base(chart->y_axis, 10);
+ * @endcode
+ *
+ * @image html chart_log_base.png
+ *
+ * The allowable range of values for the log base in Excel is between 2 and
+ * 1000.
+ *
+ * **Axis types**: This function is applicable to value axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_log_base(lxw_chart_axis *axis, uint16_t log_base);
+
+/**
+ * @brief Set the major axis tick mark type.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param type The tick mark type, defined by #lxw_chart_tick_mark.
+ *
+ * Set the type of the major axis tick mark:
+ *
+ * @code
+ *     chart_axis_set_major_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_CROSSING);
+ *     chart_axis_set_minor_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_INSIDE);
+ *
+ *     chart_axis_set_major_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_OUTSIDE);
+ *     chart_axis_set_minor_tick_mark(chart->y_axis, LXW_CHART_AXIS_TICK_MARK_INSIDE);
+ *
+ *     // Hide the default gridlines so the tick marks are visible.
+ *     chart_axis_major_gridlines_set_visible(chart->y_axis, LXW_FALSE);
+ * @endcode
+ *
+ * @image html chart_tick_marks.png
+ *
+ * The tick mark types are:
+ *
+ * - #LXW_CHART_AXIS_TICK_MARK_NONE
+ * - #LXW_CHART_AXIS_TICK_MARK_INSIDE
+ * - #LXW_CHART_AXIS_TICK_MARK_OUTSIDE
+ * - #LXW_CHART_AXIS_TICK_MARK_CROSSING
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_major_tick_mark(lxw_chart_axis *axis, uint8_t type);
+
+/**
+ * @brief Set the minor axis tick mark type.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param type The tick mark type, defined by #lxw_chart_tick_mark.
+ *
+ * Set the type of the minor axis tick mark:
+ *
+ * @code
+ *     chart_axis_set_minor_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_INSIDE);
+ * @endcode
+ *
+ * See the image and example above.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_minor_tick_mark(lxw_chart_axis *axis, uint8_t type);
+
+/**
+ * @brief Set the interval between category values.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The interval between the categories.
+ *
+ * Set the interval between the category values. The default interval is 1
+ * which gives the intervals shown in the charts above:
+ *
+ *     1, 2, 3, 4, 5, etc.
+ *
+ * Setting it to 2 gives:
+ *
+ *     1, 3, 5, 7, etc.
+ *
+ * For example:
+ *
+ * @code
+ *     chart_axis_set_interval_unit(chart->x_axis, 2);
+ * @endcode
+ *
+ * @image html chart_set_interval1.png
+ *
+ * **Axis types**: This function is applicable to category and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_interval_unit(lxw_chart_axis *axis, uint16_t unit);
+
+/**
+ * @brief Set the interval between category tick marks.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The interval between the category ticks.
+ *
+ * Set the interval between the category tick marks. The default interval is 1
+ * between each category but it can be set to other integer values:
+ *
+ * @code
+ *     chart_axis_set_interval_tick(chart->x_axis, 2);
+ * @endcode
+ *
+ * @image html chart_set_interval2.png
+ *
+ * **Axis types**: This function is applicable to category and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_interval_tick(lxw_chart_axis *axis, uint16_t unit);
+
+/**
+ * @brief Set the increment of the major units in the axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The increment of the major units.
+ *
+ * Set the increment of the major units in the axis range.
+ *
+ * @code
+ *     // Turn on the minor gridline (it is off by default).
+ *     chart_axis_minor_gridlines_set_visible(chart->y_axis, LXW_TRUE);
+ *
+ *     chart_axis_set_major_unit(chart->y_axis, 4);
+ *     chart_axis_set_minor_unit(chart->y_axis, 2);
+ * @endcode
+ *
+ * @image html chart_set_major_units.png
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_major_unit(lxw_chart_axis *axis, double unit);
+
+/**
+ * @brief Set the increment of the minor units in the axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The increment of the minor units.
+ *
+ * Set the increment of the minor units in the axis range.
+ *
+ * @code
+ *     chart_axis_set_minor_unit(chart->y_axis, 2);
+ * @endcode
+ *
+ * See the image above
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_minor_unit(lxw_chart_axis *axis, double unit);
+
+/**
+ * @brief Set the display units for a value axis.
+ *
+ * @param axis  A pointer to a chart #lxw_chart_axis object.
+ * @param units The display units: #lxw_chart_axis_display_unit.
+ *
+ * Set the display units for the axis. This can be useful if the axis numbers
+ * are very large but you don't want to represent them in scientific notation:
+ *
+ * @code
+ *     chart_axis_set_display_units(chart->x_axis, LXW_CHART_AXIS_UNITS_THOUSANDS);
+ *     chart_axis_set_display_units(chart->y_axis, LXW_CHART_AXIS_UNITS_MILLIONS);
+ * @endcode
+ *
+ * @image html chart_display_units.png
+ *
+ * **Axis types**: This function is applicable to value axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_display_units(lxw_chart_axis *axis, uint8_t units);
+
+/**
+ * @brief Turn on/off the display units for a value axis.
+
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param visible Turn off/on the display units. (0/1)
+ *
+ * Turn on or off the display units for the axis. This option is set on
+ * automatically by `chart_axis_set_display_units()`.
+ *
+ * @code
+ *     chart_axis_set_display_units_visible(chart->y_axis, LXW_TRUE);
+ * @endcode
+ *
+ * **Axis types**: This function is applicable to value axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_display_units_visible(lxw_chart_axis *axis,
+                                          uint8_t visible);
+
+/**
+ * @brief Turn on/off the major gridlines for an axis.
+ *
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param visible Turn off/on the major gridline. (0/1)
+ *
+ * Turn on or off the major gridlines for an X or Y axis. In most Excel charts
+ * the Y axis major gridlines are on by default and the X axis major
+ * gridlines are off by default.
+ *
+ * Example:
+ *
+ * @code
+ *     // Reverse the normal visible/hidden gridlines for a column chart.
+ *     chart_axis_major_gridlines_set_visible(chart->x_axis, LXW_TRUE);
+ *     chart_axis_major_gridlines_set_visible(chart->y_axis, LXW_FALSE);
+ * @endcode
+ *
+ * @image html chart_gridline1.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_major_gridlines_set_visible(lxw_chart_axis *axis,
+                                            uint8_t visible);
+
+/**
+ * @brief Turn on/off the minor gridlines for an axis.
+ *
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param visible Turn off/on the minor gridline. (0/1)
+ *
+ * Turn on or off the minor gridlines for an X or Y axis. In most Excel charts
+ * the X and Y axis minor gridlines are off by default.
+ *
+ * Example, turn on all major and minor gridlines:
  *
  * @code
- *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
- *
- *     chart_axis_set_num_font(chart->x_axis, &font1);
+ *     chart_axis_major_gridlines_set_visible(chart->x_axis, LXW_TRUE);
+ *     chart_axis_minor_gridlines_set_visible(chart->x_axis, LXW_TRUE);
+ *     chart_axis_major_gridlines_set_visible(chart->y_axis, LXW_TRUE);
+ *     chart_axis_minor_gridlines_set_visible(chart->y_axis, LXW_TRUE);
  * @endcode
  *
- * @image html chart_axis_set_num_font.png
+ * @image html chart_gridline2.png
  *
- * For more information see @ref chart_fonts.
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
  */
-void chart_axis_set_num_font(lxw_chart_axis *axis, lxw_chart_font *font);
+void chart_axis_minor_gridlines_set_visible(lxw_chart_axis *axis,
+                                            uint8_t visible);
 
 /**
- * @brief Set the line properties for a chart axis.
+ * @brief Set the line properties for the chart axis major gridlines.
  *
  * @param axis A pointer to a chart #lxw_chart_axis object.
  * @param line A #lxw_chart_line struct.
  *
- * Set the line properties of a chart axis:
+ * Format the line properties of the major gridlines of a chart:
  *
  * @code
- *     // Hide the Y axis.
- *     lxw_chart_line line = {.none = LXW_TRUE};
+ *     lxw_chart_line line1 = {.color = LXW_COLOR_RED,
+ *                             .width = 0.5,
+ *                             .dash_type = LXW_CHART_LINE_DASH_SQUARE_DOT};
  *
- *     chart_axis_set_line(chart->y_axis, &line);
+ *     lxw_chart_line line2 = {.color = LXW_COLOR_YELLOW};
+ *
+ *     lxw_chart_line line3 = {.width = 1.25,
+ *                             .dash_type = LXW_CHART_LINE_DASH_DASH};
+ *
+ *     lxw_chart_line line4 = {.color =  0x00B050};
+ *
+ *     chart_axis_major_gridlines_set_line(chart->x_axis, &line1);
+ *     chart_axis_minor_gridlines_set_line(chart->x_axis, &line2);
+ *     chart_axis_major_gridlines_set_line(chart->y_axis, &line3);
+ *     chart_axis_minor_gridlines_set_line(chart->y_axis, &line4);
  * @endcode
  *
- * @image html chart_axis_set_line.png
+ * @image html chart_gridline3.png
  *
  * For more information see @ref chart_lines.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
  */
-void chart_axis_set_line(lxw_chart_axis *axis, lxw_chart_line *line);
+void chart_axis_major_gridlines_set_line(lxw_chart_axis *axis,
+                                         lxw_chart_line *line);
 
 /**
- * @brief Set the fill properties for a chart axis.
+ * @brief Set the line properties for the chart axis minor gridlines.
  *
  * @param axis A pointer to a chart #lxw_chart_axis object.
- * @param fill A #lxw_chart_fill struct.
- *
- * Set the fill properties of a chart axis:
- *
- * @code
- *     lxw_chart_fill fill = {.color = LXW_COLOR_YELLOW};
+ * @param line A #lxw_chart_line struct.
  *
- *     chart_axis_set_fill(chart->y_axis, &fill);
- * @endcode
+ * Format the line properties of the minor gridlines of a chart, see the
+ * example above.
  *
- * @image html chart_axis_set_fill.png
+ * For more information see @ref chart_lines.
  *
- * For more information see @ref chart_fills.
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
  */
-void chart_axis_set_fill(lxw_chart_axis *axis, lxw_chart_fill *fill);
+void chart_axis_minor_gridlines_set_line(lxw_chart_axis *axis,
+                                         lxw_chart_line *line);
 
 /**
  * @brief Set the title of the chart.
@@ -1040,6 +3011,124 @@ void chart_legend_set_font(lxw_chart *chart, lxw_chart_font *font);
 lxw_error chart_legend_delete_series(lxw_chart *chart,
                                      int16_t delete_series[]);
 
+/**
+ * @brief Set the line properties for a chartarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a chartarea. In Excel the chartarea
+ * is the background area behind the chart:
+ *
+ * @code
+ *     lxw_chart_line line = {.none  = LXW_TRUE};
+ *     lxw_chart_fill fill = {.color = LXW_COLOR_RED};
+ *
+ *     chart_chartarea_set_line(chart, &line);
+ *     chart_chartarea_set_fill(chart, &fill);
+ * @endcode
+ *
+ * @image html chart_chartarea.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_chartarea_set_line(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a chartarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param fill  A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a chartarea:
+ *
+ * @code
+ *     chart_chartarea_set_fill(chart, &fill);
+ * @endcode
+ *
+ * See the example and image above.
+ *
+ * For more information see @ref chart_fills.
+ */
+void chart_chartarea_set_fill(lxw_chart *chart, lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a chartarea.
+ *
+ * @param chart   Pointer to a lxw_chart instance to be configured.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chartarea:
+ *
+ * @code
+ *     chart_chartarea_set_pattern(series1, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_chartarea_set_pattern(lxw_chart *chart,
+                                 lxw_chart_pattern *pattern);
+
+/**
+ * @brief Set the line properties for a plotarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a plotarea. In Excel the plotarea is
+ * the area between the axes on which the chart series are plotted:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .width     = 2,
+ *                            .dash_type = LXW_CHART_LINE_DASH_DASH};
+ *     lxw_chart_fill fill = {.color     = 0xFFFFC2};
+ *
+ *     chart_plotarea_set_line(chart, &line);
+ *     chart_plotarea_set_fill(chart, &fill);
+ *
+ * @endcode
+ *
+ * @image html chart_plotarea.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_plotarea_set_line(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a plotarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param fill  A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a plotarea:
+ *
+ * @code
+ *     chart_plotarea_set_fill(chart, &fill);
+ * @endcode
+ *
+ * See the example and image above.
+ *
+ * For more information see @ref chart_fills.
+ */
+void chart_plotarea_set_fill(lxw_chart *chart, lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a plotarea.
+ *
+ * @param chart   Pointer to a lxw_chart instance to be configured.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a plotarea:
+ *
+ * @code
+ *     chart_plotarea_set_pattern(series1, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_plotarea_set_pattern(lxw_chart *chart, lxw_chart_pattern *pattern);
+
 /**
  * @brief Set the chart style type.
  *
@@ -1066,15 +3155,310 @@ lxw_error chart_legend_delete_series(lxw_chart *chart,
  * to the base chart type. They can not be defined by the `chart_set_style()``
  * function.
  *
- *
  */
 void chart_set_style(lxw_chart *chart, uint8_t style_id);
 
+/**
+ * @brief Turn on a data table below the horizontal axis.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ *
+ * The `%chart_set_table()` function adds a data table below the horizontal
+ * axis with the data used to plot the chart:
+ *
+ * @code
+ *     // Turn on the data table with default options.
+ *     chart_set_table(chart);
+ * @endcode
+ *
+ * @image html chart_data_table1.png
+ *
+ * The data table can only be shown with Bar, Column, Line and Area charts.
+ *
+ */
+void chart_set_table(lxw_chart *chart);
+
+/**
+ * @brief Turn on/off grid options for a chart data table.
+ *
+ * @param chart       Pointer to a lxw_chart instance to be configured.
+ * @param horizontal  Turn on/off the horizontal grid lines in the table.
+ * @param vertical    Turn on/off the vertical grid lines in the table.
+ * @param outline     Turn on/off the outline lines in the table.
+ * @param legend_keys Turn on/off the legend keys in the table.
+ *
+ * The `%chart_set_table_grid()` function turns on/off grid options for a
+ * chart data table. The data table grid options in Excel are shown in the
+ * dialog below:
+ *
+ * @image html chart_data_table3.png
+ *
+ * These options can be passed to the `%chart_set_table_grid()` function.
+ * The values for a default chart are:
+ *
+ * - `horizontal`: On.
+ * - `vertical`: On.
+ * - `outline`:  On.
+ * - `legend_keys`: Off.
+ *
+ * Example:
+ *
+ * @code
+ *     // Turn on the data table with default options.
+ *     chart_set_table(chart);
+ *
+ *     // Turn on all grid lines and the grid legend.
+ *     chart_set_table_grid(chart, LXW_TRUE, LXW_TRUE, LXW_TRUE, LXW_TRUE);
+ *
+ *     // Turn off the legend since it is show in the table.
+ *     chart_legend_set_position(chart, LXW_CHART_LEGEND_NONE);
+ *
+ * @endcode
+ *
+ * @image html chart_data_table2.png
+ *
+ * The data table can only be shown with Bar, Column, Line and Area charts.
+ *
+ */
+void chart_set_table_grid(lxw_chart *chart, uint8_t horizontal,
+                          uint8_t vertical, uint8_t outline,
+                          uint8_t legend_keys);
+
+void chart_set_table_font(lxw_chart *chart, lxw_chart_font *font);
+
+/**
+ * @brief Turn on up-down bars for the chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ *
+ * The `%chart_set_up_down_bars()` function adds Up-Down bars to Line charts
+ * to indicate the difference between the first and last data series:
+ *
+ * @code
+ *     chart_set_up_down_bars(chart);
+ * @endcode
+ *
+ * @image html chart_data_tools4.png
+ *
+ * Up-Down bars are only available in Line charts. By default Up-Down bars are
+ * black and white like in the above example. To format the border or fill
+ * of the bars see the `chart_set_up_down_bars_format()` function below.
+ */
+void chart_set_up_down_bars(lxw_chart *chart);
+
+/**
+ * @brief Turn on up-down bars for the chart, with formatting.
+ *
+ * @param chart         Pointer to a lxw_chart instance to be configured.
+ * @param up_bar_line   A #lxw_chart_line struct for the up-bar border.
+ * @param up_bar_fill   A #lxw_chart_fill struct for the up-bar fill.
+ * @param down_bar_line A #lxw_chart_line struct for the down-bar border.
+ * @param down_bar_fill A #lxw_chart_fill struct for the down-bar fill.
+ *
+ * The `%chart_set_up_down_bars_format()` function adds Up-Down bars to Line
+ * charts to indicate the difference between the first and last data series.
+ * It also allows the up and down bars to be formatted:
+ *
+ * @code
+ *     lxw_chart_line line      = {.color = LXW_COLOR_BLACK};
+ *     lxw_chart_fill up_fill   = {.color = 0x00B050};
+ *     lxw_chart_fill down_fill = {.color = LXW_COLOR_RED};
+ *
+ *     chart_set_up_down_bars_format(chart, &line, &up_fill, &line, &down_fill);
+ * @endcode
+ *
+ * @image html chart_up_down_bars.png
+ *
+ * Up-Down bars are only available in Line charts.
+ * For more format information  see @ref chart_lines and @ref chart_fills.
+ */
+void chart_set_up_down_bars_format(lxw_chart *chart,
+                                   lxw_chart_line *up_bar_line,
+                                   lxw_chart_fill *up_bar_fill,
+                                   lxw_chart_line *down_bar_line,
+                                   lxw_chart_fill *down_bar_fill);
+
+/**
+ * @brief Turn on and format Drop Lines for a chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * The `%chart_set_drop_lines()` function adds Drop Lines to charts to
+ * show the Category value of points in the data:
+ *
+ * @code
+ *     chart_set_drop_lines(chart, NULL);
+ * @endcode
+ *
+ * @image html chart_data_tools6.png
+ *
+ * It is possible to format the Drop Line line properties if required:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_SQUARE_DOT};
+ *
+ *     chart_set_drop_lines(chart, &line);
+ * @endcode
+ *
+ * Drop Lines are only available in Line and Area charts.
+ * For more format information see @ref chart_lines.
+ */
+void chart_set_drop_lines(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Turn on and format high-low Lines for a chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * The `%chart_set_high_low_lines()` function adds High-Low Lines to charts
+ * to show the Category value of points in the data:
+ *
+ * @code
+ *     chart_set_high_low_lines(chart, NULL);
+ * @endcode
+ *
+ * @image html chart_data_tools5.png
+ *
+ * It is possible to format the High-Low Line line properties if required:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_SQUARE_DOT};
+ *
+ *     chart_set_high_low_lines(chart, &line);
+ * @endcode
+ *
+ * High-Low Lines are only available in Line charts.
+ * For more format information see @ref chart_lines.
+ */
+void chart_set_high_low_lines(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Set the overlap between series in a Bar/Column chart.
+ *
+ * @param chart   Pointer to a lxw_chart instance to be configured.
+ * @param overlap The overlap between the series. -100 to 100.
+ *
+ * The `%chart_set_series_overlap()` function sets the overlap between series
+ * in Bar and Column charts.
+ *
+ * @code
+ *     chart_set_series_overlap(chart, -50);
+ * @endcode
+ *
+ * @image html chart_overlap.png
+ *
+ * The overlap value must be in the range `0 <= overlap <= 500`.
+ * The default value is 0.
+ *
+ * This option is only available for Bar/Column charts.
+ */
+void chart_set_series_overlap(lxw_chart *chart, int8_t overlap);
+
+/**
+ * @brief Set the gap between series in a Bar/Column chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param gap   The gap between the series.  0 to 500.
+ *
+ * The `%chart_set_series_gap()` function sets the gap between series in
+ * Bar and Column charts.
+ *
+ * @code
+ *     chart_set_series_gap(chart, 400);
+ * @endcode
+ *
+ * @image html chart_gap.png
+ *
+ * The gap value must be in the range `0 <= gap <= 500`. The default value
+ * is 150.
+ *
+ * This option is only available for Bar/Column charts.
+ */
+void chart_set_series_gap(lxw_chart *chart, uint16_t gap);
+
+/**
+ * @brief Set the option for displaying blank data in a chart.
+ *
+ * @param chart    Pointer to a lxw_chart instance to be configured.
+ * @param option The display option. A #lxw_chart_blank option.
+ *
+ * The `%chart_show_blanks_as()` function controls how blank data is displayed
+ * in a chart:
+ *
+ * @code
+ *     chart_show_blanks_as(chart, LXW_CHART_BLANKS_AS_CONNECTED);
+ * @endcode
+ *
+ * The `option` parameter can have one of the following values:
+ *
+ * - #LXW_CHART_BLANKS_AS_GAP: Show empty chart cells as gaps in the data.
+ *   This is the default option for Excel charts.
+ * - #LXW_CHART_BLANKS_AS_ZERO: Show empty chart cells as zeros.
+ * - #LXW_CHART_BLANKS_AS_CONNECTED: Show empty chart cells as connected.
+ *   Only for charts with lines.
+ */
+void chart_show_blanks_as(lxw_chart *chart, uint8_t option);
+
+/**
+ * @brief Display data on charts from hidden rows or columns.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ *
+ * Display data that is in hidden rows or columns on the chart:
+ *
+ * @code
+ *     chart_show_hidden_data(chart);
+ * @endcode
+ */
+void chart_show_hidden_data(lxw_chart *chart);
+
+/**
+ * @brief Set the Pie/Doughnut chart rotation.
+ *
+ * @param chart    Pointer to a lxw_chart instance to be configured.
+ * @param rotation The angle of rotation.
+ *
+ * The `chart_set_rotation()` function is used to set the rotation of the
+ * first segment of a Pie/Doughnut chart. This has the effect of rotating
+ * the entire chart:
+ *
+ * @code
+ *     chart_set_rotation(chart, 28);
+ * @endcode
+ *
+ * The angle of rotation must be in the range `0 <= rotation <= 360`.
+ *
+ * This option is only available for Pie/Doughnut charts.
+ *
+ */
 void chart_set_rotation(lxw_chart *chart, uint16_t rotation);
+
+/**
+ * @brief Set the Doughnut chart hole size.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param size  The hole size as a percentage.
+ *
+ * The `chart_set_hole_size()` function is used to set the hole size of a
+ * Doughnut chart:
+ *
+ * @code
+ *     chart_set_hole_size(chart, 33);
+ * @endcode
+ *
+ * The hole size must be in the range `10 <= size <= 90`.
+ *
+ * This option is only available for Doughnut charts.
+ *
+ */
 void chart_set_hole_size(lxw_chart *chart, uint8_t size);
 
-int lxw_chart_add_data_cache(lxw_series_range *range, uint8_t *data,
-                             uint16_t rows, uint8_t cols, uint8_t col);
+lxw_error lxw_chart_add_data_cache(lxw_series_range *range, uint8_t *data,
+                                   uint16_t rows, uint8_t cols, uint8_t col);
 
 /* Declarations required for unit testing. */
 #ifdef TESTING